# Dépannage

> Résoudre les problèmes de Moon CLI : commande moon introuvable, installeur bloqué, empreinte refusée, connexion, mises à jour, réinstallation et messages.

Si `moon` démarre, commencez par `moon doctor` : il vérifie l’installation, le réseau et votre compte, et dit quoi corriger. Sinon, cherchez votre cas ci-dessous : chaque cas donne le message affiché, sa cause et les commandes à copier, pour Windows (PowerShell et invite de commandes), macOS et Linux.

- [« moon » n’est pas reconnu après l’installation](https://realmoon.ai/documentation/moon-cli/depannage/#commande-introuvable)
- [L’installeur ne s’exécute pas](https://realmoon.ai/documentation/moon-cli/depannage/#installeur-bloque) : politique d’exécution, antivirus, `curl` ou `irm` absent, proxy
- [L’empreinte ou la signature ne correspond pas](https://realmoon.ai/documentation/moon-cli/depannage/#empreinte)
- [La connexion ne marche pas](https://realmoon.ai/documentation/moon-cli/depannage/#connexion)
- [Mises à jour et version](https://realmoon.ai/documentation/moon-cli/depannage/#mises-a-jour)
- [Désinstaller ou réinstaller proprement](https://realmoon.ai/documentation/moon-cli/depannage/#reinstaller)
- [WSL, macOS et Linux](https://realmoon.ai/documentation/moon-cli/depannage/#plateformes)
- [Messages au lancement et pendant une session](https://realmoon.ai/documentation/moon-cli/depannage/#lancement)
- [Contrôle à distance (moon rc)](https://realmoon.ai/documentation/moon-cli/depannage/#rc)

## Lancer un diagnostic

```bash title="Terminal"
moon doctor
```

Chaque ligne est marquée ✓ (en ordre), ! (à vérifier), ✗ (à corriger) ou · (information), avec un conseil après « → » quand il faut agir. La dernière ligne résume : « ✓ Tout est en ordre », « ! N points à vérifier » ou « ✗ N problèmes à corriger ». Le code de sortie vaut 1 s’il reste un problème à corriger.

| Ligne | Ce qu’elle veut dire | Si elle est en ! ou en ✗ |
| --- | --- | --- |
| « Moon CLI 0.4.0 » | La version qui tourne et le chemin du binaire. | Information seulement. |
| « Agent … » | L’agent de code intégré est présent. | « Agent Moon introuvable » : [réinstallez](https://realmoon.ai/documentation/moon-cli/depannage/#reinstaller). |
| « MOON_OPENCODE_DIR est défini mais ignoré (dépendances non installées) » | Une variable de développement pointe vers un dossier d’agent incomplet. | Retirez `MOON_OPENCODE_DIR` de votre profil. |
| « … est défini » | Une variable d’environnement (`MOON_BASE_URL`, `MOON_BLUR_MODE`…) remplace le réglage normal. | Retirez-la de votre profil si vous ne l’avez pas voulue. |
| « Dossiers » | Où sont l’état et les réglages de Moon CLI. | Information seulement. |
| « chat.realmoon.ai résolu » | Le nom de Moon AI est trouvé par le DNS. | « introuvable (DNS) » : vérifiez votre connexion ou votre DNS. |
| « Moon AI joignable (HTTP 200) » | Moon AI répond en HTTPS. | « Certificat refusé (proxy d’entreprise ?) », « Moon AI injoignable », « Moon AI répond HTTP N », « Bloqué par le pare-feu de Moon AI » : voir [Réseau et proxy](https://realmoon.ai/documentation/moon-cli/depannage/#proxy). |
| « Horloge décalée de N s » | L’heure de l’ordinateur diffère de plus de 5 minutes de celle de Moon AI. | Synchronisez l’heure du système : une horloge décalée peut faire refuser la session. |
| « Proxy réseau défini » | Une variable `HTTPS_PROXY`, `HTTP_PROXY` ou `ALL_PROXY` est posée, avec la valeur de `NO_PROXY`. | Information seulement. |
| « Connexion locale 127.0.0.1 » | Moon CLI peut joindre son propre composant sur cet ordinateur. | « 127.0.0.1 ne répond pas » : ajoutez `127.0.0.1,localhost` à `NO_PROXY` (voir [Réseau et proxy](https://realmoon.ai/documentation/moon-cli/depannage/#proxy)). |
| « Connecté, session valable encore N jours » | Votre session et l’endroit où le jeton est rangé (trousseau du système ou `auth.json`). | « Non connecté » ou « Session expirée » : `moon login`. « Compte non vérifié (Moon AI injoignable) » : la session est là, mais Moon AI n’a pas répondu ; voir [Réseau et proxy](https://realmoon.ai/documentation/moon-cli/depannage/#proxy). |
| « Workspace … » | Le workspace de la session, son forfait (le nom du forfait n’est pas affiché pour certaines organisations) et l’accès à Moon CLI (« accès Moon CLI actif »). | « forfait Étoile ou supérieur requis », « paiement de l’abonnement en échec », « abonnement terminé », « aucun workspace » : voir [Forfait](https://realmoon.ai/documentation/moon-cli/depannage/#forfait). |
| « Moon Blur imposé par votre workspace » | Votre organisation impose Moon Blur. | Information seulement. |
| « Moon Blur : … » et « Moon Guard : … » | Vos réglages de protection. | « Moon Blur : off » est en ! : voir [Moon Blur](https://realmoon.ai/documentation/moon-cli/moon-blur/). |
| « Configuration d’agent du dépôt … » | Le dossier courant contient une configuration d’agent, approuvée ou non. | Voir [Configuration d’un dépôt](https://realmoon.ai/documentation/moon-cli/utiliser/#confiance). |
| « … Ko envoyés à chaque appel » | Un fichier d’instructions dépasse 40 Ko. | Raccourcissez-le : voir [Démarrage lent](https://realmoon.ai/documentation/moon-cli/depannage/#lent). |
| « Moon CLI est à jour » | Aucune version plus récente sur le canal suivi. | « Version … disponible » : `moon update`. « Version de développement (canal … : …) » : votre version est plus récente que celle du canal, rien à faire. « Mise à jour : canal illisible pour l’instant » : Moon AI n’a pas répondu, réessayez plus tard. Avant la 0.3.1, le diagnostic affichait « Version en avance sur la publication (0.2.0) » même quand une mise à jour existait : lancez `moon update`. |
| « Copie hors de l’installation de Moon CLI » | Le `moon` lancé n’est pas celui de l’installation (une copie posée ailleurs). | `moon update` ne la met pas à jour. Lancez le `moon` installé, ou définissez `MOON_INSTALL_DIR` avec le dossier de la copie pour la gérer. |
| « Réglages par défaut » | Vous n’avez jamais changé un réglage de Moon CLI : le fichier de réglages n’existe pas encore. | Information seulement. |

Pour une demande d’aide, joignez la version JSON. Elle ne contient pas votre jeton :

```bash title="Terminal"
moon doctor --json > diagnostic.json
```

## « moon » n’est pas reconnu après l’installation

L’installation s’est terminée par « Moon CLI … est installe. », mais le terminal répond :

```text title="Messages possibles"
PowerShell : moon : Le terme «moon» n'est pas reconnu comme nom d'applet de commande, fonction, fichier de script ou programme exécutable.
cmd :        'moon' n'est pas reconnu en tant que commande interne ou externe, un programme exécutable ou un fichier de commandes.
bash :       bash: moon: command not found
zsh :        zsh: command not found: moon
```

La cause est presque toujours la même : le binaire est bien installé, mais le dossier qui le contient n’est pas dans le `PATH` du terminal que vous utilisez. Le terminal a été ouvert avant l’installation, Windows n’a pas encore relu le `PATH`, l’installeur a configuré un autre shell que le vôtre, ou l’ajout au `PATH` a été désactivé (`MOON_NO_MODIFY_PATH=1`, `--no-modify-path`).

### Sous Windows

1. Fermez toutes les fenêtres de terminal, y compris toutes les fenêtres de Windows Terminal et le terminal intégré de votre éditeur, puis ouvrez-en une nouvelle. L’installeur l’annonce : « Ouvrez un NOUVEAU terminal ».
2. Vérifiez que le binaire est bien là, dans `%LOCALAPPDATA%\Moon` (le dossier `AppData\Local\Moon` de votre profil) :

```powershell title="PowerShell"
Test-Path "$env:LOCALAPPDATA\Moon\moon.exe"
& "$env:LOCALAPPDATA\Moon\moon.exe" --version
```

```bat title="cmd"
dir "%LOCALAPPDATA%\Moon\moon.exe"
"%LOCALAPPDATA%\Moon\moon.exe" --version
```

Si le fichier est absent (`False`, « Fichier introuvable »), l’installation n’est pas allée au bout : relancez-la (voir [Réinstaller](https://realmoon.ai/documentation/moon-cli/depannage/#reinstaller)). S’il répond « Moon CLI … », seul le `PATH` est en cause.

3. Regardez si le dossier est dans le `PATH` de votre compte :

```powershell title="PowerShell"
[Environment]::GetEnvironmentVariable('Path', 'User') -split ';'
```

```bat title="cmd"
reg query HKCU\Environment /v Path
```

4. S’il manque, ajoutez-le par les Paramètres, c’est le plus sûr : touche Windows, tapez « variables d’environnement » et ouvrez « Modifier les variables d’environnement pour votre compte » ; dans « Variables utilisateur », sélectionnez `Path`, puis « Modifier… » ; cliquez sur « Nouveau », collez `%LOCALAPPDATA%\Moon`, puis « OK » dans les deux fenêtres. Ce « OK » prévient Windows : les terminaux ouverts ensuite voient le nouveau `PATH`.

Ou dans PowerShell, sans toucher aux autres entrées (l’installeur fait de même) :

```powershell title="PowerShell"
$dir = "$env:LOCALAPPDATA\Moon"
$key = [Microsoft.Win32.Registry]::CurrentUser.OpenSubKey('Environment', $true)
$path = [string]$key.GetValue('Path', '', 'DoNotExpandEnvironmentNames')
if (($path -split ';') -notcontains $dir) { $key.SetValue('Path', "$(if ($path) { $path.TrimEnd(';') + ';' })$dir", 'ExpandString') }
$key.Close()
```

Cette écriture directe dans le registre ne prévient pas Windows : ensuite, fermez votre session Windows et rouvrez-la, ou ouvrez la fenêtre des variables d’environnement et cliquez sur « OK ».

> [!WARNING]
> **[Environment]::SetEnvironmentVariable**
>
> `[Environment]::SetEnvironmentVariable('Path', $p + ";$env:LOCALAPPDATA\Moon", 'User')` ajoute aussi le dossier et prévient Windows, mais réécrit tout votre `PATH` en remplaçant les variables par leur valeur (`%USERPROFILE%` devient le chemin complet de votre profil). Ne l’utilisez que si votre `PATH` utilisateur ne contient aucun `%…%`.

5. En attendant, pour la fenêtre déjà ouverte seulement :

```powershell title="PowerShell"
$env:Path += ";$env:LOCALAPPDATA\Moon"
moon --version
```

```bat title="cmd"
set "PATH=%PATH%;%LOCALAPPDATA%\Moon"
moon --version
```

À savoir :

- Si vous avez installé avec `MOON_INSTALL_DIR`, remplacez `%LOCALAPPDATA%\Moon` par ce dossier.
- Installez avec votre compte habituel, sans « Exécuter en tant qu’administrateur » : Moon CLI n’a pas besoin de droits d’administrateur, et une console ouverte avec un autre compte l’installerait dans le profil de ce compte.

### Sous macOS et Linux

La commande est le lien `~/.local/bin/moon` (ou le dossier `MOON_INSTALL_DIR` choisi), qui pointe vers `~/.local/share/moon/versions/<version>/moon`.

1. Vérifiez le lien et lancez-le par son chemin :

```bash title="Terminal"
ls -l ~/.local/bin/moon
~/.local/bin/moon --version
```

Si le lien est absent, [réinstallez](https://realmoon.ai/documentation/moon-cli/depannage/#reinstaller). S’il répond « Moon CLI … », seul le `PATH` est en cause.

2. Regardez si le dossier est dans le `PATH` :

```bash title="Terminal"
echo "$PATH" | tr ':' '\n' | grep -x "$HOME/.local/bin"
```

Rien ne s’affiche : il manque. L’installeur l’ajoute dans le fichier de démarrage du shell indiqué par `$SHELL` (`echo $SHELL`), entre `# >>> moon cli >>>` et `# <<< moon cli <<<` : `~/.zshrc` pour zsh (le shell par défaut de macOS), `~/.bashrc` pour bash sous Linux, `~/.bash_profile` pour bash sous macOS, `~/.profile` pour les autres, `~/.config/fish/conf.d/moon.fish` pour fish. Si votre terminal lance un autre shell que `$SHELL`, le bloc est dans le mauvais fichier.

3. Ajoutez le dossier dans le fichier de votre shell, puis relisez-le :

```bash title="zsh"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```

```bash title="bash (Linux)"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
```

```bash title="bash (macOS)"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile
```

```fish title="fish"
fish_add_path ~/.local/bin
```

4. Si `moon` lance une ancienne version ou un autre programme, listez tout ce qui s’appelle `moon` dans le `PATH` :

```bash title="Terminal"
which -a moon
hash -r
```

`moon --version` doit afficher « Moon CLI … ». Un autre outil peut aussi s’appeler `moon` : placez `~/.local/bin` en tête du `PATH`, ou retirez l’autre programme.

## L’installeur ne s’exécute pas

L’installeur affiche ses erreurs en rouge, sans accents, après « ERREUR : ». Rien n’est remplacé tant qu’il n’est pas allé au bout : une version déjà installée reste en place.

### Politique d’exécution de PowerShell

```text title="Message"
Impossible de charger le fichier C:\...\install.ps1, car l'exécution de scripts est désactivée sur ce système.
```

Ce message vient d’un fichier `install.ps1` téléchargé puis lancé par `.\install.ps1`. La commande d’installation habituelle ne crée pas de fichier et n’est pas concernée :

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

Pour lancer le fichier quand même, levez la restriction pour cette seule commande, ou pour la seule fenêtre ouverte :

```powershell title="Cette commande"
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1
```

```powershell title="Cette fenêtre"
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\install.ps1
```

Ne changez pas la politique de tout l’ordinateur (`Set-ExecutionPolicy Unrestricted` ou `-Scope LocalMachine`) : ce n’est pas nécessaire. L’installeur de l’invite de commandes (`install.cmd`) fait déjà l’équivalent de la première ligne. Sur un ordinateur géré par votre entreprise, si PowerShell reste bloqué, demandez à votre service informatique d’autoriser l’installation.

### Antivirus, SmartScreen et Smart App Control

Le binaire de Moon CLI pour Windows n’a pas encore de signature Authenticode. L’installeur le télécharge et le lance depuis PowerShell, sans passer par le navigateur : la fenêtre SmartScreen « Windows a protégé votre ordinateur » ne s’affiche normalement pas. En revanche :

```text title="Message"
ERREUR : Le binaire ne demarre pas sur cette machine.
```

- **Smart App Control** (Windows 11) peut refuser un exécutable non signé. L’installeur s’arrête alors à son test de démarrage, sans rien remplacer. Smart App Control ne permet pas d’autoriser un seul programme : ne le désactivez pas pour Moon CLI. Utilisez Moon CLI dans [WSL](https://realmoon.ai/documentation/moon-cli/depannage/#wsl), ou écrivez au support.
- **Un antivirus** peut mettre `moon.exe` en quarantaine. Dans « Sécurité Windows » › « Protection contre les virus et menaces » › « Historique de protection », vérifiez l’alerte. Avant d’autoriser le fichier, comparez son empreinte avec la liste publiée : voir [Vérifier les empreintes](https://realmoon.ai/documentation/moon-cli/installation/#signatures). En cas de doute, n’autorisez rien et écrivez au support.
- **Un binaire téléchargé à la main** depuis le navigateur peut déclencher SmartScreen. N’installez pas Moon CLI à la main : la commande d’installation vérifie les empreintes et teste le binaire.

### curl ou irm introuvable

- **`irm` dans l’invite de commandes** : « ’irm’ n’est pas reconnu… ». `irm` est une commande de PowerShell. Ouvrez PowerShell, ou utilisez la commande de l’invite de commandes :

```bat title="Invite de commandes (cmd)"
curl -fsSL https://realmoon.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```

- **`curl -fsSL` dans Windows PowerShell 5.1** : `curl` y est un autre nom d’`Invoke-WebRequest`, qui refuse les options `-fsSL`. Dans PowerShell, utilisez `irm https://realmoon.ai/install.ps1 | iex`.
- **Windows sans `curl.exe`** (versions de Windows 10 antérieures à 1803) : utilisez la commande PowerShell.
- **macOS et Linux** : « curl: command not found » ou « ERREUR : curl est requis. ». Installez curl, puis relancez l’installation :

```bash title="Debian, Ubuntu"
sudo apt install curl
```

```bash title="Fedora"
sudo dnf install curl
```

```bash title="Alpine"
apk add curl
```

```bash title="Arch"
sudo pacman -S curl
```

L’installeur demande aussi `gzip` (« ERREUR : gzip est requis. ») et `sha256sum` ou `shasum` (« ERREUR : sha256sum ou shasum introuvable. ») : installez le paquet `gzip`, ou `coreutils` pour `sha256sum`.

### Réseau d’entreprise et proxy

```text title="Messages de l'installeur"
ERREUR : Moon AI injoignable (https://realmoon.ai/dl). Verifiez votre connexion.
ERREUR : Telechargement impossible. Reessayez dans quelques minutes.
```

Sous macOS et Linux, le premier message s’arrête à « Moon AI injoignable (https://realmoon.ai/dl). » ; « Verifiez votre connexion. » n’est écrit que par l’installeur de Windows.

**Pendant l’installation**

- **macOS, Linux, WSL** : curl lit la variable `HTTPS_PROXY`. Indiquez votre proxy, puis relancez l’installation dans le même terminal :

```bash title="Terminal"
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://realmoon.ai/install.sh | sh
```

- **Windows PowerShell (5.1)** utilise le proxy du système (« Paramètres » › « Réseau et Internet » › « Proxy »). Si le proxy demande votre identifiant Windows, transmettez-le avant l’installation, dans la même fenêtre :

```powershell title="PowerShell"
[System.Net.WebRequest]::DefaultWebProxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials
irm https://realmoon.ai/install.ps1 | iex
```

- Si votre réseau filtre les sites, demandez l’accès en HTTPS à `realmoon.ai` (téléchargements) et à `chat.realmoon.ai` (le service).

**Ensuite, pour Moon CLI**

Moon CLI lit `HTTPS_PROXY` et `NO_PROXY`. Gardez les adresses locales hors du proxy : Moon CLI passe par un composant qui tourne sur votre ordinateur.

```bash title="macOS, Linux, WSL"
echo 'export HTTPS_PROXY=http://proxy.example.com:8080' >> ~/.zshrc
echo 'export NO_PROXY=127.0.0.1,localhost' >> ~/.zshrc
```

```powershell title="Windows"
[Environment]::SetEnvironmentVariable('HTTPS_PROXY', 'http://proxy.example.com:8080', 'User')
[Environment]::SetEnvironmentVariable('NO_PROXY', '127.0.0.1,localhost', 'User')
```

Ouvrez ensuite un nouveau terminal (avec bash, écrivez dans `~/.bashrc` au lieu de `~/.zshrc`).

| Diagnostic de `moon doctor` | Que faire |
| --- | --- |
| « Certificat refusé (proxy d’entreprise ?) » | Votre réseau intercepte le HTTPS : indiquez le certificat de votre entreprise avec `NODE_EXTRA_CA_CERTS=/chemin/ca.pem`. Pour l’installeur, le certificat doit être installé dans le système : demandez-le à votre service informatique. |
| « Moon AI injoignable » derrière un proxy | Définissez `HTTPS_PROXY` comme ci-dessus. |
| « 127.0.0.1 ne répond pas » | Un proxy ou un antivirus intercepte les connexions locales : ajoutez `127.0.0.1,localhost` à `NO_PROXY`. |
| « Bloqué par le pare-feu de Moon AI » | Écrivez au support avec la sortie de `moon doctor --json`. |

## L’empreinte ou la signature ne correspond pas

```text title="Messages possibles"
  ! empreinte inattendue, nouvelle tentative
ERREUR : Empreinte du binaire invalide.
Mise à jour impossible : empreinte du téléchargement invalide.
Mise à jour impossible : empreinte du binaire invalide.
Mise à jour impossible : signature du manifeste invalide : mise à jour refusée.
Mise à jour impossible : le canal de mise à jour sert un manifeste plus ancien que le dernier vu : mise à jour refusée.
Mise à jour impossible : le canal de mise à jour « … » sert le manifeste du canal « … » : mise à jour refusée.
```

**Ce que cela veut dire** : le fichier reçu n’est pas celui que Stellarr Studio a publié. L’installeur vérifie l’empreinte SHA-256 du téléchargement puis du binaire ; les mises à jour vérifient en plus un manifeste signé avec une clé intégrée à Moon CLI. Au moindre écart, rien n’est installé et votre version actuelle reste en place. Le plus souvent, le téléchargement a été coupé, ou un proxy ou un antivirus a modifié le fichier en route ; plus rarement, quelqu’un a tenté de vous servir un autre binaire.

**Ne forcez jamais** : ne téléchargez pas le binaire à la main depuis une autre adresse, ne modifiez aucun fichier de Moon CLI, ne coupez pas les vérifications ni votre antivirus pour faire passer l’installation.

1. Réessayez quelques minutes plus tard : l’installeur fait déjà trois essais.
2. Essayez depuis un autre réseau, sans proxy (partage de connexion du téléphone, par exemple).
3. Si votre entreprise inspecte le HTTPS, voyez avec son service informatique.
4. Si le message revient, écrivez au support avec le message exact et `moon doctor --json` (voir [Contacter le support](https://realmoon.ai/documentation/moon-cli/depannage/#support)).

Une installation antérieure à la 0.2.1 peut refuser une version signée par une nouvelle clé de publication (« signature du manifeste invalide »). Passez d’abord par la 0.2.1, qui contient les nouvelles clés, ou relancez l’installeur :

```bash title="Terminal"
moon update --to 0.2.1
moon update
```

## La connexion ne marche pas

### Le navigateur ne s’ouvre pas

`moon login` écrit « Ouverture du navigateur pour vous connecter à Moon AI… », puis « Si rien ne s’ouvre, ouvrez ce lien : » suivi d’une adresse. Ouvrez cette adresse dans un navigateur **du même ordinateur** : la page renvoie la connexion à Moon CLI par `127.0.0.1`, l’ordinateur lui-même. Depuis un autre appareil, utilisez la connexion par code.

### En SSH, sur un serveur ou dans un conteneur

Dans une session SSH, ou sous Linux sans affichage graphique, Moon CLI passe de lui-même à la connexion par code. Pour la forcer :

```bash title="Terminal"
moon login --device
```

Le terminal affiche « Sur un appareil avec navigateur, ouvrez : », une adresse, puis « Et entrez le code : ». Ouvrez l’adresse sur votre téléphone ou un autre ordinateur, saisissez le code et autorisez l’appareil. Le code reste valable 10 minutes : après « Échec de la connexion par code (expired) », relancez `moon login --device`. Détails : [Se connecter sans navigateur](https://realmoon.ai/documentation/moon-cli/connexion/#code).

### Dans WSL

Moon CLI lance `xdg-open` : selon la distribution, le navigateur de Windows s’ouvre, ou rien ne se passe. Si rien ne s’ouvre, copiez le lien affiché dans votre navigateur Windows : WSL 2 relaie en général `127.0.0.1` entre Windows et Linux. Si la page reste en attente ou échoue, utilisez `moon login --device`.

### Délai dépassé

« Échec de la connexion navigateur (timeout). » : Moon CLI attend 5 minutes au plus. La page du navigateur affiche alors « Moon CLI ne répond plus ». Relancez `moon login`. Avec Safari, si le terminal ne réagit pas, utilisez le lien « Mon terminal est ouvert mais rien ne se passe (Safari). Transmettre le code manuellement ».

### Forfait

```text title="Messages possibles"
! Moon CLI requiert un abonnement Étoile ou supérieur.
! Le workspace « … » (…) n’a pas le forfait Étoile requis pour Moon CLI.
```

Moon CLI est inclus à partir du forfait Étoile, sur le workspace de la session. Si un autre de vos workspaces l’inclut, choisissez-le ; sinon, changez de forfait sur [chat.realmoon.ai/billing](https://chat.realmoon.ai/billing) (voir les [tarifs](https://realmoon.ai/tarifs/)).

```bash title="Terminal"
moon workspace
moon workspace use <nom ou numéro>
```

Autres refus au lancement : le paiement de l’abonnement du workspace a échoué, l’abonnement est terminé, ou aucun workspace n’est associé à la session. Voir [Messages au lancement](https://realmoon.ai/documentation/moon-cli/depannage/#lancement).

### Jeton expiré ou révoqué

- `moon doctor` affiche « Session expirée » ou « Session refusée par Moon AI (expirée ou révoquée) » : lancez `moon login`.
- Au lancement de `moon`, une session refusée déclenche une nouvelle connexion d’elle-même.
- Une session se renouvelle seule, mais demande une nouvelle connexion par le navigateur 90 jours après la connexion : « Votre connexion à Moon CLI date de plus de 90 jours. ». Voir [Durée de la session](https://realmoon.ai/documentation/moon-cli/connexion/#duree).
- Une session révoquée depuis l’application (« Réglages » › « Sécurité ») ou par « déconnecter partout » demande aussi `moon login`.

### Le mauvais compte

`moon whoami` montre le compte et le workspace de la session. La page d’autorisation utilise le compte connecté dans votre navigateur : pour changer, connectez-vous d’abord à [chat.realmoon.ai](https://chat.realmoon.ai/) avec le bon compte, puis :

```bash title="Terminal"
moon logout
moon login
```

## Mises à jour et version

```bash title="Terminal"
moon --version
moon update
moon rollback
```

- `moon --version` affiche « Moon CLI … » en première ligne.
- Moon CLI se met à jour seul, au plus une fois par jour, pendant une session ; la nouvelle version sert au lancement suivant de `moon`. Voir [Mises à jour automatiques](https://realmoon.ai/documentation/moon-cli/mises-a-jour/#automatiques).

| Message de `moon update` | Que faire |
| --- | --- |
| « Moon CLI … est à jour. » | Rien. |
| « Moon CLI … est installé. Il sera utilisé au prochain lancement de « moon ». » | Quittez vos sessions `moon` ouvertes et relancez `moon`. |
| « Une mise à jour est déjà en cours dans une autre session. » | Attendez la fin de l’autre session, puis relancez `moon update`. |
| « La version … n’est pas encore publiée pour votre plateforme (…). » | Votre version reste en place ; réessayez plus tard. |
| « Mise à jour impossible : la nouvelle version ne démarre pas sur cette machine : installation annulée. » | Votre version reste en place. Écrivez au support avec `moon doctor --json`. |
| « Mise à jour impossible : » suivi d’une empreinte ou d’une signature | Voir [L’empreinte ou la signature ne correspond pas](https://realmoon.ai/documentation/moon-cli/depannage/#empreinte). |
| « Ce moon (…) n’est pas celui de l’installation de Moon CLI (…) : rien n’a été mis à jour. » | Depuis la 0.3.1, `moon update`, `moon rollback` et `moon uninstall` lancés depuis une copie ne touchent pas à l’installation. Lancez la commande avec le `moon` installé, ou définissez `MOON_INSTALL_DIR` avec le dossier de la copie. |

Si une nouvelle version vous gêne, revenez à la précédente : `moon rollback` demande « Revenir à la version précédente de Moon CLI ? [o/N] », puis affiche « Moon CLI … est de nouveau la version active (au prochain lancement). ». Une autre réponse que « o » affiche « Retour arrière annulé. ». Sans terminal interactif (script, intégration continue), ajoutez `--yes` : `moon rollback --yes`. Sans version précédente sur la machine : « Retour arrière impossible : aucune version précédente sur cette machine. », utilisez alors `moon update --to <version>`.

## Désinstaller ou réinstaller proprement

**Réinstaller** : relancez la commande d’installation. Elle remplace le binaire et garde vos réglages, votre connexion et l’historique des sessions.

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

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

**Repartir de zéro** : désinstallez en effaçant tout, puis réinstallez.

```bash title="Terminal"
moon uninstall --purge --yes
```

`moon uninstall` révoque d’abord votre session auprès de Moon AI, puis retire le binaire, les versions installées et l’ajout au `PATH`. Sans `--purge`, vos réglages et l’historique des sessions sont gardés. Sous Windows, ouvrez ensuite un nouveau terminal.

**Si `moon` ne démarre plus du tout** : révoquez la session dans « Réglages » › « Sécurité » de l’application, puis supprimez les dossiers à la main : voir [Désinstaller à la main](https://realmoon.ai/documentation/moon-cli/mises-a-jour/#manuel). Où sont les fichiers : voir [Emplacements des fichiers](https://realmoon.ai/documentation/moon-cli/installation/#emplacements).

## WSL, macOS et Linux

Dix plateformes sont publiées : Windows x64 (et sa variante sans AVX2) et ARM64, macOS Apple Silicon et Intel, Linux x64 (glibc, musl, sans AVX2) et ARM64 (glibc, musl). L’installeur choisit la bonne. Voir [Plateformes servies](https://realmoon.ai/documentation/moon-cli/installation/#plateformes).

### WSL

- Dans WSL, installez Moon CLI avec la commande de Linux (`curl -fsSL https://realmoon.ai/install.sh | sh`). C’est une installation à part de celle de Windows, avec sa propre connexion.
- Dans Git Bash ou MSYS, l’installeur de Linux s’arrête : « ERREUR : Sous Windows, utilisez PowerShell : irm https://realmoon.ai/install.ps1 | iex ».
- Travaillez de préférence dans un dossier de Linux (`~/projets`) : les dossiers de Windows (`/mnt/c/…`) sont plus lents à parcourir depuis WSL.
- Pour la connexion, voir [Dans WSL](https://realmoon.ai/documentation/moon-cli/depannage/#wsl-connexion).

### macOS

- Installé par `curl … | sh`, le binaire n’est pas marqué comme venant d’Internet : Gatekeeper ne l’arrête pas. Un binaire téléchargé à la main par le navigateur, lui, serait bloqué. Ne contournez pas Gatekeeper : utilisez la commande d’installation.
- « Killed: 9 » au lancement : macOS a refusé un binaire dont la signature ne correspond plus (fichier copié ou modifié). Réinstallez avec la commande d’installation.
- Sur un Mac Intel, l’installeur prend la version Intel ; dans un terminal lancé sous Rosetta sur un Mac Apple Silicon, il prend quand même la version Apple Silicon.

### Linux

| Message de l’installeur | Que faire |
| --- | --- |
| « Architecture non prise en charge (…) » | Moon CLI existe pour x64 et ARM64 (64 bits) seulement : pas pour les systèmes 32 bits (`armv7l`, `i686`). |
| « Systeme non pris en charge (…) » | Moon CLI fonctionne sous Linux, macOS et Windows. |
| « Moon CLI a besoin de libstdc++ et libgcc. Installez-les : apk add libstdc++ libgcc » | Alpine et les autres systèmes musl : installez ces deux paquets, puis relancez l’installation. |
| « Moon CLI … n’est pas publie pour … » | La version n’existe pas pour cette plateforme ; l’installeur liste celles qui existent. |
| « Le binaire ne demarre pas sur cette machine (…) » | Le binaire ne démarre pas sur ce système, par exemple une distribution très ancienne. Écrivez au support avec le résultat de `uname -m` et de `ldd --version`. |

L’installeur détecte seul glibc ou musl, et les processeurs sans AVX2 (variante « baseline »).

## Messages au lancement

| Message | Que faire |
| --- | --- |
| « Connexion Moon AI requise. Dans un terminal : moon login » | Moon CLI a été lancé sans terminal interactif et sans session : connectez-vous dans un terminal (voir [Connexion](https://realmoon.ai/documentation/moon-cli/connexion/)), ou, en intégration continue, posez `MOON_API_KEY` avec une clé d’API de workspace. Dans un terminal, la connexion démarre seule. |
| « Non connecté. Lancez : moon login » | Affiché par `moon whoami`, `moon workspace` ou `moon sessions` sans session : `moon login`. |
| « Le workspace « … » (…) n’a pas le forfait Étoile requis pour Moon CLI. » | Choisissez un workspace qui l’inclut (`moon workspace use <nom ou numéro>`) ou changez de forfait sur [chat.realmoon.ai/billing](https://chat.realmoon.ai/billing). |
| « Le paiement de l’abonnement du workspace « … » a échoué. » | Régularisez le paiement sur [chat.realmoon.ai/billing](https://chat.realmoon.ai/billing), ou choisissez un autre workspace. |
| « L’abonnement du workspace « … » est terminé. » | Renouvelez l’abonnement, ou choisissez un autre workspace. |
| « Aucun workspace n’est associé à cette session. » | `moon workspace`, puis `moon workspace use <numéro>`. |
| « Connexion refusée par Moon AI. » | Réessayez plus tard ; si cela continue, écrivez au support (voir plus bas). |
| « MOON_API_KEY refusée par Moon AI (clé révoquée ou invalide). » | La clé de workspace utilisée en intégration continue n’est plus valable : créez-en une nouvelle et remplacez la variable. |
| « Configuration du dépôt ignorée pour cette session (AGENTS.md, CLAUDE.md et skills compris). » | Vous avez répondu non à « Faire confiance à cette configuration ? ». Sans terminal interactif, la configuration du dépôt est ignorée sans message. Voir [Configuration d’un dépôt](https://realmoon.ai/documentation/moon-cli/utiliser/#confiance). |
| « Agent Moon introuvable sur cet ordinateur. » ou « Impossible de lancer l’agent Moon (« … »). Réinstallez Moon CLI, ou lancez « moon doctor ». » | [Réinstallez](https://realmoon.ai/documentation/moon-cli/depannage/#reinstaller). |
| « Moon AI est injoignable. Réessayez dans un instant, ou lancez « moon doctor ». » ou « Moon AI ne répond pas correctement. … » | Réessayez dans un instant, puis lancez `moon doctor`. |

## Messages pendant une session

| Message | Que faire |
| --- | --- |
| « Moon CLI demande le forfait Étoile ou supérieur sur le workspace actif. » | Changez de workspace (`/workspace`) ou de forfait. |
| « Le paiement de l’abonnement de ce workspace a échoué. » | Régularisez le paiement sur [chat.realmoon.ai/billing](https://chat.realmoon.ai/billing), ou changez de workspace (`/workspace`). |
| « L’abonnement de ce workspace est terminé. » | Renouvelez-le sur [chat.realmoon.ai/billing](https://chat.realmoon.ai/billing), ou changez de workspace (`/workspace`). |
| « Erreur Moon AI : Désactivé par votre organisation. » | Votre organisation a fermé Moon CLI à ses membres : voyez avec son administrateur. |
| « Session Moon CLI expirée ou révoquée. » | Quittez Moon, puis relancez `moon` : la reconnexion démarre. |
| « Votre connexion à Moon CLI date de plus de 90 jours. » | Quittez Moon, puis lancez `moon login`. |
| « Limite d’utilisation de la session de 5 h atteinte. Elle se libère à … » (ou de la semaine, du mois) | Attendez l’heure indiquée, choisissez un modèle plus économique (`/models`), ou passez à un forfait supérieur. Voir [Limites d’utilisation](https://realmoon.ai/documentation/compte/limites/). |
| « Cette requête dépasse ce que votre forfait permet en un seul tour avec ce modèle. » | Choisissez un modèle plus économique (`/models`), ou réduisez le contexte (`/compact`). |
| « Ce modèle n’est pas inclus dans votre forfait. » | Choisissez un autre modèle (`/models`). |
| « Ce modèle ne sait pas utiliser les outils de l’agent (fichiers, commandes). » | Choisissez un autre modèle (`/models`). |
| « Modèle introuvable ou retiré. » | Choisissez un autre modèle (`/models`). |
| « Vous ne faites plus partie du workspace de cette session. » | Choisissez un autre workspace (`/workspace`). |
| « La requête est trop volumineuse pour Moon AI. » | Compactez la conversation (`/compact`) ou retirez de gros fichiers du contexte. |
| « Trop de requêtes en peu de temps. » | Attendez le délai indiqué. Le nombre de requêtes simultanées par siège est limité, par exemple quand l’agent lance plusieurs sous-tâches à la fois. |
| « Moon AI ou le fournisseur du modèle est momentanément indisponible. » | Réessayez dans quelques secondes. |
| « Moon AI est injoignable (réseau). » | Vérifiez votre connexion, puis lancez `moon doctor`. |
| « Moon Blur (mode strict) : … rien n’a été envoyé. » | Retirez le secret du message, ou passez en mode `secrets` avec `/blur`. Voir [Moon Blur](https://realmoon.ai/documentation/moon-cli/moon-blur/#modes). |
| « La protection de Moon CLI (Moon Guard) ne s’est pas chargée … » | Relancez `moon`, puis `moon doctor` si cela persiste. |
| « Cette action n’est pas autorisée depuis Moon CLI. » | Faites cette action dans l’application, sur [chat.realmoon.ai](https://chat.realmoon.ai). |

## Contrôle à distance (moon rc)

`moon rc [dossier]` rend une session de cet ordinateur pilotable depuis la page Code de Moon AI ; l’agent et les fichiers restent sur l’ordinateur. Lancer une session, la reprendre, codes de refus : voir [Contrôle à distance](https://realmoon.ai/documentation/moon-cli/controle-a-distance/). S’il refuse de démarrer :

| Message | Que faire |
| --- | --- |
| « Le contrôle à distance n’est pas ouvert sur ce serveur Moon AI, ou pas encore pour votre compte. » | Code est ouvert aux forfaits qui incluent Moon CLI, sur chat.realmoon.ai. Vérifiez le compte et le workspace de la session (`moon whoami`), et retirez `MOON_BASE_URL` si vous l’avez posée. |
| « Le contrôle à distance demande une connexion Moon CLI à votre compte (moon login), pas une clé d’API. » | Une clé `MOON_API_KEY` est posée dans ce terminal : retirez-la, connectez-vous avec `moon login`, puis relancez `moon rc`. |
| « Non connecté à Moon AI. Lancez d’abord : moon login » | Connectez-vous : `moon login`. |
| « Le contrôle à distance n’est pas disponible dans ce workspace : il impose Moon Blur… » | Le contenu de la session passerait par Moon AI sans être masqué : ce workspace ne le permet pas. Utilisez Moon CLI dans le terminal. |
| « Le contrôle à distance ne démarre pas : Moon AI n’a pas dit si votre workspace impose Moon Blur. … » | Relancez `moon rc` un peu plus tard ; si cela se répète, `moon doctor`. |
| « Moon AI refuse le contrôle à distance pour ce compte. » ou « Moon AI refuse le contrôle à distance : … » | La raison suit les deux-points ; pour le forfait, voir [Forfait](https://realmoon.ai/documentation/moon-cli/depannage/#forfait). |
| « Dossier introuvable : … » ou « Usage : moon rc [dossier] [--no-qr] » | Donnez un dossier qui existe, ou lancez `moon rc` dans le dossier du projet. |

Avec `/rc` dans l’interface de Moon CLI, un refus de Moon AI ou du lanceur s’affiche dans le terminal ; les messages propres à `/rc` sont dans [/rc ne démarre pas](https://realmoon.ai/documentation/moon-cli/controle-a-distance/#rc-probleme).

## Tâches sans interface

| Message | Que faire |
| --- | --- |
| « permission demandée : … ; refus automatique » | `moon run` sans `--auto` refuse toute action qui demande votre accord. Ajoutez `--auto` dans un environnement jetable, ou autorisez certaines commandes par des [règles de permission](https://realmoon.ai/documentation/moon-cli/configuration/#permissions). |
| « Ajoutez --yes pour confirmer la désinstallation. » | Sans terminal interactif, `moon uninstall` demande l’option `--yes`. |
| « Ajoutez --yes pour confirmer le retour à la version précédente. » | Sans terminal interactif, `moon rollback` demande l’option `--yes`. |

## Démarrage lent

- **Dans votre dossier personnel ou à la racine d’un disque**, l’agent parcourt tous les fichiers : placez-vous dans le dossier d’un projet.
- **Fichiers d’instructions lourds** : un `AGENTS.md` ou `CLAUDE.md` de plus de 40 Ko est envoyé à chaque appel. Raccourcissez-le : voir [Fichiers d’instructions](https://realmoon.ai/documentation/moon-cli/configuration/#instructions).

## Variables restées dans l’environnement

`moon doctor` signale les variables d’environnement qui changent le fonctionnement normal de Moon CLI, comme `MOON_BLUR_MODE`, et les variables réservées au développement de Moon CLI. Si vous ne les avez pas voulues, retirez-les de votre profil de shell. Liste des variables : [Configuration](https://realmoon.ai/documentation/moon-cli/configuration/#variables).

## Contacter le support

Écrivez à [contact@stellarrstudio.com](mailto:contact@stellarrstudio.com) en joignant `diagnostic.json` (sortie de `moon doctor --json`), le message exact affiché et votre système (Windows, macOS ou Linux, avec la version). Si `moon` ne démarre pas, joignez la sortie de l’installeur. Vous pouvez aussi passer par « Aide et support » dans l’application : voir [Obtenir de l’aide](https://realmoon.ai/documentation/compte/support/).

## Voir aussi

- [Installer Moon CLI](https://realmoon.ai/documentation/moon-cli/installation/)
- [Se connecter](https://realmoon.ai/documentation/moon-cli/connexion/)
- [Mises à jour et désinstallation](https://realmoon.ai/documentation/moon-cli/mises-a-jour/)
- [Référence des commandes](https://realmoon.ai/documentation/moon-cli/commandes/#doctor)
- [Configuration](https://realmoon.ai/documentation/moon-cli/configuration/)

---

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