# Workspaces, modèles et limite d’utilisation

> Le workspace utilisé par Moon CLI, les forfaits qui l’incluent, le choix d’un modèle ou d’Auto, les niveaux de coût et le suivi de votre limite d’utilisation.

Moon CLI travaille toujours pour le compte d’un workspace : son forfait ouvre l’accès et sa limite d’utilisation s’applique.

## Le workspace de la session

À la connexion, Moon CLI retient un workspace pour la session :

1. le workspace ouvert sur le web, s’il inclut Moon CLI ;
2. sinon le premier de vos workspaces qui l’inclut, votre workspace personnel d’abord ;
3. sinon le workspace ouvert sur le web.

Ce choix est propre à la session Moon CLI. Changer de workspace dans Moon CLI ne change pas celui du web, et inversement.

### Voir et changer le workspace

```bash title="Terminal"
moon workspace
```

```text title="Exemple de sortie"
Vos workspaces :
  1. Mon workspace (personnel) · Lune ·
     5d1e0c3a-7b2f-4c11-9e8a-2f6b1d4c7a90
  2. Studio · Étoile ✦  ● utilisé par Moon CLI
     a83f62d1-0c4e-4b9a-8f17-6e2d5b9c0f34

  ✦ = éligible Moon CLI (Étoile ou supérieur)
  Changer : moon workspace use <numéro | nom | id>
```

```bash title="Terminal"
moon workspace use 2
moon workspace use Studio
```

Le workspace se désigne par son numéro dans la liste, son nom ou son identifiant ; le début du nom ou de l’identifiant suffit s’il est unique. Si le workspace choisi n’inclut pas Moon CLI, Moon CLI vous prévient : ses requêtes seront refusées.

Dans l’agent, `/workspace` (ou `/ws`) fait la même chose sans quitter la session.

## Qui peut utiliser Moon CLI

