前言

最近想体验Claude Code，但翻了不少教程，要么步骤零散，要么默认海外环境，国内配置总在API连接环节卡壳。
其实核心就两步：搭好基础环境，配好API接口。这篇文章把从Node.js安装到API对接的每一步都拆解开，尽量写得细一点，让你跟着做就能跑通，少走弯路。

正文

一、安装Node.js环境

Claude Code运行依赖Node.js，最低要求Node.js 18以上，建议直接安装LTS版本，兼容性更好。

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

1. 访问Node.js官网，下载LTS版本安装包
2. 双击安装包，按向导完成安装（一路默认下一步即可，无需特殊配置）

方法二：包管理器安装

如果习惯用包管理器，可以通过以下命令安装：

# 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  # 输出类似1.0.0的版本号，说明安装成功

三、配置API连接（关键步骤）

前提：获取API Key

调用Claude需要API接口，我这次用了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

配置内容：

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

创建步骤：

1. 打开文件资源管理器，进入C:\Users\<你的用户名>\目录
2. 新建文件夹.claude（注意文件夹名前有小数点）
3. 在.claude文件夹内新建settings.json文件
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

⚠️ 重要提示：配置完成后需重启终端（或IDE，如VS Code需完全关闭再打开），否则配置可能不生效。

VSCode插件配置（可选）

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

配置文件路径：

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

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

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

四、启动Claude Code

配置完成后，在PowerShell中输入：

claude

即可启动Claude Code。如需查看命令帮助，输入：

claude --help

五、常见问题排查

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

原因：首次启动可能因引导流程未完成导致连接失败。

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

文件路径：

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

文件内容：

{
  "hasCompletedOnboarding": true
}

创建步骤：

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

调试技巧：

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

总结

整个流程其实不复杂：装Node.js→装Claude Code→配API→启动。核心坑点在API配置和环境变量生效，按步骤检查路径和文件内容基本能解决。如果启动成功，就可以开始体验Claude Code的功能了。如果遇到其他问题，欢迎在评论区交流，我会尽量回复。