CallAPI 客户端接入指南

地址与鉴权对照表

工具	协议类型	推荐地址	鉴权方式
Claude Code	Anthropic 兼容	`https://callapi8.com`	`ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN`
Codex	OpenAI Responses	`https://callapi8.com/v1`	`OPENAI_API_KEY`
OpenCode	OpenAI / Anthropic	OpenAI 用 `https://callapi8.com/v1` Anthropic 用 `https://callapi8.com/v1`	在 `/connect` 中保存 API Key
Cherry Studio	OpenAI 兼容	`https://callapi8.com`	界面中填写 API Key
Open WebUI	OpenAI 兼容	`https://callapi8.com/v1`	界面中填写 API Key

如果你把地址填错，最常见的现象就是：模型列表拉不出来、连接测试失败、返回 404 或模型不存在。

Claude Code

Claude Code 走的是 Anthropic 协议，所以这里应该填根地址 https://callapi8.com，不要写成 https://callapi8.com/v1。

环境变量方式

export ANTHROPIC_BASE_URL="https://callapi8.com"
export ANTHROPIC_API_KEY="YOUR_API_KEY"

如果你的环境更适合走 Bearer 头，也可以改成：

export ANTHROPIC_BASE_URL="https://callapi8.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

优先尝试 ANTHROPIC_API_KEY，如果网关只接受 Bearer，再切到 ANTHROPIC_AUTH_TOKEN。不要两个一起配。

Codex

Codex 推荐通过 ~/.codex/config.toml 配自定义 provider，地址要写 https://callapi8.com/v1。

export OPENAI_API_KEY="YOUR_API_KEY"

model_provider = "callapi"
model = "gpt-5.4"
model_reasoning_effort = "high"

[model_providers.callapi]
name = "callapi"
base_url = "https://callapi8.com/v1"
wire_api = "responses"
requires_openai_auth = true

启动示例：

codex -m gpt-5.4
codex exec -m gpt-5.4 "用一句话确认连通性"

OpenCode

OpenCode 支持同时接 OpenAI 风格和 Anthropic 风格 provider。对 CallAPI 来说，最稳妥的方式是在 opencode.json 里同时配上两套地址。

第一步：保存 API Key

按 OpenCode 官方当前文档，优先使用 /connect 保存凭证。

第二步：配置 provider

配置文件通常位于 ~/.config/opencode/opencode.json。可参考下面的写法：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://callapi8.com/v1"
      }
    },
    "openai": {
      "options": {
        "baseURL": "https://callapi8.com/v1"
      }
    }
  }
}

如果你在 OpenCode 里主要使用 Claude 系模型，可以优先走 anthropic provider；如果主要使用 GPT / Codex 系模型，可以优先走 openai provider。

模型名仍然以你在 CallAPI 账号下实际可见的模型为准。最稳妥的做法仍然是先请求一次 /v1/models 再复制模型名。

CC Switch

如果你用 CC Switch 来统一管理 Claude Code、Codex 等 CLI，当前实例也支持这种接入方式。

CallAPI 控制台的快捷接入列表里已经包含 CC Switch。如果你的本机已经安装客户端，可以直接通过 Deep Link 拉起并导入配置。

手动填写时怎么选地址

如果目标是 Claude Code：优先填 https://callapi8.com
如果目标是 Codex：优先填 https://callapi8.com/v1
API Key 统一填写你在 CallAPI 控制台生成的令牌

如果你不确定 CC Switch 当前对应的是哪种 CLI，直接对照本页的 Claude Code 和 Codex 两节处理即可。

Cherry Studio

对这类 NewAPI / OneAPI 风格网关，Cherry Studio 推荐填根地址，不要填完整的 /v1/chat/completions 路径。

服务商选择 OpenAI
API 地址填写 https://callapi8.com
API Key 填你的 CallAPI 令牌
模型优先尝试自动获取，失败时手动从 /v1/models 复制

Open WebUI

Open WebUI 这里推荐直接填完整的 OpenAI 兼容 API URL： https://callapi8.com/v1。

进入 Admin Settings
打开 Connections
进入 OpenAI
选择 Add New Connection
API URL 填 https://callapi8.com/v1
API Key 填你的 CallAPI 令牌

如果模型没有自动出现，可以手动把 /v1/models 返回中的模型名加入 Model IDs (Filter)。