Skip to content

Windows 安装 Claude Code ​

本文说明如何在 Windows 10 1809(build 17763)或更高版本安装官方 Claude Code CLI,并配置 OpenNave API。

安装依赖 ​

  1. 下载并安装 Git for Windows,保留默认路径。
  2. 下载并安装 Node.js,保留默认路径。
  3. 在 Windows PowerShell 验证安装:
powershell
node -v
npm -v

若提示 No suitable shell found,设置系统环境变量 CLAUDE_CODE_GIT_BASH_PATH 为 C:\Program Files\git\bin\bash.exe,重启终端后再试。

安装 Claude Code ​

若曾安装旧版,可先卸载;随后安装官方包:

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

设置环境变量 ​

在“系统属性”中的“高级系统设置”打开“环境变量”,新增以下用户变量或系统变量:

变量名变量值
ANTHROPIC_BASE_URLhttps://api.opennave.top
ANTHROPIC_API_KEY你的 API Key

关闭并重新打开 PowerShell,再验证:

powershell
claude -v
cd your-project-folder
claude

常见问题 ​

401 Invalid token ​

检查 API Key 是否正确且新终端已经读取环境变量。原生 Windows 配置仍无效时,先备份并删除 C:\Users\你的用户名\.claude.json,重新启动 Claude Code 并在初始引导中选择 yes。

Unable to connect to Anthropic services ​

确认 ANTHROPIC_BASE_URL 已设置为 https://api.opennave.top。如果仍然报错,可在 .claude.json 最外层增加:

json
{
  "hasCompletedOnboarding": true
}
查看 macOS 和 Linux 安装