ZeoAPIZeoAPI API 文档与接入指南
api-access

Claude Code

在 Claude Code 中接入 ZeoAPI。

安装 Claude Code

可参考 Claude Code 文档 进行安装。

WARNING

前置准备：安装 Claude Code 前，请先安装 Node.js。下载地址：Node.js 官网

node

Windows 的安装比其他系统多一步：需要先安装 Git for Windows。这一点很多教程不会提前说清楚，不少人会在第一步就卡住。

第一步：安装 Git for Windows

git 下载后按默认选项安装即可，根据自己需要决定是否修改安装路径。安装完成后验证：

git --version

能输出版本号就说明成功了。

第二步：安装 Claude Code

以管理员身份打开 PowerShell 或 CMD，命令执行：

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

第三步：添加 PATH 环境变量（关键！）

WARNING

这是 Windows 上最容易踩的坑。如果不加 PATH，终端会找不到 claude 命令。很多"明明装好了但还是不能用"的问题，最后都是出在这一步。

添加方式：

  1. 按 Win 键（左下角开始按钮），输入 "环境变量" 搜索并打开
  2. 点击 「环境变量」 → 选中 Path → 点击 「新建」，输入以下路径：

huanjingbianliang

C:\Users\你的用户名\.local\bin

设置完成后，必须重启 PowerShell 终端（或直接重启电脑）。

第四步：验证安装

重新打开一个终端窗口：

claude --version

能输出版本号，Windows 安装就完成了。✅

直接执行 claude 我们发现会报错。这是因为ClaudeCode工具会校验位置信息。国内是无法使用的，但是我们可以通过修改配置，来绕过这个校验。 claude-error

找到C盘下。claude的json配置文件。路径：C:\Users\ username.clause.json 。添加 json

"hasCompletedOnboarding": true,

add

claude

配置 ZeoAPI API

WARNING

重要提示：

在配置前，请确保清除以下 Anthropic 相关的环境变量，以免影响 ZeoAPI API 的正常使用：

  • ANTHROPIC_AUTH_TOKEN
  • ANTHROPIC_BASE_URL

API 配置

CC-Switch 是一个便捷的桌面工具，可以快速切换 Claude Code 等 CLI 工具的 API 配置，同时支持管理 MCP、Prompts、Skills 与会话历史。

1. 安装 CC-Switch

从 Releases 页面下载最新版本：

  • CC-Switch-v{版本号}-Windows.msi（安装包）
  • CC-Switch-v{版本号}-Windows-Portable.zip（绿色版）

系统要求：Windows 10 及以上。

TIP

CC-Switch macOS 版本已通过 Apple 代码签名和公证，可直接安装打开。

启动 CC-Switch 后，可以看到主页面。如果是首次使用，可以导入现有配置或点击 「添加供应商」 开始配置。

CC-Switch 主页

2. 添加 ZeoAPI 配置

启动 CC-Switch，点击 「添加供应商」，选择预设的 ZeoAPI 供应商，并填写您的 API Key。

CC-Switch 请求配置

3. 配置模型名称

将模型名称全部改为您要使用的模型名称，完成后点击右下角的 「添加」。

CC-Switch 模型配置

4. 启用配置

  • 主界面：选择供应商 → 点击 「启用」
  • 系统托盘：直接点击供应商名称（立即生效）

添加成功后，在主界面会看到我们配置的分组，在右侧点击“启用”按钮，显示“使用中”，则配置完成。 Claude Code 无需重启即可生效，其他 CLI 工具需重启终端。 CC-Switch 成功

5. 修改通用配置

点击左上角“设置”按钮，在通用页面下拉找到 跳过 Claude Code初次安装确认 ，务必勾选。

CC-Switch 通用

TIP

更多功能：CC-Switch 还支持管理 MCP 服务器、Prompts 预设、Skills 安装以及会话历史浏览。首次启动时可手动导入现有 CLI 工具配置作为默认供应商。如需恢复官方登录，添加"官方登录"预设，重启 CLI 工具后按照其登录/OAuth 流程操作。

启动 Claude Code

配置完成后，进入工作目录，在终端中运行 claude 命令以启动 Claude Code。

看到对话界面并能正常回复即表示配置完成。

Hellocc

在 Claude Code for VS Code 插件中使用

安装插件

安装 Claude Code for VS Code 插件。

打开设置

完成安装后，可以直接使用cc switch进行模型配置。

若无安装cc switch，则点击 Settings。

配置模型

配置模型为你要使用的模型名称。

  • Settings → Claude Code: Selected Model 输入你要使用的模型名称

或者

  • 点击 Edit in settings.json，进入配置文件，修改 claude-code.selectedModel 为你要使用的模型名称
{
    "claudeCode.selectedModel": "example-coding-model",
  "claudeCode.environmentVariables": []
}

配置环境变量

  • 若已安装 Claude Code，请参考上方配置进行环境变量配置
  • 若尚未安装 Claude Code，点击 Edit in settings.json

将 claudeCode.environmentVariables 变量更改为以下设置：

"claudeCode.environmentVariables": [
  {
    "name": "ANTHROPIC_BASE_URL",
    "value": "https://www.zeoapi.com/"
  },
  {
    "name": "ANTHROPIC_AUTH_TOKEN",
    "value": "your-api-key"
  },
  {
    "name": "API_TIMEOUT_MS",
    "value": "3000000"
  },
  {
    "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
    "value": "1"
  },
  {
    "name": "ANTHROPIC_MODEL",
    "value": "example-coding-model"
  },
  {
    "name": "ANTHROPIC_SMALL_FAST_MODEL",
    "value": "example-coding-model"
  },
  {
    "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
    "value": "example-coding-model"
  },
  {
    "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
    "value": "example-coding-model"
  },
  {
    "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
    "value": "example-coding-model"
  }
],