CLI

CLI 参考

查看 Markdown

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