Machines Cloud

Cette page décrit la vie d'une machine cmux Cloud : comment la créer, quelles tailles choisir, comment s'appliquent les limites de forfait, et comment la mettre en pause, la sauvegarder, la forker et la supprimer.

Créer une machine

Dans l'app, utilisez File › New Cloud Machine (⇧⌘Y), le menu du bouton plus, la palette de commandes ou le bouton plus de la barre latérale Cloud. La fenêtre demande une taille et un libellé facultatif.

Depuis le CLI, cmux vm new crée une machine et y ouvre un espace de travail. Utilisez --detach pour la créer sans rien ouvrir. Si une demande de création est relancée, cmux réutilise la même demande pour que vous n'obteniez pas deux machines.

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

Si la création échoue, la notification vous permet de réessayer, d'afficher l'erreur ou de la copier pour une demande d'assistance.

Tailles

Chaque taille définit ensemble la mémoire, les vCPU et le disque. Choisissez une taille dans la fenêtre de création ou avec --size. Pro et Team prennent en charge 4g, 8g et 16g (2, 4 et 8 vCPU). Max déverrouille aussi 24g et 32g (12 et 16 vCPU), ainsi que 64g (32 vCPU).

Les nouvelles machines utilisent 8 GB de mémoire si vous ne choisissez pas de taille. Exécutez cmux vm ls --json pour voir les tailles autorisées par votre forfait.

Limites de forfait

Vos machines actives partagent un même pool de vCPU et de mémoire. Lancez une grande machine ou plusieurs petites. Les machines en pause n'utilisent pas le pool. Le disque est défini par machine et ne fait pas partie du pool.

• Les comptes gratuits ne peuvent pas créer de machines.
• Les comptes Pro et Founder's Edition peuvent avoir jusqu'à 5 machines actives qui partagent 20 vCPU et 40 GB de mémoire. Une machine est active tant qu'elle est en cours d'exécution ou de démarrage.
• Les comptes Team peuvent avoir jusqu'à 5 machines actives par siège payant. Chaque siège payant ajoute 20 vCPU et 40 GB de mémoire au pool de l'équipe.
• Les comptes Max peuvent avoir jusqu'à 5 machines actives qui partagent 80 vCPU et 160 GB de mémoire. Une machine Max peut utiliser jusqu'à 64 GB et 32 vCPU, y compris les tailles 24 GB / 12 vCPU et 32 GB / 16 vCPU ; Pro et Team s'arrêtent à 16 GB et 8 vCPU.
• Si une machine créée, reprise, agrandie ou dupliquée dépasse le pool, cmux refuse la demande et indique la part du pool déjà utilisée. Mettez en pause ou supprimez une machine pour libérer des ressources, ou passez à 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.

Consultez la page des tarifs pour les prix actuels. Il n'y a ni facturation à l'usage ni frais de dépassement.

Garder les agents de code à jour

Avec ce réglage activé, la machine met à jour Claude Code, Codex, OpenCode, pi et agent-browser. Elle vérifie après la création de la machine et à chaque connexion, au plus une fois toutes les 24 heures. La mise à jour s'exécute en arrière-plan de façon détachée, elle ne bloque donc jamais la connexion.

Chaque outil provient de sa version GitHub officielle et est vérifié avec l'empreinte sha256 de l'asset de la version. npm n'est pas utilisé. Une version ne s'installe qu'après 3 jours de publication, et une mise à jour n'installe jamais une version plus ancienne. Un agent en cours d'exécution garde les fichiers avec lesquels il a démarré, et une mise à jour échouée laisse la version actuelle en place.

Le résultat de la dernière vérification se trouve dans /etc/cmux/agent-updates.state, et le journal de la mise à jour dans /var/log/cmux-agent-updates.log. Une vérification échouée est relancée à la connexion suivante.

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

La feuille Nouvelle machine active ce réglage par défaut. Pour le changer sur une machine existante, faites un clic droit sur la machine et choisissez Garder les agents à jour, ou exécutez cmux vm agent-updates. cmux vm new garde les versions de l'image sauf si vous passez --agent-updates latest. Désactiver les mises à jour conserve les versions déjà installées.

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

Les mises à jour n'utilisent que github.com, api.github.com, objects.githubusercontent.com et release-assets.githubusercontent.com. cmux autorise ces hôtes dans tous les modes réseau, y compris Liste autorisée et Pas d'internet, donc une politique réseau ne bloque jamais les mises à jour.

Redimensionner

Vous pouvez agrandir une machine sans perte de données. Faites un clic droit sur la machine et choisissez Resize machine, ou utilisez cmux vm resize. Le redimensionnement ne peut qu'agrandir une machine. Le disque augmente par paliers de 4 GB jusqu'à 128 GB avec Pro et Team, ou 256 GB avec Max (Go est limité à 16 GB). La mémoire va jusqu'à 16 GB et le CPU jusqu'à 8 vCPU avec Pro et Team, ou jusqu'à 64 GB et 32 vCPU avec Max. Une machine plus grande utilise davantage votre pool. Votre forfait fixe le maximum réel.

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

Mettre en pause et reprendre

cmux vm pause arrête le calcul de la machine. Le disque, les espaces de travail et l'historique des terminaux sont conservés. Les processus en cours s'arrêtent. cmux vm resume redémarre la machine. Ouvrir une machine en pause ou y exécuter une commande la redémarre aussi.

Les machines ne se mettent pas en pause d'elles-mêmes lorsqu'elles sont inactives. Une machine continue de tourner jusqu'à ce que vous la mettiez en pause ou la supprimiez.

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

cmux vm wait attend qu'une machine soit prête. Ajoutez --wake pour démarrer d'abord une machine en pause. C'est utile dans les scripts avant la première commande.

Checkpoints, forks et restauration

Un checkpoint enregistre le disque de la machine. Un fork crée une nouvelle machine à partir de l'état actuel d'une machine. Une restauration crée une nouvelle machine à partir d'un checkpoint. Les checkpoints incluent le fichier d'environnement de la machine.

Créez un checkpoint avant une modification risquée, et utilisez un fork pour essayer deux approches en parallèle à partir du même point de départ.

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 et Fork n'apparaissent que si le fournisseur de la machine les prend en charge. Si une commande est refusée, la machine ne prend pas en charge cette opération.

Renommer

cmux vm rename définit un libellé d'affichage de 64 caractères imprimables au maximum. Le nom généré reste l'identifiant de la machine. Utilisez --clear pour supprimer le libellé.

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

État et statistiques

cmux vm status affiche l'état, la taille et l'adresse d'une machine. cmux vm stats affiche l'utilisation du CPU, de la mémoire et du disque sans réveiller une machine en pause.

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

Supprimer

Supprimer une machine efface définitivement la machine et tout ce qui se trouve sur son disque. Cela supprime aussi les URL publiques de la machine et révoque son accès aux modèles. Une suppression est irréversible.

Créez d'abord un checkpoint si vous pensez avoir besoin des fichiers plus tard.

cmux vm rm brave-otter

Quand votre forfait prend fin

Si votre forfait payant prend fin, les machines de plus de 7 jours sont verrouillées. Vous pouvez toujours les lister, les renommer et les supprimer, mais vous ne pouvez plus les ouvrir, y exécuter des commandes, rediriger des ports ni les reprendre. Les machines et leurs fichiers sont conservés. Reprenez un forfait payant pour vous reconnecter. La barre latérale Cloud affiche Locked et un élément de menu Upgrade to Reconnect.