前言
这篇文章按 Windows 实际使用流程，把 Node.js 安装、Claude Code 安装、API 配置、常见报错排查串成一篇完整教程。小白直接操作即可上手。
正文
1. 安装 Node.js
Claude Code 依赖 Node.js 运行，最低要求是 Node.js 18，建议直接安装 LTS 版本。
方法一：官网下载
方法二：使用包管理器
如果你机器上已经装了对应工具，也可以直接执行：
# Chocolatey
choco install nodejs
# Scoop
scoop install nodejs
安装后执行下面的命令验证：
node –version
# 输出示例：v20.11.0
npm –version
# 输出示例：10.2.4
建议优先在 PowerShell 中操作。如果遇到权限问题，可以尝试以管理员身份打开终端。
2. 安装 Claude Code
在终端中执行：
npm install -g @anthropic-ai/claude-code
安装完成后，验证是否成功：
claude –version
如果已经能输出版本号，就可以进入 API 配置部分。
3. 配置 API 连接
3.1 获取 API Key
对于 API key，我这里用的是88api中转（https://api.88api.shop），比较方便。步骤：
拿到之后记得妥善保管，API Key 等同于你的身份凭证。
3.2 方法一：配置文件方式
推荐优先使用配置文件。
文件路径：
C:\\Users\\<你的用户名>\\.claude\\settings.json
配置内容：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的API密钥",
"ANTHROPIC_BASE_URL": "你的 88API Base URL"
}
}
创建步骤如下：
3.3 方法二：环境变量方式
如果你更习惯用环境变量，也可以这样配置。
PowerShell 临时设置当前会话：
$env:ANTHROPIC_BASE_URL = "你的 88API Base URL"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"
PowerShell 永久设置为用户级变量：
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "你的 88API Base URL", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)
设置后可用下面的命令检查是否写入成功：
$env:ANTHROPIC_BASE_URL
$env:ANTHROPIC_AUTH_TOKEN
注意：把 "你的API密钥" 换成实际创建的 Key。
如果你是在 VS Code、Cursor 这类 IDE 的集成终端中操作，设置完成后建议彻底重启整个 IDE，而不是只关掉一个终端窗口。
4. VSCode 插件配置（可选）
如果你同时使用 VSCode 的 Claude 插件，还需要补一个插件专用配置文件。
文件路径：
C:\\Users\\<你的用户名>\\.claude\\config.json
文件内容：
{
"primaryApiKey": "any"
}
创建步骤：
这里要区分清楚：config.json 是 VSCode 插件用的，settings.json 是 Claude Code 命令行工具用的，两者不是一个文件。
5. 开始使用
配置完成后，直接运行：
claude
如需查看支持的命令，也可以执行：
claude —help
6. 常见问题排查
问题：Unable to connect to Anthropic services
如果启动后出现这个报错，常见原因是首次启动引导没有完成。原始文档给出的处理方式是在用户根目录手动创建 .claude.json。
文件路径：
C:\\Users\\<你的用户名>\\.claude.json
文件内容：
{
"hasCompletedOnboarding": true
}
创建步骤如下：
调试技巧
如果仍然无法连接，可以继续检查：
总结
Windows 下安装 Claude Code 的流程本身不复杂，真正容易卡人的地方基本都集中在配置细节上，比如 .claude 目录位置、环境变量是否写对，以及 IDE 终端是否真正重新加载了配置。
把这篇里的顺序走完之后，通常就能把安装、API 接入和基础排错一次性跑通。如果后面遇到连接问题，优先检查路径、Key 和重启是否到位，往往比反复重装更有效。
