前言
最近AI代码工具更新太快，很多教程刚出来就过时，尤其是Claude Code这类工具，环境配置和API对接总让新手头疼——不是Node.js版本不对，就是海外接口连不上，折腾半天还是报错。
其实核心问题就两个：一是国内环境下的API调用麻烦，二是缺乏一篇能从头到尾跑通的完整步骤。我花了一下午整理出这套Windows版本流程，从Node.js安装到API配置全细节，尤其解决了国内直连的问题，希望能帮你少踩坑。
正文
一、准备工作：安装Node.js环境
Claude Code运行依赖Node.js，最低要求Node.js ≥18（建议LTS版本，稳定性更好）。
方法一：官网下载（推荐）
- 访问Node.js官网，下载LTS版本（通常是首页大按钮的推荐版本）
- 双击安装包，按向导默认安装即可（建议勾选"Add to PATH"，自动配置环境变量）
方法二：包管理器安装（适合熟悉命令行的用户）
如果已安装Chocolatey或Scoop，可直接用命令安装：
# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs验证安装是否成功
打开PowerShell（建议管理员模式，避免权限问题），输入以下命令：
node--version# 输出v18.x.x或更高版本npm--version# 输出对应的npm版本⚠️ 提示：如果命令无效，检查是否已重启终端，或手动将Node.js安装路径（默认
C:\\Program Files\\nodejs）添加到系统环境变量PATH中。
二、安装Claude Code
Node.js环境就绪后，用npm全局安装Claude Code：
npminstall-g@anthropic-ai/claude-code安装完成后验证版本：
claude--version# 输出类似1.0.0的版本号，说明安装成功三、配置API连接（核心步骤）
1. 获取API Key
在使用各种大模型，比如Claude，gpt等，都需要API密钥，我最近使用的是88api中转站（https://api.88api.shop）作为接口方案，大家用自己的也可以。
主要是为了减少国内环境下的网络配置和账号问题，它支持国内直连，且一个Key可管理多个模型（如GPT、Gemini等），切换方便。
获取Key的步骤，这里以我使用的api为例：
- 注册以后，点击侧边栏的 API 令牌
- 点击添加令牌
- 选择分组
a. 根据需要调用的模型选择分组
a）claude 模型建议使用 calude code 分组、
b）gpt 模型建议使用 codex分组
b. 可通过平台的模型广场查看不同模型支持的分组
c. 若在使用中出现上游分组饱和，请切换分组使用 - 点击提交
- 点击复制按钮复制API令牌，也就是API KEY
2. 配置方式（二选一，推荐配置文件）
方法一：配置文件（永久生效，推荐）
在用户目录下创建配置文件，路径和内容如下：
配置文件路径（替换<你的用户名>为实际系统用户名）：
C:\\Users\\<你的用户名>\\.claude\\settings.json配置内容（替换"你的API密钥"为实际复制的Key）：
{"env":{"ANTHROPIC_AUTH_TOKEN":"你的API密钥","ANTHROPIC_BASE_URL":"<https://aicode.cat>"}}创建步骤：
- 打开文件资源管理器，进入
C:\\Users\\<你的用户名>\\目录 - 新建文件夹
.claude（如果已存在则跳过） - 在
.claude文件夹中新建settings.json文件，粘贴上述配置并保存
方法二：环境变量（临时或永久）
如果不想用配置文件，可通过环境变量设置：
PowerShell临时设置（仅当前会话有效）：
$env:ANTHROPIC_BASE_URL="<https://aicode.cat>"$env:ANTHROPIC_AUTH_TOKEN="你的API密钥"PowerShell永久设置（用户级，重启终端生效）：
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","<https://aicode.cat>",[System.EnvironmentVariableTarget]::User)[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","你的API密钥",[System.EnvironmentVariableTarget]::User)验证环境变量：
$env:ANTHROPIC_BASE_URL# 输出https://aicode.cat$env:ANTHROPIC_AUTH_TOKEN# 输出你的API密钥⚠️ 重要提示：配置完成后必须重启终端（如果在VS Code/Cursor等IDE中使用，需彻底重启IDE，仅重启终端可能不生效）。
3. VSCode插件配置（可选）
如果使用VSCode的Claude插件，需额外创建config.json：
配置文件路径：
C:\\Users\\<你的用户名>\\.claude\\config.json配置内容：
{"primaryApiKey":"any"}创建步骤：
- 进入
C:\\Users\\<你的用户名>\\.claude\\目录 - 新建
config.json文件，粘贴上述内容并保存
四、启动并使用Claude Code
配置完成后，在终端输入以下命令启动：
claude首次启动会进入交互界面，可直接输入问题或代码需求。如需查看命令帮助，输入：
claude--help五、常见问题排查
问题：启动后提示“Unable to connect to Anthropic services”
症状：启动Claude Code后显示无法连接服务。
原因：首次启动引导未完成。
解决方案：在用户根目录创建.claude.json文件跳过引导：
文件路径：
C:\\Users\\<你的用户名>\\.claude.json文件内容：
{"hasCompletedOnboarding":true}创建步骤：
- 进入
C:\\Users\\<你的用户名>\\目录 - 新建
.claude.json文件（注意是用户根目录，不是.claude文件夹内） - 粘贴上述内容保存，重启Claude Code
调试技巧：
- 检查网络连接是否正常
- 确认API Key和
ANTHROPIC_BASE_URL配置正确 - 重启终端或IDE后重试
总结
这套流程覆盖了Claude Code在Windows系统从环境准备到API对接的全步骤，核心解决了国内直连和配置繁琐的问题。关键在于Node.js版本、API配置文件路径和重启终端这三个细节，按步骤操作基本能一次跑通。
如果遇到其他报错，可先检查配置文件路径和内容是否正确，或参考常见问题部分。有问题欢迎在评论区交流，一起完善这套方案~
