Cursor CLI 的斜杠命令与参数：reference 两页怎么查

2026-08-18

一、为什么会来回翻这两页

用 Cursor CLI 时最容易卡住的地方不是不会用，而是同一件事有两个入口：会话里敲斜杠命令是一套，启动进程时传参数是另一套。想在 Plan 模式下开工，既可以启动时加 --plan，也可以进去之后敲 /plan；想换沙箱设置，既有 /sandbox，又有全局选项 --sandbox <mode>，还有一个叫 sandbox 的子命令。你脑子里记得有这个能力，但记不清当时是在哪一层用的。

官方文档把这两套拆在了两页：cursor.com/docs/cli/reference/slash-commands 只放会话内的斜杠命令表，cursor.com/docs/cli/reference/parameters 放全局选项、命令表和各命令的子命令表。这篇就按这两页的原文，把「一共有多少条、怎么分组、哪些是同一件事的不同写法」讲清楚，方便你下次直接定位到那一行。文中所有条目都来自这两页（Shell Mode 部分来自 cursor.com/docs/cli/shell-mode），Cursor 迭代频繁，以官方文档最新内容为准。

二、前置条件

先说清楚这些命令在哪个端上、什么状态下才谈得上。

装在哪。 安装页（cursor.com/docs/cli/installation）给了两条路径：macOS、Linux 以及 Windows 的 WSL 用同一条 shell 命令；Windows 原生用 PowerShell，两条命令的地址不一样，Windows 原生那条带了 win32=true 参数：

curl https://cursor.com/install -fsS | bash

irm 'https://cursor.com/install?win32=true' | iex

装完的验证命令是 agent --version。注意可执行文件名是 agent 而不是 cursor，parameters 页里所有示例的写法都是 agent xxx。

PATH 与版本。 安装页的「Post-installation setup」只给了 bash 和 zsh 两种 rc 文件的 PATH 追加写法（追加 $HOME/.local/bin）。Windows 原生环境下 PATH 怎么配，这一页没有写。文档写明 CLI 默认会尝试自动更新，手动更新是 agent update，会话内对应 /update。本文不涉及具体版本号——parameters 与 slash-commands 两页都没有标注每条命令是从哪个版本开始有的，官方文档没有说明这一点，所以你翻到的表就是文档当前的状态，不代表你本机那一版一定齐全。

账号与模式。 login、logout、status（别名 whoami）在命令表里，会话内也有 /logout。斜杠命令表里 /max-mode 的描述限定在「legacy request-based plans」上，/bedrock 的描述是「Bedrock 功能被启用时」才用于配置——这两条都带前置条件，不是人人可见。本文不涉及任何订阅与计费信息。

三、两页各写了什么，怎么读

斜杠命令表：35 条，按用途分堆

slash-commands 页是一张两列表，回源数过是 35 行。先说清楚这个数字的性质：它是这一页文档当前的行数，命令会随版本增删，下次你去翻很可能就不是这个数了——本文引用的所有条数都只用来说明「这一页大概多大、怎么分堆」，不要当成固定清单，一律以官方文档最新内容和你本机 --help 的输出为准。它没有分组标题，但读下来能分成几堆：

模式切换：/model [filter]、/plan [prompt]、/ask、/debug [prompt]、/run-everything [on|off|status]。注意后三者的参数形态不同：/plan 和 /debug 可以直接跟一段 prompt（文档写的是「切换模式，或在该模式下提交一个 prompt」），/ask 是纯切换，/run-everything 收的是 on|off|status 三个值之一。
会话管理：/clear、/resume、/fork、/rename <name>、/summarize、/rewind、/copy。其中 /rename 的参数在文档里写成 <name>（尖括号，必填），而 /model [filter] 是方括号（可选），这个区分在整张表里是一致的，可以当作判断依据。
显示与终端：/vim、/line-numbers、/show-thinking、/status-indicators、/setup-terminal。
外部能力：/shell [command]、/mcp [list|list-tools] [identifier]、/plugin [subcommand]、/sandbox、/config、/bedrock [subcommand]。
杂项与排障：/logs（文档写明是显示 debug 日志路径并复制到剪贴板）、/about、/help [command]、/feedback <message>、/open、/copy-request-id、/copy-conversation-id、/update、/logout、/quit、/exit。

