Windows版Claude Code安装与API对接教程(附常见问题解决)

目录

• 前言
• 一、安装Node.js
• 方法一：官网下载（推荐）
• 方法二：包管理器安装
• 验证安装
• 二、安装Claude Code
• 三、配置API连接
• 前提：获取API Key
• 方法一：配置文件（推荐）
• 方法二：环境变量（临时/永久）
• VSCode插件配置（可选）
• 四、开始使用
• 五、常见问题排查
• 问题：启动后提示“Unable to connect to Anthropic services”
• 总结

最近整理了这篇实操记录，从Node.js安装到Claude Code部署，再到国内API中转配置，每一步都附了具体命令和路径。我用88api作为接口中转，解决了国内直连问题，省去了海外账号注册的麻烦，亲测能跑通。如果你也是Windows用户，想少踩坑快速上手，跟着步骤走应该能搞定。

Claude Code依赖Node.js环境，最低要求Node.js ≥18（建议用LTS版本，稳定性更好）。

1. 访问Node.js官网，下载Windows LTS版本（比如v20.x）
2. 双击安装包，按向导默认安装即可（建议勾选“Add to PATH”，自动配置环境变量）

如果习惯命令行，可用Chocolatey或Scoop安装：

# Chocolatey
choco install nodejs
# Scoop
scoop install nodejs

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

node --version  # 输出v18.x或更高
npm --version   # 输出版本号即正常

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

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

安装完成后验证：

claude --version  # 输出版本号即成功

使用Claude Code需要API Key，我这次用的是88api作为接口中转（官网：https://api.88api.shop）。它支持国内直连，不用翻 墙和海外账号，还能统一管理多个模型的Key，切换模型只需改一行配置，对国内用户比较友好。

获取Key的步骤：
1.注册并登录后，点击侧边栏“API令牌”。

2. 点击“添加令牌”

3. 选择分组
   1. 根据需要调用的模型选择分组
      a. claude 模型建议使用 calude code 分组、
      b. gpt 模型建议使用 codex分组
   2. 可通过平台的模型广场查看不同模型支持的分组
   3. 若在使用中出现上游分组饱和，请切换分组使用

4.点击提交

5. 点击复制按钮复制API令牌，也就是API KEY

通过配置文件永久保存API信息，路径固定：

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

创建步骤：

1. 打开文件资源管理器，进入C:Users<你的用户名>目录（比如C:Users张三）
2. 新建文件夹.claude（注意文件夹名前有个点）
3. 在.claude文件夹内新建settings.json文件，粘贴以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",  // 替换为刚复制的Key
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"  // 88api的接口地址
  }
}

如果不想用配置文件，可通过环境变量设置（适合临时测试）。

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

$env:ANTHROPIC_BASE_URL = "https://api.88api.shop"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"  # 替换为实际Key

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  # 输出https://api.88api.shop
$env:ANTHROPIC_AUTH_TOKEN  # 输出你的Key

注意：配置后需重启终端（或IDE，如VS Code需彻底重启）才能生效！

如果用VSCode的Claude插件，需额外创建config.json文件：
路径：C:Users<你的用户名>.claudeconfig.json
内容：

{
  "primaryApiKey": "any"
}

创建步骤和settings.json类似，在.claude文件夹内新建文件粘贴即可。

配置完成后，在PowerShell中输入：

claude

即可启动Claude Code。输入claude --help可查看支持的命令（比如代码解释、生成、优化等）。

原因：首次启动可能因引导流程未完成导致连接失败。

解决：在用户根目录（C:Users<你的用户名>）创建.claude.json文件，内容：

{
  "hasCompletedOnboarding": true
}

保存后重启Claude Code即可。

调试技巧：

1. 检查网络是否正常（国内用户确保用中转API，如88api）
2. 确认API Key和Base URL配置正确（对比settings.json或环境变量）
3. 重启终端/IDE后重试

本文从Node.js安装到Claude Code部署，再到国内API中转配置，完整覆盖了Windows环境下的实操步骤。核心解决了两个痛点：一是提供了清晰的Windows路径和命令，二是通过88api中转解决了国内直连问题。

如果按步骤操作仍有问题，建议重点检查Node.js版本（≥18）、配置文件路径（.claude文件夹位置）和API Key是否填对。动手试试吧，Claude Code的本地代码辅助能力还是挺实用的，有问题欢迎留言交流~

以上就是Windows版Claude Code安装与API对接教程(附常见问题解决)的详细内容，更多关于Claude Code安装与API对接的资料请关注风君子博客其它相关文章！