# cmux Cloud

cmux Cloud 为你提供云端的持久化 Linux 机器，它们会以普通 cmux 工作区的形式打开。关闭面板、断开网络或合上笔记本时，终端仍会继续运行，因此 coding agent 可以继续工作，你也可以从任何已登录的 Mac 重新连接。

cmux Cloud 目前处于抢先体验阶段，除非你的组织将其禁用，否则均可使用。要使用它，请开启 Settings › Beta Features › Cloud Machines。

## 什么是机器

机器是一台属于你或你的团队的持久化云端计算机。它会保留文件、已安装的工具和正在运行的终端。请把它当作长期使用的机器，而不是用完即弃的资源：所需工具只需安装一次，之后随时回来继续使用。

每台机器都运行着 cmux TUI 守护进程。守护进程保存机器上的工作区和终端。Mac 上的 cmux 面板只是显示位于机器上的终端，因此关闭面板永远不会停止进程。

一台机器可以容纳多个工作区。常见做法是在一台长期保留的机器上为每个任务使用一个工作区，而不是为每个任务新建一台机器。

每台机器都会获得一个自动生成的名称，例如 brave-otter。这个名称就是它在应用和 CLI 中的 ID。你可以添加显示标签，但 ID 不会改变。

## 你需要准备什么

-   已运行并登录的 cmux macOS 应用。cmux CLI 与应用通信，你的凭据由应用保存。
-   cmux 付费套餐。免费账户无法创建机器。当前套餐请查看定价页面。 [cmux.com/pricing](https://cmux.com/zh-CN/pricing)
-   已在 Settings › Beta Features 中开启 Cloud Machines，且组织策略未禁用 Cloud。
-   无需配置 VPN、SSH 密钥或端口转发。cmux 通过自动启动的私有网络连接到你的机器。

## 快速入门

1.  登录。使用右侧边栏中的 Cloud 标签页，或在终端中运行登录命令。
2.  通过 File › New Cloud Machine 或 ⇧⌘Y 创建机器。选择规格和可选的标签。创建过程在后台进行，机器就绪后 cmux 会显示通知。
3.  使用 ⌘Y（New Cloud Workspace）在机器上打开工作区。在 Cloud 工作区中，按 ⌘N 始终会在这台 Mac 上创建本地工作区。
4.  运行代理。机器上已预装 Claude Code、Codex、OpenCode 和 Pi。

也可以通过 CLI 完成相同操作：

```
cmux auth login
cmux vm new --size 8g --name "api work"
cmux vm ls
cmux vm open brave-otter
cmux vm agent --agent claude --machine brave-otter --sync -- "fix the failing tests"
```

## 在应用中使用 Cloud

右侧边栏的 Cloud 标签页会列出你的机器。每台机器下方显示其工作区、已转发的端口、VNC 显示器和终端。点击某一项即可打开。你也可以在命令面板中使用 Open Cloud as Pane，将 Cloud 树作为面板打开。

右键点击机器，可以打开 shell、创建工作区、打开桌面、打开完整的 cmux TUI 客户端、调整规格、重命名、复制 IP 地址、查看状态、创建检查点、分叉或删除机器。你还可以固定机器并调整它们的顺序。

New Cloud Machine（⇧⌘Y）和 New Cloud Workspace（⌘Y）位于 File 菜单、加号按钮菜单和命令面板中。这两个快捷键都可以在设置中修改，或在 cmux.json 中通过 newCloudMachine 和 newCloudWorkspace 键修改。

```
{
  "shortcuts": {
    "bindings": {
      "newCloudMachine": "cmd+shift+y",
      "newCloudWorkspace": "cmd+y"
    }
  }
}
```

## 通过 CLI 使用 Cloud

cmux vm 和 cmux cloud 是同一个命令。不带子命令运行 cmux vm 会列出你的机器。每个子命令都有无需应用即可使用的 --help 页面，cmux vm guide 会输出完整的 Markdown 指南。为任意子命令添加 --json 即可获得机器可读的输出。

```
cmux vm              # list machines
cmux vm --help
cmux vm new --help
cmux vm guide        # full Markdown guide
cmux vm ls --json
```

## 你的基础机器

每个账户都有一台固定的基础机器。cmux vm base 会打开它，并在首次使用时创建它。cmux vm base reset 会创建一台新的基础机器并保留旧机器，因此不会意外丢失文件。

```
cmux vm base
cmux vm base reset --reason "start clean"
```

## 后续步骤

-   [机器：规格、套餐、调整规格、暂停、快照和删除。](https://cmux.com/zh-CN/docs/cloud/machines)
-   [工作区与代理：持久化终端、代理、通知以及预装内容。](https://cmux.com/zh-CN/docs/cloud/workspaces)
-   [文件与网络：上传文件、环境变量、端口、桌面和公开 URL。](https://cmux.com/zh-CN/docs/cloud/networking)
-   [Cloud CLI 参考：所有 cmux vm 子命令。](https://cmux.com/zh-CN/docs/cloud/cli)
-   [安全与故障排除：访问机制以及常见错误的解决方法。](https://cmux.com/zh-CN/docs/cloud/troubleshooting)

Canonical: https://cmux.com/zh-CN/docs/cloud

Documentation index: https://cmux.com/llms.txt