Grok CLI Manual
Grok 专题
从零安装 Grok CLI，连接 XAI Router，再逐步掌握 Grok Imagine 图片与视频、权限、会话、Worktree 和 API 调用。
这是一份面向 Grok CLI 和 Grok API 用户的实用手册。先完成安装与 XAI Router 配置，再尝试图片生成、编辑、视频生成和一个可验证的小任务。
建议阅读顺序：
- 了解 Grok CLI 的能力与运行边界。
- 安装 CLI，并检查当前版本。
- 配置
~/.grok/config.toml与 XAI Router。 - 使用
/imagine、图片工具或 Images API 生成和编辑图片。 - 使用
/imagine-video或 Videos API 生成、轮询并保存视频。 - 在真实项目中完成第一个可验证任务。
- 再使用会话恢复、Worktree、结构化输出与 MCP。
内容根据 xAI Grok Build 官方文档、Grok Imagine 模型信息、本地 Grok CLI 以及本站 XAI Router 转发链路整理。Grok 4.7 模型信息已于 2026-09-22 根据 xAI 官方文档 更新。
1 Grok CLI 是什么 了解 Grok CLI 的交互形态、适用任务，以及模型、图片与视频请求的 XAI Router 链路。 2 下载与安装 安装、更新并检查 Grok CLI。 3 第一次使用 打开真实项目，完成一个小而可验证的 Grok 任务。 4 配置文件 理解 config.toml 路径、模型、endpoint、会话与 UI 配置。 5 接入 XAI Router 使用主域名与当前 XAI API Key 连接 grok-4.7 Responses 与 Grok Imagine 图片、视频。 6 图片生成与编辑 配置 Grok CLI 的图片端点，并通过 /imagine、image_gen、image_edit 和 Images API 生成或编辑图片。 7 视频生成 通过 /imagine-video、image_to_video、reference_to_video 和 Videos API 生成、轮询与保存 Grok Imagine 视频。 8 权限与安全 理解自动批准、计划模式、allow/deny 规则与沙箱。 9 工作流与排查 会话、Worktree、自检、结构化输出、MCP 与常见问题。