前言

作为踩过不少坑的过来人，我整理了这篇Claude Code从安装到调用的完整流程，尤其适合国内用户：不用海外账户，不用复杂网络配置，直接用88api中转就能跑通。
如果你也想少折腾环境，专注于工具使用，跟着这篇一步步操作就行。

正文

一、安装Node.js环境

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

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

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

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

如果已安装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），主要是为了避免海外账户注册和网络问题，国内可直连，有额度大家可以试试。

或者大家用自己的也可以。

这里以88api为例：
获取Key的步骤：

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

2. 点击“添加令牌”
   

3. 选择分组

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

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

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

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

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

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

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",  // 替换为刚复制的88api令牌
    "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密钥"  # 替换为实际密钥

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

[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插件，需额外创建插件配置文件：

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

{
  "primaryApiKey": "any"
}

• 创建步骤：在.claude文件夹内新建config.json，粘贴上述内容并保存（注意与命令行工具的settings.json区分开）。

四、开始使用Claude Code

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

claude

首次启动会进入交互界面，可直接输入问题或代码需求。如需查看命令帮助，输入：

claude --help

五、常见问题排查

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

症状：启动Claude Code后无法连接服务，提示连接失败。

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

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

{
  "hasCompletedOnboarding": true
}

• 创建步骤：在用户根目录新建文件，粘贴上述内容保存，重启Claude Code即可。

调试技巧：若仍无法连接，检查网络、重启IDE、确认API Key和Base URL配置是否正确。

总结

这篇教程从Node.js安装到API配置，再到常见问题解决，覆盖了Claude Code在Windows系统的完整部署流程。核心是通过88api中转解决国内直连问题，避免了海外账户和网络的麻烦。只要按步骤操作，基本能一次跑通。如果遇到其他问题，欢迎在评论区交流，我会尽量解答。工具用起来才是王道，赶紧试试吧！