「Grok Build」这个名字现在对应两个产品:一个是装在电脑终端里的编程代理(CLI),另一个是网页版和 Grok App 里「一句话生成应用、发布到 grok.me」的应用构建(用量页里叫 App Builder)。本文讲前者。xAI(现 SpaceXAI)在 Grok Build 产品页写它现在由 Grok 4.7 驱动,安装只要一条命令,第一次运行会打开浏览器登录。
如果你只想看结论
- 要在自己的代码仓库里读代码、改代码、跑测试的开发者:装 CLI。macOS 和 Linux 用 curl 脚本,Windows 用 PowerShell 脚本,装完进项目目录运行 grok。
- 不写代码、只想做个小网页或小游戏的用户:用不着 CLI,在网页版对话里描述需求,用应用构建就行,2026-08-19 起所有档位都能用,用法见 Grok Build 应用构建实战。
- 关心要不要付费的用户:官方两处说法不一致,先装上用自己的账号登录试,额度提示以实际显示为准。
先分清两个 Grok Build
| 对比项 | 终端编程代理(CLI) | 应用构建(App Builder) |
|---|---|---|
| 在哪用 | 你电脑的终端 | 网页版和手机 App 的对话里 |
| 做什么 | 读写本地仓库的代码、执行命令、改文件 | 一句话生成网页、小游戏、看板,发布到 grok.me 子域名 |
| 模型 | 官方写由 Grok 4.7 驱动 | 官方没写是 4.7;截至 10 月 6 日,grok.com 网页聊天的模式选择器里 Expert、Heavy 已标 Grok 4.7,x.ai/pricing 仍写 4.6,官方未发公告 |
| 谁能用 | 官方说法冲突,见下文 | 2026-08-19 起全部档位 |
两者也能接起来:官方 08-19 公告写,应用构建做的项目可以导出到 GitHub,再用终端版接着开发。网页聊天什么时候能用上 Grok 4.7,另见 Grok 4.7 在 grok.com 能用吗。
安装:官方给的三种方式
以下命令均摘自官方文档和产品页,本文没有替你执行。
macOS、Linux:
curl -fsSL https://x.ai/cli/install.sh | bash
Windows(PowerShell):
irm https://x.ai/cli/install.ps1 | iex
npm 备选(官方企业部署文档列出的方式,不经过 x.ai 的下载地址):
npm install -g @xai-official/grok
装之前要知道的几点:
- 官方文档没有单独列出系统版本要求。更新日志里有 Windows ARM64、苹果芯片原生版本的修复条目,说明这两类机器在支持范围内。
- 一行式安装会直接执行远程脚本。公司电脑按 IT 的规定来。
- 使用时要连 cli-chat-proxy.grok.com(推理代理)和 auth.x.ai(登录)这两个地址,这是官方企业文档列的必需项。需要能稳定访问这些 xAI 服务的网络环境。
- 装完用 grok version 看版本,grok update 检查更新。
登录:三种方式
| 方式 | 怎么做 | 适合 |
|---|---|---|
| 浏览器登录(默认) | 第一次运行 grok 会自动打开浏览器,或手动运行 grok login | 有浏览器的电脑 |
| 设备码登录 | grok login --device-auth,终端显示网址和短码,在任意有浏览器的设备上完成 | 远程服务器、容器 |
| API 密钥 | 设置环境变量 XAI_API_KEY | 脚本和持续集成;走 xAI API,不走订阅的推理代理 |
退出登录用 grok logout。首发公告的原话是用你的账号登录。订阅绑定在购买时登录的那个账号上,所以 CLI 要和网页版用同一个账号,订阅和用量才对得上。
第一次用:照着做五步
- 进入项目目录,运行 grok,进入全屏交互界面。
- 先让它讲一遍整个仓库,或者用 @ 加文件路径让它讲某个文件。
- 复杂任务先进计划模式:输入 /plan 加任务描述,或按 Shift+Tab 切换。计划批准之前,它只能改计划文件,其他文件一律不动。
- 改坏了用 /rewind 回到之前某一轮。官方文档提醒它会直接改磁盘上的文件,没提交到 git 的改动会丢,所以开工前先提交一次。
- 用 /context 看上下文占用,/usage 看用量或管理账单,/quit 退出。
权限模式有三档:默认逐项请求确认;/auto 用分类器自动放行安全操作;--always-approve 跳过全部确认。刚上手别开第三档。所有会话自动保存在本机的 ~/.grok/sessions 目录,grok -c 可以接着上一次会话继续。
记忆功能(2026-09-16 起)
官方 09-16 公告的要点:
- 每完成一轮,Grok 在后台把项目约定、决策和事实记成 markdown 笔记,之后的会话动相关代码前会先读。
- 不记任务进度、没定下来的结论和密钥;当前对话里的指令优先于笔记。
- 按项目分开存,另有一份全局偏好。/memory 浏览笔记,/dream 把零散笔记整理成主题文件,grok memory clear 清除。
- 只对新会话生效:运行 /new 或重新启动,第一轮完成后开始记。
这里有一处说法不一致:更新日志 1.0.34 写记忆已正式可用,但设置参考文档里记忆开关的默认值仍写「关闭」。/memory 命令只在记忆打开时出现,看不到就在 /settings 里找记忆开关,或在配置文件里打开。这套记忆存在本机,和网页版聊天里的记忆、自定义指令是两回事,互不同步。
免费还是要订阅:官方说法不一致
| 来源 | 说法 |
|---|---|
| x.ai/build 页面、Grok 4.7 发布稿(09-21) | 可以免费试用 |
| Grok Build 首发公告(05-25) | 早期测试版面向所有 SuperGrok 和 X Premium+ 订阅用户 |
| grok.com 网页版页面显示 | 仍保留「只对 SuperGrok、X Premium+、SuperGrok Heavy 用户开放」的旧提示,以页面实际显示为准 |
| 更新日志(7 月) | 多条修复提到给免费账户的免费额度用完提示 |
比较稳妥的理解:现在官方主页写可以免费试用,但免费额度多少没有公布。订阅用户的用量走同一个周使用池,官方 FAQ 的原话是长时间的编程任务消耗远多于聊天。额度用完怎么处理,见 Grok 额度用完怎么办。
这几种情况不用装 CLI:只想做个展示页发给朋友,用应用构建;只想在编辑器里用 Grok 4.7,官方写它在 Cursor 里也能用;公司代码不允许发给外部模型,先看公司规定。
和 PayForChat 的关系
PayForChat 开通的 Super(对应官方 SuperGrok)和 Super Heavy(对应官方 SuperGrok Heavy)都开在你自己的 Grok 账户上,CLI 用同一个账号登录即可;首发公告写的也是订阅用户用自己的账号登录使用。CLI 对订阅用户开放哪些权益、额度多少,以 xAI 官方为准,本站不作承诺。开通只需要账户 UUID,获取方法见 Grok 充值页 的充值流程说明,价格以 套餐页 为准。本站是独立第三方服务,与 xAI 无关联。
常见问题
Q: Grok Build CLI 支持 Windows 吗? A: 支持。官方文档专门给了 Windows 的 PowerShell 安装命令,见上文安装一节;配置文件放在用户目录下的 .grok 文件夹里。
Q: 没有浏览器的服务器怎么登录? A: 运行 grok login --device-auth,终端会给出网址和短码,在任意有浏览器的设备上完成登录。脚本和持续集成也可以设置 XAI_API_KEY。
Q: Grok Build CLI 用的是 Grok 4.7 吗? A: 官方产品页写它现在由 Grok 4.7 驱动。可以运行 grok models 看账号可用的模型,在界面里用 /model 切换。
Q: 终端里的 Grok Build 和网页版里的 Build 是同一个东西吗? A: 不是。CLI 是本机的编程代理;网页版里的是应用构建(App Builder),生成应用并发布到 grok.me。两者在用量页里分成两项显示(以页面实际显示为准)。
Q: 安装脚本下载不下来怎么办? A: 官方企业部署文档给了 npm 全局安装作为替代方式,不经过 x.ai 的下载地址。装好之后,登录和使用仍然要能连上 xAI 的服务。
Q: 免费账号能用多少? A: 官方没有公布免费额度。产品页写可以免费试用;更新日志里提到过免费额度用完时的付费提示。
参考来源
- Grok Build 产品页(x.ai)
- Grok Build:Get Started(docs.x.ai)
- Grok Build:CLI Reference(docs.x.ai)
- Introducing Grok Build(x.ai,2026-05-25)
- Memory in Grok Build(x.ai,2026-09-16)
更新记录
- 2026-10-06:首次发布,按 10 月 6 日官方页面核对;网页聊天的模型说法改为「grok.com 模式选择器里 Expert、Heavy 已标 Grok 4.7,x.ai/pricing 仍写 4.6,官方未发公告」。