CLI
CLI 参考
不带参数运行 grok 会启动交互式 TUI。本页列出最常用的 subcommands 和 flags;运行 grok --help 或 grok <subcommand> --help 查看完整集合。
Subcommands
| 命令 | 作用 |
|---|---|
grok login | 登录。--device-auth 在 headless 或 remote 环境中使用 device-code 身份验证 |
grok logout | 退出并清除缓存 credentials |
grok inspect [--json] | 显示 Grok 为此目录发现的配置:rules、skills、plugins、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> | 管理 plugins |
grok plugin marketplace <list|add|remove|update> | 管理 marketplace 来源 |
grok sessions <list|search|delete> | 列出、搜索或删除 sessions,请参阅 Sessions |
grok export <session-id> [output] | 将 session transcript 导出为 Markdown |
grok import [targets...] | 从 Claude Code 导入 sessions |
grok memory clear [--workspace|--global|--all] | 清除 cross-session memory 文件 |
grok worktree <list|show|rm|gc> | 管理为 sessions 创建的 git worktrees,请参阅 Worktrees |
grok dashboard | 打开 Agent Dashboard |
grok agent stdio | 通过 stdin/stdout 作为 ACP agent 运行,请参阅 Headless 与脚本 |
grok wrap <command...> | 在转发 OSC 52 clipboard 写入的本地 PTY 中运行命令,请参阅 Terminal Support |
grok update | 检查更新或安装指定版本(--check、--version <V>、--alpha、--stable) |
grok version | 输出版本信息 |
grok completions <shell> | 生成 shell completion scripts |
grok setup | 获取并安装 managed 配置 |
常用 Flags
Headless 运行的 flags(-p、--output-format 及相关 flags)在 Headless 与脚本中介绍。
| Flag | 作用 |
|---|---|
--cwd <PATH> | 工作目录 |
-r, --resume [<ID>] | 按 ID 恢复 session;省略时恢复最近的 session |
-c, --continue | 继续当前目录最近的 session |
-s, --session-id <UUID> | 为新 session 使用指定 UUID |
--fork-session | 恢复时 fork 到新 session ID |
-w, --worktree [<NAME>] | 在新 git worktree 中启动 session |
--ref <REF> | 用作 worktree 基础的 branch、tag 或 commit |
-m, --model <MODEL> | 要使用的 Model ID |
--effort <LEVEL> | Reasoning effort |
--always-approve | 自动批准所有工具执行(别名 --yolo) |
--allow <RULE>, --deny <RULE> | Permission rules,请参阅权限 |
--sandbox <PROFILE> | Sandbox profile,请参阅 Sandbox |
--rules <TEXT> | 追加到 system prompt 的额外规则 |
--system-prompt-override <TEXT> | 完全替换 system prompt |
--tools <LIST>, --disallowed-tools <LIST> | 允许或移除内置工具 |
--max-turns <N> | Agent turns 最大数量 |
--no-plan, --no-subagents, --no-memory, --disable-web-search | 为此 session 禁用功能 |
--experimental-memory | 启用 cross-session memory |
--oauth | 欢迎界面启动身份验证时使用 OAuth |
重叠的 Claude Code flag 名称可作为别名使用:--allowedTools、--disallowedTools、--append-system-prompt、--system-prompt 和 --dangerously-skip-permissions。