CC-Switch · 通用步驟

CC-Switch 是一個開源的 Claude Code / Codex / Gemini CLI 設定管理工具。它用圖形介面幫你管理各 CLI 的供應商設定、一鍵切換,免去手動編輯設定檔。

CC-Switch 是第三方開源工具,非天樞官方維護。安裝前可自行查看其開源倉庫。

它能做什麼

• ✅ 一鍵切換 API 設定 —— 在多個供應商之間快速切換
• ✅ 視覺化設定管理 —— 圖形介面管理所有設定
• ✅ MCP 伺服器管理
• ✅ 系統匣快捷操作

軟體下載

前往 CC-Switch 的 GitHub Releases 頁面下載對應系統的安裝包:

Windows

訪問 GitHub Releases,選擇 .msi 安裝包下載並安裝。
安裝後執行 CC-Switch 主程式。

macOS (Homebrew)

# 新增 tap 源
brew tap farion1231/ccswitch
# 安裝 CC-Switch
brew install --cask cc-switch
# 完成後在「啟動台 / 應用程式」中找到 CC-Switch 啟動

Linux (Debian/Ubuntu)

# 到 GitHub Releases 查看最新版本號,替換下面的檔名
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_x.x.x_amd64.deb
sudo dpkg -i cc-switch_x.x.x_amd64.deb

先完成環境檢查

請勿跳過

CC-Switch 只是幫你管理設定,真正執行模型仍相依於 Node.js 和對應 CLI(Claude Code / Codex)。請先完成 環境檢查與 CLI 安裝,確保 node、claude、codex 都能正常執行。

把天樞加為自訂供應商

CC-Switch 內建了一些供應商範本,天樞需要你手動新增為自訂供應商:

• 供應商名稱:天枢 / tianshu(自訂)
• 介面位址(Base URL):見各 CLI 教學(Claude Code 用 https://tian-shu.org,Codex 用 https://tian-shu.org/v1)
• API Key:在 控制台 → 權杖管理 建立、選對分組的權杖

下一步

按 CLI 類型繼續:

• CC-Switch · Claude Code 設定
• CC-Switch · Codex 設定