云端机器

本页介绍 cmux Cloud 机器的生命周期：如何创建、可选择哪些规格、套餐限制如何生效，以及如何暂停、快照、分叉和删除机器。

创建机器

在应用中，使用 File › New Cloud Machine（⌘Y）、加号按钮菜单、命令面板，或 Cloud 侧边栏中的加号按钮。弹出的面板会要求你选择规格并填写可选的标签。

在 CLI 中，cmux vm new 会创建机器并在其上打开工作区。使用 --detach 可只创建而不打开任何内容。如果创建请求被重试，cmux 会复用同一个请求，因此不会产生两台机器。

cmux vm new
cmux vm new --size 16g --name "search index"
cmux vm new --detach --json

如果创建失败，你可以在通知中重试、查看错误，或复制错误用于提交支持请求。

规格

每种规格会同时决定内存、vCPU 和磁盘。可以在创建面板中或通过 --size 选择规格。

如果不选择规格，新机器将使用 8 GB 内存。运行 cmux vm ls --json 可查看你的套餐允许的规格。

套餐限制

你的活跃机器共享同一个 vCPU 和内存资源池。你可以运行一台大机器，也可以运行几台小机器。已暂停的机器不占用资源池。磁盘按每台机器单独设置，不计入资源池。

• 免费账户无法创建机器。
• Pro 和 Founder's Edition 账户最多可拥有 5 台活跃机器，共享 20 个 vCPU 和 40 GB 内存。正在运行或正在启动的机器即为活跃机器。
• Team 账户每个付费席位最多可拥有 5 台活跃机器。每个付费席位会为团队资源池增加 20 个 vCPU 和 40 GB 内存。
• Max 账户最多可拥有 5 台活跃机器，共享 80 个 vCPU 和 160 GB 内存。在 Pro 和 Team 中，单台机器最高 32 GB 和 16 vCPU；在 Max 中最高 64 GB 和 32 vCPU。
• 如果新建、恢复、扩容或分叉的机器会超出资源池，cmux 会拒绝该请求，并显示资源池的已用量。暂停或删除一台机器以释放资源，或升级到 Max。
• A machine larger than your plan allows is locked. You can list and delete it, but you cannot open it, run commands on it, resume it, or resize it until you upgrade.

当前价格请查看定价页面。不按用量计费，也没有超额费用。

让编码代理保持最新

开启此设置后，机器会更新 Claude Code、Codex、OpenCode、pi 和 agent-browser。机器创建后以及每次连接时都会检查，每 24 小时最多一次。更新在后台独立运行，因此不会阻塞连接。

每个工具都来自其官方 GitHub 版本，并使用发布资源的 sha256 摘要进行校验。不使用 npm。版本发布满 3 天后才会安装，更新绝不会安装更旧的版本。正在运行的代理会继续使用启动时的文件，更新失败时当前版本保持不变。

上次检查的结果在 /etc/cmux/agent-updates.state 中，更新程序的日志在 /var/log/cmux-agent-updates.log 中。失败的检查会在下次连接时重新运行。

cat /etc/cmux/agent-updates.state
tail /var/log/cmux-agent-updates.log

“新建机器”面板默认开启此设置。要为现有机器更改，请右键点击机器并选择“让代理保持最新”，或运行 cmux vm agent-updates。除非传入 --agent-updates latest，否则 cmux vm new 会保留镜像中的版本。关闭更新后，已安装的版本会保留。

cmux vm new --agent-updates latest
cmux vm agent-updates brave-otter
cmux vm agent-updates brave-otter image

更新只使用 github.com, api.github.com, objects.githubusercontent.com 和 release-assets.githubusercontent.com。cmux 在所有网络模式下都允许这些主机，包括“允许列表”和“无互联网”，因此网络策略不会阻止更新。

调整规格

你可以在不丢失数据的情况下扩大机器。右键点击机器并选择 Resize machine，或使用 cmux vm resize。调整规格只能扩大机器。磁盘以 4 GB 为步长最多扩展到 256 GB。在 Pro 和 Team 中，内存最多 32 GB，CPU 最多 16 vCPU；在 Max 中，内存最多 64 GB，CPU 最多 32 vCPU。机器越大，占用的资源池越多。实际上限由你的套餐决定。

cmux vm resize brave-otter --memory 16G
cmux vm resize brave-otter --cpu 8 --disk 128G

暂停与恢复

cmux vm pause 会停止机器的计算资源。磁盘、工作区和终端历史会保留，正在运行的进程会停止。cmux vm resume 会重新启动机器。打开已暂停的机器或在其上运行命令也会启动它。

机器空闲时不会自动暂停。机器会一直运行，直到你暂停或删除它。

cmux vm pause brave-otter
cmux vm resume brave-otter
cmux vm wait brave-otter --wake --timeout 180

cmux vm wait 会等待机器就绪。添加 --wake 可先启动已暂停的机器。这在脚本执行第一条命令之前很有用。

检查点、分叉与恢复

检查点会保存机器的磁盘。分叉会基于某台机器的当前状态创建一台新机器。恢复会基于检查点创建一台新机器。检查点包含机器的环境变量文件。

在进行有风险的更改之前先创建检查点；想从同一起点并行尝试两种方案时，使用分叉。

cmux vm checkpoint brave-otter --name before-migration
cmux vm snapshot ls brave-otter
cmux vm restore <snapshot-id>
cmux vm fork brave-otter --name try-b
cmux vm snapshot rm brave-otter <snapshot-id>

只有当机器的提供商支持时，才会显示 Checkpoint 和 Fork。如果命令被拒绝，说明该机器不支持此操作。

重命名

cmux vm rename 用于设置显示标签，最多 64 个可打印字符。自动生成的名称仍作为机器的 ID。使用 --clear 可移除标签。

cmux vm rename brave-otter "billing api"
cmux vm rename brave-otter --clear

状态与统计

cmux vm status 显示机器的状态、规格和地址。cmux vm stats 显示 CPU、内存和磁盘使用情况，且不会唤醒已暂停的机器。

cmux vm status brave-otter
cmux vm stats brave-otter

删除

删除机器会永久删除该机器及其磁盘上的所有内容，同时移除该机器的公开 URL 并撤销其模型访问权限。删除操作无法撤销。

如果之后可能还需要这些文件，请先创建检查点。

cmux vm rm brave-otter

套餐到期后

如果你的付费套餐到期，创建超过 7 天的机器将被锁定。你仍然可以列出、重命名和删除这些机器，但无法打开它们、运行命令、转发端口或恢复它们。机器及其文件会被保留。重新升级即可重新连接。Cloud 侧边栏会显示 Locked 以及 Upgrade to Reconnect 菜单项。