# Dépannage

Déterminez si un problème vient de la configuration de lancement, de la CLI ou de son fournisseur de modèles.

## Vérifiez le lancement demandé

Exécutez **Show Agent Launch** depuis la palette de commandes et choisissez l’emplacement de travail. Le rapport indique comment chaque CLI démarrerait à cet endroit maintenant : exécutable, répertoire, arguments et noms des variables d’environnement. Les valeurs sensibles sont masquées.

Le rapport décrit le prochain démarrage avec vos paramètres actuels. Il ne décrit pas un agent déjà en cours. Si une requête aboutit, l’historique d’utilisation du fournisseur peut aider à confirmer quel compte l’a traitée.

## Identifiez le symptôme

| Problème | Vérifications |
| --- | --- |
| Vous ne trouvez pas le fichier de paramètres | Choisissez Open Settings, puis Edit in facade.json sous Facade: Home. Si la fenêtre distante ouvre les paramètres au format JSON, la commande ouvre directement facade.json. |
| Une entrée manque dans New Agent | Vérifiez le nom et le `type` de l’entrée, et assurez-vous qu’elle n’est pas désactivée par `enabled: false`. Les entrées invalides apparaissent sous Unavailable, avec la raison indiquée. |
| L’exécutable est introuvable | Installez la CLI là où le projet s’exécute, ou indiquez son chemin complet dans `command`. Pour OpenCode, utilisez la version 2 (`@opencode/cli`). |
| Une référence d’environnement est manquante | L’hôte de l’éditeur doit disposer de cette variable avant le démarrage de l’agent. L’exporter dans un terminal déjà ouvert ne met pas l’hôte à jour. |
| Un argument entre en conflit avec une option contrôlée par Facade | Retirez l’option de `args`. Utilisez plutôt le champ `model`, `effort` ou `yolo` au niveau racine. |
| L’authentification échoue ou un modèle est indisponible | Vérifiez la clé, le point de terminaison, la région, l’identifiant de modèle et l’accès au compte du fournisseur. |
| Un fournisseur Codex ne répond pas | Vérifiez que son point de terminaison prend en charge l’API Responses. |
| Un agent ne trouve pas un autre agent | Vérifiez que leurs projets sont connectés via le même dossier Facade et que leurs paramètres d’accès autorisent la communication. |
| Un programme personnalisé ne reçoit aucun message | Saisissez le texte dans son terminal. Les entrées personnalisées ne reçoivent ni les messages ni les outils de Facade. |
| Des paramètres enregistrés n’ont pas changé un agent en cours | Démarrez un nouvel agent. Pour conserver la conversation, terminez l’agent, puis utilisez Resume Agent pour le relancer avec les nouveaux paramètres. |

Pour la configuration SSH, voir [Exécuter des agents sur une machine distante](https://facadecode.com/fr/docs/remote-ssh/). Pour les erreurs de connexion depuis le téléphone, voir [Continuer depuis votre téléphone](https://facadecode.com/fr/docs/remote-control/).

## Signaler un problème

Indiquez ce que vous avez essayé, le message d’erreur exact, votre système d’exploitation, les versions de l’éditeur et de l’extension, la version de la CLI et l’entrée sélectionnée. Si possible, joignez les paramètres utiles en retirant les clés et les valeurs sensibles.

[Ouvrir un ticket GitHub ↗](https://github.com/y5ez3g/facadecode/issues)