# 通过其他设备控制 GitHub Copilot 命令行界面 (CLI) 会话
启用对会话的 Copilot 命令行界面（CLI） 远程访问，以便你可以监视进度、响应提示以及继续从 GitHub.com 或 GitHub Mobile继续工作。
远程访问使你能够从任何浏览器或从Copilot 命令行界面（CLI）连接到正在运行的GitHub Mobile会话。 可以查看会话输出、响应权限请求，并继续在会话中工作，而无需在运行会话的计算机。
本文介绍如何启用和使用远程访问。 有关更多概念性信息，请参阅 [关于对会话的 GitHub Copilot 命令行界面 (CLI) 远程访问](/zh/copilot/concepts/agents/copilot-cli/about-remote-access)。
> \[!NOTE]
>
> * Copilot 命令行界面（CLI） 会话远程访问处于 公共预览版 状态，并且随时可能会发生更改。
> * 移动访问目前仅在最新 beta 版本的GitHub Mobile中可用。 可以通过GitHub Mobile 和[适用于 Android 的 Google Play](https://testflight.apple.com/join/NLskzwi5) 加入测试计划[](https://play.google.com/apps/testing/com.github.android)。
## 先决条件
* 运行 CLI 会话的计算机必须处于联机状态，会话在终端中主动运行。
> \[!TIP]
> 使用 `/keep-alive` 斜杠命令可防止你的计算机在你不在时进入睡眠状态。 请参阅 [防止计算机进入睡眠](#preventing-your-machine-from-going-to-sleep)状态。
* 工作目录必须包含托管在上的 GitHub.comGit 存储库。 如果不在存储库中 GitHub ，CLI 将显示：“远程会话已禁用：不在存储库中 GitHub 。
## 为会话启用远程访问
可以通过三种方式启用远程访问：
* 在交互式会话期间使用斜杠命令。
* 启动 Copilot 命令行界面（CLI）时使用命令行选项。
* 通过将 CLI 配置为在所有交互式会话中默认启用远程访问。
### 使用`/remote`斜杠命令
如果已在交互式会话中并想要启用远程访问，请输入：
```copilot copy
/remote
```
CLI 连接到 GitHub.com，并显示远程访问该会话的详细信息 - 请参阅本文后面的[从 GitHub.com 访问会话](#accessing-a-session-from-githubcom)和[从 GitHub Mobile 访问会话](#accessing-a-session-from-github-mobile)。
### 使用`--remote`命令行选项
如果认为你可能想要远程访问会话，可以使用命令行选项启动 CLI `--remote` 。 这样就无需记住在会话期间使用 `/remote` 斜杠命令。
```bash copy
copilot --remote
```
当交互式会话启动时，将显示远程访问会话的详细信息，并且随时可以使用 `/remote` 斜杠命令再次显示。
### 配置远程访问以始终启用
如果始终希望远程访问交互式 CLI 会话，请将以下内容 Copilot 添加到配置文件（通常位于 `~/.copilot/settings.json`）：
```json copy
{
"remoteSessions": true
}
```
若要覆盖特定会话的此设置，请使用 `--no-remote` 启动会话时的选项：
```bash copy
copilot --no-remote
```
> \[!NOTE]
> 命令行选项 `--remote` ，并且 `--no-remote` 始终优先于 `remoteSessions` 配置文件中的设置。
## 从 GitHub.com 访问会话
启用远程访问后，CLI 将显示采用以下格式的链接：
```text
https://github.com/OWNER/REPO/tasks/TASK_ID
```
使用此链接访问 Web 浏览器中的会话。 必须使用启动 CLI 会话的同一帐户登录 GitHub 。
还可以从最近的代理会话 GitHub.com列表中访问会话：
1. 在 GitHub 的左上角，单击 。
2. 单击 **Copilot**。
3. 在“最近的代理会话”中，单击您的 Copilot 命令行界面（CLI） 会话以将其打开。
> \[!IMPORTANT]
> 会话特定于用户：只能访问自己的 Copilot 命令行界面（CLI） 会话。 其他用户 GitHub 无法访问会话。
## 从 GitHub Mobile 访问会话
启用远程访问后，便可以在Copilot 命令行界面（CLI）中立即提供GitHub Mobile会话。 在 GitHub Mobile 中找到您的会话，请执行以下步骤：
1. ```
**
Copilot
**点击屏幕右下角的按钮。
```
会话列在“代理会话”下。
2. 点击会话以打开它。
### 使用 QR 码快速打开手机上的会话
1. 在交互式会话中 `/remote` ，输入斜杠命令以重新显示远程会话详细信息。
2. 按 Ctrl+E 可打开/关闭 QR 码的显示。
> \[!NOTE]
> 此键盘快捷方式可展开/折叠会话对话中的所有详细信息，而不仅仅是 QR 码。 仅当输入字段当前为空时，它才有效。
3. 使用手机扫描 QR 码以直接转到会话。GitHub Mobile
## 防止计算机进入睡眠状态
可以使用 `/keep-alive` 斜杠命令阻止计算机进入睡眠状态。 这样，就可以保持远程连接，并且继续从GitHub.com或GitHub Mobile与会话交互。
在交互式会话中，输入 `/keep-alive OPTION` ，其中 `OPTION` 为以下之一：
* `on`：阻止计算机在 CLI 会话处于活动状态时进入睡眠状态。
* `off`：允许计算机正常进入睡眠状态。
* `busy`：仅当 Copilot 正在执行任务时，防止计算机进入睡眠状态。 代理完成任务后，计算机可以正常进入睡眠状态。 如果 Copilot 等待你响应来自你的输入请求，计算机将不会进入睡眠状态。
* `NUMBERm`、、`NUMBERh`或`NUMBERd`（例如，`30m`）`8h``1d`防止计算机在特定分钟数、小时数或天数内进入睡眠状态。 如果提供的是未加后缀的数值，则会将其视为分钟数。
未传递`OPTION`时，`/keep-alive`命令会显示当前保持活动状态。
## 恢复具有远程访问的会话
关闭启用了远程访问的会话时，CLI 会显示一个恢复命令，其中包括 `--remote`：
```bash
copilot --resume=SESSION_ID --remote
```
使用此命令重启启用了远程访问的会话。
同样，将`--remote`添加到`copilot --continue`命令中会恢复启用远程访问的最新会话。
如果在您的`"remoteSessions": true`配置文件中包含Copilot，则会话恢复时将自动启用远程访问，您无需使用`--remote`选项。
## 阻止远程访问
默认情况下禁用远程访问，但可以在配置文件Copilot中启用。 可以通过以下方式确保无法远程访问会话：
* **对于单个会话**：启动 CLI `--no-remote`，即便配置文件中有设置，仍可防止该会话的远程访问。
* **永久**：从`"remoteSessions": true`配置文件中删除Copilot设置（或将其设置为 `false`）。