Skip to content
FunCoding

Search

Search docs, Skills and MCP

从其他设备远程控制

启用 GitHub 网页或 Mobile 远程控制,理解主机在线、账号和组织策略要求。

This page has not been translated into English yet. The original Chinese version is shown below.

远程控制让你从 GitHub.com 或 GitHub Mobile 查看正在运行的 CLI、回答问题和批准操作。任务仍在最初启动 CLI 的机器执行,不会转移到云端计算环境;需要关机后继续工作时,应考虑云端委派。

开启与关闭

已有交互会话中输入:

/remote on

CLI 显示访问链接。单独 /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,并把远端操作取回本地。它与仅同步历史不同,数据保存和分享见会话数据。