> ## 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/cn/cloud/projects/environment-setup.md) |
| 能用的项目 | 那台电脑上的本地项目、不在任何项目中的会话 | 云端项目、不在任何项目中的会话 |
| 支持的 Agent | 目前只支持 Claude Code | 全部 |
| 前提 | 那台电脑在线，并打开了「允许执行」 | 开通 Plus |
| 电脑关机或断网 | 这一轮暂停，重新连上后自动继续 | 不受影响 |

## 入口

* 新会话：输入框上方「项目」旁边的运行环境按钮。
* 已有会话：顶栏标题旁的运行环境胶囊。
* 「设置 › 工作区 › 机器」，或运行环境菜单底部的「执行记录」「机器与授权」。

## 新会话选择运行环境

点运行环境按钮打开「运行环境」菜单：顶部是「云主机」，下面「在你的设备上执行」分组列出每台设备（当前这台电脑带「这台设备」，第二行显示它的访问范围和权限上限），底部是「执行记录」「机器与授权」。

### 默认选哪个

* 本地项目默认选项目所在的那台电脑；其他项目和不在任何项目中的会话默认选云主机。
* 手动选择只对这一次新会话有效。所选设备变得不能用时，自动退回云主机。

### 不能选的情况

| 原因 | 菜单里的说明 |
| - | - |
| 设备离线 | 「设备离线」（本地项目所在的电脑离线时仍可以选，并标「设备离线」） |
| 设备没有打开「允许执行」 | 「未允许执行」 |
| 设备已从工作区移除 | 「设备已移除，请选择其他环境」 |
| 当前项目在这台设备上没有 | 「这个项目不在此设备上」 |
| 当前 Agent 不是 Claude Code | 「在设备上执行目前只支持 Claude Code」 |
| 本地项目选云主机 | 「这个项目只在本机，请选它所在的设备」 |

### 设备的权限上限

