Claude Code 安装教程（npm 方式）

Claude Code 是一个在终端中运行的 AI 编程工具。本教程介绍如何通过 Node.js 自带的 npm 安装 Claude Code，并提供可选的国内 npm 镜像配置方法。

本页只介绍 Claude Code 的安装、验证、更新和卸载。模型与 API 接入配置请查看项目中的“Claude 模型食用教程”。

一、安装前准备

通过 npm 安装 Claude Code，需要满足以下条件：

Node.js 22 或更高版本，建议安装当前 LTS 版本。Claude Code npm 包从 v2.1.198 起要求 Node.js 22+。

npm。安装 Node.js 时通常会同时安装 npm。

至少 4 GB 内存。

Windows 10 或更高版本。

Git for Windows 在 Windows 原生环境中是可选项：安装后可使用 Bash 工具；未安装时 Claude Code 会使用 PowerShell 工具。也可以选择在 WSL 中运行。

二、安装 Node.js 和 npm

1. 打开 Node.js 官方下载页面

Node.js 官网：

https://nodejs.org/en/download

npm 官方安装说明：

https://docs.npmjs.com/downloading-and-installing-node-js-and-npm/

Windows 和 macOS 用户可以在 Node.js 官网下载对应系统的安装程序。一般建议选择标有 LTS 的版本，不建议为了追求最新版本而选择未经充分验证的实验版本。

Linux 用户可以使用系统包管理器、NodeSource 或 nvm 安装。需要同时使用多个 Node.js 版本时，推荐使用版本管理器，例如 nvm 或 nvm-windows。

2. 安装 Node.js

运行下载好的安装程序，按照默认选项完成安装。安装过程中请保留 npm 和“添加到 PATH”相关选项。

安装完成后关闭并重新打开终端，然后执行：

如果两条命令都能返回版本号，说明 Node.js 和 npm 已安装成功。

如果提示找不到 node 或 npm，请先重新打开终端；仍然无效时，检查 Node.js 是否已加入系统 PATH。

三、选择 npm 下载源

npm 默认使用官方公共仓库：

https://registry.npmjs.org/

可以先查看当前使用的下载源：

方案一：直接使用 npm 官方源

网络可以正常访问 npm 官方仓库时，无需修改任何配置，直接进入下一节安装 Claude Code。

如需恢复官方源：

然后确认：

输出应为：

https://registry.npmjs.org/

方案二：单次使用国内镜像（推荐）

如果 npm 官方源下载较慢，可以只让本次 Claude Code 安装使用 npmmirror：

这种方法不会永久修改 npm 配置，安装完成后，其他 npm 命令仍然使用原来的下载源。

方案三：将 npm 全局切换到国内镜像

设置 npmmirror：

检查是否生效：

预期输出：

https://registry.npmmirror.com/

然后正常安装 Claude Code：

如果镜像同步延迟、提示找不到最新版本，或安装结果异常，请恢复 npm 官方源后重试：

不要继续使用旧地址 registry.npm.taobao.org。国内镜像请使用当前的 https://registry.npmmirror.com。

四、安装 Claude Code

Claude Code 的 npm 包名是：

@anthropic-ai/claude-code

npm 包页面：

https://www.npmjs.com/package/@anthropic-ai/claude-code

使用 npm 官方源安装：

如果已经按上一节永久切换到国内镜像，安装命令保持不变。

macOS、Linux 和 WSL 用户不要在安装命令前添加 sudo：

不要使用：sudo npm install -g @anthropic-ai/claude-code

使用 sudo 进行全局安装可能造成 npm 目录权限和后续自动更新问题。如果遇到权限错误，建议使用 nvm 管理 Node.js，而不是直接使用 sudo。

五、Windows 额外准备

在 Windows 原生 PowerShell 或命令提示符中，Git for Windows 是可选项。安装后 Claude Code 可以使用 Git Bash 提供的 Bash 工具：

https://git-scm.com/download/win

如果不安装 Git for Windows，Claude Code 仍可运行，并会使用 PowerShell 工具。安装 Git 后请重新打开终端，再运行 Claude Code。

如果使用便携版 Git，或 Claude Code 没有找到 Bash，可以在 PowerShell 中指定 bash.exe 路径：

$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

如果希望长期保留该变量，可以在 Windows“编辑系统环境变量”中添加同名用户变量。路径应以你电脑中的实际安装位置为准。

另一种方式是在 WSL 中安装 Node.js 和 Claude Code，然后从 WSL 终端运行。

六、验证安装

安装完成后执行：

能返回版本号，说明 Claude Code 命令已经安装。

进一步检查安装类型和运行环境：

首次启动：

随后按照终端提示完成登录或 API 配置。

七、提示“claude 不是命令”怎么办

1. 重新打开终端

全局安装后，先关闭当前 PowerShell、命令提示符、Terminal 或 VS Code 终端，再重新打开。

2. 确认包是否安装成功

3. 查看 npm 全局目录

Windows 的 npm 全局命令通常位于：

%AppData%\npm

如果该目录没有加入 PATH，需要将其加入用户环境变量后重新打开终端。

4. 检查当前下载源

镜像源出现同步问题时，恢复官方源后重新安装：

八、更新 Claude Code

Claude Code 支持自动更新，也可以手动执行：

如果 npm 安装版本需要重新安装更新，也可以执行：

更新后检查版本：

九、卸载 Claude Code

通过 npm 安装的版本可以这样卸载：

卸载后检查：

如果命令已经不存在，说明 npm 全局版本已移除。

十、常用命令速查

官方参考资料

Claude Code 安装文档：
https://code.claude.com/docs/en/setup

Node.js 下载：
https://nodejs.org/en/download

npm 安装说明：
https://docs.npmjs.com/downloading-and-installing-node-js-and-npm/

Claude Code npm 包：
https://www.npmjs.com/package/@anthropic-ai/claude-code

Claude Code 安装教程（npm 方式）

一、安装前准备#

二、安装 Node.js 和 npm#

1. 打开 Node.js 官方下载页面#

2. 安装 Node.js#

三、选择 npm 下载源#

方案一：直接使用 npm 官方源#

方案二：单次使用国内镜像（推荐）#

方案三：将 npm 全局切换到国内镜像#

四、安装 Claude Code#

五、Windows 额外准备#

六、验证安装#

七、提示“claude 不是命令”怎么办#

1. 重新打开终端#

2. 确认包是否安装成功#

3. 查看 npm 全局目录#

4. 检查当前下载源#

八、更新 Claude Code#

九、卸载 Claude Code#

十、常用命令速查#

官方参考资料#