别名是这张表最省事的一栏。 表里明确写了别名的有 5 条命令：/run-everything 的别名是 /auto-run；/clear 的别名有 /new、/new-chat、/newchat 三个；/summarize 的别名是 /compress；/shell 的别名是 /sh 和 /run；/open 的别名是 /cursor。也就是说你看到别人写 /compress，它和 /summarize 是同一条，不用再去找。

parameters 页：全局选项 23 条 + 命令 18 条 + 三组子命令

parameters 页的结构比斜杠表清楚，它自己分了小节。

**Global options（23 行，任何命令都能带）**里，几组语义值得单独记：

选项	文档写明的语义
`-p, --print`	把响应打印到控制台，供脚本或非交互使用；可以用全部工具，包括写入和 shell
`--output-format <format>`	只在 `--print` 下生效，取 `text`、`json`、`stream-json`，默认 `text`
`--stream-partial-output`	只在 `--print` 且格式为 `stream-json` 时生效
`--mode <mode>`	取 `plan` 或 `ask`；不指定 mode 时默认是 agent
`--plan`	`--mode=plan` 的简写
`--continue`	`--resume=-1` 的别名
`-f, --force`	强制放行命令，除非被显式拒绝；`--yolo` 是它的别名
`--trust`	不提示直接信任工作区，仅 headless 模式
`--sandbox <mode>`	取 `enabled` 或 `disabled`
`-w, --worktree [name]`	在 `~/.cursor/worktrees/<reponame>/<name>` 下新建 Git worktree 运行；省略 name 时自动生成
`--worktree-base <branch>`	新 worktree 基于哪个分支或 ref，默认当前 HEAD
`--skip-worktree-setup`	跳过 `.cursor/worktrees.json` 里的 worktree 安装脚本

这里有三处「读表要看括号」的细节：--api-key <key> 文档写明也可以用环境变量 CURSOR_API_KEY；-H, --header <header> 的格式是 Name: Value，且写明可以重复使用；--plugin-dir <path> 同样写明可重复指定。可重复与否文档是逐条标的，没标的就别当成能重复。

**Commands（18 行）**是子命令层。除了常见的 login／logout／status／about／models／update，有几条要留心：sandbox 的描述后面括号里写着 hidden；acp 写的是「advanced, hidden command」，页面正文还补了一句，说 agent acp 面向自定义 ACP 客户端与高级集成，默认不出现在命令帮助输出里。文档只对 acp 明说了「默认不出现在命令帮助输出里」，sandbox 那一行则只在描述末尾标了 hidden 这个词，它在帮助输出里到底显不显示，官方文档没有说明这一点。能确定的只有一条：--help 里没有的命令不等于不存在，这两页的表至少包含了标为 hidden 的条目，这是来回翻这两页最实际的一点收获。

generate-rule（别名 rule）、create-chat、install-shell-integration / uninstall-shell-integration 也在这张表里。后两条文档写明操作的是 ~/.zshrc，只提到了 zsh。

三组子命令表分别挂在 mcp、sandbox、worker 下：

mcp：login、list、list-tools、enable、disable，回源数过共 5 条。login <identifier> 的说明里写明 identifier 来自 .cursor/mcp.json 或 ~/.cursor/mcp.json。
sandbox：enable、disable、reset、run、help，5 条。sandbox disable 的描述是「禁用 sandbox 模式并改用 allowlist 模式」——不是「什么都不管了」，而是换了另一套判定。sandbox run 另有 6 个选项：--allow-paths、--readonly-paths、--blocked-patterns（gitignore 风格的阻断模式）、--sandbox（默认 true）、--network（默认 false）、--sb-debug。
worker：start、debug、help，3 条，用于「在你自己的环境里跑 agent 的私有云 worker」。选项里 --label 与 --labels-file 文档写明不能同时使用，--single-use 被标为 --pool 的 legacy alias，--idle-release-timeout 的默认值 0 表示不按空闲释放。

除上面三组各自的选项之外，parameters 页最后那张「Command-specific options」表只有两行：status／whoami 和 about 各有一个 --format，取 text 或 json，文档写明默认是 text（默认值随版本可能变动）。

组合起来长什么样

把上面几条按文档语义拼一条非交互调用：

agent -p "fix the tests" --output-format stream-json --stream-partial-output --workspace <你的项目目录> --sandbox enabled

Windows 原生 PowerShell 下写成一行同理，只是不要用反斜杠续行。以上为按官方文档中的参数语义组合的示例，未经实测，以官方文档与 --help 的实际输出为准。

四、边界：这两页没说的和标了限定的

