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

通过 AI 编程工具接入

APICAT 兼容 OpenAI 与 Anthropic 接口协议,适用于代码助手、Agent 工具、AI IDE 等多种场景。

在 Claude Code 中使用 APICAT(推荐)

安装 Claude Code

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

配置 APICAT API

WARNING

重要提示

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

  • ANTHROPIC_AUTH_TOKEN
  • ANTHROPIC_BASE_URL

API 配置

按以下方式手动编辑 Claude Code 配置文件:

// Step 1: 编辑或创建 Claude Code 的配置文件
// macOS & Linux 为 `~/.claude/settings.json`
// Windows 为 `用户目录/.claude/settings.json`
// `APICAT_API_KEY` 需替换为您的 APICAT API Key
// 环境变量 `ANTHROPIC_AUTH_TOKEN` 和 `ANTHROPIC_BASE_URL` 优先级高于配置文件
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.zeoapi.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "APICAT_API_KEY",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ANTHROPIC_MODEL": "example-coding-model",
    "ANTHROPIC_SMALL_FAST_MODEL": "example-coding-model",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "example-coding-model",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "example-coding-model",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "example-coding-model"
  }
}
// Step 2: 编辑或新增 `.claude.json` 文件
// macOS & Linux 为 `~/.claude.json`
// Windows 为 `用户目录/.claude.json`
// 新增 `hasCompletedOnboarding` 参数
{
  "hasCompletedOnboarding": true
}

启动 Claude Code

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

信任文件夹

启动后,选择 信任此文件夹 (Trust This Folder),以允许 Claude Code 访问该文件夹中的文件,随后开始在 Claude Code 中使用配置好的模型。

在 Claude Code for VS Code 插件中使用

安装插件

安装 Claude Code for VS Code 插件。

打开设置

完成安装后,点击 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/anthropic"
  },
  {
    "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"
  }
],

在 Cursor 中使用 APICAT

安装 Cursor

  1. 通过 Cursor 官网 下载并安装 Cursor
  2. 打开 Cursor,右上角“设置”按钮,进入设置界面。点击“Sign in”按钮,登录自己的 Cursor 账户

在 Cursor 中配置 APICAT API

WARNING

重要提示:使用前请先清除 OpenAI 环境变量

在配置前,请确保清除以下 OpenAI 相关的环境变量,以免影响 APICAT API 的正常使用:

  • OPENAI_API_KEY
  • OPENAI_BASE_URL

WARNING

注意:Cursor 仅支持订阅高级会员及以上的用户配置自定义模型

若非Cursor高级会员,配置时将出现以下错误:

The model does not work with your current plan or api key

  1. 点击左侧栏的 "Models",进入模型配置页面
  2. 展开 "API Keys" 部分,配置 API 信息:
    • 勾选 "Override OpenAI Base URL"
    • 在下方输入 APICAT 的调用地址 https://www.zeoapi.com/v1
  3. OpenAI API Key 输入框,配置您的 APICAT API Key
  4. 点击 “OpenAI API Key” 栏右侧的按钮
  1. 在弹出的窗口中点击 “Enable OpenAI API Key” 按钮,完成设置验证
  1. Models 板块中,点击 “View All Models” 按钮,并点击 “Add Custom Model” 按钮
  1. 输入你要使用的模型名称后,点击“Add”按钮
  1. 启用刚添加的模型
  2. 在聊天面板中选择刚添加的模型,开始使用

INFO

如果您出现模型没有返回任何内容的问题,可尝试通过将 Cursor 中的 "Network" 设置更改为 HTTP/1.0 解决。

在 TRAE 中使用 APICAT

安装 TRAE

下载并安装 TRAE

访问 Trae 官网 下载并安装 TRAE。

完成初始设置

TRAE 首次启动时,你会进入以下页面,请根据指引完成初始设置。

登录 TRAE

登录 TRAE。

选择可用模型

TRAE 中国版若页面中直接显示可用模型,可直接选用。

在 TRAE 中使用自定义模型

TRAE 还支持通过 API Key 接入自定义模型,从而满足个性化的需求。

打开设置

在 AI 对话框右上角,点击 设置 图标。

选择模型页签

添加模型

点击 + 添加模型 按钮,选择服务商 APICAT,模型填写你要使用的模型名称。

INFO

若当前分组下未显示可用模型,请检查 API Key 所绑定分组是否已开放对应模型。

填写 API 密钥

完成添加

点击 添加模型 按钮。

INFO

TRAE 将调用服务商的接口来检测 API 密钥是否有效。可能的结果如下:

  • 若连接成功,该自定义模型会被添加。
  • 若连接失败,添加模型窗口中展示错误信息和服务商返回的错误日志,你可以参考这些信息排查问题。

在 OpenCode 中使用 APICAT

安装 OpenCode

  • 使用 curl 安装 OpenCode
curl -fsSL https://opencode.ai/install | bash
  • 使用 npm 安装 OpenCode
npm i -g opencode-ai

更多信息请参考 OpenCode 官网

