工具集成/CC-Switch 接入

把 UniGateway 接入 CC-Switch。

CC-Switch 接入

CC-Switch 是一款桌面工具,可在单一界面中为 Claude Code、Codex、Gemini CLI 等编码工具切换 AI 供应商配置。通过将 CC-Switch 接入 UniGateway,你可以通过单一统一端点访问多种模型,实现集中密钥管理、自动回退,且无需修改任何上游 SDK。

前置条件

  • 有效的 UniGateway API Key
  • 已安装 CC-Switch

安装 CC-Switch

根据你的操作系统选择对应的安装方式:

  • macOS — 通过 Homebrew 安装或手动下载安装包
  • Windows — 下载 MSI 安装包或使用便携版
  • Linux — 使用 .deb 包或 AppImage

配置

启动 CC-Switch 后,在头部导航选择对应的编码工具,点击"添加供应商"按钮,填写配置信息后点击切换按钮激活供应商。

以下为三种编码工具的配置方式。

Claude Code(Anthropic 协议)

字段值
Provider NameUniGateway
Base URLhttps://api.unigateway.ai
API Key你的 UniGateway API Key

配置模型映射:

角色模型 ID
Haikuclaude-haiku-4-5
Sonnetclaude-sonnet-4-6
Opusclaude-opus-4-7

Codex(OpenAI 协议)

字段值
Provider NameUniGateway
Base URLhttps://api.unigateway.ai/v1
API Key你的 UniGateway API Key

在 Codex 的 config.toml 中配置:

model_provider = "unigateway"
model = "gpt-5.5"

[model_providers.unigateway]
name = "UniGateway"
base_url = "https://api.unigateway.ai/v1"
env_key = "UNIGATEWAY_API_KEY"
wire_api = "responses"

Gemini CLI(Vertex AI 协议)

字段值
Provider NameUniGateway
Base URLhttps://api.unigateway.ai
API Key你的 UniGateway API Key

通过环境变量配置:

export GEMINI_API_BASE="https://api.unigateway.ai"
export GEMINI_API_KEY="your-unigateway-api-key"

最后验证

在 CC-Switch 中切换到刚配置的 UniGateway 供应商,在对应编码工具中发起一个新请求,如能成功收到回复则配置成功。