小白也能照着做：Claude Code Windows安装与API中转配置全流程（附常见报错解决）
前言
最近AI代码工具更新太快，很多朋友想试试Claude Code却卡在环境配置上——不是Node.js版本不对，就是API调用总提示连接失败，尤其国内用户还得折腾海外账户和网络。
其实不用那么复杂，我整理了一套Windows下的完整流程，从基础环境到API对接都讲得很细，跟着做基本不会踩坑。
正文
一、准备工作：安装Node.js环境
Claude Code运行依赖Node.js，最低要求v18以上（建议LTS版本，稳定性更好）。
方法一：官网下载（推荐新手）
- 访问Node.js官网，下载LTS版本安装包
- 双击安装包，按向导默认安装即可（一路"Next"，建议勾选"Add to PATH"）
方法二：包管理器安装（适合有经验用户）
如果习惯命令行，可以用Chocolatey或Scoop安装：
# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs验证安装是否成功
打开PowerShell（建议管理员模式，避免权限问题），输入以下命令：
node--version# 输出v18.x.x或更高版本npm--version# 输出对应npm版本二、安装Claude Code
环境准备好后，用npm全局安装Claude Code：
npminstall-g@anthropic-ai/claude-code安装完成后验证：
claude--version# 输出类似 @anthropic-ai/claude-code/x.x.x三、配置API连接（核心步骤）
1. 获取API Key
调用Claude需要API密钥，我这里用88api（https://api.88api.shop）作为中转接口（国内可直连，省去海外账户和网络配置麻烦）。推荐大家试试，或者大家也可以用自己的。
下面以88API 为例：
获取Key的步骤：
注册并登录后，点击侧边栏“API令牌”。
点击“添加令牌”
选择分组
- 根据需要调用的模型选择分组
a. claude 模型建议使用 calude code 分组、
b. gpt 模型建议使用 codex分组 - 可通过平台的模型广场查看不同模型支持的分组
- 若在使用中出现上游分组饱和，请切换分组使用
- 根据需要调用的模型选择分组
点击提交
5. 点击复制按钮复制API令牌，也就是API KEY
2. 配置方式（二选一，推荐配置文件）
方法一：配置文件（永久生效，推荐）
在用户目录下创建配置文件，路径固定为：C:\Users\<你的用户名>\.claude\settings.json
文件内容如下（替换"你的API密钥"为实际复制的Key）：
{"env":{"ANTHROPIC_AUTH_TOKEN":"你的API密钥","ANTHROPIC_BASE_URL":"https://api.88api.shop"}}创建步骤：
- 打开文件资源管理器，进入
C:\Users\<你的用户名>目录 - 新建文件夹
.claude（注意前面有小数点） - 在
.claude文件夹内新建settings.json，粘贴上述内容并保存
方法二：环境变量（临时或永久）
如果不想用配置文件，可通过环境变量设置（PowerShell中操作）：
临时设置（当前会话有效）：
$env:ANTHROPIC_BASE_URL ="https://api.88api.shop"$env:ANTHROPIC_AUTH_TOKEN ="你的API密钥"永久设置（用户级，重启终端生效）：
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.88api.shop",[System.EnvironmentVariableTarget]::User)[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","你的API密钥",[System.EnvironmentVariableTarget]::User)验证环境变量是否配置成功：
$env:ANTHROPIC_BASE_URL# 输出 https://api.88api.shop$env:ANTHROPIC_AUTH_TOKEN# 输出你的API密钥⚠️ 注意：配置后需重启终端（或IDE，如VS Code需完全重启）才能生效。
3. VSCode插件配置（可选）
如果用VSCode的Claude插件，需额外创建config.json：
路径：C:\Users\<你的用户名>\.claude\config.json
内容：
{"primaryApiKey":"any"}四、启动并使用Claude Code
配置完成后，在PowerShell中输入：
claude即可启动。如需查看命令帮助，输入：
claude--help五、常见问题排查
问题：启动后提示"Unable to connect to Anthropic services"
原因：首次启动引导未完成。
解决：在用户根目录创建.claude.json文件（注意是根目录，不是.claude文件夹内）：
路径：C:\Users\<你的用户名>\.claude.json
内容：
{"hasCompletedOnboarding":true}保存后重启Claude Code即可。
额外排查：
- 检查网络连接是否正常
- 确认API Key和Base URL配置正确
- 重启终端或IDE后重试
总结
本文从Node.js环境搭建到API配置，一步步带你在Windows上跑通Claude Code，重点解决了国内环境下的连接问题。核心是配置文件或环境变量的正确设置，遇到连接报错记得检查.claude.json文件。如果还有其他问题，欢迎在评论区交流，我会尽量回复。