- 本機(介面上叫「在你的设备上执行」):雲端的 Agent 遠端控制你的電腦,讀寫檔案、執行命令都在你的電腦上進行,用的是你本機的環境和檔案,效果和在本機執行一樣。可以選任意一臺已登入桌面客戶端、並允許執行的電腦。
- 雲主機:會話從開始到完成都在你的雲主機(Plus 附帶的 Linux 雲主機)上進行,不經過你的電腦;合上電腦會話也照樣跑完。
適用範圍
兩種方式對比
入口
- 新會話:輸入框上方「项目」旁邊的執行環境按鈕。
- 已有會話:頂欄標題旁的執行環境膠囊。
- 「设置 › 工作区 › 机器」,或執行環境選單底部的「执行记录」「机器与授权」。
新會話選擇執行環境
點執行環境按鈕開啟「运行环境」選單:頂部是「云主机」,下面「在你的设备上执行」分組列出每臺裝置(當前這臺電腦帶「这台设备」,第二行顯示它的訪問範圍和許可權上限),底部是「执行记录」「机器与授权」。預設選哪個
- 本地專案預設選專案所在的那臺電腦;其他專案和不在任何專案中的會話預設選雲主機。
- 手動選擇只對這一次新會話有效。所選裝置變得不能用時,自動退回雲主機。
不能選的情況
裝置的許可權上限
每臺裝置可以設「权限上限」。選了這臺裝置後,會話許可權選單裡高於上限的檔位置灰(「超出此设备的授权上限」),已選的許可權高於上限時自動降到上限。許可權檔位見 輸入框。已有會話的執行環境
會話頂欄標題旁的膠囊顯示「云主机」或執行裝置的名稱,裝置離線時標「设备离线」。- 執行機器在新建會話時選定,之後不能更換;要換到另一臺機器,請新建會話。
- 選單底部的「执行记录」「机器与授权」開啟執行裝置的記錄和詳情。
裝置與機器列表
裝置是你登入了桌面客戶端的電腦:登入後自動加入工作區,出現在機器列表和執行環境選單裡。網頁版不會加入裝置。 「设置 › 工作区 › 机器」列出工作區裡的全部機器(雲主機排在最前),每行顯示名稱、系統和客戶端版本,以及狀態「在线」「离线」「停机保留」「已移除」。重灌客戶端後留下的同名離線記錄會摺疊成一行,不再用的可以點進去移除。 點一行進入機器詳情。機器詳情與執行授權
電腦和伺服器可以點名稱旁的鉛筆改名(最多 64 個字元)。- 儲存後對新會話立即生效。
- 雲主機的詳情只有「允许执行」(只讀)、執行記錄和外掛入口,不能改名、不能移除。
系統確認
在桌面客戶端裡放寬這臺電腦的執行授權(開啟「允许执行」、擴大訪問範圍、放開敏感位置、調高許可權上限等)時,會彈出確認視窗,列出放寬的內容;開啟「允许执行」後對之後所有在這臺電腦上執行的會話長期有效。收緊授權不需要確認;關閉「允许执行」時,正在使用這臺裝置的會話會暫停。誰能修改
執行授權只能在這臺電腦自己的桌面客戶端裡修改。在其他裝置或網頁版上檢視時只讀,提示「仅可在这台设备上修改执行授权。」;雲主機的設定也是隻讀。第一次在這臺電腦上執行
會話選了這臺電腦執行、而這臺電腦還不滿足條件時,這臺電腦的客戶端開啟這個會話時會提示:- 還沒開啟「允许执行」:點「打开机器与授权」,開啟「允许执行」後回來。命令以你的帳戶許可權執行。
- 專案在這臺電腦上還沒有資料夾:點「允许」並選擇專案在這臺電腦上的資料夾,之後在這個專案裡執行不再詢問;點「不允许」則不會在這臺電腦上執行這個專案。資料夾不會同步到雲端。
~/.claude/CLAUDE.md 也會發給 Agent。
敏感位置確認
裝置的「敏感位置」設為「每次询问」時,Agent 要訪問 SSH 配置這類位置前,執行裝置的客戶端會顯示「访问确认」卡片,寫明原因和要訪問的路徑:- 「允许这一次」:只放行這一次,不更改機器授權。
- 「拒绝」:不放行。
- 一段時間內沒有處理會按拒絕處理。
- 可以點「稍后处理」收起,側欄裡這個會話會顯示「需要你处理」。
執行記錄
從執行環境選單「执行记录」(這個會話)或機器詳情「查看记录」(這臺機器上的全部會話)開啟,逐行列出 Agent 在這臺機器上的操作、目標和結果。 在執行裝置自己的客戶端裡還可以「停止进程」(結束進行中的操作和後臺程序)、「断开」和「立即重连」;在網頁版或其他裝置上只能檢視記錄。斷線與重連
會話正在某臺電腦上執行時,那臺電腦斷開(關機、休眠、斷網、退出客戶端等):- 這一輪暫停,執行裝置的客戶端在會話末尾顯示「本机已断开,这一轮已暂停」和斷開原因。
- 恢復連線後會自動從中斷的地方繼續,已經完成的操作不會重複執行;也可以點「重新连接」。原因是沒有允許執行或專案資料夾未關聯時,會引導你處理。
- 其他裝置和網頁版上,會話膠囊標「设备离线」。
移除裝置
在機器詳情底部點「移除设备」並確認。裝置會立即斷開,正在使用它的會話會中斷;以後要再用,需要在這臺裝置上重新登入。- 雲主機不能移除。
- 當前這臺電腦不能在這裡移除,請透過退出帳號移除。