# Se connecter à Moon AI

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

Moon CLI agit en votre nom avec une session propre au terminal, que vous pouvez voir et révoquer à tout moment. La connexion se fait par le navigateur, ou par un code sur une machine sans navigateur.

## Se connecter avec le navigateur

1. Placez-vous dans votre projet, puis lancez `moon login`.
2. Le navigateur s’ouvre sur la page « Connecter Moon CLI. » de Moon AI. Connectez-vous à votre compte si besoin. Si rien ne s’ouvre, ouvrez le lien affiché dans le terminal.
3. Vérifiez le compte indiqué sous « Connecté en tant que », puis cliquez sur « Autoriser ». « Refuser » annule la demande.
4. La page affiche « Moon CLI est connecté ». Dans le terminal, Moon CLI confirme la connexion et l’agent démarre dans le dossier courant.

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

- Pour vous connecter sans lancer l’agent : `moon login --no-launch`.
- Pour ne pas ouvrir de navigateur sur cette machine : `moon login --no-open` affiche l’adresse de connexion ; ouvrez-la là où votre compte Moon AI est connecté, dans les 5 minutes.
- Le terminal attend votre réponse 5 minutes. Passé ce délai, la page affiche « Moon CLI ne répond plus » : relancez `moon login`.
- Avec Safari, si le terminal ne reçoit rien, utilisez le lien « Mon terminal est ouvert mais rien ne se passe (Safari). Transmettre le code manuellement ».
- À la première utilisation, `moon` sans session lance cette même connexion.

Si aucun de vos workspaces n’inclut Moon CLI, la page l’indique (« Moon CLI est inclus à partir du forfait Étoile. Aucun de vos workspaces ne l’a pour l’instant. ») et propose « Voir les forfaits ». Elle signale aussi un paiement en échec ou un abonnement terminé.

À chaque nouvelle connexion, Moon AI vous envoie l’e-mail « Nouvelle connexion à Moon CLI », avec le nom de l’appareil, l’heure et une adresse approximative.

## Se connecter sans navigateur

Sur un serveur, dans une session SSH ou un conteneur, utilisez un code d’appareil :

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

Moon CLI choisit ce mode de lui-même dans une session SSH, ou sous Linux sans affichage graphique (hors WSL). `moon login --browser` force le navigateur.

1. Le terminal affiche une adresse (`https://chat.realmoon.ai/api/v1/auths/cli/device`) et un code de la forme `ABCD-EF23`.
2. Sur n’importe quel appareil, ouvrez l’adresse, connectez-vous à Moon AI, saisissez le code et cliquez sur « Autoriser ».
3. La page « Autoriser cet appareil ? » affiche le nom de l’appareil (déclaré par la machine, non vérifié), son adresse IP approximative, l’heure de la demande et le code. S’il s’agit bien de votre machine, cliquez sur « Autoriser cet appareil », sinon sur « Refuser ».
4. Le terminal confirme la connexion. Lancez ensuite `moon` dans votre projet.

Le code reste valable 10 minutes.

> [!WARNING]
> **Code reçu par un tiers**
>
> N’autorisez jamais un code reçu par e-mail ou par message : il donnerait accès à votre compte. Un code Moon CLI ne s’autorise que s’il s’affiche dans votre propre terminal.

## Coller un jeton

```bash title="Terminal"
moon login --token <jeton>
```

Sans valeur après `--token`, Moon CLI vous demande de coller le jeton. Il le vérifie auprès de Moon AI avant de l’enregistrer. Un jeton de session du site web est refusé avec le message « Ce jeton n’est pas un jeton Moon CLI. ».

La clé d’API de votre compte (« Réglages » › « Compte » › « Clés API ») sert aussi à Moon CLI, dans la limite de votre forfait. Préférez la connexion par le navigateur : la session y est renouvelée seule et apparaît dans vos sessions Moon CLI.

