Grok Build 是 xAI 推出的终端编程 Agent,跑在命令行里,能读代码、写代码、执行命令,定位和 Claude Code、Codex CLI 属于同一类工具。它由 Grok 4.6 模型驱动,支持交互式 TUI、headless 脚本模式和 ACP 协议嵌入三种运行方式,适合开发者在本地终端里直接用 AI 干活。这篇文章从安装到跑通第一个任务,走一遍完整流程。
Grok Build 是什么?和 Grok 聊天有什么不同?
Grok 聊天是在 grok.com 网页里一问一答,Build 是装在你电脑上的命令行工具。聊天适合临时问问题、查资料;Build 适合在项目目录里连续干活——它能看到你的代码文件结构、读懂项目上下文、直接改代码并展示 diff,整个过程在终端里完成,不用来回复制粘贴。
三种运行模式分别对应不同场景:交互式 TUI 模式像一个终端里的对话框,适合边写边聊;headless 模式适合脚本化执行和 CI/CD 集成,跑完自动退出;ACP 协议可以把 Build 嵌入到其他开发工具中。
原来的 Grok Studio 已经停用,官方建议改用 Build。如果你之前用过 Studio,直接切到 Build 就行。
怎么安装 Grok Build?
macOS 和 Linux 一行命令搞定:
curl -fsSL https://x.ai/cli/install.sh | bash
Windows 用 PowerShell:
irm https://x.ai/cli/install.ps1 | iex
公司网络限制了从外部下载安装脚本的,也可以通过 npm 全局安装:
npm install -g @xai-official/grok
三种方式装出来的是同一个工具。安装完成后,在终端输入 grok 就能启动。如果提示命令未找到,检查一下安装路径是否已加入系统 PATH。
怎么登录认证?
两种方式,按你的使用环境选:
浏览器 OAuth(推荐给本地开发机):第一次运行 grok 命令,会自动弹出浏览器让你授权 xAI 账号。用你注册 grok.com 时的 Apple、Google 或 X 账号授权即可,授权完终端自动登录,后续不用重复操作。
API Key(推荐给服务器和容器环境):在没有浏览器的环境——比如远程 Linux 服务器、Docker 容器、CI 流水线——设置环境变量来跳过浏览器认证:
export XAI_API_KEY="你的密钥"
密钥在 xAI 的开发者控制台(console.x.ai)生成。设好环境变量后运行 grok 会自动读取,不再弹浏览器。密钥注意保管,不要提交到代码仓库。
哪些档位能用 Build?额度怎么算?
SuperGrok Plus($100/月)的官方定价卡上明确标注了 Chat、Imagine、Voice 和 Build 的更高用量。SuperGrok($30/月)也包含 Build 功能,但各档的具体 Build 配额数字官方没有公开,以 Settings → Usage 面板的实际显示为准。
Build 的消耗计入付费用户的 weekly 共享池——和 Chat、Imagine、Voice 用同一个额度,每周按 Settings → Usage 显示的时间自动重置。这意味着如果你某一周用 Build 跑了大量编码任务,聊天和图片生成的可用额度也会相应减少,需要有取舍意识。
和 Grok Bot 注意区分:Bot 有自己独立的 weekly usage,交给 Bot 的任务不从 Build 这个共享池扣。Build 的额度和 Bot 的额度互不影响,两边分开计算。
额度用完后,可以购买 Extra Usage Credits(Web 端最低 $5 起,购买后一年内有效),或者升级到更高档位获得更大的周额度。各档详细价格和额度池规则见 SuperGrok 怎么订阅。
第一个任务怎么跑?
装好 Build、认证通过后,建议找一个你熟悉的小项目练手,这样方便判断 AI 改得对不对。典型流程如下:
- 进入项目目录:
cd ~/your-project - 启动 Build:在项目根目录运行
grok,Build 会自动扫描当前目录的文件结构 - 让它先读项目:在交互界面输入类似”读一下这个项目的结构,告诉我主要模块和入口文件在哪”——先让 Build 建立上下文
- 给一个小改动任务:比如”给 README.md 加一段项目简介,包含技术栈和运行方法”或者”把 src/utils.js 里的日期格式化函数改成 ISO 8601 格式”
- 验收结果:Build 会在终端里展示改动的完整 diff,你可以逐行检查,然后确认采纳、要求修改或直接拒绝
几个实用建议:第一次用不要上来就让 Build 重构整个项目,容易改出意外。任务描述越具体,改动越可控——“把第 42 行的函数返回值从字符串改成对象”比”优化一下这个文件”靠谱得多。Build 的强项是”接一个明确的小任务,自己读上下文、写完、交付”,适合快速出第一版草稿,你再在这个基础上微调。
和 Claude Code、Codex CLI 比怎么样?
三者都是终端编程 Agent,功能定位高度重叠,选哪个主要看你更认可哪家的模型能力和生态:
| 对比项 | Grok Build | Claude Code | Codex CLI |
|---|---|---|---|
| 驱动模型 | Grok 4.6 | Claude Fable 5.1 | GPT-6 Astra |
| 安装方式 | curl 脚本 / npm | npm | npm |
| 额度归属 | SuperGrok weekly 共享池 | Claude 订阅额度 | Codex 订阅额度 |
| API 标准价(输入/输出,每百万 token) | $2 / $6 | 以 Anthropic 定价为准 | 以 OpenAI 定价为准 |
| 长上下文注意点 | 超 200K token 价格翻倍 | 以官方定价为准 | 以官方定价为准 |
Grok Build 的 API 标准单价在三者中偏低,适合中等长度代码任务的日常使用。但长上下文超过 200K token 后输入输出价格翻倍,跑大型代码库全量分析时成本可能追上甚至超过竞品。生态和社区活跃度方面,Claude Code 和 Codex CLI 目前更成熟,第三方教程、插件和工作流分享也更多。
关于 Codex CLI 的安装配置可以看 Codex CLI 安装教程,Claude Code 和 Codex 的详细对比在 Codex 和 Claude Code 怎么选。如果你在几款 AI 编程工具之间做选择,各家订阅的价格和功能横向对比可以看 AI 订阅工具对比。
档位、价格、模型以 xAI 官网当时显示为准,本文核对日期 2026-09-17。