Moon CLI est inclus à partir du forfait **Étoile** : Étoile, Constellation, Galaxie et Univers. Lune et le forfait gratuit ne l’incluent pas. Le forfait qui compte est celui du workspace de la session. Voir les [formules](https://realmoon.ai/tarifs/).

| État affiché par `moon whoami` ou `moon workspace` | Signification | Que faire |
| --- | --- | --- |
| « ✦ accès Moon CLI actif » | Le forfait du workspace inclut Moon CLI. | Rien. |
| « forfait Étoile ou supérieur requis » | Le forfait ne l’inclut pas. | Choisir un autre workspace, ou changer de forfait sur [chat.realmoon.ai/billing](https://chat.realmoon.ai/billing). |
| « paiement de l’abonnement en échec » | Moon CLI est suspendu jusqu’à la régularisation. | Mettre à jour le moyen de paiement. |
| « abonnement terminé » | L’abonnement du workspace a pris fin. | Le renouveler, ou choisir un autre workspace. |
| « aucun workspace » | Aucun workspace n’est associé à la session. | `moon workspace use <numéro>`. |

Un abonnement dont la résiliation est programmée garde l’accès jusqu’à la fin de la période payée.

Dans une **organisation gérée**, l’accès suit le forfait de votre licence, et l’organisation peut fermer Moon CLI à ses membres : l’agent affiche alors « Erreur Moon AI : Désactivé par votre organisation. » à chaque message. Voir [Licences](https://realmoon.ai/documentation/organisations/licences/) et [Règles](https://realmoon.ai/documentation/organisations/regles/).

Si vous quittez le workspace de la session, Moon CLI vous le signale : choisissez-en un autre avec `/workspace` ou `moon workspace use`.

## Choisir un modèle

Dans l’agent, `/models` ouvre la liste des modèles de votre workspace utilisables avec Moon CLI, sous leur nom du catalogue Moon AI. Les modèles d’images, les agents et les modèles réservés à un forfait que vous n’avez pas n’y figurent pas. Le modèle choisi vaut pour la session en cours : au lancement suivant, Moon CLI repart sur Auto.

Chaque modèle porte un **niveau de coût** :

| Niveau | Signification |
| --- | --- |
| « Économique » | Le moins coûteux pour votre limite. |
| « Standard » | Coût moyen. |
| « Haut de gamme » | Coût élevé. |
| « Très gourmand » | Un seul message peut utiliser une grande part de votre limite. |

Moon CLI n’affiche jamais de prix : seulement des niveaux et des pourcentages de votre limite.

Avant le premier message sur un modèle très gourmand, Moon CLI affiche par exemple « Ce modèle est très gourmand : un message peut utiliser environ 12 % de votre limite de session. » et propose :

| Choix | Effet |
| --- | --- |
| « Continuer » | Envoie le message. |
| « Choisir un autre modèle » | Ouvre la liste des modèles. |
| « Ne plus demander pour ce modèle » | Envoie le message et ne repose plus la question pour ce modèle. |

### Depuis le terminal

`moon models` liste les identifiants utilisables ; `-m` les utilise au lancement :

```bash title="Terminal"
moon models
moon -m moonai/anthropic/claude-haiku-4.5
moon run -m moonai/auto "explique le dossier src"
```

Pour un modèle par défaut dans un projet, voir [Modèle par défaut](https://realmoon.ai/documentation/moon-cli/configuration/#modele).

### Le mode Auto

« Auto · choix selon la tâche » est le modèle par défaut. Pour chaque tâche, il regarde seulement ce que vous avez écrit :

- une question simple (expliquer, chercher, lister) va vers un modèle économique ;
- un travail sur le code (corriger, écrire, refactorer) ou un gros contexte va vers un modèle adapté au code, au bon rapport entre qualité et coût ;
- il ne choisit jamais un modèle très gourmand ;
- il garde le même modèle pendant toute la tâche, pour profiter du cache des requêtes.

Pour fixer un modèle, choisissez-le dans `/models`, ou lancez `moon -m moonai/<identifiant>`.

### Ce que Moon CLI fait pour limiter la consommation

- Les titres, résumés, compactions et explorations du code passent par un petit modèle économique, quel que soit le modèle principal.
- La conversation est compactée automatiquement quand elle approche de la taille maximale du contexte (80 %). `/compact` le fait à la demande.
- Un modèle qui ne sait pas utiliser les outils de l’agent est signalé par « Ce modèle ne sait pas utiliser les outils de l’agent (fichiers, commandes). Choisissez-en un autre (/models). »

## Votre limite d’utilisation

Moon CLI utilise la limite d’utilisation de votre siège dans le workspace de la session, la même que sur le web dans ce workspace. Elle se compte sur trois fenêtres : la session de 5 h, la semaine et le mois. Le détail des fenêtres est dans [Limites d’utilisation](https://realmoon.ai/documentation/compte/limites/).

| Où | Ce que vous voyez |
| --- | --- |
| Au lancement | Une barre « Utilisation » avec le détail de la session de 5 h, de la semaine et du mois. |
| En-tête de l’agent | La jauge de votre limite. |
| Après chaque message | « Ce message : » suivi de la part de votre limite qu’il a utilisée. |
| `/usage` (`/quota`, `/limites`) | Le détail par fenêtre, sans quitter l’agent. |

Quand une fenêtre est pleine, Moon CLI l’indique avec l’heure où elle se libère, par exemple : « Limite d’utilisation de la session de 5 h atteinte. Elle se libère à 16 h 40. Choisissez un modèle plus économique (/models) ou passez à un forfait supérieur sur realmoon.ai. »

> [!TIP]
> **Économiser votre limite**
>
> Gardez vos fichiers `AGENTS.md` et `CLAUDE.md` courts (ils partent à chaque appel), laissez Auto choisir le modèle, et lancez `/compact` ou `/new` quand vous changez de sujet.

## Voir aussi

- [Configuration](https://realmoon.ai/documentation/moon-cli/configuration/#modele)
- [Référence des commandes](https://realmoon.ai/documentation/moon-cli/commandes/#workspace)
- [Les formules](https://realmoon.ai/tarifs/)

---

Documentation Moon AI › Moon CLI › Workspaces et modèles. Page : https://realmoon.ai/documentation/moon-cli/workspaces-modeles/. Modifiée le 5 novembre 2026.

© 2026 Stellarr Studio SAS. Tous droits réservés. Moon AI, Moon Blur et Stellarr Studio sont des marques déposées à l’INPI.