Claude 命令行工具安装完整指南

Claude Code 通过 npm 发布，安装非常简单。这篇文章覆盖三个平台的完整安装步骤，以及最常见的报错解决方法。

安装前确认

确保已满足以下条件（详见”系统要求”一节）：

node --version   # >= 18
npm --version    # >= 8

一键安装

npm install -g @anthropic-ai/claude-code

安装过程会下载 Claude Code 及其依赖，通常需要 1-2 分钟，视网络速度而定。

安装完成后验证：

claude --version
# 输出类似：claude-code/1.x.x

看到版本号，说明安装成功。

---

macOS 安装详细步骤

步骤一：安装 Node.js（已有可跳过）

推荐用 Homebrew 安装 nvm，再用 nvm 管理 Node.js：

# 安装 Homebrew（如果还没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 nvm
brew install nvm

# 把以下内容加入 ~/.zshrc
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"' >> ~/.zshrc

# 重新加载配置
source ~/.zshrc

# 安装最新 LTS 版本的 Node.js
nvm install --lts
nvm use --lts

步骤二：安装 Claude Code

npm install -g @anthropic-ai/claude-code

步骤三：验证

claude --version
claude --help

---

Linux（Ubuntu / Debian）安装详细步骤

步骤一：安装 Node.js

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

# 重新加载 bash 配置
source ~/.bashrc

# 安装 LTS 版本
nvm install --lts
nvm use --lts
nvm alias default node

# 验证
node --version

步骤二：安装 Claude Code

npm install -g @anthropic-ai/claude-code

步骤三：验证

claude --version

CentOS / RHEL 用户： 步骤相同，但使用 source ~/.bash_profile 替代 source ~/.bashrc。

---

Windows 安装详细步骤

Windows 强烈推荐通过 WSL 2 安装，体验和 Linux 一致。

方案一：WSL 2（推荐）

安装 WSL 2：

# 在管理员 PowerShell 里运行
wsl --install

# 重启电脑后，WSL 会自动安装 Ubuntu

进入 WSL 后，按 Linux 步骤安装：

# 在 WSL 终端里
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install --lts
npm install -g @anthropic-ai/claude-code

推荐搭配 Windows Terminal，在下拉菜单里选择 Ubuntu 标签页使用 WSL。

方案二：原生 Windows（不推荐）

如果不想用 WSL，可以在 PowerShell 里直接安装，但部分功能（如管道命令）可能受限：

1. 从 nodejs.org 下载安装 Node.js LTS 版本
2. 在 PowerShell 里运行：

npm install -g @anthropic-ai/claude-code

---

常见安装报错解决

报错：EACCES: permission denied

在 macOS/Linux 上，全局安装 npm 包权限不足：

# 方法一：修改 npm 全局目录（推荐）
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

# 重新安装
npm install -g @anthropic-ai/claude-code

# 方法二：使用 nvm（从根本上解决权限问题）
# nvm 安装的 Node.js 默认有全局安装权限，无需 sudo

不要用 sudo npm install -g，这会产生更复杂的权限问题。

报错：command not found: claude

安装成功但找不到命令，说明 npm 全局 bin 目录不在 PATH 里：

# 查看 npm 全局目录
npm config get prefix
# 输出类似 /Users/yourname/.npm-global

# 把对应的 bin 目录加入 PATH
echo 'export PATH="/Users/yourname/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

报错：网络超时 / ETIMEOUT

国内网络访问 npm 仓库较慢，可以切换到国内镜像：

# 临时使用淘宝镜像安装
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 或者永久切换（之后所有 npm install 都走国内镜像）
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

报错：Node.js 版本过低

# 用 nvm 切换到更高版本
nvm install 20
nvm use 20

# 重新安装
npm install -g @anthropic-ai/claude-code

---

更新 Claude Code

Claude Code 持续更新，建议定期更新到最新版本：

# 方法一：在 Claude Code 内部更新（推荐）
claude update

# 方法二：用 npm 重新安装
npm install -g @anthropic-ai/claude-code@latest

卸载 Claude Code

npm uninstall -g @anthropic-ai/claude-code

---

安装完成后，下一步是配置 Anthropic 账户和 API Key，才能真正开始使用 Claude Code。