Windows 与 macOS 安装 Claude Code 及配置第三方 Key 指南

⚠️ 非常关键
这一步决定后面能不能成功，必须认真看！

下载地址：
https://git-scm.com/downloads/win

安装时注意：
选择 'Use Git from the command line and also from 3rd-party software'

这个选项决定 Git Bash 会不会被系统识别。

✅ 验证是否成功：

打开 cmd（命令提示符），运行：

bash --version

期望输出：

GNU bash, version 4.4.23(1)-release

看到版本号 = 安装成功。

如果提示 'bash' 不是内部或外部命令：

• 重新安装 Git，确保选对选项
• 安装完后重启电脑

第 2 步：安装 Claude Code

在 cmd（建议用管理员模式）里执行：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

⚠️ 看到这个提示是正常的：

Native installation exists but C:\Users\xxx\.local\bin is not in your PATH

这不是错误，而是在提示你：下一步需要配置 PATH。

第 3 步：配置 PATH 环境变量

⚠️ 必须做这一步
否则系统找不到 claude 命令！

Claude 的可执行文件默认在：

C:\Users\你的用户名\.local\bin

💡 不知道用户名？ 打开 cmd 运行 echo %USERNAME%

配置步骤：

1. 右键 此电脑 → 属性
2. 点击 高级系统设置
3. 点击 环境变量
4. 在 用户变量 区域，找到 Path，双击编辑
5. 点击 新建
6. 输入：C:\Users\你的用户名\.local\bin（替换成你的实际用户名）
7. 一路点击 确定

⚠️ 配置完必须重启 cmd！

1. 关闭所有 cmd 窗口
2. 重新打开 cmd

✅ 验证是否成功：

claude --version

看到版本号 = 配置成功。

如果还是提示找不到命令：

• 检查 PATH 路径是否正确
• 重启电脑（有时 Windows 需要重启才生效）

第 4 步：配置第三方 API Key

⚠️ 重要区别
Windows 不支持 export 命令，要用 setx！

在 cmd 里执行：

setx ANTHROPIC_BASE_URL "http://你的中转地址/api"
setx ANTHROPIC_AUTH_TOKEN "你的API Key"

⚠️ 设置完必须重启 cmd！（否则不生效）

1. 关闭所有 cmd 窗口
2. 重新打开 cmd

✅ 验证是否生效：

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%

能看到你设置的值 = 配置成功。

第 5 步：测试是否能用

claude --help

如果你的中转有日志，可以查看是否有请求记录。

常见问题

1. Windows 提示 'bash' 不是内部或外部命令

原因： Git Bash 没装，或者安装时没选对选项。

解决：

1. 重新安装 Git for Windows
2. 安装时选择 'Use Git from the command line'
3. 安装完重启电脑

2. 设置了环境变量但还是不生效

原因： Windows 的环境变量需要重启终端才生效。

解决：

1. 关闭所有 cmd 窗口
2. 重新打开
3. 还是不行？重启电脑

3. 怎么确认 Claude 在用我的中转？

macOS 验证：

echo $ANTHROPIC_BASE_URL

Windows 验证：

echo %ANTHROPIC_BASE_URL%

能看到你的中转地址 = 配置成功。

如果你的中转有日志，执行 claude --help 后可以查看是否有请求记录。

4. claude --version 提示找不到命令

macOS：

• 检查是否安装成功：重新运行安装命令
• 重启终端

Windows：

• 检查 PATH 是否配置正确
• 关闭所有 cmd，重新打开
• 还是不行？重启电脑

总结

macOS 用户：

1. 一行命令安装
2. 设置环境变量（用 export）
3. 建议写进 .zshrc 永久生效

Windows 用户：

1. 必须先装 Git for Windows
2. 安装 Claude Code
3. 配置 PATH 环境变量（否则找不到命令）
4. 设置环境变量（用 setx，不是 export）
5. 每次修改环境变量都要重启 cmd

参考资料

官方文档：
https://code.claude.com/docs/zh-CN/quickstart