> ## 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.

# Grok

> Configure Grok CLI, local ~/.grok/config.toml, or a third-party provider.

Grok uses local `grok`. Open **Settings → CLI configuration → Grok CLI** to detect the version, install, and configure credentials.

## How to connect

1. **Use local config**: read `~/.grok/config.toml` directly. Override the config directory with `$GROK_HOME`
2. **Add provider**: name, base URL, API key, model. Enabling it writes that `config.toml` (backed up first as `config.toml.bak`)
3. You can override the `grok` executable path
4. If it is not installed, click **Install** on that page, or install with the terminal commands below

<Note>
  Config stays on this computer. The app does not upload keys to a CC GUI server.
</Note>

## Add a provider

Click **Add** and fill in:

* Name, base URL, API key, model
* API backend: Chat Completions / Responses / Messages (Anthropic)
* Optional: max context length, display name, notes

Quick preset: xAI (official). You can fetch the model list from the remote.

The hosted provider catalog is `~/.ccgui/config.json`. Click **Use local config.toml** and that file is left unchanged.

## Install

```bash theme={null}
curl -fsSL https://x.ai/cli/install.sh | bash
grok --version
```

Grok has no npm release and no official uninstaller. On Windows, run this command in WSL; in-app **Install** is not available on Windows.

Docs: [https://x.ai/cli](https://x.ai/cli)

## Capability differences

Compared with Claude Code:

* No plan mode
* Does not use desktop MCP
* Supports reasoning strength, session continue, and image input
* Stop ends the `grok` child process
* History is isolated per runtime

## When detect fails

See [Detect and install](/en/desktop/providers/cli).

## Next steps

* [Provider overview](/en/desktop/providers/overview)
* [Send the first message](/en/desktop/start/first-task)