CLI

CLI 参考

不带参数运行 grok 会启动交互式 TUI。本页列出最常用的 subcommands 和 flags;运行 grok --helpgrok <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