前言

对于想试试Claude Code的非专业人员，其实最想要的就是一篇能直接跟着做、每步都有明确指引的实操文。

所以今天把自己从头跑通的过程整理出来，从Node.js环境搭建到API对接，再到常见报错解决，全部按实际操作步骤记录。特别用了88api作为中转，省去翻墙和海外账户的麻烦，国内网络就能直连，对新手很友好。

正文

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

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

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

1. 访问Node.js官网，下载Windows LTS版本（页面通常会自动推荐适合你系统的版本）
2. 双击安装包，按向导默认安装即可（建议勾选"Add to PATH"，省去手动配置环境变量的步骤）

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

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

# Chocolatey用户
choco install nodejs

# Scoop用户
scoop install nodejs

验证安装是否成功

打开PowerShell（建议用管理员模式，避免权限问题），输入以下命令检查版本：

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

⚠️ 小提示：如果命令提示"node不是内部或外部命令"，大概率是PATH没配置对，重新运行安装包勾选"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（以88api为例）

使用Claude Code需要API Key，这里用88api（https://api.88api.shop）作为中转接口（国内直连，无需海外账户），大家可以试试。下面是详细步骤：

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

2. 点击“添加令牌”

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

4.点击提交

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

为什么用中转接口？主要是省掉海外账户注册和翻墙的麻烦，国内网络直接调用，而且一个Key能管理多个模型，切换方便。

2. 配置方式（二选一，推荐配置文件）

方法一：通过配置文件持久化配置（推荐）

在用户目录下创建配置文件，一劳永逸：

• 配置文件路径：C:\Users\<你的用户名>\.claude\settings.json（注意替换<你的用户名>为实际系统用户名）
• 配置内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",  // 粘贴刚复制的API Key
    "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)

⚠️ 重要提示：配置后需要重启终端（如果用VSCode/Cursor等IDE的集成终端，需重启整个IDE），否则配置可能不生效。

3. VSCode插件配置（可选）

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

• 配置文件路径：C:\Users\<你的用户名>\.claude\config.json
• 配置内容：

{
  "primaryApiKey": "any"
}

• 创建步骤：在.claude文件夹内新建config.json，粘贴上述内容保存即可。

四、启动并使用Claude Code

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

claude

首次启动可能需要等待几秒，成功连接后会进入交互界面。想了解更多命令，可输入claude --help查看帮助文档。

五、常见问题排查

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

原因：首次启动引导流程未完成。
解决方法：在用户根目录创建.claude.json文件跳过引导：

• 文件路径：C:\Users\<你的用户名>\.claude.json（注意是用户根目录，不是.claude文件夹内）
• 文件内容：

{
  "hasCompletedOnboarding": true
}

保存后重启Claude Code即可。

如果仍无法连接：检查网络、重启终端/IDE，或重新核对API Key和Base URL是否配置正确。

总结

整个流程走下来，其实核心就三步：搭Node.js环境、装Claude Code、配API连接。最关键的是API配置部分，用中转接口确实省了不少事，国内网络直接跑通。

如果跟着步骤走还是遇到问题，建议重点检查配置文件路径是否正确（用户名别写错）、API Key是否复制完整，或者重启终端试试。有其他问题欢迎在评论区交流，一起避坑~