前言

这篇文章整理了我亲测跑通的完整流程：从Node.js环境搭建到Claude Code安装，再到用API中转解决国内直连问题，每个步骤都标了详细路径和命令。
如果你也想省心用上Claude Code，跟着一步步操作，基本10分钟就能搞定。

正文

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

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

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

1. 访问Node.js官网，下载LTS版本安装包
2. 双击安装包，按向导提示完成安装（默认选项即可，会自动配置环境变量）

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

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

# Chocolatey用户
choco install nodejs

# Scoop用户
scoop install nodejs

验证安装是否成功

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

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

⚠️ 注意：如果提示"命令不存在"，可能是环境变量未生效，建议重启终端或检查安装路径是否添加到系统环境变量。

二、安装Claude Code

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

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

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

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

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

1. 获取API Key

Claude Code需要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

2. 配置连接（推荐用配置文件）

创建配置文件是最稳定的方式，步骤如下：

配置文件路径：
C:\Users\<你的用户名>\.claude\settings.json（将<你的用户名>替换为实际系统用户名）

配置内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",  // 替换为刚复制的Key
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"  // API中转地址
  }
}

创建步骤：

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

3. 备选方案：环境变量配置

如果不想用配置文件，也可以通过环境变量设置（仅当前用户生效）：

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)

⚠️ 重要：配置完成后必须重启终端，如果在VS Code等IDE中使用，需要重启整个IDE，否则配置可能不生效。

4. VSCode插件配置（可选）

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

配置文件路径：
C:\Users\<你的用户名>\.claude\config.json

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

1. 进入.claude文件夹（之前创建的）
2. 新建config.json文件，粘贴上述内容保存

注意：这是插件专用配置，和命令行工具的settings.json是两个文件，不要弄混。

四、开始使用Claude Code

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

claude

首次启动可能会提示协议确认，按提示操作即可。想了解更多命令，可输入：

claude --help

五、常见问题排查

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

原因：首次启动引导流程未完成。
解决：在用户根目录创建.claude.json文件跳过引导：

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

配置内容：

{
  "hasCompletedOnboarding": true
}

创建步骤：

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

如果仍无法连接：

• 检查API Key是否正确（复制时是否多了空格）
• 确认网络能访问https://api.88api.shop
• 重启终端或IDE后重试

总结

其实Claude Code配置不复杂，核心就是环境搭建+API对接两步。这篇教程从Node.js安装到API中转配置，再到常见报错解决，基本覆盖了国内用户会遇到的所有问题。按步骤操作，10分钟就能从"不会配"到"能用起来"。

如果遇到其他报错，欢迎在评论区留言，我会尽量回复。技术工具的价值在于解决问题，希望这篇教程能帮你少踩坑，把时间花在更有价值的开发上。