Skip to content

Using Grok App as a coding assistant

Besides using them as chat models, this site's Grok group (models grok-4.5 / grok-4.6) can also be used as a coding assistant. Connect Grok to your local CLI and you get engineering capabilities close to Codex / Claude Code: reading and writing files, running commands, and viewing Git diffs.

We recommend pairing it with the open-source desktop client Grok App — it provides a graphical workbench for the local Grok Build CLI (managing multiple projects, parallel sessions, file editing, permission modes, Git diff viewing).

Read this first

  • Grok App is a community open-source project, not an official xAI product, and not a product of this site; this site only provides the Grok channel and configuration instructions.
  • Only get the installer from the official website or GitHub Releases; once installed, you can verify its integrity with SHA256SUMS.

Step 1: Get this site's Grok configuration

  1. Log in to this site and go to the "API Keys" page
  2. Create a new key and select "Grok" as the group (or "Grok Free")
  • Keys and groups correspond one-to-one: using a key from the GPT group to call Grok will fail
  1. Click "Use Key / Use" for this key, select Grok CLI as the client, and copy the generated configuration.

There are just two core items; you will fill in these two values in Grok App later:

ParameterValue
API Base URLhttps://kuaiapi.net/v1
API KeyYour Grok group key (starts with sk-)
Model namegrok-4.6

Step 2: Install Grok App

  1. Open the official website https://grok-app.com/ or GitHub Releases
  2. Download according to your system: on Windows use *-setup.exe (or the portable zip); on macOS choose the aarch64 / x64 dmg based on your chip; on Linux use AppImage / deb / rpm
  3. Open it after installation; the application name is Grok

Step 3: Prepare the local Grok Build CLI

Grok App is a graphical interface; the real work is done by the local Grok Build CLI, so you need the grok command available on your machine:

  • Version requirement: 0.2.112 or higher; you can upgrade by running grok update in the terminal
  • When you start Grok App for the first time, the wizard checks whether the CLI is installed on your machine and offers one-click installation.
  • Windows requires WebView2 Runtime (usually built into Windows 11; if it is missing, the installer will guide you through installing it)

When your network is restricted

Installing the CLI / logging in to your official account for the first time may require access to xAI's official services. If your network cannot connect directly, configure an HTTP/SOCKS proxy in Grok App under Settings → Runtime Environment → Network, and click "Test Connection".

Step 4: Point Grok at this site

In Grok App's relay / provider (Provider) configuration, select Custom (custom relay) mode and fill in the values from Step 1:

  • API address: https://kuaiapi.net/v1
  • API Key: your Grok group key
  • Model: grok-4.6

TIP

  • The entry name in the app may vary slightly by version; follow the in-app wizard, and fill it in according to the configuration generated by "Use Key" on this site.
  • If you want to keep the existing official CLI login state, use the app's separate configuration mode, and do not overwrite the existing configuration in ~/.grok on this machine.

Step 5: Verification

  1. Create or trust a project directory in Grok App
  2. For permission mode, choose Ask first (confirm before each action, safer; consider a more permissive mode once you have confirmed everything works)
  3. Send a message, for example: take a look at what files are in this directory

If it responds normally and you can see the tool call process, the setup is successful.

FAQ

Won't open / reports "damaged" (macOS) Go to "System Settings → Privacy & Security" and allow it to open; or clear the quarantine attribute:

bash
xattr -cr /Applications/Grok.app
open /Applications/Grok.app

Windows reports unknown publisher Click "More info → Run anyway". It is recommended to verify the hash with SHA256SUMS and confirm that WebView2 is installed.

Linux AppImage reports missing libEGL.so.1 Install the host runtime library first:

bash
sudo apt-get install -y libegl1 libgles2 libwebkit2gtk-4.1-0 libayatana-appindicator3-1
chmod +x Grok_linux_x64.AppImage
./Grok_linux_x64.AppImage

Agent sandbox won't start on Ubuntu 24.04+ Enable unprivileged user namespaces, or disable the sandbox under "Settings → Runtime → Sandbox".

Request errors First check against Troubleshooting and Model not found / rate limited / service busy; Focus on confirming three things: the key group is Grok, the base URL is https://kuaiapi.net/v1, and the model name is grok-4.6.

Don't connect Grok to Codex CLI

Grok and Codex CLI are not natively compatible, and calling Grok through Codex CLI does not work well, so this is not recommended. Use Grok's own clients: Grok Build CLI, or Grok App above.

Other clients

The Grok group also supports the OpenAI-compatible, Responses, and Anthropic protocols, so ChatBox, Cherry Studio, OpenCode, Claude Code, CC-Switch, and others can connect directly.

The configuration is the same as Other clients: the base URL is https://kuaiapi.net/v1, and the key is the Grok group key.

If you have questions, contact support at support@kuaiapi.net.

Ready to get started?

Sign up and get $0.30 in trial credit; usage is billed per token in real time, so you pay only for what you use.

Sign up freeSee model pricing

For lawful and compliant use only. Please follow our Terms of Service and your local laws and regulations.