> ## 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 遠端控制你的電腦，讀寫檔案、執行命令都在你的電腦上進行，用的是你本機的環境和檔案，效果和在本機執行一樣。可以選任意一臺已登入桌面客戶端、並允許執行的電腦。
* **雲主機**：會話從開始到完成都在你的雲主機（Plus 附帶的 Linux 雲主機）上進行，不經過你的電腦；合上電腦會話也照樣跑完。

## 適用範圍

| 形態 | 支援情況 | 說明 |
| - | - | - |
| 桌面客戶端 | 支援 | 登入後這臺電腦自動成為可選的裝置；只有在這臺電腦自己的客戶端裡才能修改它的執行授權、處理敏感位置確認 |
| 網頁版 | 部分 | 新會話可以選雲主機或任意一臺裝置；機器列表、執行授權和執行記錄只能檢視 |
| 手機網頁 | 部分 | 同網頁版 |

## 兩種方式對比

| | 本機（在你的裝置上執行） | 雲主機 |
| - | - | - |
| 操作落在哪裡 | 你選的那臺電腦 | 你的雲主機（Ubuntu 24.04） |
| 用誰的環境和檔案 | 那臺電腦上的環境和專案資料夾 | 雲主機上的專案副本和[專案環境](https://docs.aihubmix.com/zh-Hant/cloud/projects/environment-setup.md) |
| 能用的專案 | 那臺電腦上的本地專案、不在任何專案中的會話 | 雲端專案、不在任何專案中的會話 |
| 支援的 Agent | 目前只支援 Claude Code | 全部 |
| 前提 | 那臺電腦線上，並開啟了「允许执行」 | 開通 Plus |
| 電腦關機或斷網 | 這一輪暫停，重新連上後自動繼續 | 不受影響 |

## 入口

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

## 新會話選擇執行環境

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

### 預設選哪個

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

### 不能選的情況

| 原因 | 選單裡的說明 |
| - | - |
| 裝置離線 | 「设备离线」（本地專案所在的電腦離線時仍可以選，並標「设备离线」） |
| 裝置沒有開啟「允许执行」 | 「未允许执行」 |
| 裝置已從工作區移除 | 「设备已移除，请选择其他环境」 |
| 當前專案在這臺裝置上沒有 | 「这个项目不在此设备上」 |
| 當前 Agent 不是 Claude Code | 「在设备上执行目前只支持 Claude Code」 |
| 本地專案選雲主機 | 「这个项目只在本机，请选它所在的设备」 |

### 裝置的許可權上限

每臺裝置可以設「权限上限」。選了這臺裝置後，會話許可權選單裡高於上限的檔位置灰（「超出此设备的授权上限」），已選的許可權高於上限時自動降到上限。許可權檔位見 [輸入框](https://docs.aihubmix.com/zh-Hant/cloud/sessions/composer.md)。

## 已有會話的執行環境

會話頂欄標題旁的膠囊顯示「云主机」或執行裝置的名稱，裝置離線時標「设备离线」。

* 執行機器在新建會話時選定，之後不能更換；要換到另一臺機器，請新建會話。
* 選單底部的「执行记录」「机器与授权」開啟執行裝置的記錄和詳情。

## 裝置與機器列表

**裝置**是你登入了桌面客戶端的電腦：登入後自動加入工作區，出現在機器列表和執行環境選單裡。網頁版不會加入裝置。

「设置 › 工作区 › 机器」列出工作區裡的全部機器（雲主機排在最前），每行顯示名稱、系統和客戶端版本，以及狀態「在线」「离线」「停机保留」「已移除」。重灌客戶端後留下的同名離線記錄會摺疊成一行，不再用的可以點進去移除。

點一行進入機器詳情。

## 機器詳情與執行授權

電腦和伺服器可以點名稱旁的鉛筆改名（最多 64 個字元）。

| 分組 | 設定 | 可選值（預設） | 說明 |
| - | - | - | - |
| 執行授權 | 允許執行 | 開 / 關（電腦預設關） | 開啟後雲端 Agent 才能在這臺機器上執行 |
| 執行授權 | 訪問範圍 | 「仅项目目录」「指定目录」「整台电脑」（預設整臺電腦） | 選「指定目录」時新增允許的目錄 |
| 執行授權 | 敏感位置 | 「每次询问」（預設）「禁止访问」「允许访问」 | 例如 SSH、鑰匙串與系統配置 |
| 任務許可權 | 許可權上限 | 「不设上限」（預設）「替我批准」「请求批准」 | 會話許可權不會超過這裡 |
| 任務許可權 | 可下發的金鑰 | 「全部工作区密钥」（預設）「只下发选中的」 | 選擇這臺機器上可以使用哪些工作區金鑰 |
| 環境變數覆蓋 | 變數列表 | 無 | 在這臺機器上執行時覆蓋的環境變數；不要寫金鑰明文，請用 `${VAR}` 引用 |
| 執行記錄 | 「查看执行记录」 | 無 | 見下文 |
| 外掛與 Skills | 「管理这台设备的插件」 | 無 | 見 [外掛、MCP 與 Skills](https://docs.aihubmix.com/zh-Hant/cloud/integrations/plugins-mcp-skills.md) |
| 裝置管理 | 「移除设备」 | 無 | 見下文 |

* 儲存後對新會話立即生效。
* 雲主機的詳情只有「允许执行」（只讀）、執行記錄和外掛入口，不能改名、不能移除。

### 系統確認

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

### 誰能修改

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

## 第一次在這臺電腦上執行

會話選了這臺電腦執行、而這臺電腦還不滿足條件時，這臺電腦的客戶端開啟這個會話時會提示：

* **還沒開啟「允许执行」**：點「打开机器与授权」，開啟「允许执行」後回來。命令以你的帳戶許可權執行。
* **專案在這臺電腦上還沒有資料夾**：點「允许」並選擇專案在這臺電腦上的資料夾，之後在這個專案裡執行不再詢問；點「不允许」則不會在這臺電腦上執行這個專案。資料夾不會同步到雲端。

不在任何專案中的會話使用這個會話自己的臨時目錄。適用時視窗裡會說明你的 `~/.claude/CLAUDE.md` 也會發給 Agent。

## 敏感位置確認

裝置的「敏感位置」設為「每次询问」時，Agent 要訪問 SSH 配置這類位置前，執行裝置的客戶端會顯示「访问确认」卡片，寫明原因和要訪問的路徑：

* 「允许这一次」：只放行這一次，不更改機器授權。
* 「拒绝」：不放行。
* 一段時間內沒有處理會按拒絕處理。
* 可以點「稍后处理」收起，側欄裡這個會話會顯示「需要你处理」。

## 執行記錄

從執行環境選單「执行记录」（這個會話）或機器詳情「查看记录」（這臺機器上的全部會話）開啟，逐行列出 Agent 在這臺機器上的操作、目標和結果。

在執行裝置自己的客戶端裡還可以「停止进程」（結束進行中的操作和後臺程序）、「断开」和「立即重连」；在網頁版或其他裝置上只能檢視記錄。

## 斷線與重連

會話正在某臺電腦上執行時，那臺電腦斷開（關機、休眠、斷網、退出客戶端等）：

* 這一輪暫停，執行裝置的客戶端在會話末尾顯示「本机已断开，这一轮已暂停」和斷開原因。
* 恢復連線後會自動從中斷的地方繼續，已經完成的操作不會重複執行；也可以點「重新连接」。原因是沒有允許執行或專案資料夾未關聯時，會引導你處理。
* 其他裝置和網頁版上，會話膠囊標「设备离线」。

會話不會因為裝置離線自動換到雲主機。

## 移除裝置

在機器詳情底部點「移除设备」並確認。裝置會立即斷開，正在使用它的會話會中斷；以後要再用，需要在這臺裝置上重新登入。

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

## 雲主機方式

選「云主机」時，會話全程在你的雲主機上執行，專案使用雲主機上的副本和[專案環境](https://docs.aihubmix.com/zh-Hant/cloud/projects/environment-setup.md)。雲主機需要 Plus；沒有開通時選單裡的「云主机」顯示「升级到 Plus 后可用」。雲主機的開通、狀態和遠端桌面見 [雲主機](https://docs.aihubmix.com/zh-Hant/cloud/cloud-host/overview.md)。

## 常見問題

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

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

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

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

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

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

### 怎麼新增一臺新裝置？

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

## 相關

* [專案](https://docs.aihubmix.com/zh-Hant/cloud/projects/projects.md)
* [專案環境](https://docs.aihubmix.com/zh-Hant/cloud/projects/environment-setup.md)
* [工作區設定](https://docs.aihubmix.com/zh-Hant/cloud/settings/workspace.md)
* [新會話](https://docs.aihubmix.com/zh-Hant/cloud/sessions/new-session.md)
* [輸入框](https://docs.aihubmix.com/zh-Hant/cloud/sessions/composer.md)
* [外掛、MCP 與 Skills](https://docs.aihubmix.com/zh-Hant/cloud/integrations/plugins-mcp-skills.md)
* [雲主機](https://docs.aihubmix.com/zh-Hant/cloud/cloud-host/overview.md)


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