前言

这篇文章我会把 Windows 下从 Node.js 安装到 Claude Code 启动的全流程拆解开，包括 API 接口配置（用了中转方案减少海外账号和网络的麻烦），每个步骤都附命令和截图，尽量让你少走弯路，亲测跑通。

正文

1. 安装 Node.js

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

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

1. 访问 Node.js 官网，下载 LTS 版本安装包（通常是首页大按钮那个）
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 不是内部或外部命令"，大概率是环境变量没配好，建议重新运行安装包并确保勾选"Add to PATH"，或手动配置环境变量。

2. 安装 Claude Code

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

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

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

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

3. 配置 API 连接

这一步是核心，需要先获取 API Key，再配置到 Claude Code 中。

前提：获取 API Key

我这次实操中用了 88api 作为接口中转（https://api.88api.shop），主要是为了省去海外账号注册和网络配置的麻烦，它支持国内直连，且一个 Key 可管理多个模型（比如 Claude、GPT 等），切换模型只需改一行配置。

大家用自己的也可以，都是一样的。

以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\\John\\.claude\\settings.json）

配置内容：

{
  "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密钥"  # 替换成实际 Key

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 Key

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

VSCode 插件配置（可选，仅使用插件时需要）

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

配置文件路径：

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

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

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

⚠️ 注意：config.json 是 VSCode 插件专用配置，和 Claude Code 命令行工具的 settings.json 是两个不同文件，别搞混了！

4. 开始使用

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

claude

首次启动会提示协议确认，输入 y 并回车即可。如果一切正常，会进入交互界面，此时可以输入代码问题让 Claude 辅助解答。

想查看支持的命令，输入：

claude --help

5. 常见问题排查

问题：Unable to connect to Anthropic services（无法连接服务）

症状：启动后提示无法连接到 Anthropic 服务，大概率是首次启动引导未完成导致。

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

配置文件路径：

C:\\Users\\<你的用户名>\\.claude.json（注意是用户根目录，不是 .claude 文件夹内）

配置内容：

{
  "hasCompletedOnboarding": true
}

创建步骤：

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

调试技巧：如果仍无法连接，检查网络、重启终端/IDE，或重新核对 API Key 是否配置正确（参考步骤 3）。

总结

这篇教程从 Node.js 安装到 Claude Code 启动，再到 API 配置和常见问题处理，把 Windows 环境下的核心步骤拆解开了。重点是通过中转接口解决了国内直连的问题，省去了海外账号和网络的麻烦。

如果按步骤操作还是遇到问题，欢迎在评论区留言——比如配置文件路径是否正确、命令是否报错等，我会尽量回复。技术配置难免踩坑，一起解决问题才是最快的上手方式。