小白也能照着做！Claude Code Windows环境搭建+API中转配置完整指南（无需海外账户）
前言
最近想试试Claude Code的代码辅助能力，作为非专业开发的普通用户，最头疼的就是环境配置——步骤零散、版本不对、API调用失败，折腾半天还跑不起来。
所以我整理了这篇从0到1的实操指南，包括Node.js环境准备、Claude Code安装、API连接配置（用了国内中转方案，省掉翻墙和海外账户麻烦），以及常见报错的解决方法。全程基于Windows系统，每一步都附了具体命令和路径，跟着做基本能一次跑通。
正文
一、准备工作：安装Node.js
Claude Code依赖Node.js环境运行，最低要求Node.js ≥18（建议选LTS稳定版）。
方法一：官网下载（推荐新手）
- 访问Node.js官网，下载Windows LTS版本安装包（通常是
.msi格式） - 双击安装包，按向导默认安装即可（建议勾选"Add to PATH"，自动配置环境变量）
方法二：包管理器安装（适合熟悉命令行用户）
如果已安装Chocolatey或Scoop包管理器，可直接用命令安装：
# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs验证安装是否成功
打开PowerShell（建议管理员模式，避免权限问题），输入以下命令检查版本：
node--version# 输出v18.x.x或更高版本npm--version# 输出对应的npm版本⚠️ 提示：如果命令提示"node不是内部或外部命令"，可能是PATH配置问题，建议重新安装Node.js并确保勾选"Add to PATH"。
二、安装Claude Code
Node.js环境就绪后，用npm全局安装Claude Code：
npminstall-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 为例：
注册并登录后，点击侧边栏“API令牌”。
点击“添加令牌”
选择分组
- 根据需要调用的模型选择分组
a. claude 模型建议使用 calude code 分组、
b. gpt 模型建议使用 codex分组 - 可通过平台的模型广场查看不同模型支持的分组
- 若在使用中出现上游分组饱和，请切换分组使用
- 根据需要调用的模型选择分组
点击提交
5. 点击复制按钮复制API令牌，也就是API KEY
方法一：配置文件（推荐，持久生效）
通过配置文件保存API信息，步骤如下：
配置文件路径（需替换<你的用户名>为实际系统用户名）：
C:\Users\<你的用户名>\.claude\settings.json配置内容（替换"你的API密钥"为实际复制的Key）：
{"env":{"ANTHROPIC_AUTH_TOKEN":"你的API密钥","ANTHROPIC_BASE_URL":"https://api.88api.shop"}}创建步骤：
- 打开文件资源管理器，进入
C:\Users\<你的用户名>\目录 - 新建文件夹
.claude（如果已存在则跳过） - 在
.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"}创建步骤：
- 进入
C:\Users\<你的用户名>\.claude\目录（如无.claude文件夹先创建） - 新建
config.json文件，粘贴上述内容并保存
四、开始使用Claude Code
配置完成后，在PowerShell中输入以下命令启动：
claude首次启动会进入交互界面，可直接输入问题或代码需求。如需查看支持的命令，输入：
claude--help五、常见问题排查
问题：启动后提示"Unable to connect to Anthropic services"
症状：启动Claude Code后，提示无法连接服务。
原因：通常是首次启动引导流程未完成。
解决方案：在用户根目录创建.claude.json文件跳过引导：
配置文件路径：
C:\Users\<你的用户名>\.claude.json配置内容：
{"hasCompletedOnboarding":true}创建步骤：
- 进入
C:\Users\<你的用户名>\目录 - 新建
.claude.json文件（注意是用户根目录，不是.claude文件夹内） - 粘贴上述内容保存，重启Claude Code即可
调试技巧：若仍无法连接，检查网络、重启IDE、确认API Key和Base URL配置是否正确。
总结
这篇教程从Node.js环境搭建到API配置，再到常见问题解决，覆盖了Windows系统下Claude Code的完整使用流程。核心是通过API中转服务解决国内环境调用问题，避免了海外账户和翻墙的麻烦。
如果按步骤操作仍遇到问题，建议优先检查API Key是否正确、配置文件路径是否有误，或重启终端/IDE。技术配置难免踩坑，欢迎在评论区交流你的遇到的问题，一起完善这个教程~