国内直连 Claude Code 保姆级教程：从 Node.js 安装到 API 配置，亲测跑通（附常见问题解决）

前言

这篇文章整理了我自己实操的完整流程，从 Node.js 安装到 API 配置，再到常见问题排查，每个步骤都尽量写清楚，希望能帮你少走弯路，快速把 Claude Code 跑起来。

正文

一、安装 Node.js

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

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

1. 访问 Node.js 官网 下载 LTS 版本
2. 双击安装包，按向导完成安装（建议勾选“Add to PATH”，方便后续命令行调用）

方法二：包管理器安装

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

# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs

验证安装

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

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

⚠️提示：如果提示“node 不是内部或外部命令”，检查是否勾选了“Add to PATH”，或手动将 Node.js 安装路径（默认C:\Program Files\nodejs）添加到系统环境变量。

二、安装 Claude Code

Node.js 环境准备好后，通过 npm 全局安装 Claude Code：

npminstall-g@anthropic-ai/claude-code

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

claude--version# 输出类似 0.1.x 的版本号

三、配置 API 连接

前提：获取 API Key

使用 Claude Code 需要 API 密钥，我这里选择 88api 作为中转接口（官网：https://api.88api.shop），主要是为了省去海外账号注册和网络配置的麻烦，国内可直连，且支持多模型统一管理。获取步骤如下：

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密钥”为实际密钥，保存文件

方法二：环境变量（临时或永久）

如果不想用配置文件，也可以通过环境变量设置。

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

⚠️注意：配置完成后需重启终端（或整个 IDE，如 VS Code）才能生效。

VSCode 插件配置（可选）

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

配置文件路径：

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

配置内容：

{"primaryApiKey":"any"}

创建步骤：

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

四、开始使用

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

claude

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

claude--help

五、常见问题排查

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

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

解决方案：通常是首次启动引导未完成，需创建.claude.json文件跳过引导：

配置文件路径：

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

配置内容：

{"hasCompletedOnboarding":true}

创建步骤：

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

调试技巧：

• 检查网络连接是否正常
• 确认 API Key 和ANTHROPIC_BASE_URL配置正确
• 重启终端或 IDE 后重试

总结

到这里，Claude Code 的安装和 API 配置就完成了。核心步骤是：准备 Node.js 环境 → 安装 Claude Code → 通过配置文件（或环境变量）设置 API 信息 → 启动验证。遇到连接问题时，记得检查.claude.json文件和配置项是否正确。如果过程中还有其他报错或疑问，欢迎在评论区留言，一起交流解决~