- 本机(界面上叫「在你的设备上执行」):云端的 Agent 远程控制你的电脑,读写文件、运行命令都在你的电脑上进行,用的是你本机的环境和文件,效果和在本机运行一样。可以选任意一台已登录桌面客户端、并允许执行的电脑。
- 云主机:会话从开始到完成都在你的云主机(Plus 附带的 Linux 云主机)上进行,不经过你的电脑;合上电脑会话也照样跑完。
适用范围
两种方式对比
入口
- 新会话:输入框上方「项目」旁边的运行环境按钮。
- 已有会话:顶栏标题旁的运行环境胶囊。
- 「设置 › 工作区 › 机器」,或运行环境菜单底部的「执行记录」「机器与授权」。
新会话选择运行环境
点运行环境按钮打开「运行环境」菜单:顶部是「云主机」,下面「在你的设备上执行」分组列出每台设备(当前这台电脑带「这台设备」,第二行显示它的访问范围和权限上限),底部是「执行记录」「机器与授权」。默认选哪个
- 本地项目默认选项目所在的那台电脑;其他项目和不在任何项目中的会话默认选云主机。
- 手动选择只对这一次新会话有效。所选设备变得不能用时,自动退回云主机。
不能选的情况
设备的权限上限
每台设备可以设「权限上限」。选了这台设备后,会话权限菜单里高于上限的档位置灰(「超出此设备的授权上限」),已选的权限高于上限时自动降到上限。权限档位见 输入框。已有会话的运行环境
会话顶栏标题旁的胶囊显示「云主机」或执行设备的名称,设备离线时标「设备离线」。- 执行机器在新建会话时选定,之后不能更换;要换到另一台机器,请新建会话。
- 菜单底部的「执行记录」「机器与授权」打开执行设备的记录和详情。
设备与机器列表
设备是你登录了桌面客户端的电脑:登录后自动加入工作区,出现在机器列表和运行环境菜单里。网页版不会加入设备。 「设置 › 工作区 › 机器」列出工作区里的全部机器(云主机排在最前),每行显示名称、系统和客户端版本,以及状态「在线」「离线」「停机保留」「已移除」。重装客户端后留下的同名离线记录会折叠成一行,不再用的可以点进去移除。 点一行进入机器详情。机器详情与执行授权
电脑和服务器可以点名称旁的铅笔改名(最多 64 个字符)。- 保存后对新会话立即生效。
- 云主机的详情只有「允许执行」(只读)、执行记录和插件入口,不能改名、不能移除。
系统确认
在桌面客户端里放宽这台电脑的执行授权(打开「允许执行」、扩大访问范围、放开敏感位置、调高权限上限等)时,会弹出确认窗口,列出放宽的内容;打开「允许执行」后对之后所有在这台电脑上执行的会话长期有效。收紧授权不需要确认;关闭「允许执行」时,正在使用这台设备的会话会暂停。谁能修改
执行授权只能在这台电脑自己的桌面客户端里修改。在其他设备或网页版上查看时只读,提示「仅可在这台设备上修改执行授权。」;云主机的设置也是只读。第一次在这台电脑上执行
会话选了这台电脑执行、而这台电脑还不满足条件时,这台电脑的客户端打开这个会话时会提示:- 还没打开「允许执行」:点「打开机器与授权」,打开「允许执行」后回来。命令以你的账户权限运行。
- 项目在这台电脑上还没有文件夹:点「允许」并选择项目在这台电脑上的文件夹,之后在这个项目里运行不再询问;点「不允许」则不会在这台电脑上运行这个项目。文件夹不会同步到云端。
~/.claude/CLAUDE.md 也会发给 Agent。
敏感位置确认
设备的「敏感位置」设为「每次询问」时,Agent 要访问 SSH 配置这类位置前,执行设备的客户端会显示「访问确认」卡片,写明原因和要访问的路径:- 「允许这一次」:只放行这一次,不更改机器授权。
- 「拒绝」:不放行。
- 一段时间内没有处理会按拒绝处理。
- 可以点「稍后处理」收起,侧栏里这个会话会显示「需要你处理」。
执行记录
从运行环境菜单「执行记录」(这个会话)或机器详情「查看记录」(这台机器上的全部会话)打开,逐行列出 Agent 在这台机器上的操作、目标和结果。 在执行设备自己的客户端里还可以「停止进程」(结束进行中的操作和后台进程)、「断开」和「立即重连」;在网页版或其他设备上只能查看记录。断线与重连
会话正在某台电脑上执行时,那台电脑断开(关机、休眠、断网、退出客户端等):- 这一轮暂停,执行设备的客户端在会话末尾显示「本机已断开,这一轮已暂停」和断开原因。
- 恢复连接后会自动从中断的地方继续,已经完成的操作不会重复执行;也可以点「重新连接」。原因是没有允许执行或项目文件夹未关联时,会引导你处理。
- 其他设备和网页版上,会话胶囊标「设备离线」。
移除设备
在机器详情底部点「移除设备」并确认。设备会立即断开,正在使用它的会话会中断;以后要再用,需要在这台设备上重新登录。- 云主机不能移除。
- 当前这台电脑不能在这里移除,请通过退出账号移除。