前言

最近想试试Claude Code，但网上教程要么太零散，要么默认海外环境，国内用户跟着做总卡在API配置环节。其实只要选对接口方案，整个流程并不复杂。

我花了半天时间整理出这篇实操指南，从Node.js环境搭建到API对接，再到常见报错处理，一步步带你跑通，尽量让小白也能少踩坑。

正文

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

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

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

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

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

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

# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs

验证安装是否成功

打开终端（建议用PowerShell），输入以下命令，出现版本号即安装成功：

node --version
# 输出示例：v20.11.0（版本号可能因下载版本不同略有差异）

npm --version
# 输出示例：10.2.4

⚠️ 注意：如果安装后提示"命令不存在"，可能是环境变量未生效，建议重启终端或检查安装路径是否添加到系统环境变量。权限问题可尝试以管理员身份运行终端。

二、安装Claude Code

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

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

安装完成后验证：

claude --version
# 输出版本号即安装成功（如无输出，检查Node.js是否正确安装）

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

Claude Code需要API密钥才能调用服务，这里以88api中转为例（我用它主要是省去海外账号注册和翻墙步骤，国内直连更方便，大家也可以用自己熟悉的接口服务）。

1. 获取API Key

访问88api官网（https://api.88api.shop）。

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

2. 点击"添加令牌"

3. 创建令牌，名称随意，直接提交

4. 获取 API Key，注意妥善保管，不要公开或分享。

5. 点击"知道了"，在令牌列表中可以点击"复制"按钮获取 API Key

2. 配置API（两种方法，选一种即可）

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

在用户目录下创建配置文件，路径和内容如下：

配置文件路径（需替换<你的用户名>为实际系统用户名）：

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

配置内容（替换"你的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），否则配置可能不生效。

3. VSCode插件配置（可选）

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

配置文件路径：

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

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

1. 进入C:\Users\<你的用户名>\.claude\目录（如.claude文件夹不存在，先按方法一创建）
2. 新建config.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

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

• 网络是否正常（国内直连需确保API地址可访问）
• API Key是否正确配置（重新核对配置文件或环境变量）
• 终端/IDE是否已重启（配置生效需要重启）

总结

整个流程核心在于Node.js环境和API配置，只要按步骤操作，基本能一次跑通。国内用户用中转接口能省去不少麻烦，关键是配置文件路径和重启终端这两个细节别忽略。如果遇到其他问题，欢迎在评论区交流，我会尽量回复。希望这篇教程能帮你少走弯路，顺利用上Claude Code。