告别海外账号！Claude Code Windows完整部署指南：从Node.js到api对接（附避坑）

前言

这篇文章针对小白，会从Node.js环境搭建开始，到Claude Code安装、API配置，再到常见问题处理，全程基于Windows系统，用国内可直接访问的接口方案，尽量帮你少走弯路，快速上手。

正文

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

Claude Code运行依赖Node.js环境，最低要求Node.js ≥18（建议选LTS稳定版）。

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

访问Node.js官网，下载Windows LTS版本安装包
双击安装包，按向导完成安装（默认选项即可，会自动配置环境变量）

方法二：包管理器安装（适合熟悉命令行的用户）

如果已安装Chocolatey或Scoop，可直接用命令安装：

bash 复制代码

# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs

验证安装

打开PowerShell（建议管理员模式），输入以下命令检查版本：

bash 复制代码

node --version  # 输出v18.x.x或更高
npm --version   # 输出对应npm版本

⚠️ 提示：若遇权限报错，右键PowerShell选择"以管理员身份运行"即可。

二、安装Claude Code

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

bash 复制代码

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

安装完成后验证：

bash 复制代码

claude --version  # 输出类似 0.1.0 的版本号，说明安装成功

三、配置API连接（核心步骤）

前提：获取API Key

调用Claude模型需要API Key，我最近用的是88api(官网：https://api.88api.shop)作为接口中转（省去海外账号和翻墙麻烦，国内直连）。大家有自己的也可以。

这里以88api为例：

获取Key的步骤：

注册并登录后，点击侧边栏"API令牌"。
点击"添加令牌"
选择分组
1. 根据需要调用的模型选择分组
  a. claude 模型建议使用 calude code 分组、
  b. gpt 模型建议使用 codex分组
2. 可通过平台的模型广场查看不同模型支持的分组
3. 若在使用中出现上游分组饱和，请切换分组使用
点击提交
5. 点击复制按钮复制API令牌，也就是API KEY

方法一：配置文件（推荐，永久生效）

在用户目录下创建配置文件，步骤如下：

配置文件路径 （替换<你的用户名>为实际系统用户名）：

复制代码

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

配置内容 （替换你的API密钥为实际复制的Key）：

json 复制代码

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://aicode.cat"
  }
}

创建步骤：

打开文件资源管理器，进入C:\Users\<你的用户名>\目录
新建文件夹.claude（若已存在则跳过）
在.claude文件夹中新建settings.json文件，粘贴上述配置并保存

方法二：环境变量（临时或永久）

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

PowerShell临时设置（仅当前会话生效）：

bash 复制代码

$env:ANTHROPIC_BASE_URL = "https://aicode.cat"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"

PowerShell永久设置（用户级，重启终端生效）：

bash 复制代码

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://aicode.cat", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)

验证环境变量：

bash 复制代码

$env:ANTHROPIC_BASE_URL  # 输出 https://aicode.cat
$env:ANTHROPIC_AUTH_TOKEN  # 输出你的API密钥

⚠️ 重要：配置后需重启终端，若在VS Code/Cursor等IDE中使用，需彻底重启IDE（仅重启终端可能不生效）。

VSCode插件配置（可选）

如果使用VSCode的Claude插件，需额外创建config.json：

配置文件路径：

复制代码

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

配置内容：

json 复制代码

{
  "primaryApiKey": "any"
}

创建步骤 ：同方法一，在.claude文件夹中新建config.json并粘贴上述内容。

四、开始使用Claude Code

配置完成后，在PowerShell中输入以下命令启动：

powershell 复制代码

claude

首次启动会进入交互界面，可直接输入问题或代码需求。如需查看命令帮助：

powershell 复制代码

claude --help

五、常见问题排查

问题：Unable to connect to Anthropic services（无法连接服务）

症状：启动后提示无法连接到Anthropic服务。
解决方案 ：创建.claude.json文件跳过引导流程：

文件路径：

复制代码

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

配置内容：

json 复制代码

{
  "hasCompletedOnboarding": true
}

创建步骤 ：在用户根目录（非.claude文件夹）新建.claude.json，粘贴上述内容保存，重启Claude Code即可。

调试技巧：若仍无法连接，检查网络、重启IDE或重新核对API Key是否配置正确。

总结

本文从Node.js环境搭建到Claude Code安装，再到API配置和常见问题处理，提供了一套完整的Windows本地部署方案，尤其适合国内用户（无需海外账号和翻墙）。核心在于API配置的准确性，以及环境变量/配置文件的正确生效。

如果按步骤操作仍遇到问题，欢迎在评论区留言，我会尽量回复。技术工具配置虽繁琐，但一步步跟着做，总能跑通------这也是我写这篇教程的初衷。