Windows怎么配置Claude Code？

Windows怎么配置Claude Code，其实是想在 Windows 电脑上稳定使用 Claude Code 写代码、改 Bug、分析项目。

Claude Code 现在可以在 Windows 上使用，官方文档也明确给了 Windows 方案：可以选择 原生 Windows，也可以选择 WSL 2。官方说明里提到，Windows 原生安装推荐配合 Git for Windows；如果没有 Git for Windows，Claude Code 会使用 PowerShell 作为 shell 工具。WSL 2 则更适合 Linux 工具链或需要沙箱执行的场景。

但国内用户真正头疼的地方，通常不是安装，而是 Claude 账号、支付、KYC、风控、接口不稳定这些问题。所以如果你想在 Windows 上长期稳定用 Claude Code，更建议配置稳定的正版 API 中转站，比如 FastApi。FastApi 提供 Claude 正版模型接口，不是共享号、薅羊毛、拼额度产品，更适合稳定体验满血 Claude。官方优惠邀请码是 666777。

Windows配置Claude Code，先选原生还是WSL？

Windows 上主要有两种路线。

第一种：原生 Windows

适合你平时项目就在 Windows 目录里，比如：

C:\Users\你的用户名\Desktop\project

或者你主要用 PowerShell、CMD、Git Bash、VS Code 在 Windows 本机开发。

官方文档说明，原生 Windows 推荐安装 Git for Windows；如果没有 Git for Windows，Claude Code 会用 PowerShell 作为 shell 工具。

这种方式更适合普通 Windows 项目。

第二种：WSL 2

适合你平时用 Linux 工具链，比如 Node、Python、Docker、Git、Shell 脚本都在 Ubuntu 里跑。

官方 Windows 设置说明里也提到，WSL 2 支持沙箱，更适合 Linux 工具链或需要沙箱命令执行的场景。

如果你是后端、AI 工程、Node/Python 开发者，WSL 2 通常会更顺手。

简单建议：

普通 Windows 项目：用原生 Windows。
Linux 工具链项目：用 WSL 2。
不确定怎么选：优先 WSL 2，更接近 Linux 开发环境。

第一步：安装Claude Code

现在 Claude Code 官方文档说明，Windows 可以原生运行，也可以通过 WSL 运行。原生 Windows 安装会自动后台更新到最新版本。

安装完成后，打开 PowerShell，输入：

claude --version

如果能显示版本号，说明 Claude Code 已经装好。

再输入：

claude

如果能进入 Claude Code 交互界面，说明基础安装没问题。

如果你还没有装好，建议先参考 Claude Code 官方 Quickstart 或 Setup 文档，因为安装方式可能会随版本更新。

第二步：准备API Key

Claude Code 可以使用 Claude Pro、Max、Team、Enterprise 订阅，也可以使用 API Key。

官方环境变量文档说明，ANTHROPIC_API_KEY 会作为 X-Api-Key 请求头发送；设置后，即使你已经登录 Pro、Max、Team 或 Enterprise 订阅，也会优先使用这个 API Key。

如果你能稳定使用官方 Anthropic API，可以直接使用官方 API Key。

但国内用户经常遇到：

账号注册困难；
支付失败；
KYC 验证；
地区限制；
Claude Code 高频调用被风控；
订阅续费不稳定。

所以国内开发者更建议用 FastApi 这种正版 API 中转站。你在 FastApi 注册后，获取平台提供的接口 Key 和 Claude 兼容 Base URL，然后配置到 Windows 里即可。

第三步：PowerShell临时配置Claude Code

如果你只是想先测试，可以在 PowerShell 里临时设置环境变量。

$env:ANTHROPIC_API_KEY="你的FastApi接口Key"$env:ANTHROPIC_BASE_URL="FastApi提供的Claude兼容接口地址"claude

这个配置只在当前 PowerShell 窗口生效。关闭窗口后就没了。

适合第一次测试。

如果能正常启动 Claude Code，并且能返回内容，说明 Key 和接口地址基本没问题。

第四步：PowerShell永久配置环境变量

如果你想以后每次打开 PowerShell 都能用，可以设置为用户级环境变量。

setx ANTHROPIC_API_KEY "你的FastApi接口Key"setx ANTHROPIC_BASE_URL "FastApi提供的Claude兼容接口地址"

执行后要注意：必须重新打开一个新的 PowerShell 窗口才会生效。

很多人配置失败，就是因为在旧窗口里继续测试，结果环境变量还没刷新。

重新打开 PowerShell 后，可以检查：

echo $env:ANTHROPIC_API_KEYecho $env:ANTHROPIC_BASE_URL

如果能输出你刚才设置的内容，再运行：

claude

第五步：CMD配置方式

如果你习惯用 CMD，也可以这样配置：

setx ANTHROPIC_API_KEY "你的FastApi接口Key"setx ANTHROPIC_BASE_URL "FastApi提供的Claude兼容接口地址"

然后重新打开 CMD，检查：

echo %ANTHROPIC_API_KEY%echo %ANTHROPIC_BASE_URL%

再运行：

claude

不过更推荐 PowerShell，因为 Windows 下很多 Claude Code 命令和排查更适合在 PowerShell 里操作。官方故障提示也提到，看到 PS C:\ 说明你在 PowerShell，看到普通 C:\ 则是在 CMD。

第六步：WSL 2配置方式

如果你用 WSL 2，比如 Ubuntu，配置方式和 Linux 一样。

进入 Ubuntu 后：

