# Fehlerbehandlung und -behebung (/de/docs/verdent-for-vscode/error-handling/recovery)
> Fehler interpretieren und sich davon erholen
***
Zu verstehen, wie Sie Fehler interpretieren, darauf reagieren und sie melden, hilft Ihnen, produktive Entwicklungssitzungen mit Verdent for VS Code aufrechtzuerhalten.
### Das lernen Sie [#das-lernen-sie]
* Häufige Fehlertypen und ihre Ursachen
* Wie Sie Fehlermeldungen effektiv interpretieren
* Systematische Schritte zur Fehlerbehebung
* Wann Sie warten und wann Sie handeln sollten
* Wie Sie Probleme an das Verdent-Team melden
***
## Häufige Fehlertypen [#häufige-fehlertypen]
Eine umfassende Fehlerdokumentation wird derzeit erstellt. Die folgenden Informationen decken die am häufigsten auftretenden Fehlerkategorien ab. Bei spezifischen Fehlerszenarien wenden Sie sich an [support@verdent.ai](mailto:support@verdent.ai) oder besuchen Sie die Discord-Community.
**Überlastete Server**
* Tritt bei hoher Auslastung auf
* Vorübergehende Kapazitätsengpässe
* **Maßnahme**: 5–10 Minuten warten und erneut versuchen
**Interne Serverfehler**
* Probleme bei der Backend-Verarbeitung
* Vorübergehende Dienststörungen
* **Maßnahme**: Warten und erneut versuchen, löst sich meist automatisch auf
**503 Service Unavailable**
* Keine funktionsfähigen Upstream-Server
* Vorübergehende Infrastrukturprobleme
* **Maßnahme**: Auf Wiederherstellung des Dienstes warten
**Rate-Limiting-Fehler**
* Anfragekontingent überschritten
* Drosselungsschutz von API
* **Maßnahme**: Auf Rücksetzung des Rate-Limits warten, Anfragehäufigkeit reduzieren
* Ungültige oder abgelaufene Anmeldedaten
* Probleme mit Sitzungs-Timeout
* **Maßnahme**: Über das User Center erneut authentifizieren, aktives Abonnement überprüfen
* Netzwerkverbindungsprobleme
* Firewall oder VPN blockiert Verbindungen
* Einschränkungen im Unternehmensnetzwerk
* **Maßnahme**: Netzwerkverbindung prüfen, anderes Netzwerk ausprobieren
* Ungültige Einstellungen oder Präferenzen
* Beschädigte Konfigurationsdateien
* **Maßnahme**: Zuletzt vorgenommene Einstellungsänderungen prüfen, Konfiguration überprüfen
* Unzureichende Dateisystemberechtigungen
* Einschränkungen beim Zugriff auf den Arbeitsbereich
* **Maßnahme**: Datei-/Ordnerberechtigungen prüfen, Zugriff auf den Arbeitsbereich überprüfen
***
## Fehlermeldungen interpretieren [#fehlermeldungen-interpretieren]
Ein detaillierter Leitfaden zur Interpretation von Fehlermeldungen befindet sich in Entwicklung. Nutzen Sie für konkrete Fehlermeldungen, auf die Sie stoßen, die Feedback-Schaltfläche oder die Discord-Community um Unterstützung.
Serverseitige Fehler sind vorübergehend und lösen sich meist durch Warten. Außer erneutem Versuchen nach ein paar Minuten ist keine weitere Maßnahme erforderlich.
**Achten Sie auf diese Schlüsselwörter:**
* „Overloaded“ oder „at capacity“
* „Internal server error“ oder „backend processing“
* „503 Service Unavailable“ oder „no healthy upstream“
* „Rate limit“ oder „quota“
**Was zu tun ist:**
* 5–10 Minuten warten, bevor Sie es erneut versuchen
* Mit der lokalen Entwicklungsarbeit fortfahren
* Bisher vorgenommene Codeänderungen überprüfen
* Aktuelle Arbeit in Git committen
**Allgemeine Regel:** Wenn die Fehlermeldung Serverstatus, Kapazität oder Rate-Limits erwähnt, ist sie vorübergehend. Es handelt sich um Infrastrukturprobleme, die sich automatisch lösen.
Vorübergehende Serverfehler (502, 503, 504) lösen sich meist innerhalb von Minuten. Warten Sie 2–3 Minuten, bevor Sie es erneut versuchen.
**Wann eskalieren:**
* Fehler besteht länger als 15 Minuten
* Discord auf Berichte zu Ausfällen prüfen
* Nach Aktualisierungen auf der Statusseite suchen
Clientseitige Fehler erfordern eine Maßnahme Ihrerseits. Diese lösen sich nicht durch Warten.
**Achten Sie auf diese Hinweise:**
* Meldungen im Zusammenhang mit Authentifizierung oder Anmeldedaten
* Konfigurations- oder Einstellungsfehler
* Dateiberechtigungsfehler
* Fehlgeschlagene Netzwerkverbindungen
**Was zu tun ist:**
* **Authentifizierungsfehler**: Über das User Center erneut authentifizieren, aktives Abonnement überprüfen
* **Konfigurationsfehler**: Zuletzt vorgenommene Einstellungsänderungen prüfen, Konfigurationsdateien überprüfen
* **Berechtigungsfehler**: Datei-/Ordnerberechtigungen prüfen, Zugriff auf den Arbeitsbereich überprüfen
* **Netzwerkfehler**: Internetverbindung testen, anderes Netzwerk ausprobieren, VPN/Firewall prüfen
**Allgemeine Regel:** Wenn der Fehler Authentifizierung, Konfiguration, Berechtigungen oder lokale Einstellungen erwähnt, müssen Sie korrigierend eingreifen.
**Schritte zur Fehlerbehebung:**
1. Vollständige Fehlermeldung auf konkrete Hinweise lesen
2. Feststellen, welche Komponente den Fehler gemeldet hat (Authentifizierung, Konfiguration, Berechtigungen, Netzwerk)
3. Gezielte Maßnahme je nach Fehlertyp ergreifen
4. Behebung durch erneuten Versuch der ursprünglichen Aktion überprüfen
### Fehlerkontext verstehen [#fehlerkontext-verstehen]
Wenn Fehler auftreten:
1. **Vollständige Fehlermeldung lesen** – Details nicht überspringen
2. **Fehlercodes beachten** – Konkrete Codes helfen bei der Diagnose
3. **Komponente identifizieren** – Welches System hat den Fehler gemeldet (Server, API, lokal)
4. **Zeitpunkt prüfen** – Ist der Fehler sofort oder mit Verzögerung aufgetreten?
***
## Systematische Fehlerbehebung [#systematische-fehlerbehebung]
Führen Sie diese schrittweisen Maßnahmen aus, wenn sich Verdent unerwartet verhält, beginnend mit den am wenigsten störenden Aktionen.
### Erste Reaktion [#erste-reaktion]
Prüfen Sie, ob das Verhalten durchgängig oder unregelmäßig auftritt. Notieren Sie, welche Aktion das unerwartete Verhalten ausgelöst hat. Gehen Sie nicht sofort davon aus, dass etwas defekt ist – viele Probleme sind vorübergehend.
Starten Sie Verdent for VS Code neu (schließen und erneut öffnen Sie VS Code). Das behebt oft blockierte Zustände oder Leistungsprobleme. Dies ist der einfachste erste Schritt zur Fehlerbehebung.
### Schrittweise Fehlerbehebung [#schrittweise-fehlerbehebung]
Wenn ein einfacher Neustart das Problem nicht löst:
Führen Sie die systematischen Schritte zur Fehlerbehebung in der richtigen Reihenfolge aus – wenn Sie Schritte überspringen, verpassen Sie oft die eigentliche Ursache.
Testen Sie die Internetverbindung mit anderen Websites. Probieren Sie ein anderes Netzwerk (mobiler Hotspot), um Firewall-/VPN-Probleme auszuschließen. Prüfen Sie, ob das Unternehmensnetzwerk Verbindungen blockiert.
Prüfen Sie, ob Sie noch authentifiziert sind. Überprüfen Sie im User Center, ob das Abonnement aktiv ist. Prüfen Sie zuletzt vorgenommene Einstellungsänderungen, die das Verhalten beeinflussen könnten.
Prüfen Sie die Discord-Community auf ähnliche Berichte: [https://discord.com/invite/NGjXEZcbJq](https://discord.com/invite/NGjXEZcbJq). Nutzen Sie die Feedback-Schaltfläche, um das Problem zu melden. Fügen Sie eine Beschreibung des unerwarteten Verhaltens und Schritte zur Reproduktion hinzu.
### Was Sie NICHT tun sollten [#was-sie-nicht-tun-sollten]
Vermeiden Sie diese Maßnahmen bei vorübergehenden Problemen:
* Verdent nicht sofort neu installieren
* Cache oder Anwendungsdaten von VS Code nicht löschen
* Systemeinstellungen bei vorübergehenden Problemen nicht ändern
* Computer nicht neu starten, außer wenn auch andere Anwendungen betroffen sind
Genehmigen Sie in Manual Accept Mode niemals destruktive Vorgänge (rm, DROP, DELETE), ohne den genauen Befehl sorgfältig zu prüfen.
**Warum?** Diese Maßnahmen sind zeitaufwendig und lösen Probleme selten. Die meisten Probleme lösen sich durch einen einfachen Neustart oder das Abwarten vorübergehender Serverprobleme.
***
## Wann warten und wann handeln [#wann-warten-und-wann-handeln]
Zu verstehen, ob Sie warten oder handeln sollten, verhindert unnötigen Aufwand bei der Fehlerbehebung.
Diese Fehler lösen sich automatisch – außer Warten und erneutem Versuchen ist keine Maßnahme erforderlich.
**Serverüberlastung oder Kapazitätsfehler:**
* Meldungen wie „Overloaded“ oder „at capacity“
* Zeiten hoher Auslastung
* Vorübergehende Dienststörungen
**Rate-Limiting:**
* Meldungen wie „Rate limit“ oder „quota exceeded“
* Zu viele Anfragen in kurzer Zeit
* Drosselungsschutz von API
**Zeitweise Verbindungsprobleme:**
* Gelegentlich fehlgeschlagene Anfragen, die beim erneuten Versuch erfolgreich sind
* Netzwerkaussetzer
* Kurze Verbindungsabbrüche
**Was Sie während des Wartens tun können:**
* Mit der lokalen Entwicklungsarbeit fortfahren
* Bisher vorgenommene Codeänderungen überprüfen
* Nächste Schritte oder Aufgaben planen
* Aktuelle Arbeit in Git committen
**Wie lange warten:**
* Standardwartezeit: 5–10 Minuten
* Wenn der Fehler nach 10 Minuten weiterhin auftritt, zur Fehlerbehebung übergehen
* Discord auf Berichte über weit verbreitete Probleme prüfen
Diese Fehler lösen sich nicht durch Warten – Sie müssen korrigierend eingreifen.
**Authentifizierungsfehler:**
* Sitzung abgelaufen → Über das User Center erneut authentifizieren
* Ungültige Anmeldedaten → Aktives Abonnement überprüfen
* Erneute Authentifizierung erforderlich → User Center prüfen
**Anhaltende Fehler (10+ Minuten):**
* Derselbe Fehler wiederholt nach mehreren Versuchen → Fehlerbehebung starten
* Konsistentes Fehlermuster → Konfiguration prüfen
* Fehler besteht über mehrere Neustarts hinweg → Umgebung überprüfen
**Konfigurationsprobleme:**
* Einstellungen kürzlich geändert → Änderungen prüfen und zurücksetzen
* Neue Einrichtung oder Installation → Konfigurationsdateien überprüfen
* Netzwerkumgebung geändert → Konnektivität testen
**Berechtigungsfehler:**
* Zugriff auf Dateisystem verweigert → Datei-/Ordnerberechtigungen prüfen
* Einschränkungen beim Arbeitsbereich → Zugriff auf den Arbeitsbereich überprüfen
* Ordnerberechtigungen → Erforderliche Berechtigungen gewähren
**Netzwerkprobleme:**
* Vollständige Verbindungsunfähigkeit → Internetverbindung testen
* VPN oder Firewall blockiert → Anderes Netzwerk ausprobieren
* Einschränkungen im Unternehmensnetzwerk → IT-Support kontaktieren
**Entscheidungsregel:**
* Server-/Rate-Fehler → Warten
* Authentifizierung/Konfiguration/Berechtigung/Netzwerk → Sofort handeln
* Unsicher? → Zuerst 5–10 Minuten warten, dann handeln, falls das Problem weiterhin besteht
***
## Fehlerkontext bereitstellen [#fehlerkontext-bereitstellen]
Wenn Sie um Hilfe bitten oder Probleme melden, geben Sie umfassenden Kontext für eine schnellere Diagnose an.
### Wesentliche Informationen [#wesentliche-informationen]
**Fehlerdetails:**
* Exakter Text der Fehlermeldung (kopieren, nicht umformulieren)
* Fehlercode, falls vorhanden
* Zeitstempel des Auftretens
* Häufigkeit (einmalig, unregelmäßig, durchgängig)
**Umgebung:**
* Version von Verdent for VS Code
* Version von VS Code
* Betriebssystem und Version
* Netzwerkumgebung (privat, Unternehmen, VPN)
**Schritte zur Reproduktion:**
1. Was Sie tun wollten
2. Verwendete exakte Prompts oder Befehle
3. Beteiligte Dateien oder Kontext
4. Vor dem Fehler durchgeführte Aktionen
**Kontext:**
* Welchen Ausführungsmodus Sie verwendet haben
* Größe und Komplexität des Arbeitsbereichs
* Kürzlich vorgenommene Konfigurationsänderungen
* Frühere erfolgreiche, ähnliche Vorgänge
### Beispiel für einen Fehlerbericht [#beispiel-für-einen-fehlerbericht]
Gutes Format für einen Fehlerbericht:
```
Issue: Getting "Internal server error" when requesting code analysis
Error Message (exact):
"Error: Internal server error occurred during processing. Please try again later."
Environment:
- Verdent for VS Code v1.2.3
- VS Code 1.85.0
- macOS 14.2
- Home network (no VPN)
Steps to Reproduce:
1. Opened large TypeScript project (500+ files)
2. Used Auto-Run Mode
3. Requested: "Analyze authentication flow in auth.ts and suggest improvements"
4. Error occurred immediately after request
Additional Context:
- First time working with this project
- Same request worked fine yesterday in different project
- Other requests (small file edits) work normally
```
### Was diesen Bericht wirksam macht [#was-diesen-bericht-wirksam-macht]
* Exakter Text der Fehlermeldung
* Vollständige Umgebungsdetails
* Klare Schritte zur Reproduktion
* Vergleich mit funktionierenden Szenarien
* Zusätzlicher Kontext zu Mustern
***
## Probleme melden [#probleme-melden]
**Ort:** Obere Leiste des Verdent-Panels
**Was sie macht:**
* Öffnet ein Popup-Overlay zum Einreichen von Problemen und Vorschlägen
* Direkter Kanal zum Verdent-Team
* Am besten geeignet für Fehlerberichte und Funktionswünsche
**Wann verwenden:**
* Bestätigte Fehler mit klaren Schritten zur Reproduktion
* Funktionswünsche mit konkreten Anwendungsfällen
* Direkte Kommunikation mit dem Team erforderlich
* Nicht dringende Probleme, die eine Untersuchung erfordern
**Was einzuschließen ist:**
* Klare Beschreibung des Problems
* Fehlermeldungen (exakter Text)
* Schritte zur Reproduktion
* Erwartetes vs. tatsächliches Verhalten
* Version von Verdent und Plattform
* Wann das Problem begann
**Link:** [https://discord.com/invite/NGjXEZcbJq](https://discord.com/invite/NGjXEZcbJq)
**Was sie bietet:**
* Aktive Community aus Verdent-Nutzern und Teammitgliedern
* Unterstützung bei der Fehlerbehebung in Echtzeit
* Probleme mit Screenshots teilen
* Hilfe von erfahrenen Nutzern erhalten
* Community-Diskussionen und Workarounds
**Wann verwenden:**
* Dringende Probleme, die eine sofortige Diskussion erfordern
* Komplexe Fehlerbehebung, die Hin und Her erfordert
* Community-Input zu Best Practices
* Kurze Fragen vor dem Einreichen formaler Berichte
* Workarounds mit der Community teilen
| Problemtyp | Feedback-Schaltfläche verwenden | Discord verwenden |
| ------------------------------------------------- | :-----------------------------: | :---------------: |
| Bestätigter Fehler mit Schritten zur Reproduktion | ✓ | |
| Funktionswunsch | ✓ | |
| Dringende Fehlerbehebung erforderlich | | ✓ |
| Komplexes Problem, das Diskussion erfordert | | ✓ |
| Kurze Frage | | ✓ |
| Community-Input gewünscht | | ✓ |
| Formaler Fehlerbericht | ✓ | |
| Allgemeine Hilfe | | ✓ |
**Was NICHT gemeldet werden sollte:**
* Vorübergehende Serverfehler (\< 10 Minuten)
* Zeiten hoher Auslastung
* Bereits dokumentierte Probleme
* Erwartetes Verhalten
**Stattdessen:** Bei vorübergehenden Problemen warten, Discord auf aktuelle Berichte prüfen, Dokumentation durchsehen.
***
## Best Practices zur Vorbeugung [#best-practices-zur-vorbeugung]
Proaktive Praktiken reduzieren die Fehlerhäufigkeit und verbessern die Wiederherstellung, wenn Fehler auftreten.
Verwenden Sie präzise Sprache in Prompts und fügen Sie relevanten Dateikontext hinzu, um viele häufige Fehler von vornherein zu vermeiden.
### Vor Beginn der Arbeit [#vor-beginn-der-arbeit]
**1. Einrichtung überprüfen**
* Authentifizierungsstatus im User Center prüfen
* Bestätigen, dass das Abonnement aktiv ist
* Stabile Netzwerkverbindung sicherstellen
* Kürzlich vorgenommene Konfigurationsänderungen überprüfen
**2. Git initialisieren**
* Vor der Nutzung freizügiger Modi immer Versionskontrolle einrichten
* Aktuelle Arbeit für einen sauberen Ausgangspunkt committen
* Bietet eine Rollback-Option, falls Probleme auftreten
**3. Credit-Guthaben prüfen**
* Ausreichende Credits für die geplante Arbeit sicherstellen
* Bei Bedarf vor komplexen Aufgaben aufladen
* Unterbrechungen mitten in der Aufgabe durch aufgebrauchte Credits vermeiden
### Während der Entwicklung [#während-der-entwicklung]
**1. Passende Ausführungsmodi verwenden**
* Manuelle Bestätigung bei unbekanntem Code
* Plan Mode für komplexe Änderungen
* Auto-Run nur mit dem Sicherheitsnetz von Git
* Modus an das Risikoniveau anpassen
**2. Leistung überwachen**
* Auf nachlassende Antwortqualität achten
* Langsamere Antwortzeiten beachten
* Neue Sitzungen starten, wenn die Leistung nachlässt
* Kontextnutzung manuell verfolgen
**3. Klare, präzise Prompts**
* Fehler durch missverstandene Anfragen reduzieren
* Relevanten Kontext und Einschränkungen einbeziehen
* Auf bestehende Muster verweisen
* Umfang klar angeben
### Nach Fehlern [#nach-fehlern]
**1. Aus Mustern lernen**
* Notieren, was Fehler ausgelöst hat
* Reproduzierbare Bedingungen identifizieren
* Workflow anpassen, um Auslöser zu vermeiden
* Erkenntnisse mit der Community teilen
**2. Workarounds dokumentieren**
* Notizen zu wirksamen Lösungen führen
* Mit Teammitgliedern teilen
* Zum Community-Wissen beitragen
* Dem Verdent-Team für Fixes melden
**3. Konfiguration aktualisieren**
* Einstellungen anhand von Erfahrungen anpassen
* Für Ihren Workflow optimieren
* Regeln konfigurieren, um Probleme zu vermeiden
* AGENTS.md-Dokumentation pflegen
***
## Siehe auch [#siehe-auch]
Effektive Prompts schreiben, um Fehler zu reduzieren
Kontext optimieren, um Leistungsprobleme zu vermeiden
Passende Modi wählen, um Risiken zu minimieren