前言

最近把自己亲测跑通的完整流程整理出来：从Node.js安装到API配置，甚至连常见报错的解决方法都一并附上。全程不用海外账户，不用复杂网络配置，跟着步骤走，10分钟就能让Claude Code在本地跑起来。

正文

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

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

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

1. 访问Node.js官网，下载“LTS”版本（比如v20.x.x）
2. 双击安装包，按向导默认安装即可（一路点“Next”）

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

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

# Chocolatey用户
choco install nodejs

# Scoop用户
scoop install nodejs

验证安装是否成功

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

node --version  # 输出v18.x.x或更高
npm --version   # 输出对应npm版本

⚠️ 小提示：如果提示“命令不存在”，检查是否勾选了安装时的“Add to PATH”选项，或重启终端再试。

二、安装Claude Code

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

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

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

claude --version  # 输出类似1.0.0的版本号

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

1. 获取API KEY

Claude Code需要API密钥才能调用服务。我这次用的是88api作为接口中转（官网：https://api.88api.shop），主要是省去海外账户注册和翻墙步骤，国内直连更方便，大家也可以用自己熟悉的接口服务。

获取API KEY的步骤（以88api为例）：

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

2. 点击“添加令牌”
   

3. 选择分组

   1. 根据需要调用的模型选择分组
      a. claude 模型建议使用 calude code 分组、
      b. gpt 模型建议使用 codex分组
   2. 可通过平台的模型广场查看不同模型支持的分组
   3. 若在使用中出现上游分组饱和，请切换分组使用
      

4. 点击提交
   

5. 点击复制按钮复制API令牌，也就是API KEY
   

2. 配置API（推荐用配置文件）

最稳定的方式是通过配置文件保存API信息，步骤如下：

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

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

配置内容（替换你的API密钥为刚才复制的令牌）：

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

创建步骤：

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)

⚠️ 重要提示：配置后必须重启终端（如果用VSCode等IDE，需重启整个IDE），否则配置不会生效！

4. VSCode插件配置（可选）

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

配置文件路径：

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

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤和settings.json类似，在.claude文件夹里新建文件粘贴即可。

四、启动Claude Code

配置完成后，在终端输入：

claude

如果一切正常，会进入Claude Code交互界面，此时就可以开始使用了。

想了解更多命令？输入claude --help查看帮助文档。

五、常见问题排查

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

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

文件路径：

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

文件内容：

{
  "hasCompletedOnboarding": true
}

创建后重启Claude Code即可。如果仍有问题，检查API KEY是否正确、网络是否通畅，或重启终端重试。

总结

其实Claude Code配置不难，核心就是“环境+API”两步。国内用户最容易卡壳的海外账户和网络问题，用接口中转就能解决。

这篇教程从Node.js安装到API配置，再到常见报错处理，尽量把每个细节讲清楚了。如果跟着做还是遇到问题，欢迎在评论区留言，我会尽量回复。希望大家都能少踩坑，快速用上Claude Code～