Grok Build 使用教程：xAI 编程 Agent CLI 安装、Plan Mode 与使用前提

林知远 • 2026年5月24日 • 12分钟阅读

如果你最近看到「Grok Build」「xAI CLI」「Grok 终端编程 Agent」这些说法，先记住一个结论：它不是普通聊天窗口，也不是简单的 API 调用示例，而是 xAI 面向软件工程场景推出的终端 Agent。

根据 xAI 官方介绍，Grok Build 目前处于 Early Beta，优先面向 SuperGrok Heavy 用户开放，可以在终端里运行，支持先规划再执行的 Plan Mode，也能把较大的开发任务拆给并行 Subagents。它的重点不是聊天问答，而是围绕真实代码仓库完成规划、修改、审查和反馈。

这篇文章只整理官方页面和公开资料中能确认的内容，不写亲测结论。如果你还没有 SuperGrok Heavy、无法访问 xAI CLI 页面，或者国内网络环境不稳定，建议先把本文当成安装前检查清单，而不是承诺一定能顺利跑通的教程。

快速判断： 想用 Grok Build，先确认三件事：账号是否具备对应订阅权限，终端能否稳定访问 xAI 安装脚本，当前项目是否适合交给 Agent 修改。缺少任意一项，都不要急着把生产仓库交给它。

Grok Build 到底是什么

xAI 官方将 Grok Build 描述为一个运行在终端里的 coding agent 和 CLI，目标是处理专业软件工程和复杂代码任务。公开页面展示了它可以在项目目录中工作、进入 Plan Mode、展示代码 diff，并读取 AGENTS.md、skills、plugins、hooks、MCP servers 等项目配置。

和普通「让模型写一段代码」不同，Grok Build 的重点是工作流。你给它的不是单个代码片段，而是一个项目任务，例如补安装文档、修复延迟回归、梳理 checkout 流程、检查 CI 问题。它会围绕仓库结构和项目约束行动。

它和网页版 Grok 的区别

网页版 Grok： 更适合问答、搜索、写作、图片和日常多模态任务，代码输出通常需要你手动复制到项目里。
Grok API： 适合开发者把 xAI 模型接入自己的应用，需要自己处理请求、权限、计费、上下文和工具调用。
Grok Build： 面向本地仓库和终端工作流，目标是让 Agent 直接围绕项目文件规划、修改、检查和反馈。

如果你只是想问 Grok 怎么写一段 JavaScript，网页版已经够用；如果你希望 AI 在一个真实项目里理解目录、读规则、改多文件、跑命令，那才是 Grok Build 这类 CLI Agent 的用武之地。

使用前提：不是所有 Grok 用户都能直接用

目前最需要注意的是权限。xAI 官方新闻页和 CLI 页面都写明，Grok Build 处于 Early Beta，并优先面向 SuperGrok Heavy subscribers 开放。xAI 价格页也把 Grok Build CLI 标在 Heavy、Business、Enterprise 等更高层级能力里，而 Free、Lite、普通 SuperGrok 列为不可用。

所以，文章里不能写「Grok Build 免费可用」或「普通 Grok 会员都能使用」。更稳妥的表达是： 根据当前公开页面，Grok Build 处于早期测试阶段，主要面向 SuperGrok Heavy 及更高层级用户开放，具体权限以 xAI 官方账号页面和价格页为准。

检查项	为什么重要	建议
订阅权限	Grok Build 不是普通免费能力，Early Beta 有账号门槛。	先看 xAI pricing 和账号升级页，不要只凭社媒截图判断。
系统环境	当前官方页面主要给出 Bash 安装命令；不同系统和 Shell 的支持细节要以 xAI 文档为准。	确认终端、Shell、网络和权限都正常，再执行安装。
项目备份	Agent 可能被授权修改文件，复杂任务可能涉及多文件变更。	先确保 Git 工作区干净，重要项目先开新分支。

如果你还在比较订阅方案，可以先看站内的 Grok 会员值不值得买，再决定是否为开发场景升级到更高档位。

安装入口和基础命令

xAI 官方 CLI 页面给出的 macOS / Linux 安装命令是：

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

这条命令来自 xAI 官方页面。执行前请确认你打开的是 x.ai 或 docs.x.ai 域名，不要从第三方博客复制来路不明的安装脚本。如果处在非浏览器环境，额外认证方式应以 xAI Build 文档当时给出的说明为准。

