深色模式
Grok Build 安装第一步:先读安装脚本,再装,再看没登录能干什么
这是「Grok Build 实战」系列:Dato 和他的 Bot 把官方文档和别人的教程对着真实安装的 CLI(1.0.52)验证了一遍。本篇参考了:littlemagic8:【2026保姆级】手把手教你安装使用 Grok Build(2026-06-24)、官方文档:Grok Build 概览。命令输出和截图都是我们自己做的,没有搬运原文;没做到的会写明。
官方的安装命令只有一行[^1]:
bash
curl -fsSL https://x.ai/cli/install.sh | bash很多教程(包括 littlemagic8 的那篇[^3])就是让你直接粘贴这一行。**我们的习惯是:来源于网络的脚本,先下载,读一遍,再运行。**这一步对 Dato 的盒子和你的电脑都一样适用。
第一步:下载,不运行
bash
curl -fsSL -o install.sh https://x.ai/cli/install.sh
head -20 install.sh脚本开头的注释写明了几件事(我们自己读的,没有复制原文):它支持 stable / alpha / enterprise 三个渠道,默认 stable;可以用环境变量 GROK_BIN_DIR 指定安装目录;也可以在命令后面跟版本号安装指定版本;认证用 GROK_DEPLOYMENT_KEY 或 grok login 生成的 ~/.grok/auth.json。
第二步:装到你指定的目录
bash
GROK_BIN_DIR=$HOME/tools/grok-bin bash install.sh我们在盒子上装的结果见下图:下载了 1.0.52 版本,在指定目录里生成了 grok 和 agent 两个入口,并在 ~/.local/bin 建了符号链接,还往 ~/.bashrc 里加了一行 PATH。如果你不想动 shell 配置文件,装完记得检查并还原。

第三步:不登录能做什么
| 命令 | 作用 | 我们实测 |
|---|---|---|
grok --version | 看版本 | ✅ |
grok inspect | 看当前目录发现了哪些规则、技能、权限 | ✅(见下一篇) |
grok doctor | 检查终端、剪贴板、颜色、输入支持 | ✅ |
grok du | 看 ~/.grok 占了多少盘 | ✅ 约 181 MB,几乎全是下载的程序本体 |
grok models | 列模型 | 未登录时提示未认证,默认模型显示 grok-4.6 |
grok -p "..." | 无头提问 | ❌ 未登录,提示 grok login --device-code,退出码 1 |
登录:三种方式(来自官方文档,我们没登录)
- 浏览器登录(默认):首次运行
grok会打开浏览器,通过 grok.com / auth.x.ai 授权,凭据存在~/.grok/auth.json[^7]。 - 设备码登录:没有浏览器的服务器用
grok login --device-auth(别名--device-code)[^5]。 - API Key:
export XAI_API_KEY="xai-...",适合 CI。
官方还特别提醒:auth.json 和 mcp_credentials.json 都是 owner-only 权限,不要复制到共享目录、工单或聊天里[^7]。
为什么我们没登录
盒子是 Dato 的 Bot 共用的机器,里面存着别的凭据(见《每个 Bot 各管各的是错觉》)。把订阅账号登录到共用机器上不合适,所以我们没有登录,也没有让它真的写代码。想自己试的话,在自己的电脑上登录即可。
复制可用的“装完自检”
bash
grok --version && grok doctor | head -20 && grok inspect | head -20我们没做、所以不敢保证的
- Windows 的 PowerShell 安装、WinGet 安装:只读了文档,未实测。
- 登录后的 TUI 画面、模型回答质量:未实测。
常见问题
Q:装完提示找不到 grok 命令怎么办?
A:安装脚本会提示它更新了哪个 shell 配置文件里的 PATH;重开终端,或手动把安装目录加入 PATH。
Q:怎么更新?
A:官方文档写 grok update;用 WinGet 装的要用 winget upgrade[^1]。
Q:会占多少磁盘?
A:我们实测 ~/.grok 约 181 MB,其中 179.6 MB 是下载的程序本体。
想直接开通?
需要代充,请联系站长,微信 siuserxiaowei(备注"Grok Bot 教程")。首单报优惠码 xiaowei 立减 20 元。更多免费教程在 grokguide.si。
风险提示
官方定价页写明,订阅只通过官网直接销售,不授权第三方卖家,从其他渠道买的订阅可能被暂停(cursor.com/pricing)。站长提供的是个人代充服务,与 xAI / Grok / Cursor 官方无关,请了解风险后再决定。任何时候都不要把账号密码、验证码交给别人,包括站长。
参考来源
[^1]: https://docs.x.ai/build/overview(核验 2026-10-15) [^2]: https://x.ai/cli/install.sh(核验 2026-10-15) [^3]: https://littlemagic8.github.io/2026/06/24/how-to-use-grok-build/(核验 2026-10-15) [^4]: https://x.ai/cli(核验 2026-10-15) [^5]: https://docs.x.ai/build/cli/reference(核验 2026-10-15) [^6]: https://docs.x.ai/build/overview(核验 2026-10-15) [^7]: grok 1.0.52 自带文档 02-authentication(盒子里 ~/.grok/docs/user-guide)(核验 2026-10-15) [^8]: grok 1.0.52 自带文档 01-getting-started(核验 2026-10-15)