CC Switch 管理 Claude Code / Codex 中轉站配置教程

它解決什麼問題

如果你只用 Claude Code,並且只接一個服務商,手動設置環境變量就夠了。

CC Switch 這類工具適合更復雜的場景:

• 同時使用 Claude Code、Codex、Gemini CLI、OpenCode 等工具
• 經常在官方賬號、中轉站、本地模型之間切換
• 想把 provider、API Key、Base URL、MCP、Prompt、Skills 放在一個地方管理
• 想減少手動改 settings.json、config.toml 和 shell profile 的次數

它不是新的 AI 編程工具,而是 AI 編程 CLI 的本地控制台。

推薦的使用方式

先不要一上來就導入一堆配置。更穩的流程是:

1. 先手動跑通 Claude Code 或 Codex 的最小配置。
2. 確認 Base URL、API Key、模型名都沒問題。
3. 再把這套配置錄入 CC Switch。
4. 每次切換後,重新打開對應 CLI 或終端會話,確認配置已生效。

這樣出了問題時,你知道是服務商接口沒通,還是切換工具沒有同步成功。

配置時看這幾個字段

• Provider 名稱: 給自己看的,建議寫清楚服務商和協議。
• Base URL: 嚴格按服務商文檔填寫,尤其注意 /v1。
• API Key / Token: 區分 OpenAI Key、Anthropic Key 和 Bearer Token。
• 模型名: 不要默認以為 claude-sonnet、gpt-5 這些別名都可用。
• 作用工具: 同一個 provider 可能只適合 Claude Code,不一定適合 Codex。

一個實用原則

切換工具負責“管理配置”,不負責“保證接口兼容”。真正決定能不能跑通的,還是服務商是否支持對應 CLI 需要的協議、模型和流式能力。