使用内置模型

若列表中已显示可用模型,可直接选用。

配置 APICAT API

运行认证命令

opencode auth login

选择 Provider

当提示选择 provider 时,搜索并选择 "APICAT(payapionline.top)"

输入 API Key

当提示输入 API 密钥时,输入您的 APICAT API Key

开始使用

回到命令行界面,输入 opencode 开始使用已配置模型。

其他配置方式:

编辑配置文件

编辑 OpenCode 的配置文件,路径为 ~/.config/opencode/opencode.json,将以下配置添加到配置文件中:

WARNING

重要提示:使用前请先清除 Anthropic 环境变量

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

  • ANTHROPIC_AUTH_TOKEN
  • ANTHROPIC_BASE_URL
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "APICAT": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://www.zeoapi.com/anthropic/v1",
        "apiKey": "your-api-key (可选)"
      },
      "models": {
        "example-coding-model": {
          "name": "example-coding-model"
        }
      }
    }
  }
}

启动 OpenCode

进入项目目录,启动 opencode

cd /path/to/your/project

opencode

选择模型

输入 /models,选择已配置模型并在 OpenCode 中开始使用。

在 Kilo Code 中使用 APICAT

安装 Kilo Code

  1. 打开 VS Code,点击左侧活动栏中的扩展图标,在搜索框中输入 Kilo Code
  2. 点击 Install 按钮进行安装,安装完成后,可能需要重启 VS Code

在 Kilo Code 中配置 APICAT API

WARNING

重要提示:使用前请先清除 Anthropic 环境变量

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

  • ANTHROPIC_AUTH_TOKEN
  • ANTHROPIC_BASE_URL
  1. 点击"Settings"按钮,进入参数配置界面
  1. API Provider -> 选择"APICAT"
  2. APICAT Entrypoint -> www.zeoapi.com
  3. APICAT API Key 输入您的 API Key
  4. Model 选择你要使用的模型
  5. 依次点击右上角的"Save"和"Done"按钮,保存配置
  1. 开始使用 APICAT

在 OpenClaw 中使用 APICAT

OpenClaw(原 Clawdbot) 是一个开源的 AI 助手,完全本地化,可以将各种消息平台与 AI 模型连接起来。它支持 WhatsApp、Telegram、Discord、iMessage 等多种平台,让您可以随时随地与 AI 助手对话。

INFO

安装 Openclaw

WARNING

openclaw老用户,建议也先通过以下安装命令对openclaw进行更新。

在终端中运行以下命令一键安装:

curl -fsSL https://openclaw.bot/install.sh | bash

配置 APICAT 模型

选择配置选项

如果openclaw的初始配置引导没有出现模型配置,则可以通过以下命令再次进行 openclaw 配置:

openclaw configure

选择配置选项

  • Where will the Gateway run? → 选择 Local (this machine)
  • Select sections to configure → 选择 Model
  • Model/auth provider → 选择 APICAT
  • APICAT auth method → 选择 APICAT CN — OAuth (payapionline.top)
前端配置界面

登录授权

自动弹出登录页,登录并授权。

前端配置界面

确认模型选择

OAuth 登录完成后,进入模型选择。若列表中已显示可用模型,可直接按回车确认使用。

前端配置界面

测试对话

输入 openclaw tui,若成功对话则表示配置成功:

测试对话

在 Cline 中使用 APICAT

安装 Cline

  1. 打开 VS Code,点击左侧活动栏中的扩展图标,在搜索框中输入 Cline
  2. 点击 Install 按钮进行安装,安装完成后,可能需要重启 VS Code
  1. 完成安装后,可以在左侧活动栏中看到 "Cline" 的图标

WARNING

若已安装 Cline,请升级至 3.47.0 或更高版本,并重启插件和 VS code 以确保正常使用。

在 Cline 中配置 APICAT API

WARNING

重要提示:使用前请先清除 Anthropic 环境变量

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

  • ANTHROPIC_AUTH_TOKEN
  • ANTHROPIC_BASE_URL
  1. 点击"Use your own API key"按钮,进入 Cline 的参数配置界面
  2. API Provider -> 选择"APICAT"
  3. APICAT Entrypoint -> www.zeoapi.com
  4. APICAT API Key -> 输入您的 API Key
  5. 点击右上角的 "Done",保存配置
  1. 勾选 Auto-approve 中的"Edit"选项框,开始使用“example-coding-model”

在 Roo Code 中使用 APICAT

安装 Roo Code

  1. 打开 VS Code,点击左侧活动栏中的扩展图标,在搜索框中输入 Roo Code
  2. 点击 Install 按钮进行安装,安装完成后,可能需要重启 VS Code

在 Roo Code 中配置 APICAT API

  1. 点击"Settings"按钮,进入参数配置界面
  1. API Provider -> 选择"APICAT"
  2. APICAT Entrypoint -> www.zeoapi.com
  3. APICAT API Key 输入您的 API Key
  4. Model 选择你要使用的模型
  5. 依次点击右上角的"Save"和"Done"按钮,保存配置
  1. 开始使用 APICAT

