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

# 用远程控制在网页和手机上操作 qlaude

> 在浏览器或手机上查看终端里的 qlaude 会话，收发消息、审批工具调用，每次使用前用 passkey 确认是你本人。

远程控制把终端里正在运行的 qlaude 会话搬到网页上：你可以在另一台电脑或手机的浏览器里看实时输出、给 Claude 发消息、审批工具调用，终端那边照常运行。离开电脑时也能盯着长任务，有请求等你处理时及时放行。

## 开始之前

* 终端用 [qlaude](https://docs.aitokenhub.vip/qlaude/getting-started.md) 登录了 TokenHub。用 API 密钥接入的 Claude Code 不支持远程控制。
* qlaude 是最新版本。
* 一个 passkey。远程控制能在你的电脑上执行命令，所以每次使用前都要用 passkey 确认是你本人。

## 第一步：添加 passkey

**1. 打开安全设置**

在控制台左侧菜单打开 **账户 → 个人中心**，切到 **安全设置** 标签页。

**2. 填写名称和密码**

在 **Passkey** 区域点 **添加 passkey**，填一个方便区分的名称（例如「MacBook 钥匙串」），再输入当前登录密码，点 **继续**。

**3. 按浏览器提示完成**

浏览器会弹出 passkey 窗口，用指纹、面容或设备 PIN 确认。完成后列表里会多出这个 passkey。

> [!TIP]
>
> 存进密码管理器或系统钥匙串的 passkey 会同步到你的其他设备，换到手机上验证也能直接用。列表的 **同步** 一列会显示每个 passkey 是「已同步」「可同步」还是「仅本设备」。

passkey 还能直接用来登录 TokenHub，见 [账号与安全](https://docs.aitokenhub.vip/console/account.md#passkey)。

## 第二步：在终端开启远程控制

在 qlaude 的交互模式里运行：

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

终端会显示这个会话的网页链接。在任意设备的浏览器里打开它，手机也可以；没登录 TokenHub 的话先登录。

也可以直接打开 [TokenHub 控制台](https://aitokenhub.vip)，在侧栏顶部的切换器里选 **远控**，左侧会按终端列出你的所有会话。

## 第三步：验证 passkey

第一次打开远程控制时，页面会显示「验证 passkey」。点 **验证 passkey**，按浏览器提示完成后，就能看到终端和会话了。

验证只对当前浏览器有效。出现下面几种情况时需要重新验证：

* 30 分钟没有操作（只开着页面不算操作）
* 距离上次验证已满 12 小时
* 在侧栏底部点了 **锁定远程控制**
* 退出了 TokenHub 登录，或者修改了密码

> [!NOTE]
>
> 用 passkey 登录 TokenHub 时会顺带完成这一步，不用再验证一次。

## 操作会话

### 会话列表

侧栏按终端分组列出会话，终端名旁边显示有几个会话在线。

* **等你处理**：有请求等你审批或回答的会话，不论在哪台终端，都汇总在侧栏最上方。
* 会话右侧的「⋯」菜单可以改名、置顶、标为已读 / 未读、删除。置顶的会话单独排在 **置顶** 下。
* 每台终端下面的 **已归档** 展开后，可以查看已经结束的会话。

会话页顶部显示终端当前的状态：

| 状态 | 含义 |
| - | - |
| 运行中 | Claude 正在工作 |
| 空闲 | 终端在线，等你发下一条消息 |
| 等你处理 / 等待审批 | 有工具调用、计划或问题等你答复 |
| 离线 | 终端没有连上，只能查看历史，不能发消息 |
| 已归档 | 会话已经结束，只能查看历史 |

状态旁边出现「终端前有人」，表示最近一分钟内终端那边有人在操作。

### 发消息

在底部输入框给 Claude 发消息，效果和在终端里输入一样：

* 输入 `/` 选择命令，输入 `@` 引用文件。
* 可以粘贴、拖入或点按钮添加图片，一条消息最多 6 张。
* 输入框下方可以切换权限模式、模型和思考强度。思考强度只对这个会话生效。
* Claude 正在工作时发的消息会排队。排队中的消息可以 **撤回**（终端还没执行时取消），也可以 **立即发送**（中断当前这一轮，随后执行这条消息）。
* 点 **停止** 中断当前这一轮，也可以按 Esc；触屏上长按停止按钮。

> [!WARNING]
>
> 提示「已发出，终端暂未确认收到」时不要重发，消息稍后会出现在对话里。重发会让终端执行两次。

### 审批工具调用

Claude 要做需要你确认的操作（例如执行命令、修改文件）时，会话页会出现审批卡片：

| 按钮 | 作用 |
| - | - |
| 允许 | 放行这一次 |
| 允许，本会话不再询问… | 放行，并且这个会话里同类操作不再询问。只在这个会话里生效，不会写进终端的设置文件 |
| 拒绝 | 拒绝，并停止本轮 |
| 拒绝并说明 | 拒绝，同时告诉 Claude 应该怎么做 |

Claude 提交计划时，可以选 **批准，自动接受编辑**、**批准，逐项确认**、**编辑后批准** 或 **继续完善计划**。Claude 向你提问时，选好答案点 **提交回答**；不想回答就点 **跳过**，本轮随之停止。

### 会话信息

点会话页右上角的 **会话信息**，可以看到工作目录、终端设备、模型、上下文用量和后台任务。在 **工作区** 里还能搜索、预览终端上的文件，查看 Git 工作区的改动；这些要终端在线时才能用。

要保存完整记录，点会话页顶部的 **导出记录**，会下载一个 JSONL 文件。

## 通知和显示

点侧栏底部的 **设置**：

* **通知**：开启后，停留在远程控制页面、但标签页在后台时，终端有请求等你处理或一轮结束，会弹出浏览器通知。终端前有人时不会弹。
* **屏幕常亮**：打开会话页时屏幕不自动熄灭，适合在手机上盯任务。切到后台后自动失效。
* **发送键**：Enter 发送，或者 Ctrl+Enter（Mac 上 ⌘+Enter）发送。

这些设置只对当前浏览器生效。

## 历史和删除

会话历史在最后一次活动后保留 30 天，到期自动删除。想提前删除：

* **单个会话**：会话右侧「⋯」菜单里的 **删除**，或会话页顶部的删除按钮。
* **批量删除**：在 **设置 → 历史** 里选 **删除已归档会话** 或 **删除全部会话**。删除全部会话时，正在运行的终端会话会断开。

删除后历史无法恢复。passkey 和终端的登录不受影响，终端随时可以重新开启远程控制。

> [!WARNING]
>
> 在 **账户 → 设备** 移除一台设备，或在这台终端的 qlaude 里执行 `/logout`，这台终端的远程控制会话和历史会一并删除。

## 费用

通过远程控制发出的消息，和在终端里直接输入一样计费，从这台设备授权时选的个人或团队余额中扣除。远程控制本身不额外收费。

## 安全建议

* 会话只有你自己能看到和操作，团队管理员也看不到。
* 在别人的电脑上用完后，点侧栏底部的 **锁定远程控制**，或者直接退出登录。
* 丢了保存 passkey 的设备，到 **安全设置** 删除对应的 passkey。用它做的验证会撤销，用它登录的会话也会退出。
* 修改密码会撤销所有浏览器上的远程控制验证，登录状态保留。通过「忘记密码」重置后，你所有的 passkey 都会被删除，需要重新添加。

## 常见问题

> [accordion] qlaude 里没有 /remote-control 命令
>
> qlaude 版本太旧。重新运行一遍 [qlaude 使用指南](https://docs.aitokenhub.vip/qlaude/getting-started.md) 里的安装命令更新到最新版，再重新打开 qlaude。

> [accordion] 终端提示「请先在控制台启用 Remote Control（注册 passkey）」
>
> 你的账号还没有 passkey。按上面的第一步添加后，回到终端重新运行 `/remote-control`。
>
> 已经添加了 passkey 仍然这样提示的话，可能是这台设备被平台管理员停用了，到 **账户 → 设备** 查看设备状态。

> [accordion] 个人中心里没有 Passkey 区域
>
> 当前浏览器不支持 passkey 时不会显示。换用新版的 Chrome、Edge、Safari 或 Firefox 再试。

> [accordion] 会话显示离线，发不出消息
>
> 终端没有连上远程控制。确认那台电脑上的 qlaude 还开着、网络正常。终端重新连上后，会话会自动恢复在线。

> [accordion] 页面提示「远程控制服务暂不可用」
>
> 远程控制服务暂时出了问题，你的登录状态不受影响。稍后刷新页面再试。

> [accordion] 每次打开都要验证 passkey
>
> 验证在 30 分钟没有操作或满 12 小时后失效，这是为了防止别人用你忘了关的页面操作你的电脑。用 passkey 登录 TokenHub 可以同时完成验证，少按一次。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.