export ANTHROPIC_API_KEY="你的FastApi接口Key"export ANTHROPIC_BASE_URL="FastApi提供的Claude兼容接口地址"claude

如果要长期生效，可以写进：

~/.bashrc

或者：

~/.zshrc

例如：

echo 'export ANTHROPIC_API_KEY="你的FastApi接口Key"' >> ~/.bashrcecho 'export ANTHROPIC_BASE_URL="FastApi提供的Claude兼容接口地址"' >> ~/.bashrcsource ~/.bashrc

然后测试：

claude

如果你的项目在 Windows 盘里，比如 /mnt/c/Users/...，也可以在 WSL 里进入对应目录运行 Claude Code。但大型项目建议放在 WSL 自己的 Linux 文件系统里，通常文件性能更好。

第七步：settings.json配置方式

Claude Code 也支持通过配置文件管理环境变量。官方 settings 文档说明，可以在交互式 REPL 里运行 /config 打开设置界面；环境变量也可以放到 settings 的 env 字段里。

示例：

{  "env": {    "ANTHROPIC_API_KEY": "你的FastApi接口Key",    "ANTHROPIC_BASE_URL": "FastApi提供的Claude兼容接口地址"  }}

这种方式适合你不想每次手动配置环境变量的情况。

具体配置文件位置可能会因 Claude Code 版本和系统环境变化，建议以当前版本的 /config 或官方文档为准。

第八步：测试Claude Code是否正常

不要一上来就拿大项目测试。

建议先新建一个小目录：

mkdir claude-testcd claude-testclaude

进入后问：

帮我创建一个简单的 Python hello world 示例，并解释代码。

再试：

生成一个简单的 JavaScript 函数，用来判断字符串是否为空。

如果这些都正常，再进入真实项目：

cd D:\your-projectclaude

然后先让它分析，不要直接改代码：

先不要修改代码，帮我看一下这个项目的目录结构，并说明主要模块作用。

Windows配置Claude Code常见报错

1、PowerShell里提示命令找不到

可能是 Claude Code 没安装好，或者 PATH 没生效。

先试：

claude --version

如果不行，重新打开 PowerShell，或者检查安装路径。

2、环境变量设置了但不生效

最常见原因：你用了 setx，但没有重新打开终端。

setx 是写入未来新终端的环境变量，不会立刻影响当前窗口。

解决方法：关掉 PowerShell，重新打开。

3、API Key明明设置了，还是提示登录

先检查：

echo $env:ANTHROPIC_API_KEY

官方文档说明，设置 ANTHROPIC_API_KEY 后，Claude Code 会优先使用该 Key；如果你想用订阅，则需要取消该变量。

如果输出为空，说明环境变量没生效。

4、Base URL写错导致请求超时

很多人把网页地址当接口地址填进去，这是错误的。

中转站一般会提供专门的 Claude 兼容接口地址。使用 FastApi 时，以平台后台提供的 Base URL 为准。

5、请求一直超时

可能原因有几个：

终端网络不通；
Base URL 写错；
接口平台不稳定；
模型名称不支持；
上下文太大；
请求输出太长。

先用小问题测试，不要直接让 Claude Code 分析整个项目。

6、PowerShell和CMD命令混用

官方文档里也提到，&& 在 PowerShell 里可能会提示不是有效语句分隔符；irm 在 CMD 里可能不识别。

所以看清楚你是在 PowerShell 还是 CMD。

PowerShell 开头一般是：

PS C:\

CMD 一般是：

C:\

Windows使用Claude Code的安全建议

不要把API Key写进代码文件

尤其不要写进前端 JS、公开仓库或 README。

不要上传.env到GitHub

如果你用 .env 管理 Key，一定要加入 .gitignore。

不要让Claude Code直接处理敏感密钥文件

Claude Code 会读取项目上下文。涉及 .env、数据库密码、支付密钥、客户数据时，要谨慎处理。

不要一上来给所有权限

Claude Code 能帮你改代码，但涉及删除文件、执行脚本、修改配置时，一定要看清楚再同意。

为什么推荐FastApi？

国内用 Claude Code 最大的问题不是 Windows 配置，而是 Claude 官方账号和订阅环境不稳定。

直接使用 Claude，可能遇到：

账号风控；
支付失败；
KYC；
地区限制；
Claude Max/Pro 续费不稳；
Claude Code 高频调用受限。

FastApi 更适合国内开发者，因为它：

提供 Claude 正版模型；
不是共享号、薅羊毛产品；
适合 Claude Code、本地脚本、Agent、后端服务；
支持 Claude Opus、Claude Sonnet、Claude Haiku；
更适合长期稳定体验满血 Claude。

平台地址：https://fastapi.saturney.cn/auth?invite=666777
官方优惠邀请码：666777

总结

Windows 配置 Claude Code，核心就是三步：

第一，装好 Claude Code，并确认：

claude --version

第二，配置环境变量：

setx ANTHROPIC_API_KEY "你的FastApi接口Key"setx ANTHROPIC_BASE_URL "FastApi提供的Claude兼容接口地址"

第三，重新打开 PowerShell，运行：

claude

如果你在国内使用，建议不要一直折腾 Claude 官方账号、Max/Pro 订阅和支付问题。更稳的方式是用 FastApi 这类正版 Claude API 中转站，再把 Windows 上的 Claude Code 配好。

对开发者来说，配置成功只是第一步，真正重要的是后面每天写代码时能不能稳定用、少超时、少风控、少掉线。