前言

最近想试试 Claude Code 辅助编程，结果找了一圈教程，不是步骤不全就是默认海外环境，国内配置总出问题。其实很多人卡在环境搭建和 API 调用这两步，尤其是新手对着零散教程容易越弄越乱。

这篇文章整理了我自己实操通过的完整流程，从 Node.js 安装到 API 配置，再到常见问题处理，尽量写得详细，希望能帮大家少走弯路。

正文

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

Claude Code 需要 Node.js 环境支持，最低要求 Node.js ≥18（建议选 LTS 版本，更稳定）。

方法一：官网下载（推荐）

1. 访问 Node.js 官网 下载 LTS 版本安装包
2. 双击安装包，按向导提示完成安装（一路默认下一步即可）

方法二：包管理器安装

如果习惯用包管理器，可以通过以下命令安装：

# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs

验证安装

安装完成后，打开终端输入以下命令，出现版本号即表示安装成功：

node --version
# 输出示例：v20.11.0

npm --version
# 输出示例：10.2.4

⚠️ 提示：建议使用 PowerShell 终端；如果遇到权限问题，尝试以管理员身份运行终端。

二、安装 Claude Code

Node.js 环境就绪后，通过 npm 全局安装 Claude Code：

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

安装完成后验证：

claude --version
# 出现版本号即安装成功

三、配置 API 连接

获取 API Key

使用 Claude Code 需要 API 密钥，我这次选择 88api 作为中转接口（https://api.88api.shop），主要是为了避免海外账户和网络配置的麻烦。或者大家也可以用自己的。

以下是获取 API Key 的步骤：

1. 注册登录以后，点击侧边栏的 “API 令牌”

2. 点击"添加令牌"

3. 创建令牌，名称随意，直接提交

4. 获取 API Key，注意妥善保管，不要公开或分享。

5. 点击"知道了"，在令牌列表中可以点击"复制"按钮获取 API Key

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

通过配置文件设置 API 信息，步骤如下：

配置文件路径：

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

配置内容：

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

创建步骤：

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

方法二：环境变量

如果不想用配置文件，也可以通过环境变量配置：

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

创建步骤：

1. 进入 C:\Users\<你的用户名>\.claude\ 目录（如果 .claude 文件夹不存在，先按方法一创建）
2. 新建文件 config.json，粘贴上述内容并保存

⚠️ 提醒：这是 VSCode 插件专用的 config.json，与 Claude Code 命令行工具的 settings.json 是两个不同文件，不要混淆。

四、开始使用 Claude Code

配置完成后，在终端输入以下命令启动 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 配置是否正确（参考“配置 API 连接”章节）

总结

到这里，Claude Code 在 Windows 上的安装和配置就完成了。核心步骤是 Node.js 环境准备、Claude Code 安装、API 密钥配置，最后通过命令启动使用。国内环境下用 API 中转能省不少事，遇到连接问题记得检查配置文件和引导设置。如果大家在操作中遇到其他问题，欢迎在评论区交流，我会尽量回复。