国内直连不折腾！Claude Code 从安装到 API 配置完整教程（小白也能照着做）

前言

我整理了一份从 Node.js 安装到 API 对接的完整步骤，用 88api 中转实现国内直连，不用翻墙和海外账户，亲测跑通。
如果你也是小白怕麻烦，跟着这篇一步步来，应该能少走不少弯路。

正文

一、安装 Node.js

Claude Code 需要 Node.js 环境支持，最低要求 Node.js ≥18（建议安装 LTS 版本）。

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

1. 访问 Node.js 官网 下载 LTS 版本安装包
2. 双击安装包，按向导提示完成安装（一路默认下一步即可）

方法二：包管理器安装

如果习惯用包管理器，可以通过以下命令安装：

# Chocolatey 用户chocoinstallnodejs# Scoop 用户scoopinstallnodejs

验证安装

安装完成后，打开终端输入以下命令检查版本：

node--version# 输出 Node.js 版本，如 v20.10.0npm--version# 输出 npm 版本，如 10.2.3

⚠️提示：建议使用 PowerShell 终端；若遇权限问题，可尝试以管理员身份运行终端。

二、安装 Claude Code

通过 npm 全局安装 Claude Code：

npminstall-g@anthropic-ai/claude-code

安装完成后验证版本：

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

三、配置 API 连接

前提：获取 API Key

调用 Claude 模型需要 API 密钥，我这次用的是 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密钥",// 替换为复制的 API Key"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密钥"# 替换为实际 Key

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# 应输出 https://api.88api.shop$env:ANTHROPIC_AUTH_TOKEN# 应输出你的 API Key

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

VSCode 插件配置（可选）

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

配置文件路径：

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

配置内容：

{"primaryApiKey":"any"}

创建步骤：

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

四、开始使用

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

claude

若需查看支持的命令，可运行：

claude--help

五、常见问题排查

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

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

解决方案：
这通常是首次启动引导未完成导致，需在用户根目录创建.claude.json文件跳过引导：

配置文件路径：

C:\Users\<你的用户名>\.claude.json # 注意是用户根目录，不是 .claude 文件夹内

配置内容：

{"hasCompletedOnboarding":true}

创建步骤：

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

调试技巧：
若仍无法连接，可检查：

• 网络连接是否正常
• API Key 是否配置正确（参考「配置 API 连接」章节）
• 重启终端或 IDE 后重试

总结

到这里，Claude Code 的安装和 API 配置就完成了。核心是通过中转服务解决国内直连问题，再按步骤配置好环境变量或配置文件。如果遇到连接问题，记得检查.claude.json文件和 API Key 是否正确。整个流程不算复杂，跟着步骤走基本能一次成功。有任何问题欢迎在评论区交流，一起少踩坑～