Windows安装Claude Code教程

步骤一：安装 Git for Windows（必装）

Claude Code 底层依赖 Bash 环境执行命令，必须安装 Git for Windows。

1. 下载：访问 https://git-scm.com/download/win，下载 64-bit 安装包。
2. 安装关键选项：
   • Adjusting the PATH environment：务必选择 Git from the command line and also from 3rd-party software
   • 其他选项保持默认即可。
3. 验证：打开 CMD，输入 git --version，正常输出版本号即成功。

步骤二：安装 Claude Code CLI

由于国内 IP 直接访问官方安装脚本会触发区域限制，推荐使用以下两种方式之一：

方式 A：通过 WinGet 安装

winget install Anthropic.ClaudeCode

方式 B：通过 NPM 安装（需提前安装 Node.js 18+） （nodejs下载地址：https://nodejs.org/en/download/）

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

验证安装：

*关闭并重新打开终端*，输入：

claude --version

看到类似 2.x.x (Claude Code) 输出即代表成功。

步骤三：配置第三方兼容 API（国内用户必看）

国内直连官方 API 会被拦截，需通过第三方兼容平台（如智谱、LongCat、阿里云等）接入。

1. 创建/打开配置文件

在 CMD 中执行以下命令，确保目录存在并用记事本打开配置：

mkdir "%USERPROFILE%\.claude" 2>nul
notepad "%USERPROFILE%\.claude\settings.json"

2. 写入配置模板

在记事本中清空原有内容，根据你使用的平台，选择以下一个模板复制进去：

📘 模板 A：智谱（BigModel）

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "这里替换成你的智谱API Key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_MODEL": "glm-4-flash"
  }
}

📙 模板 B：LongCat 或 其他兼容平台

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "这里替换成你的第三方API Key",
    "ANTHROPIC_BASE_URL": "https://api.longcat.chat/anthropic",
    "ANTHROPIC_MODEL": "claude-3-5-sonnet-20241022"
  }
}

⚠️ 关键提醒：

1. 必须将 ANTHROPIC_AUTH_TOKEN 替换为你真实的 API Key。
2. 必须将 ANTHROPIC_MODEL 替换为你在该平台开通的真实模型名称。
3. JSON 格式极其严格：必须是英文双引号 "，最后一项末尾不能有逗号 ,。

修改好后保存并关闭记事本。

步骤四：启动与测试

1. 彻底关闭当前终端，重新打开一个新的 CMD 或 PowerShell。
2. 进入你的项目代码目录：

cd C:\你的\项目\路径

1. 启动 Claude Code：

claude

1. 测试连通性：在交互框内输入简单指令，如 写一个Python冒泡排序，如果正常返回结果，则安装配置完毕！

🛠️ 常见问题排查 (FAQ)

1. 运行 irm ... | iex 或 curl ... install.cmd 报错 HTML 标签？

原因：国内 IP 被官方区域限制拦截，下载到了错误页面。

解决：改用步骤二中的 winget 或 npm 方式安装。

2. 启动 claude 报错 401 / Unable to connect？

原因：API 密钥或地址配置错误。

解决：

• 检查 settings.json 中的 ANTHROPIC_AUTH_TOKEN 是否填写正确且无多余空格。
• 检查 ANTHROPIC_BASE_URL 是否与你的第三方平台一致（注意末尾是否需要加 /anthropic）。

3. 提示 'claude' 不是内部或外部命令？

原因：CLI 未加入系统 PATH 或终端未刷新。

解决：

• 确认安装成功（通过 winget 或 npm）。
• 务必彻底关闭终端重开，或重启电脑刷新环境变量。

4. CMD 和 PowerShell 命令混淆？

在 CMD 中查看环境变量：echo %ANTHROPIC_API_KEY%

在 PowerShell 中查看环境变量：echo $env:ANTHROPIC_API_KEY