跳转到主要内容
每个会话在开始时选定一种运行方式,之后不能更换:
  • 本机(界面上叫「在你的设备上执行」):云端的 Agent 远程控制你的电脑,读写文件、运行命令都在你的电脑上进行,用的是你本机的环境和文件,效果和在本机运行一样。可以选任意一台已登录桌面客户端、并允许执行的电脑。
  • 云主机:会话从开始到完成都在你的云主机(Plus 附带的 Linux 云主机)上进行,不经过你的电脑;合上电脑会话也照样跑完。

适用范围

两种方式对比

入口

  • 新会话:输入框上方「项目」旁边的运行环境按钮。
  • 已有会话:顶栏标题旁的运行环境胶囊。
  • 「设置 › 工作区 › 机器」,或运行环境菜单底部的「执行记录」「机器与授权」。

新会话选择运行环境

点运行环境按钮打开「运行环境」菜单:顶部是「云主机」,下面「在你的设备上执行」分组列出每台设备(当前这台电脑带「这台设备」,第二行显示它的访问范围和权限上限),底部是「执行记录」「机器与授权」。

默认选哪个

  • 本地项目默认选项目所在的那台电脑;其他项目和不在任何项目中的会话默认选云主机。
  • 手动选择只对这一次新会话有效。所选设备变得不能用时,自动退回云主机。

不能选的情况

设备的权限上限

每台设备可以设「权限上限」。选了这台设备后,会话权限菜单里高于上限的档位置灰(「超出此设备的授权上限」),已选的权限高于上限时自动降到上限。权限档位见 输入框。

已有会话的运行环境

会话顶栏标题旁的胶囊显示「云主机」或执行设备的名称,设备离线时标「设备离线」。
  • 执行机器在新建会话时选定,之后不能更换;要换到另一台机器,请新建会话。
  • 菜单底部的「执行记录」「机器与授权」打开执行设备的记录和详情。

设备与机器列表

设备是你登录了桌面客户端的电脑:登录后自动加入工作区,出现在机器列表和运行环境菜单里。网页版不会加入设备。 「设置 › 工作区 › 机器」列出工作区里的全部机器(云主机排在最前),每行显示名称、系统和客户端版本,以及状态「在线」「离线」「停机保留」「已移除」。重装客户端后留下的同名离线记录会折叠成一行,不再用的可以点进去移除。 点一行进入机器详情。

机器详情与执行授权

电脑和服务器可以点名称旁的铅笔改名(最多 64 个字符)。
  • 保存后对新会话立即生效。
  • 云主机的详情只有「允许执行」(只读)、执行记录和插件入口,不能改名、不能移除。

系统确认

在桌面客户端里放宽这台电脑的执行授权(打开「允许执行」、扩大访问范围、放开敏感位置、调高权限上限等)时,会弹出确认窗口,列出放宽的内容;打开「允许执行」后对之后所有在这台电脑上执行的会话长期有效。收紧授权不需要确认;关闭「允许执行」时,正在使用这台设备的会话会暂停。

谁能修改

执行授权只能在这台电脑自己的桌面客户端里修改。在其他设备或网页版上查看时只读,提示「仅可在这台设备上修改执行授权。」;云主机的设置也是只读。

第一次在这台电脑上执行

会话选了这台电脑执行、而这台电脑还不满足条件时,这台电脑的客户端打开这个会话时会提示:
  • 还没打开「允许执行」:点「打开机器与授权」,打开「允许执行」后回来。命令以你的账户权限运行。
  • 项目在这台电脑上还没有文件夹:点「允许」并选择项目在这台电脑上的文件夹,之后在这个项目里运行不再询问;点「不允许」则不会在这台电脑上运行这个项目。文件夹不会同步到云端。
不在任何项目中的会话使用这个会话自己的临时目录。适用时窗口里会说明你的 ~/.claude/CLAUDE.md 也会发给 Agent。

敏感位置确认

设备的「敏感位置」设为「每次询问」时,Agent 要访问 SSH 配置这类位置前,执行设备的客户端会显示「访问确认」卡片,写明原因和要访问的路径:
  • 「允许这一次」:只放行这一次,不更改机器授权。
  • 「拒绝」:不放行。
  • 一段时间内没有处理会按拒绝处理。
  • 可以点「稍后处理」收起,侧栏里这个会话会显示「需要你处理」。

执行记录

从运行环境菜单「执行记录」(这个会话)或机器详情「查看记录」(这台机器上的全部会话)打开,逐行列出 Agent 在这台机器上的操作、目标和结果。 在执行设备自己的客户端里还可以「停止进程」(结束进行中的操作和后台进程)、「断开」和「立即重连」;在网页版或其他设备上只能查看记录。

断线与重连

会话正在某台电脑上执行时,那台电脑断开(关机、休眠、断网、退出客户端等):
  • 这一轮暂停,执行设备的客户端在会话末尾显示「本机已断开,这一轮已暂停」和断开原因。
  • 恢复连接后会自动从中断的地方继续,已经完成的操作不会重复执行;也可以点「重新连接」。原因是没有允许执行或项目文件夹未关联时,会引导你处理。
  • 其他设备和网页版上,会话胶囊标「设备离线」。
会话不会因为设备离线自动换到云主机。

移除设备

在机器详情底部点「移除设备」并确认。设备会立即断开,正在使用它的会话会中断;以后要再用,需要在这台设备上重新登录。
  • 云主机不能移除。
  • 当前这台电脑不能在这里移除,请通过退出账号移除。

云主机方式

选「云主机」时,会话全程在你的云主机上运行,项目使用云主机上的副本和项目环境。云主机需要 Plus;没有开通时菜单里的「云主机」显示「升级到 Plus 后可用」。云主机的开通、状态和远程桌面见 云主机。

常见问题

「在你的设备上执行」时我的电脑要一直开着吗?

要。电脑断开后这一轮会暂停,重新连上后自动继续。需要合上电脑也继续跑的,请选云主机。

已有的会话能从电脑换到云主机吗?

不能。执行机器在新建会话时就定下了;要换,请新建会话。

为什么网页版改不了我电脑的授权?

执行授权只能在那台电脑自己的桌面客户端里修改。

怎么添加一台新设备?

在那台电脑上安装桌面客户端并登录同一账号,它会自动出现在机器列表里;再在那台电脑的客户端里打开「允许执行」。

相关