Fehlerbehebung · Yuli Code

Was du tun kannst, wenn etwas nicht funktioniert: Start, Indizierung, KI, Claude Code, Git, Datenbank und Build.

Vorab zwei Werkzeuge, die immer helfen:

Hilfe → Fehlerprotokoll… zeigt die letzten Fehler der IDE.
Hilfe → Problem melden… erstellt eine .zip mit allem, was für die Diagnose nötig ist, ohne deinen Code und ohne deine Unterhaltungen. Zusammenfassung kopieren liefert den Text fertig zum Einfügen.

Frag den Agenten: „Was schlägt fehl?“ Mit yuli_health prüft er Probleme, Ausführung, Tests, Terminals und die Protokolle von Yuli auf einmal.

Installation und Start

Symptom	Was zu tun ist
Windows warnt beim Ausführen des Installers	Prüfe, ob du ihn aus der offiziellen Quelle heruntergeladen hast und ob der Herausgeber des Zertifikats „Yuli Code“ ist.
Das AppImage startet unter Linux nicht	Gib ihm mit `chmod +x` die Ausführungsberechtigung.
Die portable Version braucht beim ersten Mal lange	Das ist normal: Sie entpackt die Anwendung einmal pro Version. Danach startet sie sofort.
Die Oberfläche ist in einer anderen Sprache	Globale Optionen → Darstellung → Sprache. Siehe Sprachen.
Du willst messen, warum der Start lange dauert	Hilfe → Startleistung….

Symptom	Was zu tun ist
Referenzen fehlen oder die Navigation ist unvollständig	Warte, bis die Indizierung abgeschlossen ist (obere Leiste des Editors).
Lombok oder Abhängigkeiten werden nicht aufgelöst	Das Projekt ist möglicherweise im eingeschränkten Modus. Globale Optionen → Sicherheit → Vertrauenswürdige Projekte → Vertrauen.
Hinweis „Kein Sprachserver für …“	Klicke auf Installieren… und erlaube den Download.
Der Index scheint veraltet	Werkzeuge → Cache leeren… löscht Indizes und gespeicherten Zustand; Yuli baut sie neu auf.
Ein JDK, Maven oder Gradle fehlt	Yuli bietet den Download an. Konfiguriere es unter Projekt → Build, Ausführung und Debugging….

Symptom	Was zu tun ist
Authentifizierungsfehler im Platform-Modus	Prüfe den API-Key in der Modellkonfiguration und klicke auf Verbindung testen.
Ein lokales Modell antwortet nicht	Prüfe, ob der Server läuft und die Server-URL stimmt.
Der Anbieter ist ausgefallen	Yuli respektiert das `retry-after` des Anbieters. Warte oder wechsle den Anbieter.
Eine Hintergrundaufgabe wurde angehalten	Sie hat ihr Token- oder Kostenlimit erreicht: Limit erhöhen und fortsetzen.
Das Agententeam wurde pausiert	Es hat sein Budget erreicht. Erhöhe es unter Weitere Aktionen → Agententeam.

Symptom	Was zu tun ist
Yuli findet den Agenten nicht	Installiere ihn mit seinem offiziellen Installer und klicke auf Erneut erkennen.
„Warte darauf, dass Claude Code Yulis Werkzeuge nutzt“	Genehmige den Server `yuli` oder klicke auf Jetzt freigeben. Prüfe es mit `/mcp`.
`/mcp` zeigt `yuli` mit Fehler	Öffne das Projekt in Yuli: Die Werkzeuge funktionieren nur, solange Yuli geöffnet ist. `yuli_status` erklärt den Grund.
Die Regeln haben sich nicht geändert	Sie werden beim Sitzungsstart geladen: Starte die Sitzung über die Agentenleiste neu.
Codex meldet, dass der Adapter fehlt	Installiere `codex-acp`: `npm install -g @openai/codex @agentclientprotocol/codex-acp`.
Kiro verlangt ein Update	Yuli braucht Kiro CLI 1.28.2 oder neuer.
Yuli soll nichts blockieren	Deaktiviere Regeln durchsetzen („Nur warnen“). Git und Geheimnisse sind immer geschützt.

Symptom	Warum	Was zu tun ist
Kein Commit und kein Push	Git wird nur durch eine ausdrückliche Anfrage freigeschaltet.	Verlange es: „commit und push“. Gib jede Aktion frei.
Legt keinen Branch an	Branches erfordern eine eigene Anfrage.	Verlange den Branch ausdrücklich.
Liest eine Datei nicht	Es ist eine Datei mit Geheimnissen (`.env`, Schlüssel, Zugangsdaten).	Das ist Absicht. Gib die Information ohne das Geheimnis weiter.
Kann nicht außerhalb des Projekts schreiben	Die Sandbox beschränkt ihn auf das Projekt.	Projekt → Ordnerzugriff…
Führt eine Anweisung in der Datenbank nicht aus	Die Verbindung hat für diese Art keine Superrechte.	Passe den Agentenzugriff der Verbindung an.
Geht nicht zu den Tests über	Die Messung steht noch aus oder hat eine weitere Iteration verlangt.	Sieh dir den Tab Messung im Panel Qualität an.
Beendet den Durchlauf nicht	Die grüne Verifizierung fehlt.	Sieh in Ausführung, Tests oder Probleme nach, was fehlschlägt.

Symptom	Was zu tun ist
Eine Operation dauert zu lange	Nach Ablauf des Limits erscheint Erneut versuchen.
Zertifikatsfehler bei einem internen Server	Markiere das Vertrauen in sein Zertifikat; Yuli merkt sich die Entscheidung pro Server.
Ich kann wegen des Gates nicht committen	Lies die fehlgeschlagene Prüfung (Geheimnisse, Testintegrität, Größe, geschützte Pfade). Behebe sie oder beantrage eine Ausnahme mit Ablaufdatum.
Die Hooks von Yuli wurden nicht installiert	In `core.hooksPath` ist bereits ein anderes Werkzeug eingetragen (zum Beispiel husky). Yuli ersetzt es nicht.

Symptom	Was zu tun ist
„Für die Verbindung zu Oracle fehlt Oracle Instant Client“	Installiere Instant Client 19c oder neuer und füge ihn zum `PATH` hinzu.
Zertifikatsfehler	Aktiviere in der Verbindung Dem Serverzertifikat vertrauen.
Der Agent sieht eine Verbindung nicht	Sein Zugriff steht auf Kein Zugriff.
Eine Abfrage des Agenten wurde abgebrochen	Sie hat 45 Sekunden überschritten, oder ihr Plan schätzt einen zu großen Durchlauf. Grenze die Abfrage ein.

Symptom	Was zu tun ist
„Docker ist nicht verfügbar.“	Starte Docker und klicke auf Erneut versuchen.
„kubectl ist nicht konfiguriert“	Installiere `kubectl` und konfiguriere einen Kontext (kubeconfig).