步骤一：安装 Git for Windows（必装）
Claude Code 底层依赖 Bash 环境执行命令，必须安装 Git for Windows。
- 下载：访问 https://git-scm.com/download/win，下载 64-bit 安装包。
- 安装关键选项：
- Adjusting the PATH environment：务必选择
Git from the command line and also from 3rd-party software - 其他选项保持默认即可。
- Adjusting the PATH environment：务必选择
- 验证：打开 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"}
}
⚠️ 关键提醒：
- 必须将
ANTHROPIC_AUTH_TOKEN替换为你真实的 API Key。 - 必须将
ANTHROPIC_MODEL替换为你在该平台开通的真实模型名称。 - JSON 格式极其严格：必须是英文双引号
"，最后一项末尾不能有逗号,。
修改好后保存并关闭记事本。
步骤四：启动与测试
- 彻底关闭当前终端，重新打开一个新的 CMD 或 PowerShell。
- 进入你的项目代码目录：
cd C:\你的\项目\路径
- 启动 Claude Code：
claude
- 测试连通性：在交互框内输入简单指令，如
写一个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