CC Switch
CC Switch 是一款开源、跨平台的 AI CLI 统一管理桌面工具。它支持一键切换 Claude Code、Codex 和 Gemini CLI 的模型端点，集中管理跨应用的 MCP 服务器与系统提示词（Prompts），让开发者告别繁琐的手动配置文件编辑。
⚡ 一键唤起导入（推荐）
CC Switch 原生支持 ccswitch:// Deep Link 协议。您无需手动复制粘贴参数，在 OpenRely 控制台中即可一键完成端点注入：
在 OpenRely API 密钥管理页 中，点击任意密钥右侧操作菜单，选择 「CC Switch」 选项，系统将自动唤起 CC Switch 客户端并预填好 Base URL 与密钥。
🔑 准备
1登录控制台
api.openrely.ai/sign-in前往 ↗
2获取 API Key
api.openrely.ai/keys
sk-...3填写服务地址点击复制
https://api.openrely.ai/v1
🚀 步骤
安装 CC Switch
根据您的操作系统选择安装方式，或直接前往 GitHub Releases 下载最新安装包：
brew tap farion1231/ccswitch
brew install --cask cc-switch从 GitHub Releases 下载 .msi 安装包或解压即用的绿色便携版 .zip。
适用于无图形界面的远程开发服务器或 SSH 终端环境：
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch-web-linux-x64.tar.gz
tar -xzf cc-switch-web-linux-x64.tar.gz
cd cc-switch-web/
./cc-switch-web启动后在本地浏览器访问 http://<服务器IP>:17666 即可打开 Web 管理看板。
配置 OpenRely 服务商
您可以通过控制台一键唤起，也可以在 CC Switch 界面中手动添加服务商并填写以下配置项：
| 配置项 | 推荐填写值 | 说明 |
|---|---|---|
| 目标应用 | Claude / Codex / Gemini | 选择您当前需要切换的 AI CLI 工具 |
| 服务商名称 | OpenRely | 自定义识别标签 |
| API 服务地址 | https://api.openrely.ai/v1 | 务必包含 /v1 后缀 |
| API 密钥 | sk-... | 在 OpenRely 控制台创建的专属访问令牌 |
| 模型配置 | 自由选取 | 从下拉菜单选择或手动输入模型标识符 |
一键切换并开启使用
- 点击弹窗右下角的 「打开 CC Switch」（或保存），即可将配置持久化存入对应 CLI 的配置环境中；
- 在 CC Switch 主面板中，点击对应 Provider 右侧的开关即可一键切换当前激活的 API 端点；
- 打开终端运行
claude或codex，即可直接通过 OpenRely 网关开始沉浸式编程。
💡 核心管理能力
| 功能模块 | 说明 |
|---|---|
| 🔌 Provider 管理 | 一键切换 Claude Code、Codex、Gemini 的 API 端点与密钥，支持多节点延迟测速 |
| 🛠️ MCP 服务器管理 | 跨应用统一管理 MCP 服务，支持 stdio、HTTP、SSE 三种协议及双向同步 |
| 💬 Prompts 管理 | 集中维护跨应用的系统提示词（CLAUDE.md、AGENTS.md、GEMINI.md）与快速预设 |
| 🔄 跨端自动同步 | 本地修改即时同步生效至各 CLI 工具的原生配置文件中 |
❓ 常见问题
遇到其他调用报错或计费疑问？请查阅完整的 常见问题与排障指南。
这篇文档对您有帮助吗？