--print 的权限边界要连着读两处。 parameters 页在 -p, --print 那一行写的是「可以用全部工具，包括写入和 shell」；cursor.com/docs/cli/using 页在非交互模式一节写的是「Cursor 在非交互模式下有完整写入权限」。两处口径一致，非交互不等于只读。权限本身在 cursor.com/docs/cli/reference/permissions 用 Shell() / Read() / Write() / WebFetch() / Mcp() 五类 token 配置，配置文件是 ~/.cursor/cli-config.json 或 <project>/.cursor/cli.json，deny 优先于 allow。

/run-everything 和 -f, --force 是什么关系，两页都没写。 一个在斜杠表里、一个在全局选项里，描述文字互不引用，官方文档没有说明这一点，别假设敲 /run-everything on 就等于带了 --force。

Shell Mode 有明说不支持的场景。 cursor.com/docs/cli/shell-mode 的 Limitations 一节写明：长时间运行的进程、服务器、交互式提示不支持；命令有固定超时上限，FAQ 里进一步写明这个超时不可配置（本文不写具体秒数，以文档为准）。cd 不跨命令保留，要换目录得写成 cd <dir> && ...。权限方面该页写明管理员策略可能阻断某些命令，且带重定向的命令无法内联加入 allowlist。

shell 支持范围与 Windows。 shell-mode 页写的是「支持来自 $SHELL 变量的 zsh 和 bash」。Windows 原生（非 WSL）下 Shell Mode 取哪个 shell、PowerShell 是否在支持范围内，这一页没有写，官方文档没有说明这一点。要在 Windows 上稳妥使用，WSL 是文档里明确覆盖的路径。

这两页里没有 beta / preview / experimental / deprecated 字样。 有的是另外两种限定词：hidden（sandbox、acp）和 legacy（--single-use 是 legacy alias，/max-mode 限定在 legacy 计划上）。hidden 不等于试验性，legacy 也不等于已废弃，文档没往下说，就不要替它补语义。

一处口径不一致值得记一下。 命令表里 ls 的描述是「Resume a chat session」，resume 的描述是「Resume the latest chat session」，两条描述看起来重合；而 using 页把 agent ls 说成「打开之前的会话并恢复其中一个」。三处放在一起，ls 更像是先列后选。指出到这里为止，具体行为以你本机 agent ls --help 的输出为准。

五、怎么确认你查对了

这两页毕竟是文档，本机装的那一版是否一致，用下面几条自查（都在文档里能核到）：

agent --version 确认 CLI 可用；agent about --format json 拿到版本、系统与账号信息的结构化输出，会话内对应 /about。
agent help [command] 或任意命令带 -h, --help。文档写明所有命令都支持 -h, --help，mcp 与 sandbox 的子命令也各自支持。会话内用 /help <command> 看单条命令的详情。
想确认某条斜杠命令在你这一版存不存在，直接 /help 对照 slash-commands 页那 35 行；表里标了别名的 5 条，任选一个别名试同样有效。
MCP 配没配上用 agent mcp list 看已配置的服务器与状态，agent mcp list-tools <identifier> 看某个服务器的工具及参数名。
sandbox 相关用 agent sandbox run <cmd> 单独跑一条命令验证策略；需要排障时该子命令有 --sb-debug，文档写明会把 sandbox 调试日志写到临时目录并打印路径。
会话侧出问题先用 /logs 拿 debug 日志路径，再用 /copy-request-id、/copy-conversation-id 取标识，反馈时带上。
用私有 worker 的话，agent worker debug 有 --json，文档描述是针对认证、隐私与路由的预检诊断。

一句话记法：会话里能敲的看 slash-commands 那一页，启动时能传的看 parameters 那一页；两页都有的（model、plan、ask、sandbox、resume、update、about、logout）说明它是同一个能力的两层入口，别以为是两个功能。

本文依据 Cursor 官方文档（cursor.com/docs 与 cursor.com/help）于 2026-08-18 的公开内容整理。该产品闭源，本文只复述官方文档写明的机制，不推断其内部实现； 我们没有对文中涉及的功能做过实测，因此不涉及界面外观、操作手感与运行速度的任何描述。该产品迭代频繁，文中涉及的设置项与命令随版本变动，请以官方文档最新内容为准。本文不涉及订阅价格、额度与模型清单，相关信息请以官方定价与模型说明页为准。

安全与合规相关做法请结合自身环境评估，本文不构成安全方案建议。