cursor remote control 怎么用 手机遥控本机 Agent
cursor remote control 怎么用:Agents Window 交接后循环在云、工具在本机,电脑须保持在线。

人在路上想盯 Agent 改代码,又怕整仓推上云端 VM。cursor remote control 怎么用:在 Agents Window 开 Remote Control,用 /remote-control 把会话交给手机或 Web,推理循环在云端、工具执行仍在本机,仓库文件不离开你的电脑。
Remote Control 和纯 Cloud Agent 差在哪
Remote Control 文档 的核心句是:agent loop runs in the cloud, but tools execute on your local machine。纯 Cloud Agent 在远端 VM 里 checkout、改文件、push;Remote Control 改的是本机工作区里的文件,只是你从另一块屏幕发消息。
因此适合「代码必须留本地」的场景:公司笔记本政策、大仓库不想整包上传、或依赖只有本机能连的 VPN/内网 API。代价是电脑得醒着、Cursor 客户端得在线,关盖休眠或断网,远端指令无法在本机落工具。
与 cursor 本地和云端 agent 怎么切换 不同:handoff 是把整段会话绑到 cloud VM 或拉回本地;Remote Control 是「人远程、活在本机」。与 cursor in-cloud 怎么用 也不同:/in-cloud 派子任务上独立分支,Remote Control 不搬仓库。三者别混:handoff 换 runtime,in-cloud 派子 agent,remote control 换你的键盘位置。
开通条件与 Settings 入口
文档列出的硬性条件:
| 条件 | 说明 |
|---|---|
| 客户端 | Cursor ≥ 3.9.8 |
| 入口 | 仅 Agents Window |
| 订阅 | Pro+ 等含 Cloud Agents 的档位 |
| Git | 仓库必须有 Git remote |
| 隐私 | Privacy Legacy 不可用;Teams 需管理员开 Self-Hosted 相关选项 |
在桌面 Settings → Agents 打开 Remote Control 开关。Teams 组织若默认关闭,个人开关可能灰掉,要找 admin 在团队策略里放行。没有 Git remote 的纯本地文件夹开不了 Remote Control,先 git remote add 再试。
怎么用 slash 交接会话
- 本机 Agents Window 打开要遥控的项目,确认 Git remote 已配、工作区干净或已 commit。
- 在输入框发
/remote-control,下一条消息起会话进入 remote 模式,UI 会提示可从 mobile / Web 继续。 - 手机 Cursor App 或浏览器打开 Agents,同一账号下应能看到该 remote 会话;你在远端发的指令,本机 Agent 用本地工具执行(读文件、跑终端等)。
本机 Cursor 必须保持运行且机器未睡眠。合盖前调电源策略为「接通电源时不睡眠」,否则 Remote Control 会挂起。网络抖动时远端可能仍显示「思考中」,本机终端无输出,先查本机是否仍登录同一账号。交接后第一条远端消息尽量短(如「列 src 目录」),确认链路通再派长 refactor。
适用场景与别硬上的情况
值得用:通勤路上回复 Agent 提问、批准下一步、看 diff 摘要;本地跑着长测试,你离开座位用手机盯进度;同事在 Web 上看同一会话但不碰你键盘。
别硬上:本机即将关机或换网络;仓库没 remote、只在本地 git;组织禁 Privacy 以外模式但你仍开 Legacy;任务本来就该 /in-cloud 在隔离 VM 里炸 CI(那会占本机 CPU,失去 remote 的意义)。
Remote Control 不替代环境配置:本机缺依赖,远端指挥也跑不通。Cloud 侧 environment.json 那套给 VM 用,Remote Control 吃的是你当前 laptop 的 node、docker、VPN 状态。本机 terminal 弹权限框(macOS 录屏、钥匙串)时,远端看不到,必须回座位点确认。
Git 工作流上,Remote Control 仍走本机 credential:HTTPS token 或 SSH agent 必须在笔记本上可用,手机端不会替你存第二份密钥。无 remote 的仓库文档已写明不支持;fork 后忘记 push upstream 时,远端 Agent 改完本机文件,你仍要自己 git push。大 binary 或 LFS 文件改动时,手机上看 diff 摘要可能不全,回桌面 review 再 commit 更稳。
与隐私、合规相关的边界
分享的是会话控制权,不是把磁盘镜像上传。但对话内容仍经 Cursor 云端 loop,组织若要求 No Storage 或数据驻留某区域,要对照团队 Dashboard 策略,而非只看「代码在本地」这一句。
国内网络下 mobile / Web 连 Agents 的稳定性因运营商而异,文档未单列地区说明。Remote Control 前建议在本机 Wi‑Fi 稳定时试一条只读命令(如让 Agent 列目录),确认远端指令能反映到本机终端,再派长任务。若 mobile 端反复掉线,先排除本机睡眠与 VPN 分流,再查 Cursor 状态页是否有区域故障公告。
与 Automations 的区别:Automations 是事件触发、在 cloud VM 里跑完一整条流水线;Remote Control 是你主动接管已在本地开着的 Agent 会话。需要「关盖后仍跑 CI 修复」应走 in-cloud 或 handoff 上 VM,不是 Remote Control。Remote Control 适合「人不在键盘前,但机器还得用本机 VPN 和 docker」的短窗口。
多 monitor 或 RDP 进本机时,Remote Control 仍有效:远端发指令,实际 diff 出现在笔记本工作区。注意别让同事同时在本地键盘和手机上对同一会话发冲突指令,Agent 会把两条指令串行处理,后到的可能覆盖先到者的未保存中间态。
版本门槛 3.9.8 以下没有 Remote Control 菜单;升级后若开关仍灰,依次查订阅是否含 Cloud Agents、Git remote 是否存在、Privacy 是否仍 Legacy。与纯 Web 端 Cloud Agent 比,Remote Control 的最大卖点是本地未提交改动仍在磁盘上,你随时可 git checkout -- 回滚,而不必等 VM 分支 merge。
iPad 或手机竖屏看 diff 时,长文件改动建议让 Agent 分段汇报「改了哪几个文件、各几行」,你在桌面再开 IDE review。Remote Control 会话与本地 Side Chat 历史分离,别在 Side Chat 里找 remote 会话记录。若公司 policy 禁止手机装 Cursor,仍可用浏览器 Agents Web 遥控,前提是本机 Cursor 在线且 Remote Control 已开。