在 Grok CLI 中使用 APICAT(不推荐)

安装 Grok CLI

  1. 使用 npm 全局安装 Grok CLI
npm install -g @vibe-kit/grok-cli

在 Grok CLI 中配置 APICAT API

WARNING

重要提示:使用前请先清除 OpenAI 环境变量

在配置前,请确保清除以下 OpenAI 相关的环境变量,以免影响 APICAT API 的正常使用:

  • OPENAI_API_KEY
  • OPENAI_BASE_URL
  1. 通过环境变量配置 URL 和 API Key
export GROK_BASE_URL="https://www.zeoapi.com/v1"
export GROK_API_KEY="your-api-key"
  1. 使用指定模型启动 Grok CLI
grok --model your-model-name

在 Droid 中使用 APICAT

安装 Droid

对于 Mac/Linux 用户,请使用以下指令安装:

curl -fsSL https://app.factory.ai/cli | sh

对于 Windows 用户,请使用以下指令安装:

irm https://app.factory.ai/cli/windows | iex

更多信息可参考 Droid 文档

在 Droid 中配置 APICAT API

WARNING

重要提示:使用前请先清除 Anthropic 环境变量

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

  • ANTHROPIC_AUTH_TOKEN
  • ANTHROPIC_BASE_URL
  1. 使用以下指令,更新 Droid 配置文件,该配置文件的路径为 ~/.factory/config.json

INFO

提示:

  • 配置文件的路径为 ~/.factory/config.json, 并非 ~/.factory/settings.json
  • 清空 ANTHROPIC_AUTH_TOKEN 环境变量,否则会覆盖 .factory/config.json 中的 API Key 并导致错误
{
    "custom_models": [
        {
            "model_display_name": "example-coding-model",
            "model": "example-coding-model",
            "base_url": "https://www.zeoapi.com/anthropic",
            "api_key": "your-api-key",
            "provider": "anthropic",
            "max_tokens": 64000
        }
    ]
}
  1. 进入项目目录,启动 Droid
cd /path/to/your/project
droid
  1. 输入 /model, 选择 “example-coding-model” 模型,并在 Droid 中使用

在 Zed 中使用 APICAT

安装 Zed

按照 Zed 官方文档 完成 Zed 安装配置。

配置 APICAT API

进入智能体面板

点击右下角 ✨ 号进入智能体面板:

进入配置页面

点击右上角三点标志进入 setting 进行配置:

添加 LLM Provider

找到 LLM Provider 模块,点击 +Add Provider 并在出现的下拉框中选择 OpenAI 进行模型添加:

填写配置信息

进入添加面板,根据以下信息填写:

配置项
Provider Name根据需要设置
API URLhttps://www.zeoapi.com/v1
API Key从官网获取的 API Key,请参考快速开始进行获取
Model Nameexample-coding-model(示例占位)

其他配置根据个人使用需要变更。

完整配置参考如下:

保存配置

点击 Save Provider 保存,LLM Provider 已包含我们配置好的 APICAT,点击 APICAT,再次输入您的 API Key,并按 Enter 保存:

选择模型并开始使用

返回智能体面板,点击右下角 Select a Model,选择刚刚配置好的模型:

即可使用 APICAT 模型进行辅助开发工作。

在 MonkeyCode 中使用 APICAT

在 MonkeyCode 中配置 APICAT API

进入任务页面

登录后,点击「开始使用」按钮,进入 MonkeyCode 智能开发平台任务页面:

进入系统配置页面

点击页面右下角「配置」按钮,进入系统配置页面:

绑定 AI 大模型

在 AI 大模型模块中,点击「绑定」按钮:

配置 APICAT 模型

依次执行以下操作来绑定个人模型:

配置项
模型 API 地址将默认 URL 替换为 APICAT Coding 专属接口地址:https://www.zeoapi.com/anthropic
API KeyAPICAT 开放平台 获取
接口格式类型选择 anthropic
模型名称填写或选择你的模型名称(文档示例使用 example-coding-model

完成上述配置后,点击页面「保存」按钮,确认所有设置生效:

使用 APICAT 模型

返回 MonkeyCode 主界面,输入 Prompt 后,点击「执行」按钮,即可调用配置好的模型:

常见问题

API Error

API Error: Cannot read properties of undefined (reading 'map')

请按以下步骤检查:

  1. 确保已正确设置 API Host: https://www.zeoapi.com
  2. 确认已将 your-api-key 替换为你在 APICAT 开放平台APICAT 控制台获取的真实 API Key。
  3. 如果使用 Claude Code 或 Droid,请清除环境变量:ANTHROPIC_AUTH_TOKEN
  4. 如果在 VSCode 或 Cursor 中使用 Claude Code,请确保配置模型名称正确,详见在 Claude Code for VS Code 插件中使用
  5. 触发速率限制,请稍后再试。

如果以上方法仍未解决问题,请联系我们: