Grok CLI 命令速查表 - xAI Grok Build 终端编码代理
Grok CLI 终端编码代理命令都在这里了，从安装认证到交互/无头模式、从项目分析到模型切换，按场景分类整理，复制即用。
安装与认证 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指定自定义模型运行
提示
- Grok CLI 是 Rust 实现的单一二进制，首次启动会开浏览器授权；无浏览器/CI 环境用 `XAI_API_KEY` 环境变量即可跑无头任务。
- `grok inspect` 能列出当前目录被 Grok 发现的配置、skills、hooks 与 MCP 服务器，排查"为什么它没用到我的配置"时非常好用。
- 自定义模型写在 `~/.grok/config.toml` 的 `[model.my-model]` 段，配好后在 TUI 用 `/model` 或 `-m` 直接选。
常见问题
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日，内容持续校对官方文档。