Grok CLI 命令行工具 速查备忘单

# 免安装直接运行
$ GROK_API_KEY=your_key npx -y grok-cli-hurry-mode@latest

# 全局安装
$ npm install -g grok-cli-hurry-mode@latest

# 启动交互式会话
$ grok

# 启动并发送初始消息
$ grok "Help me understand this project"

# Headless / 非交互模式
$ grok -p "explain the auth module"

# 使用指定大模型版本
$ grok -m grok-4-latest "refactor this file"

# 设置工作区基准目录
$ grok -d /path/to/project

# 设置最大工具调用轮数
$ grok --max-tool-rounds 100 "rewrite the API"

核心环境变量：

自动编辑模式 (Auto-edit mode)： 无感代码编辑——AI 无需弹出确认提示框即可直接修改文件。

上下文提示面板 (Ctrl+I)： 展示项目统计、Git 分支、内存占用及会话详细信息。

Read 工具 支持大文件的行偏移量/行数限制，并可以可视化展示图像。

Edit 工具 支持：

• 精准文本字符串替换
• 正则表达式模式匹配
• 单次或全量替换所有匹配项

Bash 工具 支持：

• 捕获 stdout 标准输出与 stderr 标准错误
• 后台守护进程运行
• 超时控制管理
• 环境变量继承与覆盖

快速连按 Shift+Tab 两次：

🎯 Plan Mode: Analysis
📊 Exploring codebase and gathering insights...

或使用 Headless 非交互命令：

$ grok -p "analyze changes in this PR and create plan"
$ grok -p "check if changes follow architecture guidelines"

规划模式下禁用的操作：

• 所有的文件写入/修改编辑工具
• 具有破坏性的 Bash 命令行
• 任何会修改系统状态的操作

允许的操作：

• 文件读取与检索 (ls, cat, grep)
• 联网搜索与网页抓取
• 项目结构与依赖分析
• 方案生成（仅允许写入 Plan 方案文档）

退出规划模式：

• 按 Enter 键——确认并开启执行该方案
• 按 Esc 键——退出且不执行方案

# Add stdio server
$ grok mcp add myserver \
  -t stdio \
  -c npx \
  -a -y my-mcp-package

# Add HTTP/SSE server
$ grok mcp add myserver \
  -t http \
  -u https://api.example.com/mcp

# Add with env vars and headers
$ grok mcp add myserver \
  -t http \
  -u https://api.example.com/mcp \
  -e API_KEY=secret \
  -h Authorization="Bearer token"

# Add from raw JSON
$ grok mcp add-json myserver \
  '{"transport":{"type":"stdio","command":"npx","args":["-y","pkg"]}}'

# List all servers
$ grok mcp list

# Test connection
$ grok mcp test myserver

# Remove a server
$ grok mcp remove myserver

未找到 API key (API key not found):

# 检查环境变量是否正确设置
$ echo $GROK_API_KEY

# 或在命令行中直接指定
$ GROK_API_KEY=key grok "hello"

安装后提示找不到命令 (Command not found):

# 将 npm 全局 bin 目录添加至 PATH 环境变量
$ echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
$ source ~/.zshrc
$ which grok

全局安装时报权限错误 (Permission errors):

# 强行安装或使用 Node 版本管理器
$ npm install -g grok-cli-hurry-mode --强制执行

# 推荐使用 nvm 免 sudo 安装
$ nvm use --lts
$ npm install -g grok-cli-hurry-mode

安装卡死或存在旧缓存:

$ pkill -f grok
$ npm uninstall -g grok-cli-hurry-mode
$ npm cache clean --强制执行
$ npm install -g grok-cli-hurry-mode@latest