Claude 安装前准备：系统要求与环境配置

在安装 Claude Code 之前，先确认你的系统是否满足运行条件。这一步花 5 分钟检查，能避免安装中途出现奇怪的报错。

支持的操作系统

Claude Code 支持以下操作系统：

系统	支持情况	说明
macOS 12+	✅ 完整支持	推荐，官方主要测试环境
Linux（Ubuntu/Debian/CentOS）	✅ 完整支持	服务器部署的首选
Windows 11（WSL 2）	✅ 支持	需要通过 WSL 2 运行
Windows 原生 PowerShell	⚠️ 有限支持	部分功能可能受限

Windows 用户注意：强烈建议通过 WSL 2（Windows Subsystem for Linux）运行 Claude Code，体验和 Linux/macOS 一致。直接在 PowerShell 里使用会缺少一些 Unix 命令支持。

Node.js 版本要求

Claude Code 要求 Node.js 18 或更高版本。

检查你当前的 Node.js 版本：

node --version
# 应该输出 v18.x.x 或更高

如果版本过低或未安装，推荐用 nvm（Node Version Manager）管理 Node.js：

# macOS / Linux 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 安装完成后，重启终端，然后安装最新 LTS 版本
nvm install --lts
nvm use --lts

# 验证
node --version  # v22.x.x 或类似
npm --version   # 10.x.x 或类似

为什么推荐 nvm？ 你可以随时切换 Node.js 版本，不会影响系统全局环境，也方便以后升级。

npm 版本

Claude Code 通过 npm 安装，需要 npm 8 或更高版本：

npm --version
# 应该输出 8.x.x 或更高

npm 跟着 Node.js 一起安装，版本通常满足要求。如果版本太低：

npm install -g npm@latest

Git（推荐安装）

Claude Code 本身不强制要求 Git，但绝大多数开发场景都需要用到 Git，建议提前安装：

git --version
# 推荐 2.x.x 或更高

macOS 安装：

xcode-select --install
# 或者用 Homebrew
brew install git

Ubuntu / Debian 安装：

sudo apt-get install git

终端环境

Claude Code 是命令行工具，终端环境会影响使用体验：

推荐的终端：

• macOS：iTerm2 或系统自带的 Terminal.app
• Linux：默认终端或 Gnome Terminal
• Windows：Windows Terminal + WSL 2

Shell 推荐：

• bash（默认）
• zsh（macOS 默认，推荐）
• fish（需要额外配置）

Claude Code 在 bash 和 zsh 下测试最充分，建议使用其中之一。

网络要求

Claude Code 需要连接 Anthropic 的 API 服务器（api.anthropic.com），需要确保：

• 网络可以正常访问 api.anthropic.com（国内用户见”国内使用指南”）
• 建议有稳定的网络连接，不稳定的网络会导致请求超时

测试是否能访问：

curl -I https://api.anthropic.com
# 应该返回 200 或 401（连通就说明网络没问题）

磁盘空间

Claude Code 本身很小（几十 MB），但运行时会产生缓存：

• Claude Code 安装包：~50 MB
• 运行缓存：视使用情况而定
• 建议至少留有 500 MB 可用空间

环境检查清单

安装前按清单确认：

# ✅ Node.js >= 18
node --version

# ✅ npm >= 8
npm --version

# ✅ 推荐安装 git
git --version

# ✅ 网络连通性
curl -I https://api.anthropic.com

全部通过后，可以开始安装 Claude Code 了。接下来有两种安装方式：VS Code 插件安装和命令行工具安装，根据你的使用习惯选择。