Documentation
Dépannage des erreurs courantes
Retrouver une installation qui fonctionne, sans lire le code.
Commencez par le panneau Cadralia : il indique presque toujours la brique qui bloque.
Le panneau ne détecte aucun agent
Le connecteur local n'est pas lancé, ou il n'est pas branché à votre agent.
- Vérifiez que vous avez bien suivi l'étape Brancher votre agent de l'installation.
- Pour OpenCode, vérifiez
cadralia-bridge/opencodedans~/.config/opencode/opencode.jsonc, puis redémarrez OpenCode. - Pour Codex, vérifiez que le terminal du connecteur est toujours ouvert.
- Pour Claude Code, relancez
cadralia-bridge install claude-code. - Cliquez sur Rafraîchir dans le panneau.
Le connecteur est détecté, mais aucune session
Une session n'existe qu'après un premier message.
- Ouvrez votre agent dans le dossier du projet.
- Envoyez un message, par exemple
Bonjour. - Cliquez sur Rafraîchir dans le panneau.
L'autorisation ne fonctionne pas
- Vérifiez que le connecteur est lancé.
- Cliquez sur Récupérer le code dans le panneau.
- Si le champ reste vide, ouvrez Saisir le code manuellement et saisissez
le code affiché dans le terminal du connecteur ou dans
~/.config/cadralia/pairing-code-<port>.txt. - Cliquez sur Autoriser.
Le code est valable 5 minutes. Le connecteur en génère un nouveau si nécessaire.
Si le panneau indique que le connecteur est déjà associé à un autre navigateur, relancez l'appairage depuis zéro. Dans un terminal :
cadralia-bridge reset
Redémarrez ensuite le connecteur et votre agent, puis cliquez de nouveau sur Autoriser.
La livraison ne part pas
- Vérifiez qu'une session est bien sélectionnée dans Session cible.
- Avec Claude Code, la livraison peut attendre votre prochain message.
- Avec Codex, gardez le terminal du connecteur ouvert.
- Si l'analyse a échoué, relancez-la ou livrez en mode dégradé.
Rien ne change après un rafraîchissement
- Fermez puis relancez votre agent.
- Relancez le connecteur.
- Vérifiez qu'une mise à jour de l'extension est disponible dans votre navigateur, puis installez-la.
- Rouvrez le panneau Cadralia.
Le service ne répond pas
Vérifiez votre connexion internet, puis réessayez. Si le message persiste, attendez quelques minutes : le service peut être momentanément indisponible.
Besoin d'aide
Si le problème persiste, ouvrez une issue sur le dépôt en décrivant l'étape qui bloque et le message affiché par le panneau.