cc-switch（CC Switch）安裝指南 — Linux 桌面版

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

cc-switch 是圖形介面 app（Tauri 2 製），需要桌面環境（Wayland 或 X11）。純命令列的伺服器（headless，無桌面）無法執行——那種情況請改用各工具的「手動設定檔」方式，或社群的 cc-switch-cli 專案。

開始之前

• 一台有桌面環境的 Linux（例如 Ubuntu 桌面），具 Wayland 或 X11。
• 視發行版選擇安裝包格式（見「一、安裝」）。
• 下載來源：cc-switch 官方 GitHub Releases https://github.com/farion1231/cc-switch/releases（官方網站：ccswitch.io）
• 安裝包檔名形如 CC-Switch-v{版本}-Linux-x86_64.deb／.rpm／.AppImage。

到 Releases 頁下載對應檔案後，依你的系統：

【Ubuntu／Debian／Linux Mint／Pop!_OS】用 .deb

下載 CC-Switch-*-Linux*.deb，在該檔所在資料夾開終端機：

sudo dpkg -i CC-Switch-*.deb
sudo apt-get install -f        # 若有相依套件問題，這行會自動補裝

（或一行搞定相依：sudo apt install ./CC-Switch-*.deb）

★ 常見：相依套件 libwebkit2gtk 缺失 ★

Ubuntu 桌面預設常「沒有」cc-switch 需要的圖形庫，第一次 dpkg -i 會看到：

cc-switch depends on libwebkit2gtk-4.1-0; however:
  Package libwebkit2gtk-4.1-0 is not installed.
dpkg: error processing package cc-switch ...

這是正常的，不是壞掉。接著執行下面這行，它會自動補裝 libwebkit2gtk 等相依套件，並完成 cc-switch 設定：

sudo apt-get install -f       # 問 Y/n 按 Y

若上面仍補不齊（不同 Ubuntu 版本套件名可能不同），手動裝再重試：

sudo apt-get update
sudo apt-get install -y libwebkit2gtk-4.1-0
sudo dpkg -i CC-Switch-*.deb

完成後確認：which cc-switch 應顯示 /usr/bin/cc-switch

【Fedora／RHEL／CentOS／Rocky Linux】用 .rpm

sudo rpm -i CC-Switch-*.rpm
# 或：sudo dnf install ./CC-Switch-*.rpm

【openSUSE】用 .rpm

sudo zypper install ./CC-Switch-*.rpm

【Arch Linux／Manjaro】用 AUR（推薦）或 AppImage

paru -S cc-switch-bin
# 或：yay -S cc-switch-bin

【其他發行版／不確定】用 .AppImage（通用，免安裝）

下載 CC-Switch-*-Linux*.AppImage，在該檔所在資料夾：

chmod +x CC-Switch-*.AppImage
./CC-Switch-*.AppImage

（AppImage 是綠色可攜檔，double-click 或用上面指令執行即可，不會寫進系統套件庫。）

從應用程式選單開啟「CC Switch」，或用上面的 AppImage 指令啟動。

啟動後：

• 視窗預設開在「Claude Code」面板。
• 系統匣（system tray）會出現 CC Switch 圖示。
• 視窗左上角的切換器會列出可管理的工具：Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent。

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

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

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

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

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

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

• 雙擊 .AppImage 沒反應 → 先 chmod +x 加執行權限；部分系統需安裝 FUSE（Ubuntu：sudo apt-get install libfuse2）。
• .deb 安裝報相依套件錯誤 → sudo apt-get install -f 自動補裝相依套件後即可。
• 視窗開不起來／無畫面 → 確認是桌面環境（有 Wayland 或 X11）。純命令列伺服器無法執行圖形 app，請改用各工具的手動設定檔方式。
• 更新 cc-switch → .deb／.rpm：下載新版安裝包重新安裝（覆蓋舊版）。AUR：paru -S cc-switch-bin（重跑即更新）。AppImage：下載新的 AppImage 取代舊檔。
• 設定備份 → cc-switch 設定存於 ~/.cc-switch/；升級大版本前可手動備份 ~/.cc-switch/cc-switch.db。

官方

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