前言

最近想试试Claude Code提升开发效率，却被各种环境配置教程搞得头大——要么是默认海外环境需要翻墙，要么步骤零散看完还是不会配。作为非专业运维的开发者，其实我们只想简单上手用工具，而不是花半天折腾环境。

所以我整理了这篇实操文，从Node.js安装到API对接全程保姆级步骤，特别是用了国内API中转站解决直连问题，省去注册海外账户和翻墙的麻烦。亲测每一步都能跑通，希望能帮你快速把Claude Code用起来。

正文

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

Claude Code运行依赖Node.js，官方要求最低版本≥18（建议用LTS稳定版），先确保环境到位。

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

1. 访问Node.js官网，下载Windows LTS版本安装包
2. 双击安装包，按向导默认安装即可（一路"Next"，建议勾选"Add to PATH"）

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

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

# Chocolatey用户
choco install nodejs

# Scoop用户
scoop install nodejs

验证安装是否成功

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

node --version  # 应显示v18.x.x或更高
npm --version   # 通常随Node.js一起安装

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

二、安装Claude Code命令行工具

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

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

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

claude --version  # 应显示版本号，如0.1.0

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

Claude Code需要API密钥才能调用服务，这里用国内API中转站简化配置（不用翻墙和海外账户）。

1. 获取API Key

我用的是88api中转站（官网：https://api.88api.shop），有免费额度可试用，主要图它国内直连方便，且一个Key能管理多个模型（Claude、GPT等），切换模型只需改配置。

推荐大家试试，或者大家也可以用自己的。
下面以88 API 为例：
获取Key的步骤：

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密钥"为实际复制的Key）：

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

创建步骤：

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

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)

验证环境变量：

$env:ANTHROPIC_BASE_URL  # 应显示https://api.88api.shop
$env:ANTHROPIC_AUTH_TOKEN  # 应显示你的API密钥

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

4. VSCode插件配置（可选）

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

配置文件路径：

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

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：同配置文件方式，在.claude文件夹内新建config.json并粘贴内容。

⚠️ 注意：这是VSCode插件专用的config.json，与命令行工具的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\<你的用户名>\目录
2. 新建文件.claude.json（注意在用户根目录，不是.claude文件夹内）
3. 粘贴上述内容保存，重启Claude Code

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

总结

这篇教程从Node.js环境搭建到API配置，再到常见问题解决，覆盖了Claude Code在Windows上的完整使用流程。核心是通过API中转站解决国内直连问题，省去了海外账户和翻墙的麻烦。按步骤操作，基本能避开90%的配置坑。

如果遇到其他问题，欢迎在评论区交流——毕竟工具配置总会有各种小细节，一起踩坑一起解决，效率更高。希望这篇文章能帮你快速用上Claude Code提升开发效率！