返回

客户端接入

Codex、Claude Code、CC Switch、Cherry Studio、OpenCode 接入 OMG Router

文章目录

客户端接入#

不同客户端对 Base URL 的要求不同。最常见的规则是：

  • OpenAI SDK / Codex：填写 https://api.omgrouter.cc/v1
  • Claude Code / Anthropic 协议：填写 https://api.omgrouter.cc
  • Cherry Studio 的 New API/OpenAI 兼容提供商：填写 https://api.omgrouter.cc
  • CC Switch 导入 Codex 时 endpoint 自动使用 /v1，导入 Claude/Gemini 时不带 /v1

Codex CLI#

安装：

npm install -g @openai/codex@latest
bash

配置目录：

系统路径
macOS / Linux~/.codex
Windows%USERPROFILE%\.codex

~/.codex/config.toml：

model_provider = "omgrouter"
model = "gpt-5.4-mini"
model_reasoning_effort = "medium"

[model_providers.omgrouter]
name = "OMG Router"
base_url = "https://api.omgrouter.cc/v1"
wire_api = "responses"
requires_openai_auth = true
web_search = "live"
toml

~/.codex/auth.json：

{
  "OPENAI_API_KEY": "sk-你的API令牌"
}
json

启动验证：

codex
bash

如果提示模型不可用，请确认 API Key 是 Codex 分组，并且 model 在控制台模型广场可见。

Claude Code#

安装：

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

推荐使用环境变量：

macOS / Linux：

export ANTHROPIC_BASE_URL="https://api.omgrouter.cc"
export ANTHROPIC_AUTH_TOKEN="sk-你的API令牌"
claude
bash

Windows PowerShell：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.omgrouter.cc", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的API令牌", "User")
claude
powershell

Claude Code 请使用 CC 分组令牌。第三方客户端调用 Claude 时使用 CC-N 分组。

CC Switch#

控制台令牌列表里可以打开「导入到 CC Switch」对话框，选择应用、模型和名称后导入。

导入规则：

应用endpoint
Codexhttps://api.omgrouter.cc/v1
Claudehttps://api.omgrouter.cc
Geminihttps://api.omgrouter.cc

手动导入 URL 示例：

ccswitch://v1/import?resource=provider&app=codex&name=OMG%20Codex&endpoint=https%3A%2F%2Fapi.omgrouter.cc%2Fv1&apiKey=sk-你的API令牌&model=gpt-5.4-mini&homepage=https%3A%2F%2Fapi.omgrouter.cc&enabled=true
text

打开 https://api.omgrouter.cc/ccswitch ↗ 返回的是前端页面。真正导入动作依赖本机 ccswitch:// 协议是否已由 CC Switch 注册。

Cherry Studio#

手动配置：

字段值
Provider 类型OpenAI Compatible / New API
API Keysk-你的API令牌
Base URLhttps://api.omgrouter.cc
Models从 /v1/models 或控制台模型广场选择

一键导入协议是：

cherrystudio://providers/api-keys?v=1&data=<URL编码后的base64配置>
text

配置 payload 结构：

{
  "id": "new-api",
  "name": "OMG Router",
  "type": "new-api",
  "baseUrl": "https://api.omgrouter.cc",
  "apiKey": "sk-你的API令牌"
}
json

生成导入链接：

const payload = {
  id: "new-api",
  name: "OMG Router",
  type: "new-api",
  baseUrl: "https://api.omgrouter.cc",
  apiKey: process.env.OMG_API_KEY,
};

const data = encodeURIComponent(
  Buffer.from(JSON.stringify(payload), "utf8").toString("base64")
);

console.log(`cherrystudio://providers/api-keys?v=1&data=${data}`);
js

如果浏览器没有弹出 Cherry Studio，请先确认 Cherry Studio 已安装并注册 cherrystudio:// 协议。

OpenCode#

OpenCode 使用 OpenAI 兼容配置时：

export OPENAI_API_KEY="sk-你的API令牌"
export OPENAI_BASE_URL="https://api.omgrouter.cc/v1"
opencode
bash

如果 OpenCode 使用配置文件，请将 provider 的 base URL 指向：

https://api.omgrouter.cc/v1
text

模型建议选择 Codex 分组中可见的代码模型。

Edit on GitHub