深色模式
Grok Build 常见问题排错：九个我们遇到或在文档里读到的坑
这是「Grok Build 实战」系列：Dato 和他的 Bot 把官方文档和别人的教程对着真实安装的 CLI（1.0.52）验证了一遍。本篇参考了：官方文档：Grok Build 概览。命令输出和截图都是我们自己做的，没有搬运原文；没做到的会写明。
每条都标了来源：实测＝我们在盒子里复现过；文档＝官方文档里这样写，我们没复现。
逐条说明
1. Not signed in（实测）：未登录运行 grok -p，提示用 grok login --device-code，或设置 XAI_API_KEY，退出码 1。脚本里注意判断退出码。
2. 规则、技能、权限不加载（实测）：多半是目录未信任。grok inspect 看 Project trusted，详见《信任目录》。
3. 项目钩子不运行（文档）：没信任前钩子被静默跳过，不会报错[^1]。另外官方还写了钩子失败时默认放行（fail open），PreToolUse 才能拦工具调用，别把关键安全检查只放在会失败的钩子里。
4. 颜色全无（实测）：grok doctor 提示"Colors are off because NO_COLOR is set"，取消 NO_COLOR 重启即可。
5. Shift+Enter 不换行（实测）：终端不支持 Kitty 键盘协议时，grok doctor 提示换行用 Alt+Enter。
6. grok -w "提示词" 提示词被吞（文档）：-w 后面的引号文字被当成 worktree 名，要写 --worktree=名字 "提示词"[^2]。
7. 在交互界面里用 --max-turns 没效果（文档）：这几个参数只在无头模式有效，交互界面会警告并忽略[^2]。
8. 凭据泄露风险（文档）：~/.grok/auth.json 只有 owner 可读，别复制到共享目录、工单、聊天[^3]。
9. 磁盘占用（实测）：~/.grok 约 181 MB，几乎都是程序本体，grok du 可看。
提问前自己先跑的三条命令
bash
grok --version
grok doctor
grok inspect把这三条的输出（先去掉任何路径里的个人信息）贴出来，别人才好帮你。
我们没遇到、所以没写的
登录后的网络错误、模型选择问题、额度耗尽时的界面，我们都没有机会测试，不写。官方 TUI 里有 /feedback 可以直接给团队报问题[^4]。
常见问题
Q：grok doctor 会上传信息吗？
A：官方说它在不启动 Grok 的情况下检查终端环境。我们没有抓包验证网络行为，未证实是否完全离线。
Q：怎么给官方反馈？
A：TUI 里输入 /feedback。
Q：agent 命令是什么？
A：安装后同时生成 grok 和 agent 两个入口；grok agent 是不带界面运行的子命令，文档里用于 ACP 服务和自动化[^2]，我们没深入。
想直接开通？
需要代充，请联系站长，微信 siuserxiaowei（备注"Grok Bot 教程"）。首单报优惠码 xiaowei 立减 20 元。更多免费教程在 grokguide.si。
风险提示
官方定价页写明，订阅只通过官网直接销售，不授权第三方卖家，从其他渠道买的订阅可能被暂停（cursor.com/pricing）。站长提供的是个人代充服务，与 xAI / Grok / Cursor 官方无关，请了解风险后再决定。任何时候都不要把账号密码、验证码交给别人，包括站长。
参考来源
[^1]: grok 1.0.52 自带文档 10-hooks（核验 2026-10-15） [^2]: grok 1.0.52 自带文档 14、01（核验 2026-10-15） [^3]: grok 1.0.52 自带文档 02-authentication（核验 2026-10-15） [^4]: https://x.ai/news/grok-build-cli（核验 2026-10-15）