跳轉到主要內容
在本機執行是指雲端的 Agent 遠端控制你的一臺電腦,讀寫檔案、執行命令都在那臺電腦上進行,用的是它本機的環境和檔案,效果和在本機執行一樣。介面上這種方式叫 在你的裝置上執行。

選擇本機還是雲主機

每個會話在發起時選定執行方式,之後不能更換。 需要合上電腦也繼續跑的任務,請選雲主機。

讓一臺電腦可以執行

1

在這臺電腦上登入桌面客戶端

安裝桌面客戶端並用同一個帳號登入,見下載與登入。登入後這臺電腦會自動加入工作區。網頁版不會加入裝置。
2

開啟機器詳情

進入 設定 › 工作區 › 機器,點這臺電腦。列表裡會顯示每臺機器的系統、客戶端版本和線上狀態。
3

開啟允許執行

開啟 允許執行(電腦預設關閉),在確認視窗裡核對放寬的內容。開啟後,對之後所有在這臺電腦上執行的會話長期有效。
4

按需調整授權

設定訪問範圍、敏感位置和許可權上限,儲存後對新會話立即生效。
機器列表

設定 › 工作區 › 機器

機器詳情裡可以調整:
  • 訪問範圍:僅專案目錄、指定目錄或整臺電腦(預設)。
  • 敏感位置:例如 SSH、鑰匙串和系統配置,可選每次詢問(預設)、禁止訪問或允許訪問。
  • 許可權上限:會話許可權不會超過這裡,可選不設上限(預設)、替我批准或請求批准。
  • 可下發的金鑰:這臺電腦上能用哪些工作區金鑰,預設全部。
  • 環境變數覆蓋:在這臺電腦上執行時覆蓋的環境變數,不要寫金鑰明文。
放寬授權時會彈出確認,收緊不需要確認。關閉 允許執行 後,正在使用這臺電腦的會話會暫停。命令以你在這臺電腦上的帳戶許可權執行。
執行授權只能在這臺電腦自己的桌面客戶端裡修改。在其他裝置或網頁版上只能檢視。

選擇裝置發起會話

1

開啟執行環境選單

在新會話輸入框上方,點專案旁邊的執行環境按鈕。
2

選一臺裝置

在 在你的裝置上執行 下選擇電腦。每臺裝置下方顯示它的訪問範圍和許可權上限。
3

傳送任務

寫下任務並傳送。會話開始後就固定在這臺電腦上執行。
  • 本地專案預設選專案所在的電腦,其他情況預設選雲主機。
  • 裝置離線、沒有開啟允許執行、專案不在這臺裝置上,或當前 Agent 不是 Claude Code 時,這臺裝置無法選擇,選單裡會寫明原因。
  • 選了裝置後,高於它許可權上限的許可權無法選擇。
  • 想換到另一臺電腦或雲主機,請新建會話。
第一次在某臺電腦上執行時,如果它還沒開啟允許執行,或專案在這臺電腦上還沒有對應資料夾,這臺電腦的客戶端會提示你處理:點 開啟機器與授權 去開啟允許執行,或點 允許 並選擇專案資料夾(資料夾不會同步到雲端)。不屬於任何專案的會話使用自己的臨時目錄。

確認訪問敏感位置

敏感位置設為每次詢問時,Agent 要訪問 SSH 配置這類位置前,執行裝置的客戶端會顯示原因和要訪問的路徑。
  • 允許這一次:只放行這一次,不改變機器授權。
  • 拒絕:不放行。一段時間沒有處理也按拒絕處理。
  • 稍後處理:先收起,側欄裡這個會話會標記需要你處理。

檢視執行記錄

在執行環境選單底部點 執行記錄 檢視這個會話的操作,或在機器詳情裡點 檢視執行記錄 檢視這臺電腦上全部會話的操作。記錄逐行列出 Agent 做了什麼、物件是什麼、結果如何。 在執行裝置自己的客戶端裡,還可以停止程序、斷開或立即重連;在其他地方只能檢視。

電腦斷開後會怎樣

電腦關機、休眠、斷網或退出客戶端時,當前任務會暫停。恢復連線後會自動從中斷的地方繼續,已經完成的操作不會重複執行,也可以點 重新連線。其他裝置和網頁版上,這個會話會標記裝置離線。 會話不會因為裝置離線自動換到雲主機。連線問題見常見問題與排錯。

移除裝置

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