国内直连不折腾！Claude Code完整安装+API配置教程（附常见报错解决）

前言

最近AI工具更新太快，很多教程没跟上版本变化，尤其是Claude Code这类需要特定环境的工具，新手很容易卡在安装配置环节。要么Node.js版本不对，要么API连接总失败，国内用户还得处理网络问题。

这篇文章整理了我亲测跑通的完整流程，从Node.js环境搭建到API对接，连常见报错都附上解决办法，尽量让大家少踩坑。

正文

一、准备工作：安装Node.js

Claude Code运行依赖Node.js环境，最低要求Node.js ≥18（建议用LTS版本，更稳定）。

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

1. 访问Node.js官网，下载LTS版本安装包
2. 双击安装包，按向导完成安装（默认选项即可，会自动配置环境变量）

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

如果已安装Chocolatey或Scoop，可直接用命令安装：

# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs

验证安装是否成功

打开终端（建议用PowerShell），输入以下命令，出现版本号即安装成功：

node --version
# 输出示例：v20.11.0（版本号可能因下载版本不同略有差异）

npm --version
# 输出示例：10.2.4

⚠️ 注意：如果提示"命令不存在"，可能是环境变量未生效，建议重启终端；若遇权限问题，尝试以管理员身份运行终端。

二、安装Claude Code

Node.js环境就绪后，用npm全局安装Claude Code：

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

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

claude --version
# 输出示例：1.0.0（版本号以实际安装为准）

三、配置API连接（核心步骤）

获取API Key

Claude Code需要API Key才能调用服务。我最近在用 88api作为中转接口（网址：https://api.88api.shop）。大家也可以根据自己情况选择合适的API服务。

以88api为例，获取Key的步骤如下：

1.注册登录后，点击 “API 令牌”

2.点击添加令牌

3. 创建令牌

名称随便写，没有含义，直接点击提交即可。

4. 获取 API KEY

获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。

5. 点击“知道了”，可以看到我们刚才创建的，在这里也同样可以点击 复制 按钮去获取 API Key。
   

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

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

1. 打开文件资源管理器，进入路径：C:\Users\<你的用户名>\（替换<你的用户名>为实际系统用户名）
2. 新建文件夹.claude（若已存在则跳过）
3. 在.claude文件夹中新建文件settings.json，内容如下：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",  // 替换为实际复制的API Key
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"  // 中转接口地址
  }
}

配置方式二：环境变量（临时或永久）

如果不想用配置文件，可通过环境变量配置：

临时设置（仅当前终端会话有效）：

$env:ANTHROPIC_BASE_URL = "https://api.88api.shop"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"  // 替换为实际Key

永久设置（用户级，全局生效）：

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

⚠️ 注意：配置后需重启终端（若在VS Code等IDE中使用，需重启整个IDE）才能生效。可通过以下命令验证环境变量是否配置成功：

$env:ANTHROPIC_BASE_URL  # 应输出接口地址
$env:ANTHROPIC_AUTH_TOKEN  # 应输出API Key

VSCode插件配置（可选）

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

1. 进入路径：C:\Users\<你的用户名>\.claude\
2. 新建文件config.json，内容如下：

{
  "primaryApiKey": "any"
}

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

四、启动Claude Code

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

claude

首次启动会进入交互界面，可直接输入问题使用。若需查看支持的命令，输入：

claude --help

五、常见问题排查

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

症状：启动Claude Code后，提示无法连接服务。
解决办法：这通常是首次启动引导未完成导致，需手动创建.claude.json文件跳过引导：

1. 进入路径：C:\Users\<你的用户名>\（用户根目录，非.claude文件夹）
2. 新建文件.claude.json，内容如下：

{
  "hasCompletedOnboarding": true
}

3. 保存后重启Claude Code即可。

调试技巧：若仍无法连接，检查网络是否正常、API Key是否正确配置，或重启终端/IDE后重试。

总结

这篇教程从Node.js环境搭建到API配置，再到常见问题解决，覆盖了Claude Code在Windows系统的完整部署流程。核心是通过API中转实现国内直连，避免了海外账户和网络问题。如果按步骤操作仍遇到问题，欢迎在评论区留言，我会尽量帮忙解答。技术配置难免踩坑，关键是耐心排查每一步，祝大家顺利用上Claude Code！