每台设备可以设「权限上限」。选了这台设备后，会话权限菜单里高于上限的档位置灰（「超出此设备的授权上限」），已选的权限高于上限时自动降到上限。权限档位见 [输入框](https://docs.aihubmix.com/cn/cloud/sessions/composer.md)。

## 已有会话的运行环境

会话顶栏标题旁的胶囊显示「云主机」或执行设备的名称，设备离线时标「设备离线」。

* 执行机器在新建会话时选定，之后不能更换；要换到另一台机器，请新建会话。
* 菜单底部的「执行记录」「机器与授权」打开执行设备的记录和详情。

## 设备与机器列表

**设备**是你登录了桌面客户端的电脑：登录后自动加入工作区，出现在机器列表和运行环境菜单里。网页版不会加入设备。

「设置 › 工作区 › 机器」列出工作区里的全部机器（云主机排在最前），每行显示名称、系统和客户端版本，以及状态「在线」「离线」「停机保留」「已移除」。重装客户端后留下的同名离线记录会折叠成一行，不再用的可以点进去移除。

点一行进入机器详情。

## 机器详情与执行授权

电脑和服务器可以点名称旁的铅笔改名（最多 64 个字符）。

| 分组 | 设置 | 可选值（默认） | 说明 |
| - | - | - | - |
| 执行授权 | 允许执行 | 开 / 关（电脑默认关） | 打开后云端 Agent 才能在这台机器上执行 |
| 执行授权 | 访问范围 | 「仅项目目录」「指定目录」「整台电脑」（默认整台电脑） | 选「指定目录」时添加允许的目录 |
| 执行授权 | 敏感位置 | 「每次询问」（默认）「禁止访问」「允许访问」 | 例如 SSH、钥匙串与系统配置 |
| 任务权限 | 权限上限 | 「不设上限」（默认）「替我批准」「请求批准」 | 会话权限不会超过这里 |
| 任务权限 | 可下发的密钥 | 「全部工作区密钥」（默认）「只下发选中的」 | 选择这台机器上可以使用哪些工作区密钥 |
| 环境变量覆盖 | 变量列表 | 无 | 在这台机器上执行时覆盖的环境变量；不要写密钥明文，请用 `${VAR}` 引用 |
| 执行记录 | 「查看执行记录」 | 无 | 见下文 |
| 插件与 Skills | 「管理这台设备的插件」 | 无 | 见 [插件、MCP 与 Skills](https://docs.aihubmix.com/cn/cloud/integrations/plugins-mcp-skills.md) |
| 设备管理 | 「移除设备」 | 无 | 见下文 |

* 保存后对新会话立即生效。
* 云主机的详情只有「允许执行」（只读）、执行记录和插件入口，不能改名、不能移除。

### 系统确认

在桌面客户端里放宽这台电脑的执行授权（打开「允许执行」、扩大访问范围、放开敏感位置、调高权限上限等）时，会弹出确认窗口，列出放宽的内容；打开「允许执行」后对之后所有在这台电脑上执行的会话长期有效。收紧授权不需要确认；关闭「允许执行」时，正在使用这台设备的会话会暂停。

### 谁能修改

执行授权只能在**这台电脑自己的桌面客户端**里修改。在其他设备或网页版上查看时只读，提示「仅可在这台设备上修改执行授权。」；云主机的设置也是只读。

## 第一次在这台电脑上执行

会话选了这台电脑执行、而这台电脑还不满足条件时，这台电脑的客户端打开这个会话时会提示：

* **还没打开「允许执行」**：点「打开机器与授权」，打开「允许执行」后回来。命令以你的账户权限运行。
* **项目在这台电脑上还没有文件夹**：点「允许」并选择项目在这台电脑上的文件夹，之后在这个项目里运行不再询问；点「不允许」则不会在这台电脑上运行这个项目。文件夹不会同步到云端。

不在任何项目中的会话使用这个会话自己的临时目录。适用时窗口里会说明你的 `~/.claude/CLAUDE.md` 也会发给 Agent。

## 敏感位置确认

设备的「敏感位置」设为「每次询问」时，Agent 要访问 SSH 配置这类位置前，执行设备的客户端会显示「访问确认」卡片，写明原因和要访问的路径：

* 「允许这一次」：只放行这一次，不更改机器授权。
* 「拒绝」：不放行。
* 一段时间内没有处理会按拒绝处理。
* 可以点「稍后处理」收起，侧栏里这个会话会显示「需要你处理」。

## 执行记录

从运行环境菜单「执行记录」（这个会话）或机器详情「查看记录」（这台机器上的全部会话）打开，逐行列出 Agent 在这台机器上的操作、目标和结果。

在执行设备自己的客户端里还可以「停止进程」（结束进行中的操作和后台进程）、「断开」和「立即重连」；在网页版或其他设备上只能查看记录。

## 断线与重连

会话正在某台电脑上执行时，那台电脑断开（关机、休眠、断网、退出客户端等）：

* 这一轮暂停，执行设备的客户端在会话末尾显示「本机已断开，这一轮已暂停」和断开原因。
* 恢复连接后会自动从中断的地方继续，已经完成的操作不会重复执行；也可以点「重新连接」。原因是没有允许执行或项目文件夹未关联时，会引导你处理。
* 其他设备和网页版上，会话胶囊标「设备离线」。

会话不会因为设备离线自动换到云主机。

## 移除设备

在机器详情底部点「移除设备」并确认。设备会立即断开，正在使用它的会话会中断；以后要再用，需要在这台设备上重新登录。

* 云主机不能移除。
* 当前这台电脑不能在这里移除，请通过退出账号移除。

## 云主机方式

选「云主机」时，会话全程在你的云主机上运行，项目使用云主机上的副本和[项目环境](https://docs.aihubmix.com/cn/cloud/projects/environment-setup.md)。云主机需要 Plus；没有开通时菜单里的「云主机」显示「升级到 Plus 后可用」。云主机的开通、状态和远程桌面见 [云主机](https://docs.aihubmix.com/cn/cloud/cloud-host/overview.md)。

## 常见问题

### 「在你的设备上执行」时我的电脑要一直开着吗？

要。电脑断开后这一轮会暂停，重新连上后自动继续。需要合上电脑也继续跑的，请选云主机。

### 已有的会话能从电脑换到云主机吗？

不能。执行机器在新建会话时就定下了；要换，请新建会话。

### 为什么网页版改不了我电脑的授权？

执行授权只能在那台电脑自己的桌面客户端里修改。

### 怎么添加一台新设备？

在那台电脑上安装桌面客户端并登录同一账号，它会自动出现在机器列表里；再在那台电脑的客户端里打开「允许执行」。

## 相关

* [项目](https://docs.aihubmix.com/cn/cloud/projects/projects.md)
* [项目环境](https://docs.aihubmix.com/cn/cloud/projects/environment-setup.md)
* [工作区设置](https://docs.aihubmix.com/cn/cloud/settings/workspace.md)
* [新会话](https://docs.aihubmix.com/cn/cloud/sessions/new-session.md)
* [输入框](https://docs.aihubmix.com/cn/cloud/sessions/composer.md)
* [插件、MCP 与 Skills](https://docs.aihubmix.com/cn/cloud/integrations/plugins-mcp-skills.md)
* [云主机](https://docs.aihubmix.com/cn/cloud/cloud-host/overview.md)


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