跳轉到主要內容
每個會話在開始時選定一種執行方式,之後不能更換:
  • 本機(介面上叫「在你的设备上执行」):雲端的 Agent 遠端控制你的電腦,讀寫檔案、執行命令都在你的電腦上進行,用的是你本機的環境和檔案,效果和在本機執行一樣。可以選任意一臺已登入桌面客戶端、並允許執行的電腦。
  • 雲主機:會話從開始到完成都在你的雲主機(Plus 附帶的 Linux 雲主機)上進行,不經過你的電腦;合上電腦會話也照樣跑完。

適用範圍

兩種方式對比

入口

  • 新會話:輸入框上方「项目」旁邊的執行環境按鈕。
  • 已有會話:頂欄標題旁的執行環境膠囊。
  • 「设置 › 工作区 › 机器」,或執行環境選單底部的「执行记录」「机器与授权」。

新會話選擇執行環境

點執行環境按鈕開啟「运行环境」選單:頂部是「云主机」,下面「在你的设备上执行」分組列出每臺裝置(當前這臺電腦帶「这台设备」,第二行顯示它的訪問範圍和許可權上限),底部是「执行记录」「机器与授权」。

預設選哪個

  • 本地專案預設選專案所在的那臺電腦;其他專案和不在任何專案中的會話預設選雲主機。
  • 手動選擇只對這一次新會話有效。所選裝置變得不能用時,自動退回雲主機。

不能選的情況

裝置的許可權上限

每臺裝置可以設「权限上限」。選了這臺裝置後,會話許可權選單裡高於上限的檔位置灰(「超出此设备的授权上限」),已選的許可權高於上限時自動降到上限。許可權檔位見 輸入框。

已有會話的執行環境

會話頂欄標題旁的膠囊顯示「云主机」或執行裝置的名稱,裝置離線時標「设备离线」。
  • 執行機器在新建會話時選定,之後不能更換;要換到另一臺機器,請新建會話。
  • 選單底部的「执行记录」「机器与授权」開啟執行裝置的記錄和詳情。

裝置與機器列表

裝置是你登入了桌面客戶端的電腦:登入後自動加入工作區,出現在機器列表和執行環境選單裡。網頁版不會加入裝置。 「设置 › 工作区 › 机器」列出工作區裡的全部機器(雲主機排在最前),每行顯示名稱、系統和客戶端版本,以及狀態「在线」「离线」「停机保留」「已移除」。重灌客戶端後留下的同名離線記錄會摺疊成一行,不再用的可以點進去移除。 點一行進入機器詳情。

機器詳情與執行授權

電腦和伺服器可以點名稱旁的鉛筆改名(最多 64 個字元)。
  • 儲存後對新會話立即生效。
  • 雲主機的詳情只有「允许执行」(只讀)、執行記錄和外掛入口,不能改名、不能移除。

系統確認

在桌面客戶端裡放寬這臺電腦的執行授權(開啟「允许执行」、擴大訪問範圍、放開敏感位置、調高許可權上限等)時,會彈出確認視窗,列出放寬的內容;開啟「允许执行」後對之後所有在這臺電腦上執行的會話長期有效。收緊授權不需要確認;關閉「允许执行」時,正在使用這臺裝置的會話會暫停。

誰能修改

執行授權只能在這臺電腦自己的桌面客戶端裡修改。在其他裝置或網頁版上檢視時只讀,提示「仅可在这台设备上修改执行授权。」;雲主機的設定也是隻讀。

第一次在這臺電腦上執行

會話選了這臺電腦執行、而這臺電腦還不滿足條件時,這臺電腦的客戶端開啟這個會話時會提示:
  • 還沒開啟「允许执行」:點「打开机器与授权」,開啟「允许执行」後回來。命令以你的帳戶許可權執行。
  • 專案在這臺電腦上還沒有資料夾:點「允许」並選擇專案在這臺電腦上的資料夾,之後在這個專案裡執行不再詢問;點「不允许」則不會在這臺電腦上執行這個專案。資料夾不會同步到雲端。
不在任何專案中的會話使用這個會話自己的臨時目錄。適用時視窗裡會說明你的 ~/.claude/CLAUDE.md 也會發給 Agent。

敏感位置確認

裝置的「敏感位置」設為「每次询问」時,Agent 要訪問 SSH 配置這類位置前,執行裝置的客戶端會顯示「访问确认」卡片,寫明原因和要訪問的路徑:
  • 「允许这一次」:只放行這一次,不更改機器授權。
  • 「拒绝」:不放行。
  • 一段時間內沒有處理會按拒絕處理。
  • 可以點「稍后处理」收起,側欄裡這個會話會顯示「需要你处理」。

執行記錄

從執行環境選單「执行记录」(這個會話)或機器詳情「查看记录」(這臺機器上的全部會話)開啟,逐行列出 Agent 在這臺機器上的操作、目標和結果。 在執行裝置自己的客戶端裡還可以「停止进程」(結束進行中的操作和後臺程序)、「断开」和「立即重连」;在網頁版或其他裝置上只能檢視記錄。

斷線與重連

會話正在某臺電腦上執行時,那臺電腦斷開(關機、休眠、斷網、退出客戶端等):
  • 這一輪暫停,執行裝置的客戶端在會話末尾顯示「本机已断开,这一轮已暂停」和斷開原因。
  • 恢復連線後會自動從中斷的地方繼續,已經完成的操作不會重複執行;也可以點「重新连接」。原因是沒有允許執行或專案資料夾未關聯時,會引導你處理。
  • 其他裝置和網頁版上,會話膠囊標「设备离线」。
會話不會因為裝置離線自動換到雲主機。

移除裝置

在機器詳情底部點「移除设备」並確認。裝置會立即斷開,正在使用它的會話會中斷;以後要再用,需要在這臺裝置上重新登入。
  • 雲主機不能移除。
  • 當前這臺電腦不能在這裡移除,請透過退出帳號移除。

雲主機方式

選「云主机」時,會話全程在你的雲主機上執行,專案使用雲主機上的副本和專案環境。雲主機需要 Plus;沒有開通時選單裡的「云主机」顯示「升级到 Plus 后可用」。雲主機的開通、狀態和遠端桌面見 雲主機。

常見問題

「在你的设备上执行」時我的電腦要一直開著嗎?

要。電腦斷開後這一輪會暫停,重新連上後自動繼續。需要合上電腦也繼續跑的,請選雲主機。

已有的會話能從電腦換到雲主機嗎?

不能。執行機器在新建會話時就定下了;要換,請新建會話。

為什麼網頁版改不了我電腦的授權?

執行授權只能在那臺電腦自己的桌面客戶端裡修改。

怎麼新增一臺新裝置?

在那臺電腦上安裝桌面客戶端並登入同一帳號,它會自動出現在機器列表裡;再在那臺電腦的客戶端裡開啟「允许执行」。

相關