Aller au contenu

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.

  1. Vérifiez que vous avez bien suivi l'étape Brancher votre agent de l'installation.
  2. Pour OpenCode, vérifiez cadralia-bridge/opencode dans ~/.config/opencode/opencode.jsonc, puis redémarrez OpenCode.
  3. Pour Codex, vérifiez que le terminal du connecteur est toujours ouvert.
  4. Pour Claude Code, relancez cadralia-bridge install claude-code.
  5. 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.

  1. Ouvrez votre agent dans le dossier du projet.
  2. Envoyez un message, par exemple Bonjour.
  3. Cliquez sur Rafraîchir dans le panneau.

L'autorisation ne fonctionne pas

  1. Vérifiez que le connecteur est lancé.
  2. Cliquez sur Récupérer le code dans le panneau.
  3. 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.
  4. 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

  1. Fermez puis relancez votre agent.
  2. Relancez le connecteur.
  3. Vérifiez qu'une mise à jour de l'extension est disponible dans votre navigateur, puis installez-la.
  4. 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.