配置指南

CC Switch 统一配置

从一个桌面界面管理 Claude Code、Codex 和兼容的客户端配置文件。

安装 CC Switch

CC Switch 是可选的第三方配置管理器。从项目发布页面下载它,或者在 macOS 上使用 Homebrew 安装它。

如果您不想使用配置管理器,则可以手动完成每个设置。
macOS
brew tap farion1231/ccswitchbrew install --cask cc-switch

添加 OmniGateway 提供商

  1. 打开 CC Switch 并选择要配置的客户端。
  2. 选择添加提供商或添加配置,然后选择自定义提供商。
  3. 输入 OmniGateway 作为提供商名称,并从控制台粘贴 API 地址。
  4. 粘贴专用 API 密钥并选择可用于其令牌组的模型。
  5. 保存并激活提供商,然后完全重新启动终端或 IDE。
设置项值
提供商名称OmniGateway
API 密钥在控制台中创建的密钥
模型模型广场 的准确模型 ID

匹配协议和基本 URL

  • Claude Code 通常使用 Anthropic Messages 协议和不带尾随 /v1 的基本 URL。
  • Codex 通常使用 Responses 协议和以 /v1 结尾的基本 URL。
  • 通用 OpenAI 客户端通常使用 Chat Completions 和以 /v1 结尾的基本 URL。
  • 令牌组、模型 ID 和协议必须描述相同的路由。

激活并验证配置文件

  1. 关闭可能仍保存旧环境变量的每个终端和 IDE 窗口。
  2. 打开一个新会话并启动配置的客户端。
  3. 在生产项目中使用配置文件之前发送简短的测试请求。
  4. 检查控制台请求日志,确认模型和费用。