> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reclaude.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Dépannage

> Solutions aux problèmes ReClaude : erreurs DNS d'installation, limites d'appareils à la connexion, binaire claude manquant et erreurs 401.

## L'installation échoue

| Symptôme                                                             | Solution                                                                                                                                                                       |
| -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Échec de la résolution DNS` ou `Échec de connexion / délai dépassé` | Vérifiez votre réseau. Sur un réseau restreint, basculez les miroirs ou récupérez le binaire directement depuis [Téléchargement manuel](/fr/cli/install#téléchargement-manuel) |
| `Échec du téléchargement (HTTP 4xx/5xx)`                             | Habituellement une valeur `--version` inexistante ; essayez sans `--version` pour utiliser `latest`                                                                            |
| `OS / arch non pris en charge`                                       | ReClaude livre actuellement macOS / Linux sur amd64 + arm64, et Windows amd64. x86 32 bits, ARMv7, PowerPC et RISC-V ne sont pas encore publiés                                |
| `Répertoire d'installation non accessible en écriture`               | L'emplacement d'installation par défaut est `~/.local/bin` ; vérifiez les permissions ou indiquez un répertoire accessible en écriture                                         |

## L'approbation par navigateur échoue

| Message du navigateur                               | Solution                                                                                                                                                                                                 |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Cette session CLI a expiré ou est invalide`        | Relancez `reclaude login` pour un nouveau lien                                                                                                                                                           |
| `Limite d'appareils atteinte : Y / X appareils`     | Révoquez un ancien appareil sur la page [Appareils](/fr/account/devices)                                                                                                                                 |
| `L'organisation sélectionnée n'a pas de compte lié` | Choisissez une autre organisation sur la page d'approbation, ou contactez le support                                                                                                                     |
| **Le bouton Approuver est grisé / non cliquable**   | Votre compte n'est pas encore rattaché à une organisation ou à un plan — souscrivez un abonnement sur [reclaude.ai](https://reclaude.ai), ou contactez le support pour l'activer, puis revenez approuver |

## Erreurs lors de l'exécution de claude

| Symptôme                          | Solution                                                                                                                             |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Le shell ne trouve pas `reclaude` | Vous n'avez pas ouvert de nouveau terminal après l'installation ; ouvrez un nouveau terminal ou exécutez `source` sur votre rc shell |
| Le shell ne trouve pas `claude`   | Le CLI Claude Code n'est pas installé ; relancez le script d'installation et laissez-le installer Claude Code pour vous              |
| `reclaude` quitte immédiatement   | Vérifiez `reclaude status` ; si le démon ne fonctionne pas, relancez simplement `reclaude`                                           |
| Erreurs `401 / 403` répétées      | Probablement une session expirée — relancez `reclaude login`                                                                         |

## Erreurs à l'exécution

| Symptôme                                                          | Solution                                                                                                                                                                     |
| ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `401 device_revoked` / le serveur révoque sans arrêt mon appareil | Voir [Appareils → Appareils révoqués automatiquement](/fr/account/devices)                                                                                                   |
| `403 x-claude-code-session-id missing`                            | Votre Claude Code CLI est trop ancien et la gateway le rejette ; mettez à jour vers la dernière version (`claude update` ou réinstallez le CLI officiel)                     |
| `Unable to connect to API: SSL certificate has expired`           | Exécutez d'abord `reclaude stop`, puis relancez `reclaude` (le redémarrage régénère le certificat local) ; si l'erreur persiste, vérifiez que l'horloge système est correcte |
| Erreurs `502` fréquentes / erreurs amont                          | Lancez `reclaude config gateway` pour basculer sur une autre route (voir [Référence des commandes → Configurer la gateway](/fr/cli/commands#configurer-la-gateway))          |

## Problèmes de paiement

| Symptôme                                                                                             | Solution                                                                                                                                                                                                                                                                                                                        |
| ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Paiement effectué mais la commande affiche toujours **En attente**                                   | Le callback du canal de paiement se synchronise généralement en 1 à 3 minutes ; si rien ne change, ouvrez un ticket sur [reclaude.ai](https://reclaude.ai) → **Facturation** en indiquant le numéro de commande                                                                                                                 |
| Paiement effectué mais la commande affiche **Expirée**                                               | Le canal a prélevé mais le callback a échoué — ouvrez un ticket avec la capture du paiement et le numéro de commande ; après vérification, le support recréditera ou remboursera                                                                                                                                                |
| Un même paiement a créé deux commandes                                                               | N'effectuez plus de paiement ; ouvrez un ticket pour que le support fusionne les commandes                                                                                                                                                                                                                                      |
| Paiement réussi mais la page d'accueil affiche toujours **Aucun abonnement** / aucun plan disponible | Le plus souvent, la mauvaise organisation est sélectionnée en haut — le plan vit sur sa propre organisation ; utilisez `reclaude org use <org_id>` pour basculer (ou changez d'organisation en haut sur le web), puis rouvrez le terminal ; la synchronisation du statut accuse parfois un bref retard, rafraîchissez peu après |

## Alertes de la page d'accueil

| Alerte                                 | Signification                                                                            | Solution                                                                              |
| -------------------------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| **Compte banni**                       | Le compte qui vous est attribué a été signalé par Anthropic                              | Le système va **automatiquement réassigner un nouveau compte** — patientez un instant |
| **Nécessite un examen**                | Le compte a rencontré une exception ; service suspendu jusqu'à résolution par le support | Attendez le support, ou ouvrez un ticket pour le statut                               |
| **Abonnement expire bientôt / expiré** | La fenêtre de renouvellement est arrivée                                                 | Cliquez sur la bannière de renouvellement pour payer                                  |

## Lire les journaux

```bash theme={null}
reclaude logs                       # fin du journal du démon
```

Fichier journal complet : `~/.reclaude/logs/reclaude.log`.

## Toujours bloqué ?

Connectez-vous sur [reclaude.ai](https://reclaude.ai), puis **Tickets → Nouveau** pour soumettre :

* **Technique** : problèmes de connexion, erreurs CLI, démon ne démarre pas
* **Facturation** : commandes, remboursements, factures
* **Autre** : commentaires ou suggestions
