# Moon CLI

> L’agent de code de Moon AI dans votre terminal. Il lit et modifie votre projet avec les modèles de votre compte, et masque vos secrets avant l’envoi.

Moon CLI est l’agent de code de Moon AI en ligne de commande. Lancé dans le dossier d’un projet, il lit vos fichiers, propose et applique des modifications, exécute des commandes et vous demande votre accord avant d’agir. Il utilise les modèles et la limite d’utilisation de votre compte Moon AI.

Version actuelle : 0.4.0. Les nouveautés de chaque version sont dans les [notes de version](https://realmoon.ai/documentation/moon-cli/versions/).

## Ce que fait Moon CLI

- **Il travaille dans votre projet.** L’agent part du dossier où vous le lancez, à l’intérieur du dépôt Git qui le contient, et ne charge aucune configuration située au-dessus de la racine du dépôt.
- **Il passe par votre compte.** Mêmes modèles que sur [chat.realmoon.ai](https://chat.realmoon.ai), même limite d’utilisation, comptée en pourcentage. Aucun prix n’est affiché.
- **Il demande avant d’agir.** Par défaut, chaque modification de fichier, chaque commande et chaque accès au web attend votre accord. Deux autres modes réduisent ces demandes quand vous le décidez.
- **Il masque vos secrets sur votre machine.** Moon Blur remplace les clés, jetons et mots de passe par des valeurs de remplacement avant l’envoi au modèle, puis remet les vraies valeurs dans les réponses.
- **Il protège votre session.** Le jeton de connexion est rangé dans le trousseau du système et n’est jamais transmis à l’agent. Moon CLI ne parle qu’à Moon AI : aucun autre fournisseur de modèles, pas de partage de session vers un service tiers.
- **Il se méfie des dépôts clonés.** La configuration d’agent d’un dépôt (plugins, serveurs MCP, skills) n’est chargée qu’après votre accord.
- **Il se met à jour seul.** Chaque mise à jour est signée et vérifiée avant d’être activée.

## Ce qu’il faut

| Élément | Détail |
| --- | --- |
| Un compte Moon AI | Celui de [chat.realmoon.ai](https://chat.realmoon.ai). |
| Un forfait qui inclut Moon CLI | Moon CLI est inclus à partir du forfait Étoile, sur le workspace qu’utilise Moon CLI. Lune et le forfait gratuit ne l’incluent pas. Voir les [formules](https://realmoon.ai/tarifs/). |
| Un système pris en charge | Windows 10 et 11, macOS (Apple Silicon et Intel), Linux (x64 et ARM, glibc ou musl) et WSL. Détail dans [Installation](https://realmoon.ai/documentation/moon-cli/installation/). |

Rien d’autre à installer : Moon CLI est un binaire autonome.

> [!NOTE]
> **Organisations**
>
> Dans une organisation gérée, l’accès suit le forfait de votre licence, et l’organisation peut désactiver Moon CLI. Voir [Workspaces et modèles](https://realmoon.ai/documentation/moon-cli/workspaces-modeles/#acces).

## Démarrer

Installez Moon CLI :

```powershell title="Windows (PowerShell)"
irm https://realmoon.ai/install.ps1 | iex
```

```bash title="macOS, Linux, WSL"
curl -fsSL https://realmoon.ai/install.sh | sh
```

Ouvrez un nouveau terminal, placez-vous dans votre projet, puis connectez-vous :

```bash title="Terminal"
cd mon-projet
moon login
```

`moon login` ouvre la page « Connecter Moon CLI. » dans votre navigateur. Cliquez sur « Autoriser » : l’agent démarre aussitôt dans le dossier courant. Les fois suivantes, `moon` suffit.

## Moon CLI et le chat web

| Sujet | Chat web | Moon CLI |
| --- | --- | --- |
| Compte et modèles | Votre compte et son catalogue | Le même compte et ses modèles, listés par `moon models` |
| Limite d’utilisation | Celle du workspace ouvert | Celle du workspace de la session Moon CLI |
| Workspace | Choisi dans l’application | Propre à la session Moon CLI, sans effet sur le web |
| Moon Blur | Appliqué par Moon AI | Appliqué sur votre machine, mode réglable |

## Dans cette section

### Prise en main

- [Installer Moon CLI](https://realmoon.ai/documentation/moon-cli/installation/) : Installer Moon CLI sous Windows, macOS, Linux ou WSL, choisir une version ou un autre dossier, retrouver ses fichiers et vérifier les empreintes publiées.
- [Se connecter à Moon AI](https://realmoon.ai/documentation/moon-cli/connexion/) : Relier Moon CLI à votre compte Moon AI par le navigateur ou par un code, savoir où est rangé le jeton, combien de temps dure la session et comment la révoquer.

### Utilisation

- [Utiliser l’agent](https://realmoon.ai/documentation/moon-cli/utiliser/) : Lancer l’agent dans un projet, accepter ou non la configuration d’un dépôt, choisir un mode de permission et exécuter une tâche sans interface avec moon run.
- [Workspaces, modèles et limite d’utilisation](https://realmoon.ai/documentation/moon-cli/workspaces-modeles/) : 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.
- [Contrôle à distance avec moon rc et /rc](https://realmoon.ai/documentation/moon-cli/controle-a-distance/) : Piloter Moon CLI depuis Code sur chat.realmoon.ai avec moon rc ou /rc : lancer une session, ce que voit la page, gérer les sessions et les codes de refus.
- [Serveurs MCP dans Moon CLI](https://realmoon.ai/documentation/moon-cli/serveurs-mcp/) : Donner de nouveaux outils à l’agent avec des serveurs MCP : catalogue vérifié, serveur personnalisé, connexion même sans navigateur et confirmation des outils.

### Protection

- [Moon Blur dans Moon CLI](https://realmoon.ai/documentation/moon-cli/moon-blur/) : Le masquage réversible de vos secrets, fait sur votre machine avant chaque envoi au modèle : modes, réglage par projet, valeurs autorisées, audit et limites.
- [Moon Guard](https://realmoon.ai/documentation/moon-cli/moon-guard/) : La garde qui bloque les commandes destructrices et la fuite de vos secrets. Désactivée par défaut depuis la version 0.2.2, elle s’active en une commande.

### Référence

- [Référence des commandes](https://realmoon.ai/documentation/moon-cli/commandes/) : Toutes les sous-commandes du binaire moon avec leurs options et un exemple, les commandes de l’interface de l’agent tapées avec / et les raccourcis clavier.
- [Configuration](https://realmoon.ai/documentation/moon-cli/configuration/) : Fichiers de réglages de Moon CLI et de l’agent, leurs emplacements par système, les clés disponibles, les variables d’environnement et leur ordre de priorité.
- [Mises à jour et désinstallation](https://realmoon.ai/documentation/moon-cli/mises-a-jour/) : Mises à jour automatiques et signées de Moon CLI, mise à jour immédiate ou vers une version précise, retour à la version précédente et désinstallation complète.
- [Dépannage](https://realmoon.ai/documentation/moon-cli/depannage/) : Résoudre les problèmes de Moon CLI : commande moon introuvable, installeur bloqué, empreinte refusée, connexion, mises à jour, réinstallation et messages.

- [Notes de version](https://realmoon.ai/documentation/moon-cli/versions/) : Les notes de chaque version de Moon CLI, de la plus récente à la plus ancienne : nouveautés, corrections et changements à connaître avant de mettre à jour.

## Voir aussi

- [Installation](https://realmoon.ai/documentation/moon-cli/installation/)
- [Utiliser l’agent](https://realmoon.ai/documentation/moon-cli/utiliser/)
- [Configuration](https://realmoon.ai/documentation/moon-cli/configuration/)
- [Référence des commandes](https://realmoon.ai/documentation/moon-cli/commandes/)

---

Documentation Moon AI › Moon CLI. Page : https://realmoon.ai/documentation/moon-cli/. 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.
