Windows 安装 Claude Code 指南

Claude Code 当前最新版本：v2.1.76

---

第一步：安装 Node.js

从 nodejs.org 下载 LTS 版本安装，安装时勾选 "Add to PATH"。

安装完成后打开终端验证：

node --version
npm --version

---

第二步：安装 Claude Code

以管理员身份打开终端，执行：

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

安装最新版也可以直接：

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

验证安装：

claude --version

如提示命令找不到，运行 npm config get prefix 查看全局路径，将其加入系统 PATH

例如：C:\Users\<用户名>\AppData\Roaming\npm

---

第三步：首次启动（生成配置文件）

进入任意项目目录，运行一次 Claude Code，让它自动生成配置文件：

cd C:\你的项目路径
claude

启动后按 Ctrl+C 退出，此时 C:\Users\<用户名>\.claude.json 已自动生成。

---

第四步：配置第三方中转 API Key

编辑文件 C:\Users\<你的用户名>\.claude.json，在文件中加入 env 字段：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-你的中转API Key",
    "ANTHROPIC_BASE_URL": "https://你的中转服务地址"
  }
}

注意：

• ANTHROPIC_BASE_URL 只填域名，不加 /v1
• 如果文件已有其他字段，只需插入 env 部分，不要删除其他内容
• 不要用系统环境变量方式配置，在 Windows 上不生效

---

第五步：重新启动使用

claude

首次运行会询问是否信任该 API Key，选择同意即可正常使用。

---

常见问题

问题	解决方法
claude 命令找不到	重启终端，或将 npm 全局路径加入系统 PATH
401 认证错误	检查 Key 是否正确，ANTHROPIC_BASE_URL 不要加 /v1
.claude.json 不存在	先运行一次 claude，文件会自动创建后再编辑
JSON 格式错误	用 VS Code 打开检查格式，注意逗号和括号
npm 安装失败	以管理员身份运行终端后重试

---

升级到最新版

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