前言

作为踩过坑的开发者，我整理了这篇从0到1的实操文，用88api中转解决国内直连问题，省去翻墙和海外注册麻烦，一步步带你完成安装配置，亲测有效。

正文

一、安装Node.js环境

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

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

1. 访问Node.js官网，点击下载LTS版本（通常是首页显眼位置的"Recommended For Most Users"）
2. 双击下载的安装包，按向导默认安装即可（一路"Next"，建议勾选"Add to PATH"，自动配置环境变量）

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

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

# Chocolatey用户
choco install nodejs

# Scoop用户
scoop install nodejs

验证安装是否成功

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

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

⚠️ 注意：如果提示"node不是内部或外部命令"，可能是环境变量未配置，建议重新安装Node.js并勾选"Add to PATH"，或手动将Node.js安装路径（默认C:\Program Files\nodejs）添加到系统环境变量Path中。

二、安装Claude Code

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

npm install -g @anthropic-ai/claude-code

安装完成后，验证是否成功：

claude --version  # 输出类似 @anthropic-ai/claude-code/x.x.x 的版本信息

三、配置API连接（核心步骤）

前提：获取API Key

调用Claude，gpt等模型都需要API密钥，我这次用88api作为中转（官网：https://api.88api.shop），主要是省去翻墙和海外账号注册，国内直连方便，还能统一管理多个模型API。

大家用自己的也可以，这里以88api为例：
获取Key的步骤：

1. 注册并登录后，点击侧边栏“API令牌”。
   

2. 点击“添加令牌”
   

3. 选择分组

   1. 根据需要调用的模型选择分组
      a. claude 模型建议使用 calude code 分组、
      b. gpt 模型建议使用 codex分组
   2. 可通过平台的模型广场查看不同模型支持的分组
   3. 若在使用中出现上游分组饱和，请切换分组使用
      

4. 点击提交
   5. 点击复制按钮复制API令牌，也就是API KEY
   

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

在用户目录下创建配置文件，步骤如下：
配置文件路径（需替换<你的用户名>为实际系统用户名）：

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

配置内容（替换"你的API密钥"为实际复制的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（仅重启终端可能不生效）。

VSCode插件配置（可选）

如果使用VSCode的Claude插件，需额外创建插件专用配置文件：
配置文件路径：

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

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

1. 进入C:\Users\<你的用户名>\.claude\目录（如果.claude文件夹不存在，先按方法一创建）
2. 新建config.json文件，粘贴上述内容并保存

⚠️ 注意：这是VSCode插件专用的config.json，与Claude Code命令行工具的settings.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\<你的用户名>\目录（注意是用户根目录，不是.claude文件夹内）
2. 新建文件.claude.json，粘贴上述内容并保存
3. 重启Claude Code

调试技巧：
如果仍无法连接，检查：

• 网络是否正常（可尝试访问https://api.88api.shop测试连通性）
• API Key是否正确（重新复制粘贴，注意不要有空格或换行）
• 配置文件路径是否正确（用户目录下的.claude\settings.json）

总结

至此，Claude Code在Windows上的安装和API配置就完成了。核心步骤：安装Node.js ≥18、用npm装Claude Code、通过配置文件或环境变量设置API密钥和中转地址，最后处理可能的连接问题。整个过程不复杂，关键是注意路径和配置的准确性。如果遇到其他问题，欢迎在评论区留言，一起交流解决~