前言

最近想体验Claude Code的本地代码辅助功能，却被各种环境配置卡了壳——不是Node.js版本不对，就是API调用需要海外账户，国内直连总失败。网上教程要么太零散，要么步骤不完整，折腾半天还是跑不起来。

所以干脆整理了这篇从0到1的实操文，包含Node.js安装、Claude Code模型配置等，甚至连常见报错的解决办法都附上了。亲测Windows环境下能跑通，希望能帮到同样想尝试的朋友。

正文

一、准备工作：安装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（版本≥18即可）

npm --version
# 示例输出：10.2.4（npm会随Node.js一起安装）

⚠️ 小提示：如果命令执行失败，检查是否用了管理员模式运行PowerShell，或重启终端后再试。

二、安装Claude Code

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

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

安装完成后验证：

claude --version
# 能显示版本号即安装成功（如无输出，检查Node.js环境变量是否配置正确）

三、配置API连接（以88api为例）

Claude Code需要API密钥才能调用服务。我这里直接用88api中转接口，主要是为了省掉海外账户注册和翻墙的麻烦。

第一步：获取88api的API Key

1.访问 88api (https://api.88api.shop)，注册登录后，点击 “API 令牌”

2.点击添加令牌

3. 创建令牌

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

4. 获取 API KEY

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

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

第二步：配置API连接（推荐用配置文件）

在用户目录下创建配置文件，永久保存API信息：

配置文件路径（替换<你的用户名>为实际系统用户名）：
C:\Users\<你的用户名>\.claude\settings.json

配置内容（替换你的API密钥为实际复制的Key）：

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

创建步骤：

1. 打开文件资源管理器，进入C:\Users\<你的用户名>\目录
2. 新建文件夹.claude（如果已存在则跳过）
3. 在.claude文件夹内新建settings.json文件，粘贴上述配置并保存

备选方案：用环境变量配置（临时或永久）

如果不想用配置文件，可通过环境变量设置（适合临时测试）：

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密钥

⚠️ 重要提示：配置完成后必须重启终端，如果用VS Code/Cursor等IDE的集成终端，需要彻底重启IDE（仅重启终端可能不生效）。

（可选）VSCode插件额外配置

如果使用VSCode的Claude插件，还需在.claude文件夹内创建config.json：

配置文件路径：
C:\Users\<你的用户名>\.claude\config.json

配置内容：

{
  "primaryApiKey": "any"
}

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

四、启动Claude Code开始使用

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

claude

首次启动可能需要等待加载，成功后会进入交互界面。如需查看支持的命令，输入：

claude --help

五、常见问题排查

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

症状：启动Claude Code后，显示无法连接服务。
原因：首次启动引导流程未完成。

解决方案：在用户根目录创建.claude.json文件跳过引导：
文件路径：C:\Users\<你的用户名>\.claude.json
文件内容：

{
  "hasCompletedOnboarding": true
}

创建步骤：

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

调试小技巧：
如果仍无法连接，检查：

• 网络是否正常（国内直连88api无需翻墙）
• API Key是否正确配置（对比settings.json或环境变量）
• 重启终端或IDE后重试

总结

整个流程其实不复杂，核心就是3步：装Node.js（≥18版本）→ 装Claude Code → 配API（用88api中转省掉海外账户麻烦）。最容易踩坑的是配置文件路径和重启终端，按步骤来基本能跑通。

如果遇到其他报错，先检查Node.js版本和API配置是否正确，大部分问题都能通过这两步解决。有成功或失败经验的朋友，欢迎在评论区交流~