Pour une exécution sans terminal (intégration continue), voir [Tâche sans interface](https://realmoon.ai/documentation/moon-cli/utiliser/#ci).

## Où est rangé le jeton

- Le jeton est rangé dans le trousseau du système : Gestionnaire d’identification sous Windows, Trousseau sous macOS, libsecret sous Linux. Le fichier `auth.json` du dossier d’état ne garde alors que l’adresse, l’e-mail et les dates.
- Sans trousseau (serveur Linux sans session graphique, WSL, conteneur), le jeton est dans `auth.json`, lisible par votre seul compte.
- `moon doctor` indique où se trouve votre jeton.
- L’agent ne voit jamais le jeton : un composant local de Moon CLI l’ajoute à chaque requête vers Moon AI.
- Le jeton n’est envoyé qu’à `https://chat.realmoon.ai`. Une session enregistrée pour une autre adresse est ignorée.

## Durée de la session

| Étape | Ce qui se passe |
| --- | --- |
| Connexion | Un jeton valable 30 jours est créé. |
| Moins de 7 jours avant l’échéance | Au lancement suivant, Moon CLI le renouvelle sans rien vous demander : nouveau jeton, l’ancien est révoqué. |
| 90 jours après la connexion par le navigateur ou par code | Moon CLI vous demande de vous reconnecter par le navigateur. |

`moon whoami` affiche l’échéance du jeton et le nombre de jours avant la reconnexion obligatoire. Plusieurs `moon` ouverts en même temps partagent le même renouvellement.

## Voir l’état de la connexion

```bash title="Terminal"
moon whoami
```

```text title="Exemple de sortie"
Connecté · vous@exemple.fr · jeton eyJh…k3Qw · valable jusqu’au 05/12/2026
Workspace · Studio · Étoile · ✦ accès Moon CLI actif
Reconnexion par le navigateur dans 84 jours.
```

Le jeton n’est jamais affiché en entier. Si Moon AI refuse la session (expirée ou révoquée), `moon whoami` vous dit de lancer `moon login`.

## Voir et révoquer les sessions

Chaque connexion crée une session Moon CLI, nommée d’après l’appareil (par exemple `PC-ALICE · Windows`).

Depuis le terminal :

```bash title="Terminal"
moon sessions
moon sessions revoke 3f9a1c
```

`moon sessions` liste vos sessions avec leur identifiant, l’appareil et la date ; la session du terminal courant est marquée « celle-ci ». `moon sessions revoke` accepte le début de l’identifiant s’il ne désigne qu’une session.

Depuis l’application :

1. Ouvrez « Réglages » › « Sécurité » ([chat.realmoon.ai/settings/security](https://chat.realmoon.ai/settings/security)).
2. Dans « Sessions Moon CLI », cliquez sur « Révoquer » en face de la session, puis confirmez « Révoquer cette session Moon CLI ? ».

La section n’apparaît que si vous avez au moins une session Moon CLI.

Ces gestes ferment aussi vos sessions Moon CLI :

- « Déconnecter les autres appareils », dans « Réglages » › « Sécurité » : tous les autres navigateurs, applications et sessions Moon CLI.
- « Se déconnecter de tous les appareils » (« Tout déconnecter ») : chaque appareil, celui-ci compris.
- Le changement de votre mot de passe.

Dans une organisation gérée, un administrateur peut aussi terminer les sessions Moon CLI d’un membre liées à l’organisation. Voir [Sécurité du compte](https://realmoon.ai/documentation/compte/securite/).

## Se déconnecter

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

Moon CLI révoque la session auprès de Moon AI, puis efface le jeton de votre machine. Si Moon AI est injoignable à ce moment, le jeton local est quand même effacé : révoquez alors la session depuis « Réglages » › « Sécurité ».

## Si ça ne marche pas

- Le navigateur ne s’ouvre pas, ou vous êtes en SSH, dans WSL ou sur un serveur : voir [La connexion ne marche pas](https://realmoon.ai/documentation/moon-cli/depannage/#connexion).
- « Moon CLI requiert un abonnement Étoile ou supérieur » : voir [Forfait](https://realmoon.ai/documentation/moon-cli/depannage/#forfait).
- Session expirée ou mauvais compte : voir [Jeton expiré ou révoqué](https://realmoon.ai/documentation/moon-cli/depannage/#jeton) et [Le mauvais compte](https://realmoon.ai/documentation/moon-cli/depannage/#autre-compte).

## Voir aussi

- [Workspaces, modèles et limite d’utilisation](https://realmoon.ai/documentation/moon-cli/workspaces-modeles/)
- [Référence des commandes](https://realmoon.ai/documentation/moon-cli/commandes/#login)
- [Dépannage](https://realmoon.ai/documentation/moon-cli/depannage/)

---

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