小白也能装好的 Claude Code Windows 教程：从 Node.js 到 api 接入，手把手跑通全流程

前言

这篇是 Windows 环境下从零开始的完整操作记录，Node.js 安装、Claude Code 安装、API Key 获取与配置（用的是 88api 中转，国内直连省掉很多麻烦）、VSCode 插件额外配置，以及最常见的启动报错解法，全都在这里。

正文

1. 安装 Node.js

Claude Code 需要 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

3. 配置 API 连接

获取 API Key

我这里用的是 88api 中转站（网址：https://api.88api.shop），有免费额度可以先试用，国内直连不需要额外处理网络。推荐大家可以试试，或者大家也可以用自己的。

下面以88 API 为例：

方法一：配置文件（推荐）

配置文件路径：

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

配置内容：

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

创建步骤：

方法二：环境变量

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"
}

创建步骤：

⚠️ 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
}

创建步骤：

💡 如果配置后仍然无法连接，依次检查：网络是否正常、终端或 IDE 是否已完全重启、API Key 是否配置正确。

总结

这篇把 Windows 上配好 Claude Code 的完整流程走了一遍：Node.js 安装（含包管理器方式）、Claude Code 安装、API Key 获取与配置（配置文件和 PowerShell 环境变量两种方式），以及 VSCode 插件的额外配置和首次启动报错的解法。

Windows 和 Mac 的主要差别在路径格式和环境变量设置方式，配置文件用 C:\\Users\\<用户名>\\.claude\\ 这个路径，PowerShell 永久设置用 SetEnvironmentVariable 方法。其他地方基本一致。有问题欢迎评论区交流。