一个界面管理 Codex、Claude 与 Gemini。
CC Switch 是一个开源、跨平台的 AI 编程工具配置管理器。通过可视化界面管理供应商、Base URL、API Key 和协议设置，减少手动修改配置文件的麻烦。
为什么推荐 CC Switch？
当你同时使用多个 AI 编程客户端时，CC Switch 能把散落的配置集中到一个可视化界面中。
从“改配置文件”变成“选择并启用”。
Codex、Claude Code 和 Gemini CLI 的配置文件位置、字段名称和接口方式并不完全相同。CC Switch 负责管理这些差异，让供应商切换和配置维护更加直观。
根据操作系统选择安装包。
下载文件类型可能随版本变化，请始终以 GitHub Releases 页面显示的最新资产为准。
先选择你要配置的客户端。
不同应用使用的协议和 Base URL 可能不同。不要把 Codex、Claude Code 与 Gemini CLI 的配置机械地写成完全相同。
Codex 配置
适用于 Codex CLI 或 Codex App。优先使用 OmniDino 的 OpenAI 兼容地址，并根据模型所需端点选择 Responses 或兼容模式。
Claude Code 配置
Claude Code 通常使用根地址，由客户端或 CC Switch 生成具体的 Claude 请求路径，因此不要在根地址后重复追加 OpenAI 的 /v1。
Gemini CLI 配置
先确认 OmniDino 当前提供的 Gemini 路由及协议类型，再在 Gemini CLI 对应应用中填写。模型名称必须与控制台展示完全一致。
其他兼容工具
OpenCode、OpenClaw、Hermes 等工具可能使用 OpenAI Chat Completions 或其他协议。先选择对应应用，再根据该应用的字段填写。
/v1 的地址。从 OmniDino 到客户端启用。
下面以通用流程说明，具体字段请配合上方对应应用的配置卡片。
准备账户、余额和 API Key
登录 OmniDino 控制台，确认余额可用，并为 CC Switch 或具体客户端创建独立 API Key。
安装并打开 CC Switch
从官方 GitHub Releases 下载适合系统的版本，完成安装后打开应用。
先选择目标应用
在顶部应用区域选择 Codex、Claude Code、Gemini CLI、OpenCode 或其他真实目标。应用类型决定配置文件和协议逻辑。
新增 OmniDino 供应商
点击新增供应商或“+”，选择自定义配置，供应商名称填写 OmniDino。
填写地址、密钥、协议和模型
按照目标应用填写 Base URL。Codex 和 OpenAI 兼容工具通常使用带 /v1 的地址，Claude Code 通常填写根地址。
保存并设为当前启用配置
仅保存配置不一定代表已经切换成功。确认供应商卡片显示为启用或当前配置。
重启目标客户端并测试
完全关闭原来的终端或客户端窗口，再重新打开并发送简单请求，同时检查 OmniDino 控制台是否出现调用记录。
最容易填错的配置项。
| 配置项 | OmniDino 建议 | 说明 |
|---|---|---|
| Provider Name | OmniDino |
只是本地显示名称，可以增加 Codex、Claude 等后缀方便区分。 |
| Codex Base URL | https://api.omnidino.com/v1 |
用于 OpenAI 兼容或 OmniDino Codex 路由。 |
| Claude Base URL | https://api.omnidino.com |
Claude Code 通常填写根地址，避免重复拼接路径。 |
| API Key | 控制台创建的独立密钥 | 不要使用截图展示完整 Key，也不要提交到公开仓库。 |
| Wire API | 根据应用选择 Responses、Claude 或兼容协议 | 协议选错可能导致 404、请求转换失败或返回格式异常。 |
| Model | 模型广场中的实际名称 | 区分大小写、连接符和版本后缀，不要自行猜测模型名。 |
CC Switch 可以管理哪些工具？
具体应用范围会随版本演进，下面列出当前页面重点覆盖的工具类型。
配置失败时先检查这里。
OmniDino 配置仍然失败？
发送邮件时请提供操作系统、CC Switch 版本、目标客户端、模型名称、Base URL 和完整错误信息。请隐藏 API Key。
[email protected]