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 服务器 — 请参阅 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`	打开代理仪表板
`grok agent stdio`	通过 stdin/stdout 作为 ACP 代理运行 — 请参阅无头与脚本
`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。