---
title: "Claude 安装前准备：系统要求与环境配置"
description: "安装前花五分钟核对四件事：系统与终端、网络连通性、磁盘空间，以及只在 npm 安装时才需要的 Node 与 npm 版本，附一份可复制执行的检查清单，把安装中途的报错挡在门外。"
updated: 2026-11-13
canonical: https://docai.cc/learn/system-requirements-setup/
markdown_mirror: https://docai.cc/learn/system-requirements-setup.md
---
## 装之前，先看四样东西

安装报错很少是安装本身的问题。多数时候是环境欠了账：Node 太旧（走 npm 时）、网络半通不通、终端少几个命令。装到一半才撞上，排查成本高得多。

先花几分钟核对四样：系统、网络、磁盘，以及 Node 与 npm。最后一项只对 npm 安装有意义：官方推荐的原生安装脚本自带运行环境，不需要 Node。Git 不在硬性要求里，但日常开发绕不开，顺手装上。

## 系统与终端：Windows 先选运行环境

当前官方文档列出的下限是 macOS 13、Ubuntu 20.04、Debian 10，Windows 则是 10（1809 以上）或 Server 2019，内存至少 4 GB。版本要求会调整，装前扫一眼官方文档最稳。

Windows 有两条路。原生 PowerShell 已经能直接安装和运行；如果项目依赖 Linux 工具链，或者想要沙箱隔离，就在 WSL 2 里装，行为与 Linux 一致。Claude Code 在原生 Windows 上，装了 Git for Windows 时会走 Git Bash，否则走 PowerShell，个别 Unix 命令和管道的表现会有差异。

终端选顺手的即可：macOS 用系统终端或 iTerm2，Linux 用自带终端，Windows 用 Windows Terminal，需要 WSL 时切到 Ubuntu 标签页。Shell 方面，bash 与 zsh 在 Unix 环境里最通用，遇到怪问题先换回它们试试。

判断环境顺不顺手，有个简单测试：管道、重定向、文件权限这些操作能不能照常使用。Claude Code 在执行命令时会频繁依赖这些能力，环境越接近标准 Unix，越少出现「本机可以、工具里不行」的怪事。

## Node 与 npm：只有 npm 安装才需要

原生安装脚本不依赖 Node；选择 npm 安装时，npm 包当前要求 Node.js 22 及以上。先看现状：

```bash
node --version   # npm 安装需 22 及以上
npm --version    # 随 Node 一起装
```

版本不够或没装，用官网安装包可以，用版本管理器更省心：

```bash
# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash
# 重开终端后
nvm install --lts
nvm use --lts
```

好处是随时切换版本、不污染全局，升级和回退都不折腾。装完新版本，一定用 `node --version` 再确认一次，别只看安装日志说成功。

npm 随 Node 一起装，通常够用；确实偏低时再单独升级：

```bash
npm install -g npm@latest
```

不想用版本管理器，至少要知道当前 Node 从哪来、全局目录在哪。以后装包、切项目，排查问题都靠这两条线索。

如果后面要用 npm 全局安装，先想清楚全局目录在哪。Linux 和 macOS 上用系统 Node 时，常常需要加 `sudo` 才能写入，而加 `sudo` 又会引出权限混乱。用 nvm 管的 Node 没有这个问题。

## 网络：先测通，再谈安装

安装包和后续请求都要连厂商的接口。先确认链路：

```bash
curl -I https://api.anthropic.com
```

看到 200 就算通；看到 401 也算通，那只是说明请求到了、但没有携带凭据。超时或域名解析失败，才是真的没通。

网络不稳的后果不只是装不上：后续对话会频繁中断、流式输出卡住，很难判断是工具问题还是线路问题。国内网络环境下的处理方式，见[国内访问与配置指南](/learn/claude-code-access-in-china/)。

如果公司网络要走代理，先确认终端继承了代理设置。浏览器能打开，不代表命令行也能连，这两个环境的配置经常是分开的。

## 磁盘与目录习惯

程序本体不大，但运行时会攒缓存、会话记录和日志，占用会随使用增长。给磁盘留出宽裕的余量比较稳妥，长期使用尤其如此。缓存会随使用增长，隔段时间清理一次，既能避免磁盘告警，也能排除缓存损坏带来的异常。

项目目录也值得提前想一下：放在用户目录下的普通路径最省事，路径里少带空格和奇怪符号，能避开一类只在特定脚本里才暴露的转义问题。

## 一张可以照着跑的清单

把上面几项合成一段，逐条看输出：

```bash
node --version                      # 仅 npm 安装：22 及以上
npm --version                       # 仅 npm 安装：随 Node 一起装
git --version                       # 建议 2.x 以上
curl -I https://api.anthropic.com   # 200 或 401 都算连通
```

四项全过，再进入安装步骤。缺哪项补哪项，别带着疑问往下走——安装阶段混合了两个问题，排查时会互相干扰。

还有一件不在命令里的事：准备可用的账号或凭据。装完要登录或配置密钥，没有这一步，环境再干净也走不到对话。怎么申请、放在哪里，见[账户与 API Key 配置](/learn/account-and-api-key-setup/)。

环境就绪后，可以从编辑器里开始：[VS Code 插件安装与配置](/learn/vs-code-extension-setup/)；习惯命令行的，直接看[命令行工具安装指南](/learn/cli-tool-installation-guide/)。