cc-switch（CC Switch）安裝指南 — macOS 版

本指南目標：在 macOS 安裝 cc-switch（多工具 API 設定切換的圖形管理工具），之後用它來設定 Claude Code、Codex 等工具連接 MYAI168。

cc-switch 是圖形介面 app（Tauri 2 製）。本指南以 Homebrew Cask 安裝為主，另附手動下載 .dmg 的方式。

開始之前

• macOS（Apple Silicon 或 Intel 皆可）。
• 建議已安裝 Homebrew（https://brew.sh）；沒有也可用方式 B 手動下載。
• 官方來源：GitHub Releases https://github.com/farion1231/cc-switch/releases、官方網站 ccswitch.io

cc-switch 已收錄於 Homebrew 官方 cask，開「終端機」直接安裝即可（不需再加私人 tap）：

brew install --cask cc-switch

安裝完成後，從「啟動台／應用程式」開啟「CC Switch」。

（若 brew 找不到 cask 或安裝失敗，先 brew update 後重試，或改用方式 B 手動下載。）

1. 到 Releases 頁下載 macOS 版安裝檔（副檔名 .dmg；現行版本為單一通用檔，Apple Silicon 與 Intel 皆適用）。
2. 雙擊 .dmg，把「CC Switch」拖進「應用程式（Applications）」資料夾。
3. 第一次開啟若被 Gatekeeper 擋（「無法打開，因為無法驗證開發者」）：到「系統設定 → 隱私權與安全性」，找到被攔下的 CC Switch，按「仍要打開」；或在應用程式上按右鍵→打開→再按一次打開。

開啟「CC Switch」後：

• 視窗預設開在「Claude Code」面板。
• 選單列（menu bar）會出現 CC Switch 圖示。
• 視窗左上角的切換器會列出可管理的工具：Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent。
• 若你已用過這些工具，cc-switch 通常會自動匯入既有設定。

建議設定（可選）：進 Settings → General，視需要開啟開機自啟、最小化到選單列等選項。

cc-switch 只是「設定管理工具」，本身不含各 AI 工具。要先各自安裝好 Claude Code／Codex 等 CLI，再用 cc-switch 設定它們連 MYAI168。

各工具的安裝與 MYAI168 設定，請參考開發者中心的對應分頁：

• Claude Code → 見「Claude Code CLI macOS」分頁
• Codex → 見「Codex CLI macOS」分頁
• Hermes → 見「Hermes Agent macOS」分頁（注意：cc-switch 對 Hermes 寫入可能失效，Hermes 建議手動設定）

設定共通要點（在 cc-switch 各工具分頁新增供應商時）

• Claude Code → 端點 https://www.myai168.com/nccu/api/anthropic（不含 /v1），模型 claude-opus-4-8，金鑰用 apiKeyHelper 或 ANTHROPIC_API_KEY 提供皆可（見 Claude Code 分頁）。
• Codex → 端點 https://www.myai168.com/nccu/api/openai/v1，模型 gpt-5.6-sol。

若只用 Claude Desktop（圖形對話，不碰終端機），cc-switch 的 Claude Desktop 分頁可直接設定，並支援「一鍵從 Claude Code 匯入供應商」。

• Gatekeeper 擋住「無法驗證開發者」 → 系統設定 → 隱私權與安全性 → 對 CC Switch 按「仍要打開」；或右鍵→打開。
• brew 安裝失敗／找不到 cask → 先執行 brew update 更新 Homebrew 後重試（cc-switch 在官方 cask，不需加 tap）；或改用方式 B 下載 .dmg。
• 「未設定官方網站／No Routing Support」標籤 → 正常，只代表你用的是自訂端點（MYAI168），不影響使用。
• 更新 cc-switch → Homebrew：brew upgrade --cask cc-switch；手動下載：下載新版 .dmg 覆蓋安裝。
• 設定備份 → cc-switch 設定存於 ~/.cc-switch/；升級大版本前可手動備份 ~/.cc-switch/cc-switch.db。

官方

• https://github.com/farion1231/cc-switch
• https://github.com/farion1231/cc-switch/releases