Claude Code完整安装+API配置教程（Windows系统）

前言

我整理了一套Claude Code从基础安装到API配置的完整步骤，亲测Windows系统下能顺利运行，小白跟着做基本不会踩坑。

正文

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

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

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

访问Node.js官网，下载LTS版本安装包
双击安装包，按向导提示完成安装（默认选项即可，无需额外配置）

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

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

bash 复制代码

# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs

验证安装是否成功

打开PowerShell（建议管理员模式），输入以下命令，能显示版本号即安装成功：

bash 复制代码

node --version
# 示例输出：v20.11.0（版本号可能因下载版本不同略有差异）

npm --version
# 示例输出：10.2.4

⚠️ 注意：若遇权限报错，尝试以管理员身份运行PowerShell；命令无效可能是环境变量未刷新，重启终端即可。

二、安装Claude Code

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

bash 复制代码

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

安装完成后验证：

bash 复制代码

claude --version
# 成功会显示当前版本号，如：1.0.0（版本号以实际安装为准）

三、配置API连接（以88api为例）

获取API Key

调用Claude需要API接口，我最近用的是 88api中转（https://api.88api.shop）获取 API。或者大家也可以用自己的，获取Key的步骤如下：

1.注册登录以后，点击页面上方的"控制台"，然后进入后再点击侧边栏的 "API 令牌"

2.点击添加令牌

创建令牌

名称随便写，没有含义，直接点击提交即可。

获取 API KEY

获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。

点击"知道了"，可以看到我们刚才创建的，在这里也同样可以点击复制按钮去获取 API Key。

配置API参数（两种方法任选）

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

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

打开文件资源管理器，进入路径：C:\Users\<你的用户名>\（将<你的用户名>替换为实际系统用户名）
新建文件夹.claude（若已存在则跳过）
在.claude文件夹中新建settings.json文件，粘贴以下内容：

json 复制代码

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",  // 替换为刚复制的88api Key
    "ANTHROPIC_BASE_URL": "https://api.88api.shop",  // 88api接口地址
    "ANTHROPIC_MODEL": "claude-fable-5"  // 指定使用最新的Claude-Fable-5模型
  }
}

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

若不想用配置文件，可通过环境变量设置（PowerShell中操作）：

临时生效（当前会话）：

bash 复制代码

$env:ANTHROPIC_BASE_URL = "https://api.88api.shop"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"  # 替换为实际Key
$env:ANTHROPIC_MODEL = "claude-fable-5"  # 指定Claude-Fable-5模型

永久生效（用户级）：

bash 复制代码

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.88api.shop", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-fable-5", [System.EnvironmentVariableTarget]::User)

⚠️ 重要：配置完成后需重启终端（或彻底重启VS Code等IDE），否则配置可能不生效。

VSCode插件配置（可选）

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

进入路径：C:\Users\<你的用户名>\.claude\
新建config.json文件，内容如下：

json 复制代码

{
  "primaryApiKey": "any"
}

四、启动Claude Code并使用

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

powershell 复制代码

claude

首次启动若提示引导未完成，按提示操作即可。若需查看支持的命令，输入：

powershell 复制代码

claude --help

💡 小技巧 ：若要临时切换模型，可在命令后加--model参数，例如：claude --model claude-fable-5。

五、常见问题排查

问题：启动后提示"Unable to connect to Anthropic services"

原因：首次启动引导流程未完成。

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

json 复制代码

{
  "hasCompletedOnboarding": true
}

保存后重启Claude Code即可。

其他排查方向：

检查API Key是否正确（重点核对是否有空格或字符缺失）
确认网络连接正常（国内直连88api无需翻墙）
重启终端或IDE后重试

总结

这套流程从Node.js环境搭建到API配置，再到最新Claude-Fable-5模型调用，覆盖了国内环境下运行Claude Code的核心步骤。关键在于API配置时填对Key和接口地址，以及通过环境变量或配置文件指定模型。如果按步骤操作仍有问题，欢迎在评论区留言，我会尽量帮忙解答。希望这篇教程能帮你少踩坑，顺利用上Claude的新功能！