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 工具的原生配置檔案中 |
❓ 常見問題
遇到其他呼叫報錯或計費疑問？請查閱完整的 常見問題與排障指南。
這篇文件對您有幫助嗎？