設定指南

中轉站設定指南

依工具瀏覽設定步驟與問題排查。

中轉站設定指南/CC-Switch 通用步驟

CC-Switch 通用步驟

CC Switch 是一個開源的 AI 編程 CLI 統一管理工具。它主要解決一個問題：你同時使用 Claude Code、Codex、Gemini CLI、OpenCode 等工具時，不想每個工具都單獨改一遍 Key、Base URL、模型名和 MCP 配置。

官方信息 下載和文檔以官方站點為準
官方網站 CC Switch 官方站點 安裝說明 下載安裝和 Homebrew GitHub 官方倉庫和 Releases

這個工具是什麼，用於什麼

它適合已經安裝了多個命令行 AI 編程工具的人。普通新手如果只用一個聊天軟件，不需要先學 CC Switch；如果你開始同時用 Claude Code、Codex CLI、Gemini CLI，再考慮用它統一管理 Provider。

適合什麼場景

多 CLI 共用服務商同一個中轉站或官方 API，需要同時給 Claude Code、Codex、Gemini CLI 使用。
經常切換 Provider比如白天用官方賬號，測試時切到中轉站，或者在不同項目裡切不同模型。
統一 MCP / SkillsCC Switch 官方說明裡也包含 MCP、Skills 等跨工具管理能力，新手先從 Provider 切換學起即可。

下載安裝和首次打開

先確認主界面 安裝完成後先打開主程序，確認左側能看到 Provider、MCP、Skills 等入口。新手先只處理 Provider，不要同時改 MCP 和提示詞。
CC Switch 主界面截圖
  1. 進入 CC Switch 官網或 GitHub Releases 下載當前版本。
  2. Windows 用戶選擇適合自己系統的安裝包；macOS / Linux 用戶按官方安裝說明操作。
  3. 安裝後先打開主程序，確認界面能正常加載。
  4. 如果系統攔截啟動，先確認來源是官方倉庫或官網，再按系統提示放行。

新增 Provider

新增 Provider 參考 這裡先確認新增 Provider 的入口和字段位置；不同目標 CLI 的字段會隨版本有細節差異。
CC Switch 官方倉庫中的新增 Provider 截圖
  1. 先分別確認 Claude Code、Codex CLI、Gemini CLI 這些工具本身已經能啟動。CC Switch 是管理工具，不是替你安裝所有 CLI。
  2. 從 CC Switch 官方倉庫或官網下載安裝包。不要從不明網盤下載。
  3. 打開 CC Switch，進入 Provider 或供應商管理頁面。
  4. 新增一個 Provider，名稱寫服務商名稱，例如“某某中轉站”。
  5. 把服務商後臺提供的 Base URL、API Key、模型名填進去。不同目標工具字段可能不同，按 CC Switch 當前頁面提示填寫。
  6. 保存後選擇要應用的目標工具，例如 Claude Code、Codex、Gemini CLI。
  7. 執行 Switch / Apply 之後，按提示重啟對應終端或 CLI。官方文檔說明多數工具切換後需要重啟，Claude Code 當前支持熱切換。
配置項怎麼填新手注意
Provider 名稱寫服務商或用途例如“主力中轉站”“備用官方 Key”，不要只寫 1、2、3
Base URL複製服務商後臺 API 鏈接按後臺示例決定是否帶 /v1
API Key複製完整 Key不要截圖公開，不要把備註名當 Key
模型名照抄模型列表Claude Code、Codex、Gemini CLI 可能需要不同模型名
目標工具選擇要同步的 CLI不是所有 Provider 都能適配所有工具，失敗時先只選一個工具測試

按目標 CLI 分別核對

目標工具先核對什麼詳情頁
Claude CodeClaude / Anthropic 接口地址、Key、Claude 模型名CC-Switch Claude Code
Codex CLIOpenAI / Codex 兼容地址、Key、Codex 可用模型名CC-Switch Codex
Gemini CLIGoogle / Gemini 或 Vertex 相關認證方式CC-Switch Gemini
CC-Switch-CLI沒有圖形界面時的命令行配置方式CC-Switch-CLI 使用
CC Switch 是統一管理入口，不代表一個 Provider 可以無差別套到所有 CLI。Claude、Codex、Gemini 的接口協議不同，失敗時先只選擇一個目標工具測試。

切換後怎麼測試

切換完成後，不要馬上處理真實項目。先在一個空目錄或測試項目裡發最短問題，確認請求確實走到你選的服務商。

切換後的最小測試命令
claude "請只回覆：配置成功" codex "請只回覆：配置成功" gemini "請只回覆：配置成功"
如果某個 CLI 仍然走舊配置，先關閉當前終端窗口，重新打開終端再試。不要同時手動改配置文件和用 CC Switch 改同一項。