Grok CLI 命令速查表 - xAI Grok Build 终端编码代理
Grok CLI 是 xAI 出的终端编码代理，形态和其他终端代理一致，但选它的理由通常不是功能差异，而是你已经在用 xAI 的额度、或需要它的检索增强能力。安装认证、交互会话、无头模式与脚本、子命令与 MCP 这几组命令里，真正需要动手的只有三处，而且顺序不能乱：先解决认证，因为它是 Rust 单二进制、首次启动会走浏览器授权，CI 或远程服务器上必须改用 XAI_API_KEY；再决定运行形态，日常用交互会话，批量任务用 -p 无头模式直接产出可捕获的输出；最后才配自定义模型，写在用户级配置文件里而不是散落在命令行参数中，便于在多台机器间复制。与本批其它终端代理的差别在于配置探查方式：它内置了检查命令，能列出当前目录被发现的所有配置与工具挂载，排"为什么它没按我的配置行事"时省掉大量猜测。
安装与认证 4
curl -fsSL https://x.ai/cli/install.sh | bashmacOS/Linux/WSL 一行安装
irm https://x.ai/cli/install.ps1 | iexWindows PowerShell 安装
grok --version查看已安装版本
export XAI_API_KEY="xai-..."无浏览器环境用 API Key 认证
交互与会话 4
grok进入项目目录启动交互会话（首次浏览器授权）
/model在 TUI 内切换模型
grok inspect发现当前目录的配置、指令、skills、hooks、MCP
cat ~/.grok/config.toml查看/编辑用户级模型与端点配置
无头模式与脚本 3
grok -p "Explain this codebase"无头单次执行后退出
grok -p "Explain the architecture" --output-format streaming-json以流式 JSON 输出，便于程序解析
grok -p "Hello" -m my-model指定自定义模型运行
子命令与 MCP 16
grok -k <key> / --api-key用 CLI 选项设置/更新 API Key
grok -u <url> / --base-url指定自定义 API 端点（默认 https://api.x.ai）
grok -d <dir> / --directory设置本次会话的工作目录
grok -s <id> / --session恢复指定 ID 的已存会话
grok --max-tool-rounds <n>限制工具执行轮数（默认 400）
grok --sandbox在隔离沙箱中执行工具调用
grok --batch-api走 xAI Batch API 降本（适合非紧急任务）
grok --format json以 JSONL 事件流输出便于解析
grok --output-format jsonprint 模式的结构化 JSON 输出
grok models列出可用模型
grok git commit-and-pushAI 生成提交信息并推送当前分支
grok mcp add <name>添加 MCP 服务器（stdio）
grok mcp add-json <name> <json>用 JSON 配置添加 MCP 服务器
grok mcp remove <name>移除 MCP 服务器
grok mcp list列出已配置 MCP 服务器
grok mcp test <name>测试某个 MCP 服务器连通性
提示
- Grok CLI 是 Rust 实现的单一二进制，首次启动会开浏览器授权；无浏览器/CI 环境用
XAI_API_KEY环境变量即可跑无头任务。 grok inspect能列出当前目录被 Grok 发现的配置、skills、hooks 与 MCP 服务器，排查"为什么它没用到我的配置"时非常好用。- 自定义模型写在
~/.grok/config.toml的[model.my-model]段，配好后在 TUI 用/model或-m直接选。 - 无头模式里务必显式限定工作目录与允许的写范围，避免 Agent 从上层目录读到凭据文件；CI 中先跑只读任务验证提示词再放开写权限。
- 会话恢复与续接依赖本地会话记录，排查"上下文丢了"时先确认是否在同一目录启动——目录不同会命中不同的会话作用域。
- 接第三方模型时除填 API Key 外还要确认该模型名在 Grok CLI 的配置段里被声明为自定义项，否则
/model列表里不会出现它。
常见问题
Grok CLI 和社区里的 grok-cli (npm) 是同一个吗？
不是。本表是 xAI 官方 Grok Build 的 CLI（命令名 grok，由 x.ai/cli 安装脚本分发）；npm 上的 grok-cli（如 airplne/grok-cli）是社区第三方实现，命令与配置不同，请勿混用。
没有图形浏览器怎么用 Grok CLI？
设好 XAI_API_KEY 环境变量后直接用 grok -p "..." 跑无头任务即可，不需要浏览器授权；交互式 TUI 才需要首次浏览器 OAuth。
由 巧匠 维护
公开更新于 2026年8月26日，内容持续校对官方文档。