# Référence CLI Cloud

cmux vm et cmux cloud sont la même commande. Le CLI communique avec l'app cmux en cours d'exécution, qui conserve votre connexion. Ajoutez --json à n'importe quel verbe pour obtenir une sortie lisible par une machine. Chaque verbe a une page --help.

Codes de sortie : 0 en cas de succès, 1 en cas d'erreur et 2 pour une commande inconnue. cmux vm run renvoie le code de sortie distant.

## Connexion

Connectez-vous, vérifiez votre compte et choisissez une équipe.

```
cmux auth login
cmux auth status --json
cmux auth logout
cmux auth team list
cmux auth team use <team-id>
```

## Machines

Créer, inspecter, modifier et supprimer des machines.

```
cmux vm ls [--json]
cmux vm new [--size 4g|8g|16g|24g|32g|64g] [--name <label>] [--workspace <id>] [--window <id>] [--focus true|false] [--detach]
cmux vm base [open] [--detach]
cmux vm base reset [--reason <text>]
cmux vm status <id>
cmux vm stats <id>
cmux vm resize <id> [--cpu <vCPUs>] [--memory <GiB>] [--disk <GiB>]
cmux vm rename <id> <label> | --clear
cmux vm pause <id>
cmux vm resume <id>
cmux vm wait <id> [--timeout <seconds>] [--wake]
cmux vm tools <id>
cmux vm ports <id>
cmux vm rm <id>
```

## Checkpoints et forks

Ces verbes fonctionnent lorsque le fournisseur de la machine les prend en charge.

```
cmux vm snapshot <id> [--name <name>]      # alias: checkpoint
cmux vm snapshot ls <id>
cmux vm snapshot rm <id> <snapshot-id>
cmux vm fork <id> [--name <name>] [--detach]
cmux vm restore <snapshot-id> [--detach]
```

## Ouvrir

Ouvrir une machine, un espace de travail, un terminal, le bureau ou un port dans cmux.

```
cmux vm shell <id>                         # alias: attach
cmux vm tui <id>                           # full cmux TUI client
cmux vm desktop <id>                       # alias: vnc
cmux vm open <machine>[/<workspace>[/<terminal>[/<tab>]]] [--workspace <id>] [--focus true|false]
cmux vm open <machine>:desktop
cmux vm open <machine>:port/<n> [--print]
cmux vm open <machine> <port> [--print]
```

## Exécuter des commandes et des agents

Exécuter des commandes et des agents sur une machine depuis votre Mac.

```
cmux vm exec [--timeout <seconds>] <id> -- <command...>
cmux vm run [--sync] [--pull <remote-path>] [--machine <id>] [--new] [--size <size>] [--timeout <seconds>] -- <command...>
cmux vm route [--cwd <dir>] [--new] [--provision] [--size <size>]
cmux vm agent --agent claude|codex|opencode|pi [--machine <id>] [--sync] [--cwd <dir>] [--name <name>] [--no-open] [--wait [--output] [--timeout <seconds>]] [--new] [--size <size>] -- <prompt>
cmux vm dev <machine> [<local-dir>] [--name <workspace>] [--layout <file>] [--command "<cmd>"] [--port <n>] [--remote <path>] [--sync|--no-sync] [--no-open] [--dry-run]
cmux vm prompt [--open claude|codex|opencode|pi]
```

## Espaces de travail et terminaux

Contrôler les espaces de travail et les terminaux qui vivent sur une machine.

```
cmux vm tree [<machine>] [--refresh]
cmux vm workspace new <machine> [--name <name>] [--reuse] [--no-open]
cmux vm workspace open <machine> <workspace-id>
cmux vm workspace rename <machine> <workspace-id> <name>
cmux vm workspace close <machine> <workspace-id>   # terminals keep running
cmux vm workspace rm <machine> <workspace-id>      # terminals stop
cmux vm terminal send <machine> <terminal-id> [text] [--keys <k1,k2>]
cmux vm terminal read <machine> <terminal-id>
cmux vm terminal wait <machine> <terminal-id> --pattern <regex> [--timeout <seconds>]
cmux vm terminal wait-exit <machine> <terminal-id> [--timeout <seconds>]
cmux vm terminal output <machine> <terminal-id> [--after <offset>] [--max-bytes <n>]
cmux vm terminal rename <machine> <terminal-id> <name>
cmux vm terminal close <machine> <terminal-id>
cmux vm layout export <machine> [<workspace>]
cmux vm layout apply <machine> <file>|- [--name <name>] [--cwd <dir>] [--open]
```

## Fichiers et environnement

Transférer des fichiers et des secrets, et définir des variables d'environnement.

```
cmux vm push <id> <local-path> [remote-path] [--exclude <pattern>]... [--no-default-excludes] [--watch]
cmux vm push --secret <id> <local-file> [remote-path] [--mode <octal>]
cmux vm pull <id> <remote-path> [local-path]
cmux vm env set <machine> KEY=VALUE... | --from-file <.env> | -
cmux vm env ls <machine> [--show]
cmux vm env rm <machine> KEY...
```

## URL publiques

Publier les ports des machines et gérer les domaines personnalisés et l'accès.

```
cmux cloud domains [list]
cmux cloud domains zones
cmux cloud domains verify <domain>
cmux cloud domains publish <vm> <port> [--domain <hostname>] [--access personal|team|public] [--team <id>] [--yes]
cmux cloud domains access <hostname> personal|team|public [--yes]
cmux cloud domains grant <hostname> <email> [--expires <ISO-date>]
cmux cloud domains ungrant <hostname> <email>
cmux cloud domains grants <hostname>
cmux cloud domains rm <hostname>
```

## VPN

Route système facultative pour les autres apps de votre Mac.

```
cmux vpn up
cmux vpn status
cmux vpn down
cmux vpn revoke
```

## Comptes IA et routage des modèles

Envoyer des comptes d'agents pour votre équipe et vérifier le routage des modèles.

```
cmux ai-accounts list
cmux ai-accounts upload claude|codex|anthropic-key|openai-key [--label <label>] [--team <id>]
cmux coderouter status
cmux coderouter machines
```

[Référence complète des commandes CodeRouter](https://cmux.com/fr/docs/coderouter/cli)

## Liste de contrôle pour les scripts

Avant qu'un script crée ou utilise des machines, exécutez ces vérifications en lecture seule. Elles confirment que vous êtes connecté, affichent vos machines et vos limites de forfait, et indiquent quelle machine un répertoire utilise.

```
cmux auth status
cmux vm ls --json
cmux vm route --json
```

Canonical: https://cmux.com/fr/docs/cloud/cli

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