> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 在本機執行

> 讓雲端的 Agent 在你自己的電腦上執行會話：授權一臺電腦、選擇裝置發起會話、確認敏感位置訪問、檢視執行記錄，以及斷線和移除裝置。

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

## 選擇本機還是雲主機

每個會話在發起時選定執行方式，之後不能更換。

| | 本機 | 雲主機 |
| - | - | - |
| 操作在哪裡進行 | 你選的那臺電腦 | 你的[雲主機](https://docs.aihubmix.com/zh-Hant/cloud/environments/cloud-host.md) |
| 使用的環境和檔案 | 那臺電腦上的環境和專案資料夾 | 雲主機上的專案副本和專案環境 |
| 可用的專案 | 那臺電腦上的本地專案，或不屬於任何專案的會話 | 雲端專案，或不屬於任何專案的會話 |
| 支援的 Agent | 目前只支援 Claude Code | 全部 |
| 前提 | 電腦線上，並開啟了 **允許執行** | 已訂閱 Plus |
| 電腦關機或斷網 | 當前任務暫停，重新連上後繼續 | 不受影響 |

需要合上電腦也繼續跑的任務，請選雲主機。

## 讓一臺電腦可以執行

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

安裝桌面客戶端並用同一個帳號登入，見[下載與登入](https://docs.aihubmix.com/zh-Hant/cloud/getting-started/install-and-sign-in.md)。登入後這臺電腦會自動加入工作區。網頁版不會加入裝置。

**2. 開啟機器詳情**

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

**3. 開啟允許執行**

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

**4. 按需調整授權**

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

![機器列表](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/machines.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=7e1df978d48ba5be7f5a7a9edeb30f68)

設定 › 工作區 › 機器

機器詳情裡可以調整：

* **訪問範圍**：僅專案目錄、指定目錄或整臺電腦（預設）。
* **敏感位置**：例如 SSH、鑰匙串和系統配置，可選每次詢問（預設）、禁止訪問或允許訪問。
* **許可權上限**：會話許可權不會超過這裡，可選不設上限（預設）、替我批准或請求批准。
* **可下發的金鑰**：這臺電腦上能用哪些工作區金鑰，預設全部。
* **環境變數覆蓋**：在這臺電腦上執行時覆蓋的環境變數，不要寫金鑰明文。

放寬授權時會彈出確認，收緊不需要確認。關閉 **允許執行** 後，正在使用這臺電腦的會話會暫停。命令以你在這臺電腦上的帳戶許可權執行。

> [!NOTE]
>
> 執行授權只能在這臺電腦自己的桌面客戶端裡修改。在其他裝置或網頁版上只能檢視。

## 選擇裝置發起會話

**1. 開啟執行環境選單**

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

**2. 選一臺裝置**

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

**3. 傳送任務**

寫下任務並傳送。會話開始後就固定在這臺電腦上執行。

* 本地專案預設選專案所在的電腦，其他情況預設選雲主機。
* 裝置離線、沒有開啟允許執行、專案不在這臺裝置上，或當前 Agent 不是 Claude Code 時，這臺裝置無法選擇，選單裡會寫明原因。
* 選了裝置後，高於它許可權上限的許可權無法選擇。
* 想換到另一臺電腦或雲主機，請新建會話。

第一次在某臺電腦上執行時，如果它還沒開啟允許執行，或專案在這臺電腦上還沒有對應資料夾，這臺電腦的客戶端會提示你處理：點 **開啟機器與授權** 去開啟允許執行，或點 **允許** 並選擇專案資料夾（資料夾不會同步到雲端）。不屬於任何專案的會話使用自己的臨時目錄。

## 確認訪問敏感位置

敏感位置設為每次詢問時，Agent 要訪問 SSH 配置這類位置前，執行裝置的客戶端會顯示原因和要訪問的路徑。

* **允許這一次**：只放行這一次，不改變機器授權。
* **拒絕**：不放行。一段時間沒有處理也按拒絕處理。
* **稍後處理**：先收起，側欄裡這個會話會標記需要你處理。

## 檢視執行記錄

在執行環境選單底部點 **執行記錄** 檢視這個會話的操作，或在機器詳情裡點 **檢視執行記錄** 檢視這臺電腦上全部會話的操作。記錄逐行列出 Agent 做了什麼、物件是什麼、結果如何。

在執行裝置自己的客戶端裡，還可以停止程序、斷開或立即重連；在其他地方只能檢視。

## 電腦斷開後會怎樣

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

會話不會因為裝置離線自動換到雲主機。連線問題見[常見問題與排錯](https://docs.aihubmix.com/zh-Hant/cloud/reference/troubleshooting.md)。

## 移除裝置

在機器詳情底部點 **移除裝置** 並確認。

> [!WARNING]
>
> 移除後裝置立即斷開，正在使用它的會話會中斷。以後要再用這臺電腦，需要在上面重新登入。

雲主機不能移除。當前這臺電腦不能在這裡移除，請透過退出帳號移除。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.