# Code dans Moon Desktop

> Faire travailler Moon CLI sur un dossier de votre ordinateur depuis Moon Desktop : prérequis, dossier, autorisations, et que faire si Code ne démarre pas.

Dans Moon Desktop, Code fait travailler Moon CLI directement sur un dossier de votre ordinateur : l’agent lit et modifie le code, lance les commandes et utilise vos connecteurs, et vous suivez tout dans l’interface de Moon AI. Vous passez du Chat à Code par l’interrupteur en haut de la barre latérale.

## Ce qu’il faut

- **Moon CLI 0.3.0 ou plus récent**, installé sur l’ordinateur. Moon Desktop fournit Moon CLI 0.4.0 sous Windows et Linux : l’installeur de Windows le propose (option « Installer Moon CLI »), et l’assistant du premier lancement aussi. Une version plus récente déjà installée est gardée. Sinon, voir [Installer Moon CLI](https://realmoon.ai/documentation/moon-cli/installation/).
- **Un forfait qui inclut Moon CLI** sur votre workspace : voir les [tarifs](https://realmoon.ai/tarifs/).
- **Moon CLI connecté au même compte** que Moon Desktop. Au premier usage, « Relier Moon CLI » ouvre la page d’autorisation dans une fenêtre de l’appli : un clic sur « Autoriser » suffit. Moon Desktop ne voit jamais le jeton de Moon CLI.

## Ouvrir un dossier

1. Dans Code, cliquez sur « Ouvrir un dossier », ou choisissez-en un dans « Dossiers récents ».
2. Choisissez le dossier de votre projet dans la fenêtre du système. La racine d’un disque est refusée : l’agent y verrait tout le disque.
3. Écrivez ce que Moon doit faire.

Moon AI ne reçoit que le nom du dossier, jamais son chemin complet. Depuis la barre d’état, « Ouvrir le dossier » l’affiche dans l’explorateur, et « Ouvrir dans l’éditeur » l’ouvre dans VS Code ou Cursor s’ils sont installés.

## Les sessions

Dans la barre latérale de Code, chaque session du dossier a un menu « … » : « Renommer », « Archiver » (ou « Désarchiver »), « Sélectionner plusieurs » et « Supprimer », comme sur le web. Ces actions demandent Moon CLI 0.4.0 ou plus récent, fourni avec Moon Desktop 1.0.1. Avec une version plus ancienne, elles sont grisées avec « Mettez Moon CLI à jour (0.4.0) » : lancez `moon update` dans un terminal.

Supprimer demande toujours une confirmation, dans une fenêtre de Moon Desktop elle-même : « Supprimer cette session ? » (ou « Supprimer ces 3 sessions ? »), avec le titre de chaque session, « Annuler » proposé par défaut. La conversation et son historique sont supprimés de l’ordinateur, et les fichiers modifiés par Moon restent tels quels. Une session où Moon travaille ne peut pas être supprimée : arrêtez d’abord le tour. Détail : [Gérer les sessions](https://realmoon.ai/documentation/moon-cli/controle-a-distance/#sessions).

## Ce qui reste sur votre ordinateur

- L’agent tourne sur votre ordinateur, dans le dossier choisi : vos fichiers ne sont pas copiés sur les serveurs de Moon AI.
- Ce que l’agent envoie au modèle passe par Moon AI comme dans Moon CLI, avec Moon Blur selon votre réglage ou la règle de votre workspace : voir [Moon Blur dans Moon CLI](https://realmoon.ai/documentation/moon-cli/moon-blur/).
- Les autorisations restent celles de Moon CLI : l’agent demande avant une commande ou une modification, et vous répondez dans la page. Moon Desktop ne répond jamais à votre place.

## Si Code ne démarre pas

| Message | Que faire |
| --- | --- |
| « Moon CLI n’est pas installé sur cet ordinateur. » | Cliquez sur « Installer Moon CLI » et suivez [Installer Moon CLI](https://realmoon.ai/documentation/moon-cli/installation/), puis revenez dans Code. |
| « Code demande Moon CLI 0.3.0 ou plus récent : mettez-le à jour. » | Lancez `moon update` dans un terminal (voir [Mises à jour](https://realmoon.ai/documentation/moon-cli/mises-a-jour/)), puis revenez dans Code. |
| « Moon CLI est connecté avec un autre compte (…). » | Déliez puis reliez Moon CLI depuis Code avec le compte de l’appli. Dans un terminal, `moon logout` puis `moon login` font de même. |
| « Moon CLI n’a pas pu être relié à votre compte. » | Fermez la fenêtre d’autorisation et réessayez. Si cela continue, lancez `moon doctor` dans un terminal : voir [Dépannage de Moon CLI](https://realmoon.ai/documentation/moon-cli/depannage/). |
| « Moon CLI n’est pas inclus dans votre forfait » | Choisissez un workspace qui l’inclut, ou changez de forfait : voir [Forfait](https://realmoon.ai/documentation/moon-cli/depannage/#forfait). |
| « Choisissez un dossier de projet, pas la racine d’un disque. » | Choisissez le dossier du projet lui-même. |
| « Moon CLI n’a pas répondu sur cette machine. » | Cliquez sur « Relancer Moon CLI ». Si cela continue, lancez `moon doctor` dans un terminal. |

Les autres problèmes de Moon CLI (`PATH`, proxy, connexion) se règlent comme dans le terminal : voir [Dépannage de Moon CLI](https://realmoon.ai/documentation/moon-cli/depannage/).

## Voir aussi

- [Moon Desktop](https://realmoon.ai/documentation/moon-desktop/)
- [Utiliser Moon CLI](https://realmoon.ai/documentation/moon-cli/utiliser/)
- [Dépannage de Moon Desktop](https://realmoon.ai/documentation/moon-desktop/depannage/)

---

Documentation Moon AI › Moon Desktop › Code. Page : https://realmoon.ai/documentation/moon-desktop/code/. Modifiée le 8 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.