Grok Build 是 SpaceXAI 的可扩展编程智能体，可用交互式终端界面、脚本无头模式或 ACP 接入其他应用。Grok 4.5 官方发布说明显示，它已成为 Build 的默认模型。
一、Grok Build 与网页聊天有什么不同
读取目录、代码、配置、项目规则和测试，而不是只处理粘贴的一小段代码。
运行终端命令、测试、构建和格式化，并根据结果继续修改。
复杂任务可先进入计划阶段，用户检查步骤后再允许执行。
支持 skills、plugins、hooks、MCP、worktree 和 ACP 等扩展方式。
二、安装并登录 Grok Build
macOS、Linux 或 WSL
curl -fsSL https://x.ai/cli/install.sh | bash
Windows PowerShell
irm https://x.ai/cli/install.ps1 | iex
安装后进入项目目录并启动：
cd your-project
grok
首次启动会打开浏览器登录。无浏览器环境可按官方文档设置 XAI_API_KEY。安装命令会更新，执行前建议到官方 Build 文档再次核对。
三、先让 Build 解释项目，不要马上大改
新项目第一轮适合建立共同上下文。官方文档给出的入门提示包括“Explain this repo”和用 @文件路径解释具体文件。
Explain this repo. Describe the entry points, main modules,
test commands, build commands, and project-specific rules.
Do not change files.
确认它理解正确后，再给一个边界清晰的小任务：
修复移动端导航遮挡问题。只允许修改导航相关 HTML、CSS 和 JS；先复现并说明原因，再提出最小修改；保持桌面布局不变；在 375px 与 768px 规则下检查，并运行现有测试或语法检查。最后列出修改文件和验证结果。
四、可靠的“读—计划—改—验”工作流
读取现状
先查看相关文件、项目说明和测试，确认问题可以复现。
提出计划
复杂任务先列修改范围、风险和验证方式；发现理解错误时在执行前纠正。
做最小修改
要求遵循现有风格，不顺手重构无关代码，不新增没有被请求的功能。
运行验证
测试、构建、类型检查、静态分析或针对问题的复现步骤至少完成一项。
检查差异
确认每一处改动都能对应任务，且没有敏感信息、临时文件或意外删除。
五、用无头模式运行脚本任务
官方 Build 文档支持用 -p 发送单次任务，并用 JSON 或 streaming-json 输出，适合自动化、机器人或 CI 集成。
grok -p "Explain this codebase"
grok -p "Run the tests and summarize failures" --output-format streaming-json
| 参数 | 用途 |
|---|---|
-p | 发送单次提示词 |
-m | 指定模型 |
--cwd | 指定工作目录 |
--output-format | 选择 plain、json 或 streaming-json |
-r / -c | 恢复指定会话或最近会话 |
--always-approve 会自动批准工具执行。只有在隔离环境、权限边界清楚且命令可预测时才考虑使用。六、用 /goal 处理长时间任务
官方在 2026 年 6 月推出 /goal，用于持续规划、实施和验证长任务。适合迁移、批量修复或完整功能开发，不适合一句话就能完成的小改动。
/goal 将登录模块迁移到新 API，保留现有行为，
补齐回归测试，运行构建并记录仍未解决的风险
目标必须包含范围和终止条件。运行期间定期查看进展；如果发现方向错误，优先修正目标或暂停，而不是等到最后才审查。
七、提交代码前的安全检查
查看差异，确认没有无关文件或大规模格式化。
检查配置、日志和输出中是否包含 Token、密码或用户数据。
重点复核删除、迁移、数据库和部署命令。
记录真正运行过的测试，不把“应该通过”写成“已通过”。