前言

这篇文章针对Windows用户，从Node.js安装到API配置，一步步带你走通Claude Code的完整流程。
我会用国内可用的API中转方案，省去翻墙和海外账号的麻烦，尽量把每个步骤讲细，连新手常犯的配置文件路径问题也会提到，争取让你跟着做就能跑起来。

正文

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

Claude Code运行需要Node.js环境，最低要求Node.js ≥18（建议选LTS版本，更稳定）。

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

1. 访问Node.js官网，下载LTS版本安装包（一般是首页显眼位置的"Recommended For Most Users"）
2. 双击安装包，按向导提示完成安装（默认选项即可，会自动配置环境变量）

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

如果你的电脑装了Chocolatey或Scoop，可以直接用命令安装：

# Chocolatey用户
choco install nodejs

# Scoop用户
scoop install nodejs

验证安装是否成功

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

node --version  # 查看Node.js版本，应显示v18.x或更高
npm --version   # 查看npm版本，通常会随Node.js一起安装

⚠️ 提示：如果命令提示"不是内部或外部命令"，可能是环境变量没配置好，建议重新运行Node.js安装包，勾选"Add to PATH"选项。

二、安装Claude Code

Node.js准备好后，用npm全局安装Claude Code：

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

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

claude --version  # 应显示当前安装的版本号

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

前提：获取API Key

调用Claude需要API Key，我这次用的是88api作为接口中转（官网：https://api.88api.shop），主要是考虑国内直连方便，无需海外账户，且一个Key能管理多个模型，减少切换配置的麻烦。
推荐大家使用，大家也可以用自己的。

下面以88API 为例：
获取Key的步骤：

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

2. 点击“添加令牌”
   

3. 选择分组

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

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

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

通过配置文件保存API信息，步骤如下：

配置文件路径（必须准确）：

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

（把<你的用户名>替换成你电脑的实际用户名，比如C:\Users\张三\.claude\settings.json）

配置内容（替换为你的API Key）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",  // 粘贴刚才复制的API Key
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"  // 中转接口地址
  }
}

创建步骤：

1. 打开文件资源管理器，进入C:\Users\<你的用户名>\目录
2. 新建文件夹.claude（如果已存在则跳过）
3. 在.claude文件夹内新建文件settings.json（注意后缀是.json，不是.txt）
4. 粘贴上述配置内容，替换"你的API密钥"为实际Key，保存文件

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

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

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  # 应显示设置的接口地址
$env:ANTHROPIC_AUTH_TOKEN  # 应显示你的API Key

⚠️ 重要提示：配置完成后必须重启终端（或彻底重启VS Code/Cursor等IDE），否则配置可能不生效！

VSCode插件配置（可选，如果你用Claude插件）

如果在VSCode中使用Claude插件，还需要额外创建一个配置文件：

配置文件路径：

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

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

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

⚠️ 注意：这是VSCode插件专用的config.json，和命令行工具的settings.json是两个不同文件，不要搞混！

四、开始使用Claude Code

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

claude

首次启动会进入交互界面，输入问题即可使用。想了解更多命令，可输入：

claude --help

五、常见问题排查

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

症状：启动Claude Code后报错，无法连接服务。
原因：首次启动引导流程未完成。
解决方案：在用户根目录创建.claude.json文件跳过引导：

文件路径：

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

（注意是在用户根目录，不是.claude文件夹内）

配置内容：

{
  "hasCompletedOnboarding": true
}

创建步骤：

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

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

• 网络是否正常（国内直连需确保API地址正确）
• API Key是否配置正确（对比复制的Key和配置文件中的内容）
• 终端/IDE是否已重启（配置生效需要重启）

总结

到这里，Claude Code的安装和API配置就完成了。核心步骤是Node.js环境准备、Claude Code安装，以及通过配置文件或环境变量对接API。国内用户用中转接口能省掉不少麻烦，遇到连接问题时，检查配置文件路径和.claude.json文件通常能解决。

如果跟着做还是遇到问题，欢迎在评论区留言，我会尽量回复。技术配置难免踩坑，关键是耐心检查每一步——路径对不对、Key有没有填错、终端有没有重启，这些细节往往决定成败。