CLI
CLI 参考
不带参数运行 grok 会启动交互式 TUI。本页列出最常用的子命令和选项;运行 grok --help 或 grok <subcommand> --help 查看完整列表。
子命令
| 命令 | 作用 |
|---|---|
grok login | 登录。--device-auth 在无界面或远程环境中使用设备代码身份验证 |
grok logout | 退出并清除缓存的凭据 |
grok inspect [--json] | 显示 Grok 为此目录发现的配置:规则、技能、插件、hooks 和 MCP servers |
grok models | 列出可用模型 |
grok mcp <list|add|remove|doctor> | 管理 MCP servers,请参阅 MCP Servers |
grok plugin <list|install|uninstall|update|enable|disable|details|validate> | 管理插件 |
grok plugin marketplace <list|add|remove|update> | 管理 marketplace 来源 |
grok sessions <list|search|delete> | 列出、搜索或删除会话,请参阅 Sessions |
grok export <session-id> [output] | 将会话记录导出为 Markdown |
grok import [targets...] | 从 Claude Code 导入会话 |
grok memory clear [--workspace|--global|--all] | 清除跨会话 memory 文件 |
grok worktree <list|show|rm|gc> | 管理为会话创建的 git worktree,请参阅 Worktrees |
grok dashboard | 打开 Agent Dashboard |
grok agent stdio | 通过 stdin/stdout 作为 ACP agent 运行,请参阅 无界面模式与脚本 |
grok wrap <command...> | 在可转发 OSC 52 clipboard 写入的本地 PTY 中运行命令,请参阅 Terminal Support |
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 | 恢复时分叉为新的 session ID |
-w, --worktree [<NAME>] | 在新的 git worktree 中启动会话 |
--ref <REF> | 用作 worktree 基准的 branch、tag 或 commit |
-m, --model <MODEL> | 要使用的 Model ID |
--effort <LEVEL> | 推理强度 |
--always-approve | 自动批准所有工具执行(别名 --yolo) |
--allow <RULE>, --deny <RULE> | 权限规则,请参阅权限 |
--sandbox <PROFILE> | Sandbox profile,请参阅 Sandbox |
--rules <TEXT> | 追加到系统 prompt 的额外规则 |
--system-prompt-override <TEXT> | 完全替换系统 prompt |
--tools <LIST>, --disallowed-tools <LIST> | 允许或移除内置工具 |
--max-turns <N> | agent 的最大轮数 |
--no-plan, --no-subagents, --no-memory, --disable-web-search | 为本次会话禁用功能 |
--experimental-memory | 启用跨会话 memory |
--oauth | 欢迎界面开始身份验证时使用 OAuth |
名称重叠的 Claude Code 选项可作为别名使用:--allowedTools、--disallowedTools、--append-system-prompt、--system-prompt 和 --dangerously-skip-permissions。
最后更新:2026 年 7 月 21 日