Documentation / Référence
Dépannage
Que faire quand quelque chose ne fonctionne pas : démarrage, indexation, IA, Claude Code, Git, base de données et build.
Avant toute chose, deux outils toujours utiles :
- Aide → Journal des erreurs… affiche les erreurs récentes de l’IDE.
- Aide → Signaler un problème… prépare un
.zip contenant le nécessaire pour le diagnostic, sans votre code ni vos conversations. Copier le résumé fournit le texte prêt à coller.
Demandez à l’agent « qu’est-ce qui ne fonctionne pas ? ». Avec yuli_health, il passe en revue d’un seul coup les problèmes, l’exécution, les tests, les terminaux et les journaux de Yuli.
Installation et démarrage
| Symptôme |
Que faire |
| Windows affiche un avertissement au lancement de l’installateur |
Vérifiez que vous l’avez téléchargé depuis la source officielle et que l’éditeur du certificat est « Yuli Code ». |
| L’AppImage ne s’ouvre pas sous Linux |
Donnez-lui le droit d’exécution avec chmod +x. |
| La version portable est lente la première fois |
C’est normal : elle décompresse l’application une fois par version. Ensuite, elle démarre instantanément. |
| L’interface est dans une autre langue |
Options globales → Apparence → Langue. Voir Langues. |
| Vous voulez mesurer pourquoi le démarrage est lent |
Aide → Performances de démarrage…. |
Indexation et intelligence du code
| Symptôme |
Que faire |
| Des références manquent ou la navigation est incomplète |
Attendez la fin de l’indexation (barre supérieure de l’éditeur). |
| Lombok ou les dépendances ne sont pas résolus |
Le projet est peut-être en mode restreint. Options globales → Sécurité → Projets de confiance → Faire confiance. |
| Avertissement « Aucun serveur de langage pour… » |
Cliquez sur Installer… et autorisez le téléchargement. |
| L’index semble obsolète |
Outils → Vider le cache… efface les index et l’état enregistré ; Yuli les régénère. |
| Il manque un JDK, Maven ou Gradle |
Yuli propose de le télécharger. Configurez-le dans Projet → Build, exécution et débogage…. |
L’IA ne répond pas
| Symptôme |
Que faire |
| Erreur d’authentification en mode Platform |
Vérifiez la clé API dans les paramètres du modèle et cliquez sur Tester la connexion. |
| Un modèle local ne répond pas |
Vérifiez que le serveur est en cours d’exécution et que l’URL du serveur est correcte. |
| Le fournisseur est indisponible |
Yuli respecte le retry-after du fournisseur. Patientez ou changez de fournisseur. |
| Une tâche en arrière-plan s’est arrêtée |
Elle a atteint son plafond de tokens ou de coût : Augmenter la limite et reprendre. |
| L’équipe d’agents s’est mise en pause |
Elle a atteint son budget. Augmentez-le dans Plus d'actions → Équipe d'agents. |
Claude Code, Kiro, Codex et Antigravity
| Symptôme |
Que faire |
| Yuli ne trouve pas l’agent |
Installez-le avec son installateur officiel et cliquez sur Détecter à nouveau. |
| « En attente de l'utilisation des outils de Yuli par Claude Code » |
Approuvez le serveur yuli ou cliquez sur Approuver maintenant. Vérifiez-le avec /mcp. |
/mcp affiche yuli en erreur |
Ouvrez le projet dans Yuli : les outils ne fonctionnent que lorsque Yuli est ouvert. yuli_status en explique la raison. |
| Les règles n’ont pas changé |
Elles sont chargées au démarrage de la session : redémarrez-la depuis la barre de l’agent. |
| Codex indique qu’il manque l’adaptateur |
Installez codex-acp : npm install -g @openai/codex @agentclientprotocol/codex-acp. |
| Kiro demande une mise à jour |
Yuli nécessite Kiro CLI 1.28.2 ou une version ultérieure. |
| Vous ne voulez pas que Yuli bloque quoi que ce soit |
Désactivez Faire respecter les règles (« avertissement seul »). Git et les secrets restent toujours protégés. |
L’agent ne fait pas quelque chose
| Symptôme |
Pourquoi |
Que faire |
| Il ne fait ni commit ni push |
Git n’est activé que sur demande explicite. |
Demandez-le : « haz commit y push ». Approuvez chaque action. |
| Il ne crée pas de branche |
Les branches nécessitent leur propre demande. |
Demandez la branche explicitement. |
| Il ne lit pas un fichier |
C’est un fichier de secrets (.env, clés, identifiants). |
C’est voulu. Transmettez l’information sans le secret. |
| Il ne peut pas écrire hors du projet |
La sandbox le limite au projet. |
Projet → Accès aux dossiers… |
| Il n’exécute pas une instruction sur la base |
La connexion n’a pas de Super permissions pour ce type d’instruction. |
Ajustez l’Accès de l'agent de la connexion. |
| Il ne passe pas aux Tests |
La mesure est en attente ou a demandé d’itérer. |
Consultez l’onglet Mesure du panneau Qualité. |
| Il ne termine pas le tour |
Il manque une vérification au vert. |
Regardez ce qui échoue dans Exécution, Tests ou Problèmes. |
Git
| Symptôme |
Que faire |
| Une opération prend trop de temps |
À l’expiration du délai, Réessayer apparaît. |
| Erreur de certificat avec un serveur interne |
Accordez la confiance à son certificat ; Yuli mémorise la décision par serveur. |
| Le gate vous empêche de faire un commit |
Lisez le contrôle qui a échoué (secrets, intégrité des tests, taille, chemins protégés). Corrigez-le ou demandez une dérogation avec date d’expiration. |
| Les hooks de Yuli ne se sont pas installés |
Un autre outil occupe déjà core.hooksPath (par exemple husky). Yuli ne le remplace pas. |
Base de données
| Symptôme |
Que faire |
| « Pour se connecter à Oracle, Oracle Instant Client est requis » |
Installez Instant Client 19c ou une version ultérieure et ajoutez-le au PATH. |
| Erreur de certificat |
Cochez Faire confiance au certificat du serveur dans la connexion. |
| L’agent ne voit pas une connexion |
Son accès est réglé sur Aucun accès. |
| Une requête de l’agent a été interrompue |
Elle a dépassé 45 secondes ou son plan prévoit un parcours trop volumineux. Restreignez la requête. |
Conteneurs
| Symptôme |
Que faire |
| « Docker n'est pas disponible » |
Démarrez Docker et cliquez sur Réessayer. |
| « kubectl n'est pas configuré » |
Installez kubectl et configurez un contexte (kubeconfig). |
Le problème persiste
- Aide → Signaler un problème…
- Décrivez ce que vous faisiez et ce que vous attendiez.
- Partagez le
.zip ou le résumé sur GitHub.