前言

最近想体验Claude Code的本地代码辅助功能，却被各种环境配置折腾得够呛——不是Node.js版本不对，就是API连接总报错，网上教程要么太碎片化，要么默认国外环境。

作为非专业开发的普通用户，其实最需要的就是一篇能直接跟着做、少踩坑的完整指南。所以我把自己从安装到成功运行的全过程整理出来，特别是结合了国内可用的API中转方案，希望能帮到同样想尝试的朋友。

正文

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

Claude Code运行依赖Node.js，官方要求最低版本≥18（建议用LTS稳定版），先确保这个基础环境没问题。

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

1. 访问Node.js官网，下载LTS版本安装包（通常是页面最醒目的推荐版本）
2. 双击安装包，按向导提示完成安装（建议勾选"Add to PATH"，省去手动配置环境变量的麻烦）

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

如果你的系统已安装Chocolatey或Scoop包管理器，可直接用命令安装：

# Chocolatey用户
choco install nodejs

# Scoop用户
scoop install nodejs

验证安装是否成功

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

node --version  # 应显示v18.x.x或更高
npm --version   # 通常随Node.js一起安装，版本号对应即可

二、安装Claude Code命令行工具

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

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

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

claude --version  # 显示版本号即表示安装成功

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

1. 获取API Key

使用Claude Code需要API密钥，我这里用的是88api中转服务（官网：https://api.88api.shop），国内直连无需翻墙，一个Key可管理多个模型，省掉注册海外账户的麻烦。推荐大家可以试试。

下面以88api为例：

1. 注册并登录后，点击侧边栏“API令牌”。
   

2. 点击“添加令牌”
   

3. 选择分组

   1. 根据需要调用的模型选择分组
      a. claude 模型建议使用 calude code 分组、
      b. gpt 模型建议使用 codex分组
   2. 可通过平台的模型广场查看不同模型支持的分组
   3. 若在使用中出现上游分组饱和，请切换分组使用
      

4. 点击提交
   5. 点击复制按钮复制API令牌，也就是API KEY
   

2. 配置连接（推荐用配置文件方式）

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

配置文件路径（需替换<你的用户名>为实际系统用户名）：

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

配置内容（替换"你的API密钥"为上一步复制的令牌）：

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

创建步骤：

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

3. 环境变量配置（备选方案）

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

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)

⚠️ 注意：配置完成后需重启终端，若在VS Code等IDE的集成终端使用，需彻底重启IDE才能生效。

4. VSCode插件配置（可选）

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

配置文件路径：

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

配置内容：

{
  "primaryApiKey": "any"
}

四、启动并使用Claude Code

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

claude

首次启动可能需要简单交互，按提示操作即可。若想查看支持的命令，可输入：

claude --help

五、常见问题排查

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

原因：首次启动引导流程未完成。
解决方案：在用户根目录创建.claude.json文件跳过引导：

文件路径：

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

文件内容：

{
  "hasCompletedOnboarding": true
}

创建后重启Claude Code即可。若仍无法连接，检查网络、API Key配置是否正确，或重启终端/IDE重试。

总结

整个过程其实不复杂，核心就是三步：装好Node.js、用npm安装Claude Code、配置API连接。国内用户通过中转服务能省掉不少环境麻烦，实测下来配置文件方式最稳定。如果遇到连接问题，优先检查配置文件路径和内容，或尝试创建.claude.json跳过引导。按照步骤操作，基本能一次跑通。如果还有其他问题，欢迎在评论区交流~