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. 首次启动与登录
-
进入你的项目目录：
cd /path/to/your/project -
启动 Grok Build：
grok
输入 grok 启动 Grok Build
-
首次登录： 会自动打开浏览器进行 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 的三种常用方法
-
快捷键切换（最快，推荐日常使用） :在 TUI 中按
Shift + Tab循环切换模式，直到状态栏显示 Plan。
Plan
-
使用 Slash 命令: 输入命令
/plan或/plan on后按回车。 -
启动时直接进入（适合复杂任务）:
grok --plan或结合项目路径：cd your-project && grok --plan
退出或切换回 Normal 模式
再次按 Shift + Tab 切换到 Normal 模式或输入命令：/plan off
6. 基本使用示例
示例 1：新建项目
创建一个现代化的 React + TypeScript Todo App，带暗黑模式、拖拽排序、本地存储，使用 Tailwind CSS，风格参考 Apple
操作建议：
-
直接在空文件夹中启动
grok -
推荐开启 Plan Mode，让 Grok Build 先输出项目结构、依赖清单和技术方案
-
批准计划后，它会自动创建
package.json、组件文件、样式，并初始化 Git 仓库
项目创建中
项目创建完成
预期效果：
-
生成完整的项目结构（含 README、测试文件）
-
包含暗黑模式切换、拖拽排序（@dnd-kit）、本地持久化（localStorage + Zustand）
-
自动安装依赖并运行
npm run dev
示例 1 结果预览
进阶技巧：
-
追加需求：“加上用户登录界面和后端 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反馈。 -
卸载：参考官方文档或删除对应二进制文件。
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
21
0- 0
已为社区贡献4条内容
所有评论(0)