> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Remote Control

Remote Control 让开发者离开电脑也能实时掌控正在跑的 Qoder CLI Agent，使用手机/Web 在关键节点做出决策。

Qoder CLI 提供两种远程控制模式：

<CardGroup cols={2}>
  <Card title="远程控制模式" icon="tower-broadcast" href="#remote-control-mode">
    在已有的 CLI 会话中开启远程监听，通过手机实时查看和控制正在运行的任务。
  </Card>

  <Card title="守护进程模式" icon="server" href="#daemon-mode">
    以后台守护进程运行 CLI，随时从手机端发起新任务，无需提前打开会话。
  </Card>
</CardGroup>

<div id="remote-control-mode" />

## 远程控制模式（本地任务远程控制）

适合你已经在电脑上启动了 CLI 会话、临时需要离开但又想继续监控和操作的场景。开启后任务进展实时同步到手机，需要保持本地电脑处于活跃状态。

<Steps>
  <Step title="开启远程监听">
    在运行中的 qodercli 会话中输入：

    ```bash theme={null}
    /remote-control
    ```

    开启成功后会显示二维码和 URL。用手机相机扫码，或复制 URL 在浏览器中打开即可连接。
  </Step>

  <Step title="连接移动端">
    在手机上打开 Qoder 移动端（使用相同账号登录），你将看到已连接的 CLI 会话。

    连接后你可以：

    * 实时查看本地 CLI 的运行状态
    * 对需要审批的操作进行交互
    * 从移动端发送新任务，例如："帮我优化这个项目页面交互"
  </Step>

  <Step title="远程执行">
    本地终端会执行你远程下发的任务，所有产物保存在本地电脑中。
  </Step>

  <Step title="停止远程控制">
    在 CLI 中输入：

    ```bash theme={null}
    /remote-control stop
    ```
  </Step>
</Steps>

<div id="daemon-mode" />

## 守护进程模式（手机端直接发起任务）

守护进程模式也称为 Daemon session。

适合你想让电脑保持待命、随时通过手机发起新任务的场景。以守护进程模式运行 CLI 后，可持续接收并处理来自 Qoder 移动端的多个任务。需要保持本地电脑处于活跃状态。

<Steps>
  <Step title="启动守护进程">
    在项目目录中直接运行（不需要先启动 qodercli 会话）：

    ```bash theme={null}
    qodercli remote-control
    ```

    开启成功后会显示二维码和 URL。用手机相机扫码，或复制 URL 在浏览器中打开即可连接。
  </Step>

  <Step title="从移动端发起任务">
    点击 Qoder 移动端右下角 "+" 号新建任务。

    * 无需等待第一个任务完成，即可发送第二个任务
    * 移动端会独立显示每个任务的状态和结果
  </Step>

  <Step title="任务处理">
    CLI 会按顺序或并行处理任务。所有生成的文件均保存在运行 CLI 的电脑上。
  </Step>

  <Step title="退出守护进程">
    按 `Ctrl+C` 退出该模式。
  </Step>
</Steps>

## 常见问题

**如何查看远程控制状态？**

在 CLI 中输入 `/remote-control status` 即可查看当前的远程控制连接状态。

**Web 端如何访问？**

在浏览器中访问 [https://qoder.com/agents](https://qoder.com/agents) 来管理你的远程任务。