# Installer Moon CLI

> 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.

Moon CLI s’installe en une commande, sans droits administrateur. L’installeur choisit le binaire adapté à votre machine, vérifie son empreinte, teste son démarrage, puis ajoute la commande `moon` à votre `PATH`.

## Installer sous Windows

Dans PowerShell (5.1 ou 7) :

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

Depuis l’invite de commandes (CMD) :

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

Ouvrez ensuite un **nouveau** terminal : le `PATH` mis à jour n’est lu qu’à l’ouverture.

- Sur un PC ARM64, l’installeur prend la version ARM64 si elle est publiée, sinon la version x64, qui tourne en émulation. Il l’indique pendant l’installation.
- Sur un processeur x64 sans instructions AVX2, il choisit seul la variante adaptée.
- Dans Git Bash ou MSYS, le script `install.sh` refuse de s’installer : utilisez PowerShell.

## Installer sous macOS, Linux et WSL

Dans un terminal :

```bash title="Terminal"
curl -fsSL https://realmoon.ai/install.sh | sh
```

Le script a besoin de `curl`, de `gzip` et de `sha256sum` ou `shasum`. Il détecte l’architecture (x64 ou ARM), la bibliothèque C (glibc ou musl) et la présence des instructions AVX2. Sur un Mac Apple Silicon, il installe la version native même si le terminal tourne sous Rosetta.

- **WSL** : lancez la commande dans votre distribution Linux.
- **Alpine et autres systèmes musl** : Moon CLI a besoin des paquets `libstdc++` et `libgcc`. S’ils manquent, l’installeur affiche la commande à lancer :

```bash title="Alpine"
apk add libstdc++ libgcc
```

- **macOS** : installez avec le script plutôt qu’en téléchargeant le binaire avec un navigateur, que macOS peut bloquer.

Ouvrez ensuite un nouveau terminal, ou rechargez le profil de votre shell, pour que `moon` soit trouvé.

## Plateformes servies

| Système | Variantes |
| --- | --- |
| Windows 10 et 11 | x64, x64 sans AVX2, ARM64 (sinon x64 en émulation) |
| macOS | Apple Silicon, Intel |
| Linux (glibc) | x64, x64 sans AVX2, ARM64 |
| Linux (musl, par exemple Alpine) | x64, ARM64 |

Si la version demandée n’est pas publiée pour votre machine, l’installeur s’arrête sans rien modifier.

## Ce que fait l’installeur

1. Il lit le numéro de la dernière version publiée, ou prend celle que vous avez indiquée.
2. Il télécharge le binaire compressé de votre plateforme, en HTTPS seulement.
3. Il vérifie l’empreinte SHA-256 du fichier téléchargé, puis celle du binaire décompressé, avec la liste publiée pour cette version.
4. Il lance le binaire (`moon --version`) pour vérifier qu’il démarre sur votre machine. En cas d’échec, rien n’est remplacé.
5. Il range le binaire dans un dossier propre à la version et active cette version.
6. Il ajoute le dossier de `moon` à votre `PATH`.
7. Il retire `moon-agent`, le second binaire des versions 0.1.x, devenu inutile.

Ajout au `PATH`, selon votre shell :

| Shell | Fichier modifié |
| --- | --- |
| zsh | `~/.zshrc` |
| bash | `~/.bashrc`, ou `~/.bash_profile` sous macOS |
| fish | `~/.config/fish/conf.d/moon.fish` |
| autre | `~/.profile` |
| Windows | variable `Path` de votre compte utilisateur |

Dans les fichiers de shell, l’ajout est encadré par les lignes `# >>> moon cli >>>` et `# <<< moon cli <<<`.

## Options d’installation

| Réglage | macOS, Linux, WSL | Windows |
| --- | --- | --- |
| Version précise | numéro de version en argument du script | variable `MOON_VERSION` |
| Ne pas modifier le `PATH` | option `--no-modify-path`, ou variable `MOON_NO_MODIFY_PATH=1` | variable `MOON_NO_MODIFY_PATH=1` |
| Autre dossier | variable `MOON_INSTALL_DIR` : dossier du lien `moon` | variable `MOON_INSTALL_DIR` : dossier de `moon.exe` et des versions |

```bash title="macOS, Linux, WSL"
# Version précise
curl -fsSL https://realmoon.ai/install.sh | sh -s -- 0.4.0

# Sans toucher au PATH
curl -fsSL https://realmoon.ai/install.sh | sh -s -- --no-modify-path

# Commande moon dans ~/bin
curl -fsSL https://realmoon.ai/install.sh | MOON_INSTALL_DIR="$HOME/bin" sh
```

```powershell title="Windows"
# Version précise
$env:MOON_VERSION = '0.4.0'
irm https://realmoon.ai/install.ps1 | iex

# Sans toucher au PATH
$env:MOON_NO_MODIFY_PATH = '1'
irm https://realmoon.ai/install.ps1 | iex

# Autre dossier
$env:MOON_INSTALL_DIR = 'D:\Outils\Moon'
irm https://realmoon.ai/install.ps1 | iex
```

Sous macOS et Linux, une variable se place après le `|`, devant `sh` : c’est le script qui la lit, pas `curl`.

