Grok Build 使用教程（2026 年最新版）

Grok Build 是 xAI 官方推出的终端 AI 编码代理（Coding Agent CLI），于 2026 年 5 月正式进入早期 Beta 阶段。它把强大的 Grok 模型直接塞进你的终端，能帮你完成从规划、搜索、编码、测试到 Git 提交的全流程工作。

它支持交互式 TUI（全屏、鼠标操作、无闪烁）、Plan Mode（先规划再执行）、并行子代理、无头模式（脚本/自动化）、ACP 协议接入其他工具等特性，是目前最接近“专业软件工程师”的终端 AI 工具之一。

1. 前提条件

• 订阅要求：SuperGrok 或 X Premium Plus 会员（点击查看文章 : 2026 国内最新 SuperGrok 升级订阅教程）

• 系统支持：macOS、Linux、Windows（推荐 macOS/Linux 体验最佳）。

• 推荐环境：在你的项目根目录下运行效果最好（它会自动读取仓库结构、AGENTS.md、技能等）。

2. 安装 Grok Build

macOS / Linux

curl -fsSL https://x.ai/cli/install.sh | bash

Windows（PowerShell，管理员权限推荐）

irm https://x.ai/cli/install.ps1 | iex

安装完成后，终端输入 grok --version 验证是否成功。

3. 首次启动与登录

1. 进入你的项目目录：cd /path/to/your/project
2. 启动 Grok Build：grok

3. 首次登录： 会自动打开浏览器进行 xAI 账号授权（推荐）。

无浏览器环境可手动设置环境变量：export XAI_API_KEY="xai-你的密钥" （密钥可在 https://console.x.ai/team/default/api-keys 获取）

登录成功后会进入全屏交互式 TUI 界面。

4. TUI 界面操作指南

Grok Build 的 TUI 支持鼠标点击、键盘快捷键，界面清晰无闪烁：

输入框：直接输入自然语言指令（如中文或英文）。

常用命令（在 TUI 内输入）：

命令	功能说明
/help	打开动态帮助面板（推荐新手必用）
/plan	手动进入 Plan Mode
/yolo 或 /always-approve	开启/关闭自动批准模式（YOLO 模式）
/model <模型名>	切换模型
/inspect	查看当前项目加载的技能、插件与配置
/feedback	直接向 xAI 团队提交反馈（Beta 阶段非常有用）
/clear	清空当前会话历史

5. Plan Mode（强烈推荐用于复杂任务）

输入复杂需求前，先用 /plan 或启动时加标志进入规划模式。

Grok Build 会先输出完整执行计划（分步骤）。 你可以：

• 逐条批准（Enter）
• 评论修改某一步
• 完全重写计划
• 批准后，所有文件变更都会以干净的 diff 形式展示，确认无误后再执行。

Plan Mode 的三种常用方法

1. 快捷键切换（最快，推荐日常使用） :在 TUI 中按 Shift + Tab 循环切换模式，直到状态栏显示 Plan。

2. 使用 Slash 命令: 输入命令/plan或/plan on后按回车。
3. 启动时直接进入（适合复杂任务）:grok --plan 或结合项目路径：cd your-project && grok --plan

退出或切换回 Normal 模式

再次按 Shift + Tab 切换到 Normal 模式或输入命令：/plan off

6. 基本使用示例

示例 1：新建项目

创建一个现代化的 React + TypeScript Todo App，带暗黑模式、拖拽排序、本地存储，使用 Tailwind CSS，风格参考 Apple

操作建议：

1. 直接在空文件夹中启动 grok
2. 推荐开启 Plan Mode，让 Grok Build 先输出项目结构、依赖清单和技术方案
3. 批准计划后，它会自动创建 package.json、组件文件、样式，并初始化 Git 仓库

预期效果：

• 生成完整的项目结构（含 README、测试文件）

• 包含暗黑模式切换、拖拽排序（@dnd-kit）、本地持久化（localStorage + Zustand）
• 自动安装依赖并运行 npm run dev

进阶技巧：

• 追加需求：“加上用户登录界面和后端 API 模拟”
• 完成后输入：“帮我部署到 Vercel 并生成部署脚本”

示例 2：分析现有项目

Explain this repo in detail. 重点分析架构、核心模块和潜在优化点。

示例 3：修改代码

@src/main.rs 帮我把这个文件重构为更清晰的模块结构，并添加错误处理。

示例 4：并行子代理（大型任务）

Grok Build 会自动拆分任务给多个子代理并行执行（如一个写前端、一个写后端、一个写测试）。

7. 无头模式（Headless）—— 脚本/自动化神器

适合 CI/CD、自动化脚本或嵌入其他工具：

# 简单执行
grok -p "为当前项目添加用户认证模块（JWT + 数据库）"

# 输出 JSON 便于解析
grok -p "分析这个代码库的安全问题" --output-format streaming-json

8. 高级功能

功能	说明	如何使用
并行子代理	大任务自动拆分多个代理同时工作	自然语言描述即可
Git 深度集成	自动创建分支、提交、生成 PR	直接说“提交这些改动”
自定义配置	支持 AGENTS.md、技能、插件、MCP 服务器	项目根目录放置即可
自定义模型	可接入其他模型	配置文件 + /model 切换
ACP 协议	可接入 IDE、其他 Agent 框架	官方支持
Inspect	查看当前项目已加载的配置、技能等	grok inspect

9. 实用技巧 & 注意事项

• 最好在 Git 仓库根目录运行，效果最强。
• 大项目建议先用 Plan Mode，避免一次性改太多。
• 图片支持：可直接粘贴截图让它分析 UI 或报错。
• 多任务切换：支持同时运行多个 Grok Build 实例。
• Beta 阶段：偶尔会有小 bug，遇到问题请用 /feedback 反馈。
• 卸载：参考官方文档或删除对应二进制文件。