Claude Code 安装教程（Windows）

一、方案简介

在 Windows 系统上安装 Claude Code 需要先配置好 Git 和 Node.js 环境。通过将官方原版 npm 包的 API 地址指向 APIBox，我们可以在国内无缝直连调用 Claude，价格仅为官方的 1/7。

二、安装前准备（必须）

在开始之前，请确保你已经安装了以下环境：

1. Git for Windows
   • 访问 git-scm.com/downloads/win 下载安装，一路下一步即可。
2. Node.js LTS
   • 访问 nodejs.org 下载最新的 LTS 安装包，一路下一步即可。

三、安装步骤

1. 验证基础环境

打开 Windows PowerShell，运行以下命令确认 Git 和 Node.js 已正确安装：

node -v
npm -v
git --version

如果提示类似 “No suitable shell found”，说明 Git 没有安装好，或者路径没有加入环境变量。可以将 CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe 加入到系统的环境变量中。

2. 卸载旧版本（可选）

如果之前安装过 Claude Code，建议先卸载以防冲突：

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

3. 安装 Claude Code

通过 npm 全局安装：

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

4. 获取并配置 API 密钥

前往 APIBox 控制台 创建你的 API Key。

在 PowerShell 中，执行以下命令设置环境变量（仅当前窗口生效）：

$env:ANTHROPIC_BASE_URL="https://api.apibox.cc/v1"
$env:ANTHROPIC_AUTH_TOKEN="你的_APIBox_Key"

如果你希望永久生效，请右键**“此电脑” -> 属性 -> 高级系统设置 -> 环境变量**，在“用户变量”或“系统变量”中新建上述两个键值对。

注意：必须是 ANTHROPIC_AUTH_TOKEN，写成 API_KEY 会导致弹起默认浏览器要求网页登录。

5. 验证安装

在 PowerShell 中运行：

claude

如果能进入命令行交互界面，且没有跳出浏览器网页授权，说明配置成功！

四、常见问题排查

❌ 启动后弹出网页登录

原因： 环境变量没有生效，或者名称写错了。 解决： 确认环境变量名为 ANTHROPIC_AUTH_TOKEN。如果是在系统设置里修改的，请务必重启整个 PowerShell 窗口后再试。

❌ 报错：“No suitable shell found”

原因： Claude Code 依赖 bash 环境，而 Windows 默认没有 bash。 解决： 确保你安装了 Git for Windows，然后在系统环境变量中添加一个名为 CLAUDE_CODE_GIT_BASH_PATH，值为 C:\Program Files\Git\bin\bash.exe 的变量。

❌ 突然崩溃退出

原因： npm 缓存冲突或版本不兼容。 解决： 清理缓存并重装：

npm cache clean --force
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code