安装和打开
供应商和 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 手动下载新安装包覆盖安装。