Plan Mode：先看计划，再批准执行

Grok Build 最值得关注的能力之一是 Plan Mode。官方介绍里强调，复杂任务可以先进入规划模式：Agent 会提出结构化计划，用户可以批准、评论某个步骤，甚至重写计划，然后它才开始真正改文件。

这点对开发者很重要。因为代码 Agent 最大的风险不是「不会写代码」，而是「它很自信地改错方向」。Plan Mode 的意义，就是把决策前置，让你先看它有没有理解任务边界。

适合用 Plan Mode 的任务

多文件改动： 例如把某个 API 字段从旧命名迁移到新命名，涉及前端、后端、测试和文档。
不确定原因的 bug： 例如 p99 延迟上升、某个 checkout 流程偶发失败，需要先探索再动手。
文档和代码同步： 例如安装文档漏写 headless mode，代码已经支持但 README 没跟上。
需要人工判断的重构： 例如拆组件、改目录结构、调整 schema，必须先确认方案。

反过来，如果只是让它改一个拼写错误、补一个小测试，直接执行也可以。但只要任务会影响多个文件，Plan Mode 就值得打开。

Subagents、AGENTS.md 与 MCP：为什么它更像工程工具

官方页面还提到 Grok Build 支持 Subagents、Skills、Hooks、MCP servers、AGENTS.md、Memory、Code search、Multi-file edits、Git integration 等能力。这里不要被名词吓到，核心意思是：它不是只和一个聊天框对话，而是试图接入真实工程环境。

其中最值得站长和开发者关注的是三件事。

Subagents：把大任务拆给多个子代理

xAI 页面显示，Subagents 可以并行做研究、构建和审查。比如一个子代理探索 checkout 流程，一个子代理检查基础设施和 CI，一个子代理阅读共享库。对于大型仓库，这能减少单个上下文塞太满的问题。

但并行不等于一定正确。实际写文章时应提醒读者：Subagents 输出依然需要主 Agent 汇总，也需要开发者看最终 diff 和测试结果。

AGENTS.md：让工具读懂仓库规则

AGENTS.md 的价值是把项目约定写成文件。例如这个网站就把 RSS、SEO、Hermes 素材、构建、审计边界都写进 AGENTS.md。这样新开对话或换工具时，Agent 不需要靠聊天记忆猜流程，而是能直接读仓库规则。

如果你计划使用 Grok Build，建议先在项目根目录准备一份简洁的 AGENTS.md，写清楚安装命令、测试命令、禁止修改的目录、代码风格和发布前检查。规则越清楚，Agent 越不容易乱动。

MCP 和 Hooks：把外部工具接进工作流

MCP servers 和 Hooks 更适合成熟团队。前者通常用于把外部工具能力接进 Agent 工作流，后者可以在特定操作前后触发脚本或检查。个人站长不一定马上需要，但它说明 Grok Build 的定位不是玩具式代码生成，而是工程自动化入口。

国内用户最容易卡在哪些地方

目前 Grok Build 还处于 Early Beta，国内网络环境下要尤其注意访问稳定性、账号权限和本地终端配置的差异。下面这些不是官方承诺，只是根据公开信息和常见开发环境问题整理出的排查顺序。

安装脚本无法下载

如果终端执行 curl 命令时卡住，先不要急着怀疑账号。安装脚本本身需要访问 x.ai 域名，国内网络、公司代理、DNS 或安全软件都可能影响下载。

先在浏览器打开官方 CLI 页面，确认页面能正常访问。
再在终端里检查是否能访问同一域名，不要只看浏览器结果。
如果公司网络有代理，确认终端是否继承了代理配置。
不要从陌生镜像下载替代脚本，代码 Agent 的安装脚本权限较高，安全风险比普通网页更大。

登录授权成功，但 CLI 没反应

这类问题在很多 CLI 工具里都常见：浏览器授权看起来成功，但本地终端等待回调失败。可能原因包括本地端口被占用、代理没有覆盖终端、浏览器和终端走了不同网络、公司安全软件拦截回调。

这时可以先记录报错文本和命令输出，不要反复重装。后续如果要写成亲测排查文，需要真实终端截图或日志；没有日志时，只能写成通用排查思路。

权限不足或功能不可用

