国内环境如何跑通Claude Code？从安装到API配置的完整实操教程（2026亲测）

前言

最近想体验Claude Code，但找了一圈教程不是步骤零散，就是默认国外环境，国内用户跟着做总踩坑。其实核心就两个难点：Node.js环境搭建和API接口配置。这

篇文章把从安装到能用的每一步都拆解开，用API中转服务简化国内直连流程，亲测Windows系统下能跑通，跟着做基本不会出错。

正文

一、安装Node.js环境

Claude Code运行依赖Node.js，最低要求是Node.js 18以上（建议选LTS稳定版）。

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

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

方法二：包管理器安装

如果习惯命令行操作，可以用Chocolatey或Scoop安装：

bash 复制代码

# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs

验证安装是否成功

打开终端，输入以下命令，能显示版本号即安装成功：

bash 复制代码

node --version
# 输出示例：v20.11.0

npm --version
# 输出示例：10.2.4

⚠️ 提示：建议使用PowerShell终端；如果遇到权限问题，右键以管理员身份运行终端再试。

二、安装Claude Code

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

bash 复制代码

npm install -g @anthropic-ai/claude-code

安装完成后验证版本：

bash 复制代码

claude --version

能显示版本信息说明安装成功。

三、配置API连接

获取API Key

我最近用的是88API中转服务（网址：https://api.88api.shop）。

具体步骤：

注册登录以后，点击侧边栏的 "API 令牌"

点击"添加令牌"

创建令牌，名称随意，直接提交

获取 API Key，注意妥善保管，不要公开或分享。

点击"知道了"，在令牌列表中可以点击"复制"按钮获取 API Key

方法一：配置文件（推荐）

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

配置文件路径：

复制代码

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

配置内容：

json 复制代码

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"
  }
}

创建步骤：

打开文件资源管理器，进入C:\Users\<你的用户名>\目录
新建文件夹.claude（如果已存在则跳过）
在.claude文件夹中新建settings.json文件
粘贴上述配置内容，替换"你的API密钥"为实际Key，保存文件

方法二：环境变量配置

如果不想用配置文件，也可以通过环境变量临时或永久设置：

PowerShell临时设置（当前会话有效）：

bash 复制代码

$env:ANTHROPIC_BASE_URL = "https://api.88api.shop"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"

PowerShell永久设置（用户级）：

bash 复制代码

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.88api.shop", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)

验证环境变量：

bash 复制代码

$env:ANTHROPIC_BASE_URL
$env:ANTHROPIC_AUTH_TOKEN

能显示配置的URL和Key即生效。

⚠️ 注意：配置完成后需要重启终端；如果在VS Code、Cursor等IDE的集成终端中使用，需要彻底重启IDE（不只是重启终端），否则配置可能不生效。

VSCode插件配置（可选）

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

配置文件路径：

复制代码

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

配置内容：

json 复制代码

{
  "primaryApiKey": "any"
}

创建步骤：

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

⚠️ 注意：这是VSCode插件专用配置文件，与命令行工具的settings.json是两个不同文件。

四、开始使用Claude Code

配置完成后，在终端输入：

powershell 复制代码

claude

即可启动Claude Code。想了解更多命令，可运行：

powershell 复制代码

claude --help

五、常见问题排查

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

症状：启动Claude Code后无法连接服务。

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

配置文件路径：

复制代码

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

配置内容：

json 复制代码

{
  "hasCompletedOnboarding": true
}

创建步骤：

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

调试技巧：

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

总结

国内环境跑Claude Code其实不复杂，核心就是Node.js环境和API配置两步。用API中转服务能省掉不少麻烦，配置文件方式比环境变量更省心。如果遇到连接问题，记得检查.claude.json文件是否创建。跟着步骤走，基本10分钟就能从安装到用上。如果还有其他问题，欢迎在评论区交流~**