当前位置：首页 > news >正文

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

news 2026/6/2 19:59:37

前言

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

正文

一、安装 Node.js

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

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

访问 Node.js 官网下载 LTS 版本
双击安装包，按向导完成安装（建议勾选“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. 点击“添加令牌”

选择分组
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"// 中转接口地址}}

创建步骤：

打开文件资源管理器，进入C:\Users\<你的用户名>\目录
新建文件夹.claude（如果已存在则跳过）
在.claude文件夹中新建settings.json文件
粘贴上述配置内容，替换“你的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"}

创建步骤：

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

四、开始使用

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

claude

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

claude--help

五、常见问题排查

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

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

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

配置文件路径：

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

配置内容：

{"hasCompletedOnboarding":true}

创建步骤：

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

调试技巧：

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

总结

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

查看全文

http://www.gsyq.cn/news/1449098.html