如果登录后仍提示不可用，优先核对订阅层级。根据 xAI 官方页面，Grok Build 不是普通免费能力，也不是所有付费层级都明确开放。普通 SuperGrok 用户如果看到不可用提示，不应直接推断为安装失败。

开发者如果更关注 API 接入，可以同时阅读 Grok API 接入与开发指南，区分「网页会员权限」「API Key 调用」和「CLI Agent Beta 权限」这三件事。

哪些人适合先尝试 Grok Build

由于 Grok Build 仍处于 Early Beta，现在不适合把它包装成所有开发者都该立刻迁移的新默认工具。更实际的判断方式，是先看你的账号、项目类型和风险承受能力是否匹配。

人群	是否适合	原因
已有 SuperGrok Heavy 或企业权限的开发者	适合优先尝试	账号门槛已满足，可以用测试仓库验证 Plan Mode、Subagents 和 diff 工作流。
普通 SuperGrok 或免费用户	先观望	当前公开页面没有把普通档位列为 Grok Build CLI 可用对象，先不要把安装失败误判为教程问题。
生产项目负责人	谨慎接入	先用小分支和非关键任务试跑，确认计划、diff、测试和回滚路径都清楚。

如果你还不确定是否需要终端 Agent，可以先从 Grok 开发者模式这类低门槛工作流开始。等你真的需要 AI 读取仓库、修改多文件、生成 diff，再考虑 Grok Build。

建议准备的截图和图片素材

这篇教程暂时不放伪造截图。后续如果要增强可读性，最适合补三类图：官方 CLI 页面截图、真实终端运行日志、Plan Mode 生成计划和 diff 的截图。

官方页面截图： 用于证明当前入口、安装命令和 Early Beta 状态，截图时标注日期。
真实终端截图： 用于展示安装、登录、Plan Mode 和 diff，但要隐藏用户名、路径、仓库名、Token、邮箱等信息。
原创流程图： 可以用 AI 或本地设计制作，展示「安装前检查 → 登录授权 → 测试仓库 → Plan Mode → 审查 diff → 执行测试」流程。

只要没有真实截图，就不要在文章里放「终端成功运行实测图」。Google 和用户都更看重可信度，宁愿先用文字清楚解释，也不要用假截图制造亲测感。

常见问题解答

Q. Grok Build 是免费的吗？

不是按普通免费能力来理解。根据 xAI 当前公开页面，Grok Build 处于 Early Beta，主要面向 SuperGrok Heavy 及更高层级用户开放，具体可用性以官方账号和价格页为准。

Q. 普通 SuperGrok 用户能不能用 Grok Build？

目前不建议直接假设可以。xAI 官方页面强调 Early Beta first for SuperGrok Heavy subscribers，价格页也把 Grok Build CLI 标在 Heavy、Business、Enterprise 等档位。普通 SuperGrok 是否后续开放，要看官方更新。

Q. Grok Build 可以替代程序员吗？

不应该这样理解。它更像一个能读仓库、提计划、改文件、生成 diff 的工程助手。需求拆解、代码审查、测试判断、上线责任仍然需要开发者承担。

Q. 国内安装 Grok Build 卡住怎么办？

先区分是网页访问问题、终端网络问题、代理配置问题，还是账号权限问题。不要反复执行来路不明的第三方安装脚本，也不要把授权失败直接判断为账号异常。

Q. 什么时候应该用 Plan Mode？

只要任务会影响多个文件、需要重构、涉及不确定 bug，或者需要先探索项目结构，就应该先用 Plan Mode。小修改可以直接执行，大修改先看计划更安全。

核心要点总结

Grok Build 是 xAI 面向开发者推出的终端编程 Agent，不是普通网页版聊天功能。
当前公开页面显示，它处于 Early Beta，并优先面向 SuperGrok Heavy 及更高层级用户开放。
Plan Mode 是这类工具的关键安全阀：复杂任务先看计划，再批准执行。
Subagents、AGENTS.md、MCP、Hooks 说明它更偏工程工作流，适合真实仓库任务，而不是单段代码问答。
国内用户应先确认网络、终端代理、账号权限和 Git 备份，再把它接入正式项目。

参考来源：xAI Grok Build 官方新闻页、xAI CLI 页面、xAI Build 文档、xAI Pricing 页面，以及本地 Hermes 素材库中的公开资料整理。涉及权限、价格和额度的内容可能随官方策略调整，发布前应再次核验。