Claude Code Windows 安装

在纯 Windows（不用 WSL）环境下手动部署 Claude Code，核心是两步：用 npm 全局装好包，然后把环境变量永久写到用户级别。

0. 前置：装好 Node.js

Claude Code 要求 Node.js 22 或更高版本。打开 PowerShell 验证：

node -v
npm -v

版本不够请先回到 Node.js Windows 安装。

1. 安装 Claude Code

PowerShell 里跑：

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

装完验证：

claude --version

能输出版本号就 OK。

2. 配置环境变量

2.1 为什么要配环境变量

Claude Code 运行时不会问你 Key 是多少，而是从进程的环境变量里读。Windows 上想让环境变量持久生效，必须写到用户级别的环境变量里，而不是只在当前 PowerShell 会话中设置。

2.2 设置环境变量（持久生效）

方式一：PowerShell 命令

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://aitongdao.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的密钥", "User")

User 表示写到当前用户级别，不需要管理员权限。

方式二：CMD 命令

setx ANTHROPIC_BASE_URL "https://aitongdao.com"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"

方式三：图形界面

按 Win + R，输入 sysdm.cpl，回车 → 高级 → 环境变量 → 在"用户变量"里点"新建"，分别添加上面两条。

2.3 让环境变量生效

setx 和 [Environment]::SetEnvironmentVariable 都是只对新开的进程生效。所以：

• 完全关闭当前 PowerShell/CMD 窗口
• 重新开一个新窗口
• 跑验证命令：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

两行都能正确输出就说明写入成功。

3. 启动并验证

claude doctor
claude

claude doctor 如果全部通过，就说明网络、认证、环境变量都 OK。然后 cd 到你的项目目录跑 claude 进入交互模式即可。

常见问题

1）npm install -g 报权限错误（EACCES / EPERM）

Windows 下全局安装通常不会遇到权限问题，如果遇到，多半是 Node.js 被装到了 Program Files。建议：要么用 winget/MSI 重装（它会自动处理），要么卸掉后换 nvm-windows。

2）环境变量设置后 claude 仍然读不到

99% 是因为你没重开终端。setx 只影响新启动的进程，必须关掉所有 PowerShell/CMD/VS Code 的终端窗口重新打开。VS Code 的集成终端也要整个 VS Code 重启才会生效。

3）提示"claude: command not found"

npm 全局安装的命令通常在 %APPDATA%\npm 下，Windows 会自动把这个路径加进 PATH。如果没加上，手动到"环境变量"里把这个目录追加到 Path 即可。

4）想不想用 WSL

如果你同时要跑 Docker、bash 脚本或者其他 Linux 工具链，建议直接装 WSL2，在里面走 Linux 教程，体验会平滑很多。