小白也能装好的 Claude Code Windows 教程：从 Node.js 到 api 接入，手把手跑通全流程
前言
这篇是 Windows 环境下从零开始的完整操作记录，Node.js 安装、Claude Code 安装、API Key 获取与配置（用的是 88api 中转，国内直连省掉很多麻烦）、VSCode 插件额外配置，以及最常见的启动报错解法，全都在这里。
正文
1. 安装 Node.js
Claude Code 需要 Node.js >=18，建议用 LTS 版本。
方法一：官网下载（推荐）
- 访问 Node.js 官网 下载 LTS 版本
- 双击安装包，按向导完成安装
方法二：包管理器安装
# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs验证安装，出现版本号即成功：
node--version# 输出示例：v20.11.0npm--version# 输出示例：10.2.4⚠️ 建议使用 PowerShell；如遇权限问题可尝试以管理员身份运行。
2. 安装 Claude Code
npminstall-g@anthropic-ai/claude-code验证安装：
claude--version3. 配置 API 连接
获取 API Key
我这里用的是 88api 中转站（网址：https://api.88api.shop），有免费额度可以先试用，国内直连不需要额外处理网络。推荐大家可以试试，或者大家也可以用自己的。
下面以88 API 为例：
- 注册登录后，点击页面上方的"控制台"，进入后点击侧边栏的"API 令牌"
- 点击"添加令牌"
- 创建令牌，名称随意，直接提交即可
- 获取 API Key，妥善保管，不要公开或分享
- 点击"知道了"，在列表中点击"复制"按钮获取 API Key
方法一：配置文件（推荐）
配置文件路径：
C:\Users\<你的用户名>\.claude\settings.json配置内容：
{"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$env:ANTHROPIC_AUTH_TOKEN⚠️ 配置完成后需要重启终端才能生效。在 VS Code / Cursor 等 IDE 中使用时，需要彻底重启整个 IDE，否则配置可能不会生效。
VSCode 插件额外配置（可选）
如果同时使用 VSCode 的 Claude 插件，还需要创建插件专用认证文件：
配置文件路径：
C:\Users\<你的用户名>\.claude\config.json配置内容：
{"primaryApiKey":"any"}创建步骤：
- 打开文件资源管理器，进入
C:\Users\<你的用户名>\.claude\目录 - 如果
.claude文件夹不存在，先参考方法一创建 - 在
.claude文件夹中新建文件config.json - 将上述配置内容粘贴到文件中并保存
⚠️
config.json是 VSCode 插件专用的，和 Claude Code 命令行工具用的settings.json是两个不同的文件，不要搞混。
4. 启动 Claude Code
claude可运行claude --help查看支持的命令。
5. 常见问题排查
问题：Unable to connect to Anthropic services
症状：启动 Claude Code 后提示无法连接到 Anthropic 服务。
解决方案：通常是首次启动引导未完成，手动创建.claude.json跳过引导即可。
配置文件路径（注意是用户根目录，不是.claude文件夹内）：
C:\Users\<你的用户名>\.claude.json配置内容：
{"hasCompletedOnboarding":true}创建步骤：
- 打开文件资源管理器，进入
C:\Users\<你的用户名>\目录 - 新建文件
.claude.json - 将上述内容粘贴进去并保存
- 重启 Claude Code
💡 如果配置后仍然无法连接，依次检查：网络是否正常、终端或 IDE 是否已完全重启、API Key 是否配置正确。
总结
这篇把 Windows 上配好 Claude Code 的完整流程走了一遍：Node.js 安装（含包管理器方式）、Claude Code 安装、API Key 获取与配置（配置文件和 PowerShell 环境变量两种方式），以及 VSCode 插件的额外配置和首次启动报错的解法。
Windows 和 Mac 的主要差别在路径格式和环境变量设置方式，配置文件用C:\Users\<用户名>\.claude\这个路径，PowerShell 永久设置用SetEnvironmentVariable方法。其他地方基本一致。有问题欢迎评论区交流。