从0到1上手Claude Code：Windows安装+88api配置全流程

前言

最近整理了这篇实操文，从Node.js安装到Claude Code部署，再到API中转配置，一步步带大家在Windows环境下跑通。我这里用了88api作为接口中转，主要图个国内直连不用翻墙，还能统一管理多模型，省点环境配置的功夫。

正文

一、安装Node.js

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

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

访问Node.js官网，下载LTS版本安装包
双击安装包，按向导提示完成安装（一路默认下一步即可，建议勾选"Add to PATH"）

方法二：包管理器安装

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

bash 复制代码

# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs

验证安装

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

bash 复制代码

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

⚠️ 提示：如果遇到权限报错，尝试以管理员身份运行PowerShell；若提示"命令不存在"，检查Node.js是否已添加到系统PATH。

二、安装Claude Code

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

bash 复制代码

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

安装完成后验证：

bash 复制代码

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

三、配置API连接

前提：获取API Key

使用Claude Code需要API密钥，我这里用88api(官网：https://api.88api.shop)作为接口中转（大家可以用自己熟悉的平台）。注册后进入控制台，按以下步骤获取Key：

获取Key的步骤：

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

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

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

通过配置文件持久化保存API信息，步骤如下：

配置文件路径：

复制代码

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

配置内容：

json 复制代码

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

创建步骤：

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

方法二：环境变量

如果不想用配置文件，可通过环境变量临时或永久配置：

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

bash 复制代码

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

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

bash 复制代码

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

验证环境变量：

bash 复制代码

$env:ANTHROPIC_BASE_URL  # 应输出设置的URL
$env:ANTHROPIC_AUTH_TOKEN  # 应输出设置的Key

⚠️ 注意：配置完成后需重启终端；如果在VS Code/Cursor等IDE的集成终端使用，需彻底重启IDE（仅重启终端可能不生效）。

VSCode插件配置（可选）

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

配置文件路径：

复制代码

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

配置内容：

json 复制代码

{
  "primaryApiKey": "any"
}

创建步骤：

进入.claude文件夹（之前创建的）
新建config.json文件，粘贴上述内容保存

四、开始使用

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

powershell 复制代码

claude

首次启动会进入交互界面，可输入claude --help查看支持的命令（如代码解释、生成、优化等）。

五、常见问题排查

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

症状：启动后提示无法连接到Anthropic服务。

解决方案 ：这通常是首次启动引导未完成导致，需创建.claude.json跳过引导：

配置文件路径：

复制代码

C:\Users\<你的用户名>\.claude.json  # 注意是用户根目录，不是.claude文件夹内

配置内容：

json 复制代码

{
  "hasCompletedOnboarding": true
}

创建步骤：

进入用户根目录（C:\Users\<你的用户名>\）
新建.claude.json文件，粘贴上述内容保存
重启Claude Code

调试技巧：

检查网络连接是否正常
确认API Key和Base URL配置正确
重启终端或IDE后重试

总结

国内环境用Claude Code其实不难，核心就是Node.js环境+API中转配置。本文从安装到调用，把关键步骤和避坑点都列出来了，跟着做基本能一次跑通。如果遇到连接问题，优先检查配置文件路径和API Key是否正确，大部分报错都是这两个地方没弄对。

如果大家有其他好用的API中转方案，或者遇到新的问题，欢迎在评论区交流~