Skip to content

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

登录:三种方式(来自官方文档,我们没登录) ​

  1. 浏览器登录(默认):首次运行 grok 会打开浏览器,通过 grok.com / auth.x.ai 授权,凭据存在 ~/.grok/auth.json[^7]。
  2. 设备码登录:没有浏览器的服务器用 grok login --device-auth(别名 --device-code)[^5]。
  3. 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)

非官方教程,内容整理自官方文档和社区讨论,以官方最新说明为准。 · 联系作者 / 加微信交流