前言

最近想试试Claude Code，但网上教程要么太碎片化，要么默认海外环境，国内用户跟着做总踩坑。其实核心就卡在环境配置和API连接上——Node.js版本不对、API密钥配错、终端没重启导致配置不生效，这些小问题都能让整个流程卡壳。

我花了一下午整理出这套完整步骤，从Node.js安装到API对接全流程，用接口中转服务省去翻墙和海外账户注册的麻烦，亲测Windows系统能跑通。如果你也想少走弯路，跟着这篇一步步操作就行。

正文

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

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

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

1. 访问Node.js官网，下载LTS版本安装包
2. 双击安装包，按向导默认安装即可（建议勾选"Add to PATH"，自动配置环境变量）

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

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

# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs

验证安装是否成功

打开PowerShell（建议管理员模式），输入以下命令，能显示版本号即安装成功：

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

npm --version
# 示例输出：10.2.4

⚠️ 注意：如果提示"node不是内部或外部命令"，检查是否勾选了"Add to PATH"，或手动将Node.js安装路径（默认C:\Program Files\nodejs）添加到系统环境变量。

二、安装Claude Code

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

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

安装完成后验证：

claude --version
# 能显示版本号即安装成功（如无输出，检查Node.js环境变量是否配置正确）

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

Claude Code需要API密钥才能调用服务，我这次实操中使用88api作为接口中转（https://api.88api.shop），比较方便。

第一步：获取API密钥

以88api为例，获取密钥的步骤如下：

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

2. 点击"添加令牌"

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

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

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

第二步：配置连接（两种方法选其一）

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

在用户目录下创建配置文件，步骤如下：

1. 打开文件资源管理器，进入路径：C:\Users\<你的用户名>\（比如C:\Users\John\）
2. 新建文件夹.claude（注意文件夹名前有小数点）
3. 在.claude文件夹中新建文件settings.json，内容如下：

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

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

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

临时配置（仅当前终端会话有效）：

$env:ANTHROPIC_BASE_URL = "https://api.88api.shop"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"  // 替换成实际密钥

永久配置（用户级，重启后生效）：

[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），否则配置不会生效！

第三步：VSCode插件配置（可选）

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

1. 进入路径：C:\Users\<你的用户名>\.claude\
2. 新建文件config.json，内容如下：

{
  "primaryApiKey": "any"
}

四、启动Claude Code

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

claude

首次启动可能需要确认条款，按提示操作即可。如果想查看支持的命令，输入：

claude --help

五、常见问题排查

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

原因：首次启动引导未完成，需要手动跳过。
解决：在用户根目录（C:\Users\<你的用户名>\）创建.claude.json文件，内容如下：

{
  "hasCompletedOnboarding": true
}

保存后重启Claude Code即可。

排查思路：如果仍无法连接，检查：

1. API密钥是否正确（复制时是否多了空格或漏了字符）
2. 网络是否正常（国内直连需确保接口中转服务可用）
3. 配置文件路径是否正确（.claude文件夹在用户根目录，不是其他地方）

总结

这套流程核心解决了两个问题：一是Node.js环境配置（版本和环境变量），二是国内直连API（用中转服务省去海外账户和翻墙）。只要严格按步骤操作，尤其是注意"重启终端"和"配置文件路径"这两个细节，基本能一次跑通。

如果遇到其他报错，欢迎在评论区留言，我会尽量回复。技术工具配置难免踩坑，分享出来就是为了让大家少走弯路～