# Utiliser l’agent > 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. Une fois connecté, Moon CLI s’utilise depuis le dossier de votre projet. Vous décrivez la tâche, l’agent lit le code, propose des modifications et lance des commandes, avec votre accord. ## Lancer l’agent dans un projet ```bash title="Terminal" cd mon-projet moon ``` Vous pouvez aussi désigner un autre dossier : `moon ../autre-projet`. Au lancement, le terminal affiche un résumé : votre workspace et son forfait, le modèle choisi, le mode de Moon Blur et votre utilisation (session de 5 h, semaine, mois). La barre d’utilisation passe à l’ambre à partir de 75 % et au rouge à partir de 90 %. L’interface de l’agent s’ouvre ensuite. L’agent travaille dans ce dossier, à l’intérieur du dépôt Git qui le contient. Il ne charge ni configuration ni instructions situées au-dessus de la racine du dépôt. À la fin de la session, Moon CLI indique combien de valeurs Moon Blur a masquées. ## Dossier personnel et racine d’un disque Lancé dans votre dossier personnel ou à la racine d’un disque, l’agent parcourrait tous les fichiers et le démarrage pourrait prendre plusieurs minutes. Moon CLI le signale et demande « Continuer quand même ? [o/N] ». Placez-vous plutôt dans le dossier d’un projet. Pour ne plus voir cet avertissement (par exemple dans un script), définissez `MOON_ALLOW_BROAD_DIR=1`. ## Configuration d’un dépôt Un dépôt peut contenir une configuration d’agent : elle peut lancer des plugins, ajouter des serveurs MCP ou des skills, ou autoriser des commandes sans confirmation. Un dépôt cloné piégé pourrait ainsi prendre la main. Moon CLI ne la charge qu’avec votre accord. Fichiers concernés, dans chaque dossier entre le dossier ouvert et la racine du dépôt : - `opencode.json`, `opencode.jsonc`, `tui.json`, `tui.jsonc` ; - les dossiers `.opencode/`, `.claude/skills/` et `.agents/skills/`. Si l’un d’eux existe, Moon CLI les liste et demande « Faire confiance à cette configuration ? [o/N] ». | Réponse | Effet | | --- | --- | | `o` (oui) | La configuration est chargée. Votre accord est retenu pour ce dépôt tant que ces fichiers ne changent pas. | | `N` (non, par défaut) | Rien n’est chargé du dépôt pour cette session : ni configuration, ni plugins, ni skills, ni `AGENTS.md` ou `CLAUDE.md`. | - La question revient si le contenu de ces fichiers change. - Au-delà de 5 000 fichiers ou de 200 Mo, la configuration ne peut pas être vérifiée en entier : la question revient à chaque lancement. - Sans terminal interactif, la configuration du dépôt est ignorée, sauf si `MOON_TRUST_PROJECT=1` est défini. - Un dépôt sans aucun de ces fichiers ne pose pas de question : ses fichiers d’instructions sont lus normalement. - Pour oublier tous vos accords, supprimez le fichier `trusted-projects.json` du dossier d’état (voir [Emplacements des fichiers](https://realmoon.ai/documentation/moon-cli/installation/#emplacements)). > [!WARNING] > Accepter la configuration d’un dépôt revient à lui faire confiance comme à un script que vous lancez. Ne l’acceptez que pour un dépôt que vous connaissez. ## Fichiers d’instructions L’agent lit les fichiers `AGENTS.md` de votre projet (à défaut `CLAUDE.md`, puis `CONTEXT.md`) et votre fichier d’instructions personnel (`~/.config/moon/AGENTS.md`, à défaut `~/.claude/CLAUDE.md`). Ils accompagnent chaque appel au modèle et comptent donc dans votre limite d’utilisation. Au-delà de 40 Ko, Moon CLI affiche un avertissement au lancement avec une estimation des jetons envoyés à chaque appel : gardez ces fichiers courts. `/init` crée ou met à jour l’`AGENTS.md` du projet. Ordre de lecture et limites : [Fichiers d’instructions](https://realmoon.ai/documentation/moon-cli/configuration/#instructions). ## L’interface - **En-tête** : votre workspace et la jauge de votre limite d’utilisation. - **Barre d’état** : dossier, branche Git, mode de Moon Blur et remplissage du contexte. - **Panneau de saisie** : votre message et le mode de permission actif. - **Actions** : chaque action de l’agent est résumée sur une ligne. - **Autorisations et questions** : les choix sont numérotés, répondez avec les touches `1`, `2`, `3`. - **Moon**, la mascotte de Moon AI, suit la session : elle réfléchit, agit, attend votre accord, se réjouit à la fin d’un tour ou s’inquiète d’une erreur. `/themes` change les couleurs de toute l’interface. ## Écrire à l’agent | Saisie | Effet | | --- | --- | | Texte puis `Entrée` | Envoie la demande. `Maj` `Entrée` va à la ligne. | | `@` | Cite un fichier du projet, un agent ou une ressource d’un serveur MCP. | | `/` | Ouvre la liste des commandes. Voir [Commandes de l’interface](https://realmoon.ai/documentation/moon-cli/commandes/#interface). | | `!` en début de saisie | Passe en mode shell : la ligne est lancée comme commande dans le projet. | | `Échap` deux fois | Interrompt la réponse en cours. | ## Agents build et plan Deux agents principaux sont disponibles. `Tab` ou `/agents` passe de l’un à l’autre. | Agent | Usage | | --- | --- | | `build` | Agent par défaut, avec tous les outils : il lit, modifie et lance des commandes. | | `plan` | Analyse et propose sans modifier vos fichiers. Utile pour explorer un dépôt avant d’autoriser des modifications. | Pour explorer le code, l’agent peut confier une partie du travail à un sous-agent, qui utilise un modèle économique. ## Modes de permission Par défaut, l’agent demande votre accord avant de modifier un fichier, de lancer une commande, de lire une page web ou de faire une recherche, et avant d’utiliser l’outil d’un serveur MCP. Certaines demandes proposent aussi de toujours autoriser (par exemple pour un site). Trois modes changent ce comportement : | Mode | Modifications de fichiers | Commandes, web et outils MCP | Indicateur | | --- | --- | --- | --- | | Normal | Demandées | Demandées | aucun | | Modifications acceptées | Sans demande | Demandées | « ⏵⏵ modifications acceptées » | | Approbation automatique | Sans demande | Sans demande | « ⏵⏵ approbation automatique » | - `Maj` `Tab` passe de normal à modifications acceptées, puis à l’approbation automatique si vous l’avez déjà acceptée dans cette session, puis revient à normal. - `/modifications` active ou coupe le mode modifications acceptées. - `/auto` active ou coupe l’approbation automatique. La première fois dans une session, Moon CLI demande « Activer l’approbation automatique ? ». - `moon --auto` démarre directement en approbation automatique, sans confirmation. Les demandes déjà affichées au moment du changement de mode attendent toujours votre réponse. > [!WARNING] > **Approbation automatique** > > Dans ce mode, l’agent agit sans vous demander. Moon Guard, qui bloque les commandes destructrices, est désactivé par défaut : activez-le avec `moon guard on` avant de travailler en approbation automatique. Ses avertissements passent alors sans confirmation, mais ses blocages restent. Voir [Moon Guard](https://realmoon.ai/documentation/moon-cli/moon-guard/). Pour autoriser durablement certaines commandes dans un projet, utilisez des règles de permission : voir [Permissions](https://realmoon.ai/documentation/moon-cli/configuration/#permissions). ## Commandes de l’agent Tapez `/` dans l’agent pour afficher les commandes, ou `Ctrl` `P` pour la palette. Les plus utilisées : | Commande | Rôle | | --- | --- | | `/models` | Choisir le modèle, avec son niveau de coût. | | `/workspace` | Changer le workspace de la session. | | `/usage` | Voir votre utilisation : session de 5 h, semaine, mois. | | `/blur` | Changer le mode de Moon Blur pour la session. | | `/mcp` | Ajouter et connecter des serveurs MCP. | | `/compact` | Résumer la conversation pour libérer du contexte. | | `/undo` | Annuler le dernier message et ses modifications de fichiers. | | `/new` | Démarrer une nouvelle session. | Liste complète avec les alias : [Commandes de l’interface](https://realmoon.ai/documentation/moon-cli/commandes/#interface). ## Tâche sans interface (`moon run`) Pour une tâche ponctuelle, sans ouvrir l’interface : ```bash title="Terminal" moon run "explique le rôle du dossier src/api" moon run --auto "ajoute un test pour la fonction parse_date" ``` `moon "…"` fait la même chose : un premier argument qui n’est ni une option, ni une commande, ni un dossier existant est traité comme une tâche. Moon CLI affiche la réponse puis se termine. Personne n’est là pour répondre aux demandes d’autorisation : sans `--auto`, toute modification de fichier, commande ou accès au web est refusé, et le terminal affiche « permission demandée : … ; refus automatique ». La lecture et la recherche dans le code restent possibles. Avec `--auto`, chaque demande est acceptée. | Option | Rôle | | --- | --- | | `--auto` | Accepter les demandes d’autorisation. | | `--dir ` | Travailler dans un autre dossier. La question de confiance et le mode de Moon Blur portent sur ce dossier. | | `-m`, `--model moonai/` | Choisir le modèle, par exemple `moonai/auto`. | | `-c`, `--continue` | Continuer la dernière session. | Ce que vous envoyez sur l’entrée standard est ajouté à la demande : `git diff | moon run "résume ces modifications"`. Toutes les options : [moon run](https://realmoon.ai/documentation/moon-cli/commandes/#run). ### En intégration continue Sans terminal interactif, Moon CLI ne lance pas de connexion par le navigateur. Utilisez une clé d’API de workspace (`moai_org_…`) dans la variable `MOON_API_KEY` : rien n’est écrit sur le disque, et le workspace et le forfait sont ceux de la clé. ```bash title="Intégration continue" export MOON_API_KEY="moai_org_..." export MOON_TRUST_PROJECT=1 # seulement si la configuration du dépôt est sûre export MOON_GUARD=on # bloque les commandes destructrices moon run --auto "lance les tests et résume les échecs" ``` - `--auto` permet à l’agent de lancer des commandes : réservez-le à un environnement jetable. - La clé est retirée de l’environnement de l’agent et des commandes qu’il lance. - Les mises à jour automatiques ne tournent pas en intégration continue. - Créer une clé de workspace : voir [Clés de workspace](https://realmoon.ai/documentation/api-organisations/cles-workspace/). ## Voir aussi - [Référence des commandes](https://realmoon.ai/documentation/moon-cli/commandes/) - [Configuration](https://realmoon.ai/documentation/moon-cli/configuration/) - [Workspaces, modèles et limite d’utilisation](https://realmoon.ai/documentation/moon-cli/workspaces-modeles/) --- Documentation Moon AI › Moon CLI › Utiliser l’agent. Page : https://realmoon.ai/documentation/moon-cli/utiliser/. 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.