Grok CLI 备忘清单（官方）

grok

grok -s my-session -p "Draft plan"
grok -s my-session -p "Implement step 1"
grok -c -p "Continue from latest"

grok inspect
grok -p "Hello" -m my-model

grok agent stdio

自定义模型写在用户级配置文件中：

~/.grok/config.toml

在配置中声明自定义模型并设为默认：

[model.my-model]
model = "model-id"
base_url = "https://api.example.com/v1"
name = "Display Name"
env_key = "API_KEY"

[models]
default = "my-model"

[model.fast]
model = "grok-build-0.1"
base_url = "https://api.x.ai/v1"
name = "Fast Build"
env_key = "XAI_API_KEY"

[model.strict]
model = "my-strict-model"
base_url = "https://api.example.com/v1"
name = "Strict Review"
env_key = "EXAMPLE_API_KEY"

[models]
default = "fast"

检查生效并调用：

$ grok inspect
$ grok -p "Hello" -m my-model

也可以在 TUI 中用 /model <name> 切换。

常用方式：

# 使用默认模型
$ grok -p "Summarize this repo"

# 临时指定模型别名
$ grok -p "Review this patch" -m strict

# 1) 检查当前目录发现到的模型/配置来源
$ grok inspect

# 2) 检查对应 key 是否存在
$ printenv XAI_API_KEY

若模型无法选择，优先检查：

• env_key 对应环境变量是否已导出。
• base_url 和 model 是否拼写正确。
• default 是否引用了已定义别名。

ACP 适合把 Grok 接入 IDE、脚本平台或你自己的工具链。运行方式是 JSON-RPC over stdio。

$ grok agent stdio

• 已登录本机账号：可直接使用本地缓存凭据。
• 无本地登录态：设置环境变量 XAI_API_KEY。

$ export XAI_API_KEY="xai-..."
$ grok agent stdio

1. initialize：声明客户端能力并读取可用认证方法。
2. authenticate：使用 cached_token 或 xai.api_key。
3. session/new：创建会话并指定 cwd。
4. session/prompt：发送提示。
5. 监听 session/update：增量接收 agent_message_chunk 文本。

保存为 acp-quick.mjs 后可直接运行：

$ node acp-quick.mjs

import { spawn } from "node:child_process";
import readline from "node:readline";

const p = spawn("grok", ["agent", "stdio"], { stdio: ["pipe", "pipe", "pipe"] });
const rl = readline.createInterface({ input: p.stdout });
let id = 1;
let text = "";

rl.on("line", line => {
  const m = JSON.parse(line);
  if (m.method === "session/update") {
    const u = m.params?.update;
    if (u?.sessionUpdate === "agent_message_chunk" && u.content?.text) text += u.content.text;
    if (u?.sessionUpdate === "done") console.log(text.trim());
  }
});

const send = (method, params) =>
  p.stdin.write(`${JSON.stringify({ jsonrpc: "2.0", id: id++, method, params })}\n`);

send("initialize", { protocolVersion: 1, clientCapabilities: { terminal: true } });
send("authenticate", { methodId: process.env.XAI_API_KEY ? "xai.api_key" : "cached_token" });
send("session/new", { cwd: process.cwd(), mcpServers: [] });
// 实际接入时，拿到 sessionId 后再发送 session/prompt

• 在 CI/脚本里配合 --no-auto-update，减少额外噪音和不确定性。
• 若只需要一次性结果，用 grok -p 更简单；需要双向协议集成时再用 ACP。