Cursor Side Chat 怎么用:主 Agent 不停、旁路问答与对话搜索
Cursor 3.11 的 Side Chat(/side、/btw)与 Agents Window 对话搜索(Cmd+K / Cmd+F)用法、适用边界、常见踩坑,以及和主 Agent、Cloud hooks 的分工。

主 Agent 正在改半个模块,你突然想起「这个鉴权以前怎么写的」——若塞进同一条线程,上下文会被带偏,进度也被打断。Cursor 3.11(changelog 标注 2026-07-10)给出的解法是:Side Chat 旁路会话 + 可搜索的历史 transcript。依据 官方 Side Chat changelog;命令以你本机版本为准。
Side Chat 解决什么问题
打开方式有三种:输入 /side、输入 /btw,或点聊天面板顶部的加号。新开会话会带上主会话上下文,但是独立、可持久、可回访的完整 Agent 对话;之后可用 at-mention 把旁路结论拉回主线程。
官方默认定位偏「读、搜、答」:
- 澄清一个事实或接口含义
- 调研备选方案,却还不想让主 Agent 转向
- 主 Agent 还在跑时,做一次 sanity check
它不是「再开一个无限制乱改仓库的小号主对话」。大范围改文件、换架构,应停主任务或新开执行向会话,并写清范围——可对照 Agent 模式排查。
一套可复制的用法
场景 A:主任务在跑,你要核对。
主 Agent 继续;Side Chat 问「AuthMiddleware 现在校验的是 JWT 还是 session?」要求只读文件、给结论。确认后 at-mention 回主线程一句「按 side chat 结论继续」。
场景 B:怕主线程被带偏。
想比较「用 Redis 还是内存缓存」时,先 Side Chat 列利弊与改动面;决定后再回主会话下指令。避免主线程里来回打架。
场景 C:找回历史结论。
上周 Agent 贴过一段 SQL,会话标题却是 Untitled。打开 Agents Window,用命令面板 Cmd+K(Windows 多为 Ctrl+K)搜 transcript 正文里的报错或文件名;已打开的长会话里用 Cmd+F 跳匹配。官方称索引在本地,可撑到上千条会话。
和同版其它改动别混在一键里
3.11 还改了项目/仓库选择器:搜索按 This Computer / Cloud / 远程机分区;可在 picker 里建项目并接 GitHub、GitLab、Azure DevOps;无仓库工作是明确的 No Repo(输入 none 或 no repo 可搜到)。这和 Side Chat 无关,但开 Agents Window 时会一起撞上。
同版还加了 Cloud Agent 对话级 hooks(如 beforeSubmitPrompt、afterAgentResponse 等),用于观察与管控云端对话本身。本地 Side Chat 是个人流控;hooks 是团队云端治理——需要团队策略时再读官方 hooks 文档,不要指望 /side 代替合规门禁。
常见失效与误用
| 现象 | 先查什么 |
|---|---|
/btw 无反应 |
版本是否 ≥ 3.11;改用面板加号;重启窗口 |
| 旁路也开始大改文件 | 你是否给了「直接改」指令;默认应偏只读,明确禁止写盘 |
| 搜不到旧会话 | 是否在 Agents Window 用 Cmd+K;是否搜的是正文关键词而非标题 |
| 和 CLI 工作流搅在一起 | CLI 是另一条入口;Side Chat 是 IDE/Agents Window 旁路 |
Composer 与 Chat 的分工见 Composer vs Chat;总选型见 Cursor 还值不值得换。
什么时候用旁路,什么时候别用
- 主任务还在跑,只想核对一个事实 → Side Chat。
- 准备换方案、要动很多文件 → 停主任务或新开主会话。
- 把侧栏当「第二个工地」长期并行大改 → 用多会话/多 agent,并接受更高的冲突成本,而不是滥用 Side Chat。
- 需要组织级拦截危险工具 → Cloud hooks / 团队策略,不是个人
/btw。
一句话:Side Chat 是走廊问询,不是第二间装修现场。
常见问题
Side Chat 会不会消耗和主会话一样的额度?
会占用模型用量;具体计费以账户面板为准。旁路适合短问短答,把长重构放回主会话更清晰。
能不能多个 Side Chat 同时开?
可以开多个旁路,但人的注意力有限。超过两个并行旁路时,建议把结论写进 issue/笔记,关掉闲置会话。
和 Claude Code 的子代理是一回事吗?
不是。Side Chat 是 Cursor 产品内的旁路对话;Claude Code 子代理是另一套编排。不要混配置、混预期。