用途：把编码任务委派给 Grok Build（xAI 自主编程智能体 CLI，即 grok 命令）执行，适用场景包括构建功能、重构、PR 审查、批量修复 issue，以及任何原本会用 Codex / Claude Code 的任务。它可读取文件、编写代码、运行 shell 命令、派生 subagent 并管理 git 工作流。
安装与认证：推荐 npm install -g @xai-official/grok；官方安装脚本 curl -fsSL https://x.ai/cli/install.sh | bash 也可用，但 x.ai 主机在部分环境受 Cloudflare 限制，npm 方式可绕开。认证默认走 SuperGrok / X Premium+ 订阅：运行 grok login 一次，浏览器 OAuth，令牌缓存于 ~/.grok/auth.json。可用 grok --no-auto-update -p "Say ok." 做低成本冒烟测试；TUI 中 /logout 退出登录。备用方式：设置 XAI_API_KEY 走 api.x.ai 按量计费，仅在订阅登录不可用时使用。无需 git 仓库也能运行。零配置兼容 CLAUDE.md、.claude/ 与 AGENTS.md。
两种编排模式：一是无头模式（首选），grok --no-auto-update -p '...' 一次性执行并退出，适合一次性任务、CI/CD 自动化、配合 --output-format json 解析结构化输出；自动化中始终加 --no-auto-update。二是交互 TUI，需 pty=true，建议配合 tmux 监控，如 tmux new-session -d -s grok-work -x 140 -y 40，再用 tmux send-keys 与 tmux capture-pane 驱动和查看。
常用标志：-p/--single、-m/--model、-s/--session-id（新 UUID，不能用于续接）、-r/--resume [UUID]、-c/--continue、--fork-session、--max-turns、--cwd、--output-format plain|json|streaming-json、--always-approve（自主写入开关）、--no-alt-screen、--no-auto-update。长任务可 background=true、notify_on_complete=true 并用 process 工具轮询、查看日志或终止。会话以 UUID 为键，可自建 UUID 后按 UUID 续接，或用 -c 续接当前目录最近会话。
限制与注意：grok login 需 SuperGrok 或 X Premium+ 订阅；Hermes 自身的 xAI 认证与 grok CLI 认证相互独立，x_search 可用不代表 grok 已登录。只读审查应省略 --always-approve 以免自动改文件。文档改写时松散提示可能只返回变更摘要，应要求仅输出完整修订后的 markdown。完成后清理 tmux 会话（tmux kill-session -t <name>）和工作树。配置写入 ~/.grok/config.toml（非项目级），permission_mode 取代旧 approval_mode / yolo 键。价格与具体模型能力资料未提供。