CLI 参考
不带参数运行 grok 启动交互式 TUI。本页列出了最常用的子命令和标志；运行 grok --help 或 grok <子命令> --help 查看完整列表。
子命令
| 命令 | 功能 |
|---|---|
grok login | 登录。--device-auth 使用设备码认证，适用于无头或远程环境 |
grok logout | 登出并清除缓存的凭证 |
grok inspect [--json] | 显示 Grok 为当前目录发现的配置：规则、技能、插件、钩子和 MCP 服务器 |
grok models | 列出可用模型 |
grok mcp <list|add|remove|doctor> | 管理 MCP 服务器 |
grok plugin <list|install|uninstall|update|enable|disable|details|validate> | 管理插件 |
grok plugin marketplace <list|add|remove|update> | 管理市场源 |
grok sessions <list|search|delete> | 列出、搜索或删除会话 |
grok export <session-id> [output] | 将会话记录导出为 Markdown |
grok import [targets...] | 从 Claude Code 导入会话 |
grok memory clear [--workspace|--global|--all] | 清除跨会话记忆文件 |
grok worktree <list|show|rm|gc> | 管理为会话创建的 git 工作树 |
grok dashboard | 打开 Agent 仪表板 |
grok agent stdio | 作为 ACP 智能体通过 stdin/stdout 运行 |
grok wrap <command...> | 在本地 PTY 中运行命令，转发 OSC 52 剪贴板写入 |
grok update | 检查更新或安装特定版本（--check、--version <V>、--alpha、--stable） |
grok version | 打印版本信息 |
grok completions <shell> | 生成 shell 补全脚本 |
grok setup | 获取并安装托管配置 |
常用标志
无头运行的标志（-p、--output-format 等）请参阅无头模式与脚本。
| 标志 | 功能 |
|---|---|
--cwd <PATH> | 工作目录 |
-r, --resume [<ID>] | 按 ID 恢复会话，省略则恢复最近的 |
-c, --continue | 继续当前目录最近的会话 |
-s, --session-id <UUID> | 为新会话使用特定 UUID |
--fork-session | 恢复时分叉到新会话 ID |
-w, --worktree [<NAME>] | 在新的 git 工作树中启动会话 |
--ref <REF> | 工作树所基于的分支、标签或提交 |
-m, --model <MODEL> | 使用的模型 ID |
--effort <LEVEL> | 推理深度 |
--always-approve | 自动批准所有工具执行（别名 --yolo） |
--allow <RULE>, --deny <RULE> | 权限规则 |
--sandbox <PROFILE> | 沙箱配置 |
--rules <TEXT> | 追加到系统提示的额外规则 |
--system-prompt-override <TEXT> | 完全替换系统提示 |
--tools <LIST>, --disallowed-tools <LIST> | 允许或移除内置工具 |
--max-turns <N> | 最大智能体轮次数 |
--no-plan, --no-subagents, --no-memory, --disable-web-search | 禁用某个功能 |
--experimental-memory | 启用跨会话记忆 |
--oauth | 欢迎屏幕启动认证时使用 OAuth |
Claude Code 的标志名称也被接受为别名：--allowedTools、--disallowedTools、--append-system-prompt、--system-prompt 和 --dangerously-skip-permissions。