> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mossx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Fix common install, provider, CLI detect, cold-start, and auto-update issues.

Match the prompt you see below. If it still fails, send the repro steps to [GitHub Issues](https://github.com/zhukunpenglinyutong/desktop-cc-gui/issues).

## Install and open

<AccordionGroup>
  <Accordion title="Where do I download it">
    Open [Releases](https://github.com/zhukunpenglinyutong/desktop-cc-gui/releases) and pick `dmg` / `exe` / `AppImage` for your platform.
  </Accordion>

  <Accordion title="I opened it and do not know where to start">
    **Add project** first, configure a provider in Settings, then send the first message. See [Send the first message](/en/desktop/start/first-task).
  </Accordion>
</AccordionGroup>

## Providers and CLI

<AccordionGroup>
  <Accordion title="It says the provider is not configured">
    Open **Settings → CLI configuration**. Add a provider for the current engine, use local config, or install the matching CLI first.
  </Accordion>

  <Accordion title="CLI stays not installed">
    The app does not silently install for you. In **CLI configuration**, click **Install** (confirm the plan first), or confirm the command works in a system terminal and come back to Settings to detect again. A GUI launched from a launcher may not see your shell `PATH`. Write the path into system environment variables and restart the app. Details: [Detect and install](/en/desktop/providers/cli).
  </Accordion>

  <Accordion title="I see Gemini in Settings but cannot configure it">
    Gemini and similar engines currently sit in the **Coming soon** group. The README line that Gemini is enabled by default is outdated. Trust the Settings page, and do not troubleshoot them as shipped runtimes.
  </Accordion>

  <Accordion title="Where are the config files">
    The provider catalog is `~/.ccgui/config.json`. Claude hosted providers write only there and do not change `~/.claude/settings.json` (you can still choose local official config). Enabling Codex writes `~/.codex/`. Enabling a third-party Kimi / Grok provider writes each `config.toml` (backed up as `.bak` first). OpenCode hosted providers use env injection and do not change `opencode.json`. Pi writes `~/.pi/agent/auth.json`. DSH models and keys live in the Web UI / `$DSH_HOME`, not in CC GUI. App settings and workspaces live in the app data directory.
  </Accordion>
</AccordionGroup>

## Performance and cold start

<AccordionGroup>
  <Accordion title="On Windows it does not respond for the first few seconds after install">
    Newer versions fix the cold-start click freeze. Upgrade to the latest build. Version notes wait until startup-gate-ready before they pop up.
  </Accordion>

  <Accordion title="Long sessions get slower">
    The app uses a DOM window and incremental Markdown for long sessions. If it is still slow, start a new session or collapse old messages, and upgrade to the latest build.
  </Accordion>

  <Accordion title="I cannot change UI zoom">
    The product permanently locks UI scale at 100% to avoid a WebView freeze path. This is expected.
  </Accordion>
</AccordionGroup>

## Updates

<AccordionGroup>
  <Accordion title="How do I update">
    The app has built-in auto-update. You can also download a new installer from Releases and overwrite the install.
  </Accordion>
</AccordionGroup>