𝐙𝐀𝐈

Grok CLI Manual

Grok Hub

Install Grok CLI, connect it to ZAI Router, then learn permissions, sessions, headless mode, worktrees, and API usage step by step.

xAI

This practical manual covers both Grok CLI and Grok API access through ZAI Router. Complete installation and configuration first, then start with one small, verifiable task in a real project.

Recommended path:

  1. Understand what Grok CLI can do and where it runs.
  2. Install the CLI and check the current version.
  3. Configure ~/.grok/config.toml and ZAI Router.
  4. Complete one verifiable task in a real project.
  5. Move on to session resume, worktrees, structured output, and MCP.

Sources checked on 2026-07-11: the official xAI Grok Build documentation, Grok 4.5 model information, the local Grok CLI, and the ZAI Router forwarding path.

1 What Is Grok CLI Understand Grok CLI modes, suitable tasks, and the ZAI Router request path. 2 Download and Install Install, update, and verify Grok CLI. 3 Your First Task Open a real project and complete one small, verifiable Grok task. 4 Configuration Understand config.toml paths, models, endpoints, sessions, and UI settings. 5 Use ZAI Router Connect grok-4.5 Responses with the main domain and your current ZAI API Key. 6 Permissions and Safety Understand auto-approval, plan mode, allow/deny rules, and sandboxing. 7 Workflows and Troubleshooting Sessions, worktrees, self-checking, structured output, MCP, and common failures.