安裝和開啟
供應商和 CLI
提示未配置供應商
提示未配置供應商
開啟 設定 → CLI配置管理，為當前引擎新增供應商、使用本地配置，或先安裝對應 CLI。
CLI 一直顯示未安裝
CLI 一直顯示未安裝
客戶端不會靜默代裝。可在 CLI配置管理 裡點 安裝（先確認計劃），或先在系統終端確認命令可用，再回到設定重新檢測。GUI 啟動的程序可能讀不到 shell
PATH，把路徑寫入系統環境變數後重啟客戶端。詳見 檢測與安裝。設定裡看到 Gemini 卻配不了
設定裡看到 Gemini 卻配不了
Gemini 等引擎當前在「暫未開放」分組。README 裡「Gemini 預設啟用」的表述已過時，以設定頁為準，不要按已交付 runtime 排查。
配置檔案在哪
配置檔案在哪
供應商目錄在
~/.ccgui/config.json。Claude 託管供應商只寫這裡，不改 ~/.claude/settings.json（本地官方配置可選用）。Codex 啟用後寫入 ~/.codex/。Kimi / Grok 啟用第三方會寫入各自 config.toml（先備份 .bak）。OpenCode 託管供應商走環境注入，不改 opencode.json。Pi 寫 ~/.pi/agent/auth.json。DSH 的模型和 Key 在 Web UI / $DSH_HOME，不進 CC GUI。客戶端設定與工作區在應用 data 目錄。效能和冷啟動
Windows 安裝後前幾秒點不動
Windows 安裝後前幾秒點不動
較新版本已修復冷啟動點選假死。請升級到最新版；版本記錄會延後到 startup-gate-ready 後再彈出。
長會話越來越卡
長會話越來越卡
客戶端對長會話做了 DOM 視窗與增量 Markdown。仍卡時，新開會話或摺疊舊訊息，並升級到最新版。
介面縮放調不了
介面縮放調不了
產品側已永久鎖定 100% UI scale，以避免 WebView 假死路徑。這是預期行為。
更新
如何更新
如何更新
客戶端內建自動更新。也可以從 Releases 手動下載新安裝包覆蓋安裝。