前言

最近发现不少朋友想体验Claude Code，但被环境配置和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
npm --version

若能正常显示版本号（如v20.10.0），说明安装成功。

⚠️ 提示：如果遇到权限问题，尝试右键PowerShell选择"以管理员身份运行"。

二、安装Claude Code

在PowerShell中执行以下命令全局安装Claude Code：

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

安装完成后验证：

claude --version

显示版本信息（如1.2.0）即表示安装成功。

三、配置API连接

前提：获取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
   

方法一：配置文件（推荐）

通过配置文件永久保存API信息，步骤如下：

配置文件路径：

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

配置内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"
  }
}

创建步骤：

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密钥"

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
$env:ANTHROPIC_AUTH_TOKEN

能显示设置的URL和Key即表示配置成功。

⚠️ 注意：配置完成后需重启终端，若在VS Code/Cursor等IDE的集成终端使用，需彻底重启IDE才能生效。

VSCode插件配置（可选）

如果使用VSCode的Claude插件，需额外创建插件配置文件：

配置文件路径：

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

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

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

⚠️ 注意：这是VSCode插件专用的config.json，与Claude Code命令行工具的settings.json是两个不同文件。

四、开始使用

在PowerShell中输入以下命令启动Claude Code：

claude

首次启动可能需要简单设置，按提示操作即可。想了解更多命令，可执行：

claude --help

五、常见问题排查

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

症状：启动后提示无法连接到Anthropic服务。

解决方案：创建.claude.json文件跳过引导流程：

配置文件路径：

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

配置内容：

{
  "hasCompletedOnboarding": true
}

创建步骤：

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

调试技巧：若仍无法连接，检查网络、重启终端/IDE，或重新确认API Key配置是否正确。

总结

到这里，Claude Code的安装和API配置就全部完成了。整个过程核心是Node.js环境搭建和API连接，只要按步骤操作，国内环境下也能顺利使用。如果遇到问题，先检查配置文件路径和API Key是否正确，大部分报错都能通过这两步解决。希望这篇教程能帮你少走弯路，顺利体验Claude Code的功能。如果有其他问题，欢迎在评论区交流~