> [!WARNING]
> **Dossier d’installation personnalisé**
>
> Les mises à jour lisent aussi `MOON_INSTALL_DIR`. Si vous l’utilisez, définissez-la de façon permanente (profil du shell, variables d’environnement de Windows), sinon les mises à jour suivantes seront activées dans le dossier par défaut.

## Emplacements des fichiers

| Élément | macOS, Linux, WSL | Windows |
| --- | --- | --- |
| Commande `moon` | `~/.local/bin/moon` (lien vers la version active) | `%LOCALAPPDATA%\Moon\moon.exe` |
| Versions installées (active et précédente) | `~/.local/share/moon/versions/<version>/` | `%LOCALAPPDATA%\Moon\versions\<version>\` |
| Réglages de Moon CLI (`moon.json`) | `~/.config/moon/` | `%USERPROFILE%\.config\moon\` |
| Configuration personnelle de l’agent | `~/.config/moon/` | `%USERPROFILE%\.config\moon\` |
| Session et état du lanceur | `~/.local/share/moon/cli/` | `%USERPROFILE%\.local\share\moon\cli\` |
| Données de l’agent (historique des sessions) | `~/.local/share/moon/` | `%USERPROFILE%\.local\share\moon\` |
| Journaux de l’agent | `~/.local/share/moon/log/` | `%USERPROFILE%\.local\share\moon\log\` |
| Cache et état de l’agent | `~/.cache/moon/`, `~/.local/state/moon/` | `%USERPROFILE%\.cache\moon\`, `%USERPROFILE%\.local\state\moon\` |

Les variables `XDG_CONFIG_HOME`, `XDG_DATA_HOME`, `XDG_CACHE_HOME` et `XDG_STATE_HOME` sont respectées si vous les définissez. Le jeton de connexion est rangé dans le trousseau du système quand il existe : voir [Où est rangé le jeton](https://realmoon.ai/documentation/moon-cli/connexion/#stockage). Les fichiers de configuration sont décrits dans [Configuration](https://realmoon.ai/documentation/moon-cli/configuration/#emplacements).

## Vérifier l’installation

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

`moon --version` affiche `Moon CLI 0.4.0`. `moon doctor` vérifie l’installation, le réseau et votre session, et dit quoi corriger : voir [Dépannage](https://realmoon.ai/documentation/moon-cli/depannage/#doctor).

## Vérifier les empreintes

Pour refaire vous-même la vérification de l’installeur :

```bash title="macOS, Linux, WSL"
curl -fsSL https://realmoon.ai/dl/releases/0.4.0/SHA256SUMS
sha256sum ~/.local/share/moon/versions/0.4.0/moon
```

```powershell title="Windows"
irm https://realmoon.ai/dl/releases/0.4.0/SHA256SUMS
Get-FileHash "$env:LOCALAPPDATA\Moon\versions\0.4.0\moon.exe" -Algorithm SHA256
```

L’empreinte du binaire doit être celle de la ligne `moon-<version>-<plateforme>` de la liste, par exemple `moon-0.4.0-linux-x64` ou `moon-0.4.0-windows-x64.exe`. Sous macOS, utilisez `shasum -a 256` à la place de `sha256sum`.

Les mises à jour vérifient en plus un manifeste signé avec une clé publique intégrée au binaire. Une mise à jour dont la signature ou une empreinte ne correspond pas est refusée : voir [Vérifications](https://realmoon.ai/documentation/moon-cli/mises-a-jour/#verifications).

## Mettre à jour ou désinstaller

Moon CLI se met à jour seul, au plus une fois par jour. Pour une mise à jour immédiate, un retour à la version précédente ou une désinstallation, voir [Mises à jour et désinstallation](https://realmoon.ai/documentation/moon-cli/mises-a-jour/).

## Si ça ne marche pas

- « moon » n’est pas reconnu après l’installation : voir [Ajouter Moon CLI au PATH](https://realmoon.ai/documentation/moon-cli/depannage/#commande-introuvable), sous [Windows](https://realmoon.ai/documentation/moon-cli/depannage/#path-windows) ou [macOS et Linux](https://realmoon.ai/documentation/moon-cli/depannage/#path-unix).
- L’installeur est bloqué (politique d’exécution de PowerShell, antivirus, `curl` absent, proxy) : voir [L’installeur ne s’exécute pas](https://realmoon.ai/documentation/moon-cli/depannage/#installeur-bloque).
- « Empreinte » ou « signature » refusée : voir [L’empreinte ou la signature ne correspond pas](https://realmoon.ai/documentation/moon-cli/depannage/#empreinte).
- WSL, macOS ou Linux : voir [Plateformes](https://realmoon.ai/documentation/moon-cli/depannage/#plateformes).

## Voir aussi

- [Se connecter](https://realmoon.ai/documentation/moon-cli/connexion/)
- [Configuration](https://realmoon.ai/documentation/moon-cli/configuration/)
- [Dépannage](https://realmoon.ai/documentation/moon-cli/depannage/)

---

Documentation Moon AI › Moon CLI › Installation. Page : https://realmoon.ai/documentation/moon-cli/installation/. Modifiée le 7 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.