从其他设备远程控制
启用 GitHub 网页或 Mobile 远程控制,理解主机在线、账号和组织策略要求。
远程控制让你从 GitHub.com 或 GitHub Mobile 查看正在运行的 CLI、回答问题和批准操作。任务仍在最初启动 CLI 的机器执行,不会转移到云端计算环境;需要关机后继续工作时,应考虑云端委派。
开启与关闭
已有交互会话中输入:
/remote onCLI 显示访问链接。单独 /remote 查看状态并重新显示访问详情,/remote off 关闭当前会话远程连接。启动时也可用 copilot --remote,避免会话开始后再手工启用。
若希望所有交互会话默认提供远程控制,在个人 settings.json 中设置:
{
"remoteSessions": true
}copilot --no-remote 对本次启动覆盖个人默认值。永久关闭则移除该设置或改为 false。官方正文有一处把设置简称为 remote,实际示例键为 remoteSessions,不要据此创建另一个键。
前提与位置
运行主机必须联网、终端中的 CLI 会话必须保持活跃。--prompt 非交互脚本不支持远程控制。工作目录无需是 Git 仓库,也不必托管在 GitHub;未关联 GitHub 仓库的会话只出现在个人 agents 页面,关联仓库的会话还会出现在该仓库 Agents 标签中。
若已有 Git remote 无法访问、CLI 无法解析仓库,可能显示 Remote session disabled。此时应排查仓库解析与策略,不能认定非 GitHub 仓库一概不受支持。
连接后能做什么
网页和 Mobile 可以发送提示、回应工具 / 路径 / URL 权限请求、回答澄清问题、接受或拒绝计划、切换模式和取消当前操作。远程界面目前不支持 /allow-all 等斜杠命令。
本地和远程界面同时有效,同一个问题或批准请求以先收到的回答为准。只能用启动该会话的同一个 GitHub 账号访问,其他用户不能据此接管你的会话。
在本地执行 /remote 后,输入框为空时按 Ctrl+O 可展开访问二维码;该快捷键会展开或折叠所有详情,不只改变二维码。
防止休眠与恢复
| 命令 | 作用 |
|---|---|
/keep-alive | 查看状态 |
/keep-alive on | 会话活跃期间保持唤醒 |
/keep-alive off | 恢复正常休眠 |
/keep-alive busy | 工作或等待用户输入时保持唤醒 |
/keep-alive 30m | 指定时长,也接受 h、d;无后缀数字按分钟 |
主机断网或休眠时无法远控,恢复联网后可以重新连接。用 --continue 或 --resume 恢复曾开启远程控制的会话时,会自动重新启用远控;不要把退出后恢复理解为自动清除远控偏好。
组织与设备策略
组织提供的 seat 要求 Store local sessions in the Cloud 策略为 View and control。View from cloud 只同步供查看;禁用或未配置时,组织用户既不能同步也不能远控。企业可以强制设置或允许组织自行选择。
额外的企业 remoteControl 管理设置针对托管会话的设备,可要求控制端对指定组织完成 SSO,或完全禁止该设备被远控,不影响用户控制其他设备上的会话。
远程控制会把消息、工具事件和权限请求发送到 GitHub,并把远端操作取回本地。它与仅同步历史不同,数据保存和分享见会话数据。