前言

最近想试试Claude Code的代码辅助能力，作为非专业开发的普通用户，最头疼的就是环境配置——步骤零散、版本不对、API调用失败，折腾半天还跑不起来。

所以我整理了这篇从0到1的实操指南，包括Node.js环境准备、Claude Code安装、API连接配置（用了国内中转方案，省掉翻墙和海外账户麻烦），以及常见报错的解决方法。全程基于Windows系统，每一步都附了具体命令和路径，跟着做基本能一次跑通。

正文

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

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

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

1. 访问Node.js官网，下载Windows LTS版本安装包（通常是.msi格式）
2. 双击安装包，按向导默认安装即可（建议勾选"Add to PATH"，自动配置环境变量）

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

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

# Chocolatey用户
choco install nodejs

# Scoop用户
scoop install nodejs

验证安装是否成功

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

node --version  # 输出v18.x.x或更高版本
npm --version   # 输出对应的npm版本

⚠️ 提示：如果命令提示"node不是内部或外部命令"，可能是PATH配置问题，建议重新安装Node.js并确保勾选"Add to PATH"。

二、安装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密钥才能调用服务。我这次用的是88api中转服务（官网：https://api.88api.shop），主要图它国内直连不用翻墙，且一个Key能管理多个模型（Claude、GPT、Gemini等），本地配置更方便。

推荐大家可以试试，或者大家也可以用自己的。

下面以88API 为例：

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

2. 点击“添加令牌”
   

3. 选择分组

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

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

方法一：配置文件（推荐，持久生效）

通过配置文件保存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），否则配置可能不生效。

VSCode插件配置（可选）

如果使用VSCode的Claude插件，需额外创建插件专用配置文件：

配置文件路径：

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

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

1. 进入C:\Users\<你的用户名>\.claude\目录（如无.claude文件夹先创建）
2. 新建config.json文件，粘贴上述内容并保存

四、开始使用Claude Code

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

claude

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

claude --help

五、常见问题排查

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

症状：启动Claude Code后，提示无法连接服务。
原因：通常是首次启动引导流程未完成。
解决方案：在用户根目录创建.claude.json文件跳过引导：

配置文件路径：

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

配置内容：

{
  "hasCompletedOnboarding": true
}

创建步骤：

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

调试技巧：若仍无法连接，检查网络、重启IDE、确认API Key和Base URL配置是否正确。

总结

这篇教程从Node.js环境搭建到API配置，再到常见问题解决，覆盖了Windows系统下Claude Code的完整使用流程。核心是通过API中转服务解决国内环境调用问题，避免了海外账户和翻墙的麻烦。

如果按步骤操作仍遇到问题，建议优先检查API Key是否正确、配置文件路径是否有误，或重启终端/IDE。技术配置难免踩坑，欢迎在评论区交流你的遇到的问题，一起完善这个教程~