cmux Cloud
cmux Cloud 为你提供云端的持久化 Linux 机器，它们会以普通 cmux 工作区的形式打开。关闭面板、断开网络或合上笔记本时，终端仍会继续运行，因此 coding agent 可以继续工作，你也可以从任何已登录的 Mac 重新连接。
什么是机器
机器是一台属于你或你的团队的持久化云端计算机。它会保留文件、已安装的工具和正在运行的终端。请把它当作长期使用的机器，而不是用完即弃的资源：所需工具只需安装一次，之后随时回来继续使用。
每台机器都运行着 cmux TUI 守护进程。守护进程保存机器上的工作区和终端。Mac 上的 cmux 面板只是显示位于机器上的终端，因此关闭面板永远不会停止进程。
一台机器可以容纳多个工作区。常见做法是在一台长期保留的机器上为每个任务使用一个工作区，而不是为每个任务新建一台机器。
每台机器都会获得一个自动生成的名称，例如 brave-otter。这个名称就是它在应用和 CLI 中的 ID。你可以添加显示标签，但 ID 不会改变。
你需要准备什么
- 已运行并登录的 cmux macOS 应用。cmux CLI 与应用通信，你的凭据由应用保存。
- cmux 付费套餐。免费账户无法创建机器。当前套餐请查看定价页面。 cmux.com/pricing
- 已在 Settings › Beta Features 中开启 Cloud Machines，且组织策略未禁用 Cloud。
- 无需配置 VPN、SSH 密钥或端口转发。cmux 通过自动启动的私有网络连接到你的机器。
快速入门
- 登录。使用右侧边栏中的 Cloud 标签页，或在终端中运行登录命令。
- 通过 File › New Cloud Machine 或 ⇧⌘Y 创建机器。选择规格和可选的标签。创建过程在后台进行，机器就绪后 cmux 会显示通知。
- 使用 ⌘Y（New Cloud Workspace）在机器上打开工作区。在 Cloud 工作区中，按 ⌘N 始终会在这台 Mac 上创建本地工作区。
- 运行代理。机器上已预装 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"