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

​
开始之前

  • 终端用 qlaude 登录了 TokenHub。用 API 密钥接入的 Claude Code 不支持远程控制。
  • qlaude 是最新版本。
  • 一个 passkey。远程控制能在你的电脑上执行命令，所以每次使用前都要用 passkey 确认是你本人。

​
第一步：添加 passkey

1

打开安全设置

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

填写名称和密码

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

按浏览器提示完成

浏览器会弹出 passkey 窗口，用指纹、面容或设备 PIN 确认。完成后列表里会多出这个 passkey。
存进密码管理器或系统钥匙串的 passkey 会同步到你的其他设备，换到手机上验证也能直接用。列表的 同步 一列会显示每个 passkey 是「已同步」「可同步」还是「仅本设备」。
passkey 还能直接用来登录 TokenHub，见 账号与安全。

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

在 qlaude 的交互模式里运行：
终端会显示这个会话的网页链接。在任意设备的浏览器里打开它，手机也可以；没登录 TokenHub 的话先登录。 也可以直接打开 TokenHub 控制台，在侧栏顶部的切换器里选 远控，左侧会按终端列出你的所有会话。

​
第三步：验证 passkey

第一次打开远程控制时，页面会显示「验证 passkey」。点 验证 passkey，按浏览器提示完成后，就能看到终端和会话了。 验证只对当前浏览器有效。出现下面几种情况时需要重新验证：
  • 30 分钟没有操作（只开着页面不算操作）
  • 距离上次验证已满 12 小时
  • 在侧栏底部点了 锁定远程控制
  • 退出了 TokenHub 登录，或者修改了密码
用 passkey 登录 TokenHub 时会顺带完成这一步，不用再验证一次。

​
操作会话

​
会话列表

侧栏按终端分组列出会话，终端名旁边显示有几个会话在线。
  • 等你处理：有请求等你审批或回答的会话，不论在哪台终端，都汇总在侧栏最上方。
  • 会话右侧的「⋯」菜单可以改名、置顶、标为已读 / 未读、删除。置顶的会话单独排在 置顶 下。
  • 每台终端下面的 已归档 展开后，可以查看已经结束的会话。
会话页顶部显示终端当前的状态： 状态旁边出现「终端前有人」，表示最近一分钟内终端那边有人在操作。

​
发消息

在底部输入框给 Claude 发消息，效果和在终端里输入一样：
  • 输入 / 选择命令，输入 @ 引用文件。
  • 可以粘贴、拖入或点按钮添加图片，一条消息最多 6 张。
  • 输入框下方可以切换权限模式、模型和思考强度。思考强度只对这个会话生效。
  • Claude 正在工作时发的消息会排队。排队中的消息可以 撤回（终端还没执行时取消），也可以 立即发送（中断当前这一轮，随后执行这条消息）。
  • 点 停止 中断当前这一轮，也可以按 Esc；触屏上长按停止按钮。
提示「已发出，终端暂未确认收到」时不要重发，消息稍后会出现在对话里。重发会让终端执行两次。

​
审批工具调用

Claude 要做需要你确认的操作（例如执行命令、修改文件）时，会话页会出现审批卡片： Claude 提交计划时，可以选 批准，自动接受编辑、批准，逐项确认、编辑后批准 或 继续完善计划。Claude 向你提问时，选好答案点 提交回答；不想回答就点 跳过，本轮随之停止。

​
会话信息

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

​
通知和显示

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

​
历史和删除

会话历史在最后一次活动后保留 30 天，到期自动删除。想提前删除：
  • 单个会话：会话右侧「⋯」菜单里的 删除，或会话页顶部的删除按钮。
  • 批量删除：在 设置 → 历史 里选 删除已归档会话 或 删除全部会话。删除全部会话时，正在运行的终端会话会断开。
删除后历史无法恢复。passkey 和终端的登录不受影响，终端随时可以重新开启远程控制。
在 账户 → 设备 移除一台设备，或在这台终端的 qlaude 里执行 /logout，这台终端的远程控制会话和历史会一并删除。

​
费用

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

​
安全建议

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

​
常见问题

qlaude 版本太旧。重新运行一遍 qlaude 使用指南 里的安装命令更新到最新版，再重新打开 qlaude。
你的账号还没有 passkey。按上面的第一步添加后，回到终端重新运行 /remote-control。已经添加了 passkey 仍然这样提示的话，可能是这台设备被平台管理员停用了，到 账户 → 设备 查看设备状态。
当前浏览器不支持 passkey 时不会显示。换用新版的 Chrome、Edge、Safari 或 Firefox 再试。
终端没有连上远程控制。确认那台电脑上的 qlaude 还开着、网络正常。终端重新连上后，会话会自动恢复在线。
远程控制服务暂时出了问题，你的登录状态不受影响。稍后刷新页面再试。
验证在 30 分钟没有操作或满 12 小时后失效，这是为了防止别人用你忘了关的页面操作你的电脑。用 passkey 登录 TokenHub 可以同时完成验证，少按一次。