前言

最近AI代码工具更新太快，很多教程刚出来就过时，尤其是Claude Code这类工具，环境配置和API对接总让新手头疼——不是Node.js版本不对，就是海外接口连不上，折腾半天还是报错。

其实核心问题就两个：一是国内环境下的API调用麻烦，二是缺乏一篇能从头到尾跑通的完整步骤。我花了一下午整理出这套Windows版本流程，从Node.js安装到API配置全细节，尤其解决了国内直连的问题，希望能帮你少踩坑。

正文

一、准备工作：安装Node.js环境

Claude Code运行依赖Node.js，最低要求Node.js ≥18（建议LTS版本，稳定性更好）。

方法一：官网下载（推荐）

1. 访问Node.js官网，下载LTS版本（通常是首页大按钮的推荐版本）
2. 双击安装包，按向导默认安装即可（建议勾选"Add to PATH"，自动配置环境变量）

方法二：包管理器安装（适合熟悉命令行的用户）

如果已安装Chocolatey或Scoop，可直接用命令安装：

# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs

验证安装是否成功

打开PowerShell（建议管理员模式，避免权限问题），输入以下命令：

node --version  # 输出v18.x.x或更高版本
npm --version   # 输出对应的npm版本

⚠️ 提示：如果命令无效，检查是否已重启终端，或手动将Node.js安装路径（默认C:\\Program Files\\nodejs）添加到系统环境变量PATH中。

二、安装Claude Code

Node.js环境就绪后，用npm全局安装Claude Code：

npm install -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为例：

1. 注册以后，点击侧边栏的 API 令牌
   
2. 点击添加令牌
   
3. 选择分组
   a. 根据需要调用的模型选择分组
   a）claude 模型建议使用 calude code 分组、
   b）gpt 模型建议使用 codex分组
   b. 可通过平台的模型广场查看不同模型支持的分组
   c. 若在使用中出现上游分组饱和，请切换分组使用
   
4. 点击提交
   
5. 点击复制按钮复制API令牌，也就是API KEY
   

2. 配置方式（二选一，推荐配置文件）

方法一：配置文件（永久生效，推荐）

在用户目录下创建配置文件，路径和内容如下：

配置文件路径（替换<你的用户名>为实际系统用户名）：

C:\\Users\\<你的用户名>\\.claude\\settings.json

配置内容（替换"你的API密钥"为实际复制的Key）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "<https://api.88api.shop>"
  }
}

创建步骤：

1. 打开文件资源管理器，进入C:\\Users\\<你的用户名>\\目录
2. 新建文件夹.claude（如果已存在则跳过）
3. 在.claude文件夹中新建settings.json文件，粘贴上述配置并保存

方法二：环境变量（临时或永久）

如果不想用配置文件，可通过环境变量设置：

PowerShell临时设置（仅当前会话有效）：

$env:ANTHROPIC_BASE_URL = "<https://api.88api.shop>"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"

PowerShell永久设置（用户级，重启终端生效）：

[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密钥

⚠️ 重要提示：配置完成后必须重启终端（如果在VS Code/Cursor等IDE中使用，需彻底重启IDE，仅重启终端可能不生效）。

3. VSCode插件配置（可选）

如果使用VSCode的Claude插件，需额外创建config.json：

配置文件路径：

C:\\Users\\<你的用户名>\\.claude\\config.json

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

1. 进入C:\\Users\\<你的用户名>\\.claude\\目录
2. 新建config.json文件，粘贴上述内容并保存

四、启动并使用Claude Code

配置完成后，在终端输入以下命令启动：

claude

首次启动会进入交互界面，可直接输入问题或代码需求。如需查看命令帮助，输入：

claude --help

五、常见问题排查

问题：启动后提示“Unable to connect to Anthropic services”

症状：启动Claude Code后显示无法连接服务。

原因：首次启动引导未完成。

解决方案：在用户根目录创建.claude.json文件跳过引导：

文件路径：

C:\\Users\\<你的用户名>\\.claude.json

文件内容：

{
  "hasCompletedOnboarding": true
}

创建步骤：

1. 进入C:\\Users\\<你的用户名>\\目录
2. 新建.claude.json文件（注意是用户根目录，不是.claude文件夹内）
3. 粘贴上述内容保存，重启Claude Code

调试技巧：

• 检查网络连接是否正常
• 确认API Key和ANTHROPIC_BASE_URL配置正确
• 重启终端或IDE后重试

总结

这套流程覆盖了Claude Code在Windows系统从环境准备到API对接的全步骤，核心解决了国内直连和配置繁琐的问题。关键在于Node.js版本、API配置文件路径和重启终端这三个细节，按步骤操作基本能一次跑通。

如果遇到其他报错，可先检查配置文件路径和内容是否正确，或参考常见问题部分。有问题欢迎在评论区交流，一起完善这套方案~