# Fehlerbehebung (/de/docs/verdent-for-vscode/help-support/common-issues)

> Häufige Probleme, Diagnosen und Lösungen



### Was Sie lernen werden [#was-sie-lernen-werden]

Häufige Verfahren zur Fehlerbehebung, Diagnoseschritte und Workarounds für bekannte Probleme bei Verdent for VS Code.

<Info>
  Eine detaillierte Fehlerbehebung für die am häufigsten gemeldeten Probleme wird derzeit aus Support-Daten zusammengestellt. Diese Seite enthält allgemeine Diagnoseverfahren. Wenden Sie sich für spezifische Probleme, die hier nicht behandelt werden, an [support@verdent.ai](mailto:support@verdent.ai).
</Info>

***

## Schnelldiagnose [#schnelldiagnose]

<Tabs>
  <Tab title="Dienstfehler (am häufigsten)">
    ### „Service is experiencing high traffic. Please try again later!“ [#service-is-experiencing-high-traffic-please-try-again-later]

    **Dies ist der häufigste Fehler**, auf den Nutzer stoßen. Er weist darauf hin, dass der Verdent-Dienst vorübergehend überlastet ist.

    **Wann er auftritt:**

    * Während Spitzenlastzeiten
    * Wenn Backend-Dienste stark ausgelastet sind
    * Bei vorübergehender Beeinträchtigung des Dienstes

    **Wiederherstellungsschritte (in dieser Reihenfolge):**

    <Steps>
      <Step title="Nachricht zurücksetzen" stepNumber="1">
        Wenn der Fehler weiterhin besteht, setzen Sie die zuletzt gesendete Nachricht zurück:

        * Wählen Sie die Schaltfläche „Rollback/Zurücksetzen“ in der Chat-Oberfläche
        * Senden Sie Ihre Anfrage nach einer kurzen Wartezeit erneut
      </Step>

      <Step title="Neue Sitzung starten" stepNumber="2">
        Wenn weiterhin Fehler auftreten, starten Sie eine neue Sitzung:

        * Wählen Sie die Schaltfläche „+“ (Neue Sitzung) in der oberen Leiste
        * Dadurch werden Kontext und Werkzeugfreigaben gelöscht
        * Senden Sie Ihre Anfrage in der neuen Sitzung erneut
      </Step>

      <Step title="Warten und erneut versuchen" stepNumber="3">
        Warten Sie 30–60 Sekunden und versuchen Sie Ihre Anfrage erneut. Die meisten Dienstprobleme lösen sich schnell.
      </Step>
    </Steps>

    <Warning>
      Wenn das Problem über mehrere Sitzungen hinweg länger als 5–10 Minuten anhält, prüfen Sie die [Statusseite von Verdent](https://verdent.ai/status) oder wenden Sie sich an [support@verdent.ai](mailto:support@verdent.ai).
    </Warning>
  </Tab>

  <Tab title="Installation und Einrichtung">
    ### Probleme bei Installation und Einrichtung [#probleme-bei-installation-und-einrichtung]

    **Systemanforderungen:**

    * **VS Code-Version:** 1.90.0 oder höher (erforderlich)
    * **Internetverbindung:** Aktive Verbindung erforderlich
    * **Abonnement:** Aktives Verdent-Abonnement

    **Grundlegende Diagnose-Checkliste:**

    1. **VS Code-Version prüfen:** Hilfe → Info (muss 1.90.0 oder höher sein)
    2. **Internetverbindung prüfen:** Verdent benötigt eine aktive Verbindung
    3. **Abonnement prüfen:** Stellen Sie sicher, dass das Verdent-Abonnement aktiv ist
    4. **VS Code neu starten:** Nach der Installation oder Konfigurationsänderungen
    5. **Erweiterungsstatus prüfen:** Ansicht → Erweiterungen → Verdent (sollte „Aktiviert“ anzeigen)

    **Vorgehen für eine saubere Neuinstallation:**

    <Steps>
      <Step title="Verdent deinstallieren">
        Ansicht → Erweiterungen → Verdent → Deinstallieren
      </Step>

      <Step title="VS Code neu starten">
        VS Code vollständig schließen und erneut öffnen
      </Step>

      <Step title="Verdent neu installieren">
        Ansicht → Erweiterungen → Nach „Verdent“ suchen → Installieren
      </Step>
    </Steps>

    **Protokolle prüfen:**

    * Öffnen Sie das Ausgabefenster: Ansicht → Ausgabe
    * Wählen Sie „Verdent“ im Dropdown-Menü aus
    * Suchen Sie nach Fehlermeldungen oder Stack-Traces

    <Info>
      Die meisten Installationsprobleme lösen sich durch ein einfaches Neuladen von VS Code oder eine saubere Neuinstallation. Wenn Probleme weiterhin bestehen, prüfen Sie die Protokolle und wenden Sie sich mit den Protokolldetails an den Support.
    </Info>
  </Tab>

  <Tab title="Authentifizierung und Konto">
    ### Anmeldung bei Verdent for VS Code nicht möglich [#anmeldung-bei-verdent-for-vs-code-nicht-möglich]

    **Häufigste Ursache:** Problem mit der Proxy-Konfiguration

    **Lösung:**

    <Steps>
      <Step title="VS Code-Einstellungen öffnen">
        Drücken Sie `Cmd+,` (macOS) oder `Ctrl+,` (Windows/Linux)
      </Step>

      <Step title="Nach der Proxy-Einstellung suchen">
        Suchen Sie in der Einstellungssuche nach „useProxy“ oder „verdent.enableProxy“
      </Step>

      <Step title="Proxy-Status umschalten">
        Schalten Sie die Proxy-Einstellung ein bzw. aus (jeweils entgegen dem aktuellen Zustand)
      </Step>

      <Step title="Anmeldung erneut versuchen">
        Versuchen Sie erneut, sich bei Verdent anzumelden
      </Step>
    </Steps>

    <Info>
      Wenn Sie sich hinter einer Unternehmens-Firewall befinden, müssen Sie die Proxy-Einstellung möglicherweise aktivieren. In einem Heimnetzwerk versuchen Sie stattdessen, sie zu deaktivieren.
    </Info>

    ***

    ### Kostenlose Testversion: Credits nicht erhalten [#kostenlose-testversion-credits-nicht-erhalten]

    **Fehler:** Credits der kostenlosen Testversion wurden nicht gutgeschrieben oder der Zugang zur Testversion wurde verweigert

    **Grund:** Bei der Registrierung wurde ein Verstoß gegen die Nutzungsbedingungen festgestellt

    **Lösung:** Wenden Sie sich für Unterstützung bei Ihrem Zugang zur kostenlosen Testversion an [support@verdent.ai](mailto:support@verdent.ai). Das Support-Team prüft Ihr Konto und hilft, das Problem zu lösen.

    ***

    ### Registrierung fehlgeschlagen [#registrierung-fehlgeschlagen]

    **Fehler:** Die Kontoregistrierung wurde abgelehnt oder eingeschränkt

    **Grund:** Die Registrierung verstößt gegen die Nutzungsbedingungen von Verdent, was zu einer Zugangsbeschränkung geführt hat

    **Lösung:** Wenden Sie sich an [support@verdent.ai](mailto:support@verdent.ai). Das Support-Team kann Ihre Registrierung prüfen und Ihnen Hinweise zur Lösung des Problems geben.

    ***

    ### Fehlende Modelle (Claude, GPT, Gemini) [#fehlende-modelle-claude-gpt-gemini]

    **Problem:** Claude, GPT- oder Gemini-Modelle sind in der Modellauswahl nicht zu finden

    **Grund:** Standortbezogene Einschränkungen der Modellanbieter

    **Erklärung:** Einige KI-Modellanbieter haben regionale Einschränkungen, die verhindern, dass bestimmte Modelle in bestimmten geografischen Regionen verfügbar sind. In diesem Fall gilt:

    * Eingeschränkte Modelle erscheinen nicht in Ihrem Modellauswahlmenü
    * Sie können weiterhin alle anderen verfügbaren Modelle ohne Unterbrechung nutzen
    * Es gibt keine Auswirkungen auf Ihr Abonnement oder Ihre Credits

    **Verfügbare Modelle prüfen:** Besuchen Sie [https://www.verdent.ai/regions](https://www.verdent.ai/regions), um zu sehen, welche Modelle in Ihrer Region verfügbar sind

    <Note>
      Regionale Einschränkungen werden von den KI-Modellanbietern (Anthropic, OpenAI, Google) festgelegt, nicht von Verdent. Verdent kann diese Einschränkungen nicht außer Kraft setzen.
    </Note>
  </Tab>

  <Tab title="Leistung">
    ### Leistungsprobleme [#leistungsprobleme]

    **Symptome:**

    * Langsame Antwortzeiten
    * Fehler wegen vollem Kontextfenster
    * Zeitüberschreitungen bei der Werkzeugausführung

    **Häufige Ursachen und Lösungen:**

    | Problem                           | Ursache                      | Lösung                                                                         |
    | --------------------------------- | ---------------------------- | ------------------------------------------------------------------------------ |
    | Langsame Antworten                | Große Dateien werden gelesen | Zeilenbereiche verwenden: `file_read("file.js", start_line=100, max_lines=50)` |
    | Kontext voll                      | Langer Konversationsverlauf  | An Subagenten delegieren oder neue Konversation starten                        |
    | Zeitüberschreitung bei Werkzeugen | Lang laufende Bash-Befehle   | Explizites Timeout festlegen oder in kleinere Befehle aufteilen                |
    | Hoher Speicherverbrauch           | Zu viele parallele Vorgänge  | Gleichzeitige Werkzeugausführungen begrenzen                                   |

    <Tip>
      Delegieren Sie explorative Aufgaben an den @Explorer-Subagenten, um den Hauptkontext zu bewahren.
    </Tip>
  </Tab>

  <Tab title="Bildfehler">
    ### Fehlermeldungen im Zusammenhang mit Bildern [#fehlermeldungen-im-zusammenhang-mit-bildern]

    **Kurzübersicht häufiger Fehler bei der Bildverarbeitung:**

    | Fehlermeldung                  | Ursache                                                                                                   | Lösung                                                                   |
    | ------------------------------ | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
    | **Unsupported Image Type**     | Es werden nur JPEG-, PNG-, GIF- oder WebP-Bilder unterstützt                                              | Zurücksetzen und den Bildtyp in ein unterstütztes Format ändern          |
    | **Image Dimensions Too Large** | Bildbreite oder -höhe darf 8000 Pixel nicht überschreiten                                                 | Zurücksetzen und die Bildabmessungen auf 8000×8000 oder kleiner anpassen |
    | **Input Too Long**             | Die Eingabe überschreitet die maximal zulässige Länge des Modells                                         | Eingabe vereinfachen oder Bildgröße reduzieren                           |
    | **File Too Large**             | Die Bildgröße darf 5 MB nicht überschreiten                                                               | Zurücksetzen und ein komprimiertes Bild senden (max. 5 MB)               |
    | **Unreadable Image**           | Das Bild konnte nicht verarbeitet werden, Datei möglicherweise beschädigt oder nicht unterstütztes Format | Zurücksetzen und das Bild durch eine gültige Datei ersetzen              |
  </Tab>
</Tabs>

***

## Werkzeugspezifische Probleme [#werkzeugspezifische-probleme]

<Tabs>
  <Tab title="Fehler bei file_edit">
    ### Fehler bei file\_edit [#fehler-bei-file_edit]

    **Fehler:** „Failed to find exact match“

    **Ursachen:**

    * Text wurde seit dem letzten file\_read geändert
    * Unterschiede bei Leerzeichen (Tabs vs. Leerzeichen)
    * String ist in der Datei nicht eindeutig

    **Lösungen:**

    ```bash
    # 1. Read file again to get current state
    file_read("file.js")

    # 2. Use larger context string for uniqueness
    file_edit("file.js",
      old_string="function foo() {\n  return 42;\n}",
      new_string="...")

    # 3. For multiple identical strings, use replace_all
    file_edit("file.js", old_string="TODO", new_string="DONE", replace_all=true)
    ```

    <Warning>
      Lesen Sie die Datei immer unmittelbar vor der Bearbeitung, um sicherzustellen, dass Sie den aktuellen Stand vorliegen haben.
    </Warning>
  </Tab>

  <Tab title="Fehler bei bash">
    ### Fehler bei bash-Befehlen [#fehler-bei-bash-befehlen]

    **Fehler:** Zeitüberschreitung oder Ausführungsfehler des Befehls

    **Maximales Timeout:** 120 Sekunden (2 Minuten, feste Grenze)

    **Lösung:** Lange Befehle in kleinere Vorgänge aufteilen:

    ```bash
    # Instead of one long command, break into steps
    bash("step1")  # Completes in < 2min
    bash("step2")  # Completes in < 2min
    ```

    **Befehl nicht gefunden:**

    * Prüfen, ob der Befehl existiert: `bash("which command-name")`
    * Sicherstellen, dass der Pfad korrekt ist oder zuerst die Umgebung aktivieren
    * Vollständige Pfade für ausführbare Dateien verwenden

    **Berechtigungsfehler:**

    * Befehle werden mit Benutzerberechtigungen ausgeführt
    * `sudo` nur bei Bedarf und in Manual Accept Mode verwenden
    * Datei- bzw. Verzeichnisberechtigungen prüfen
  </Tab>

  <Tab title="Suchprobleme">
    ### Suche liefert keine Ergebnisse [#suche-liefert-keine-ergebnisse]

    **Problem:** grep\_file oder glob findet die erwarteten Dateien nicht

    **Muster-Syntax prüfen:**

    ```bash
    # Wrong
    grep_file("*.ts")  # Missing ** for recursive

    # Correct
    grep_file("**/*.ts")  # Recursive search
    ```

    **Ausschlüsse prüfen:**

    ```bash
    # Ensure not accidentally excluding target files
    glob("**/*.js", exclude=["**/dist/**", "**/node_modules/**"])
    ```

    **Groß-/Kleinschreibung:**

    ```bash
    # Use case-insensitive search if needed
    grep_content("pattern", case_insensitive=true)
    ```
  </Tab>
</Tabs>

***

## Probleme mit Subagenten und Konfiguration [#probleme-mit-subagenten-und-konfiguration]

<Tabs>
  <Tab title="Subagent wird nicht aufgerufen">
    ### Subagent wird nicht aufgerufen [#subagent-wird-nicht-aufgerufen]

    **Problem:** Ein benutzerdefinierter Subagent wird nicht automatisch aktiviert

    **Checkliste:**

    * Dateispeicherort: `~/.verdent/subagents/[name].md`
    * Gültiges YAML-Frontmatter mit `name` und `description`
    * Aufrufrichtlinie entspricht der Nutzung (bei „strict“ ist eine @-Erwähnung erforderlich)
    * Die Hinweise „Wann verwenden“ entsprechen dem Anfragemuster
    * Keine Syntaxfehler in der Markdown-Datei

    **Manuell testen:**

    ```
    @subagent-name perform task
    ```

    <Tip>
      Verwenden Sie eine explizite @-Erwähnung, um zu prüfen, ob der Subagent funktioniert, bevor Sie die automatische Aufrufung untersuchen.
    </Tip>
  </Tab>

  <Tab title="Integrierte Subagenten">
    ### Verhalten integrierter Subagenten [#verhalten-integrierter-subagenten]

    **Problem:** @Explorer, @Verifier oder @Code-reviewer verhalten sich nicht wie erwartet

    **Häufige Ursachen:**

    * Die Anfrage entspricht nicht der Spezialisierung des Subagenten
    * Kontext des Subagenten ist voll (selten)
    * Der Hauptkonversationskontext beeinflusst das Routing

    **Lösung:**

    * Verwenden Sie eine explizite @-Erwähnung, um einen bestimmten Subagenten zu erzwingen
    * Formulieren Sie die Anfrage um, damit sie zur Expertise des Subagenten passt
    * Starten Sie bei Kontextproblemen eine neue Konversation
  </Tab>

  <Tab title="AGENTS.md-Regeln">
    ### AGENTS.md wird nicht angewendet [#agentsmd-wird-nicht-angewendet]

    **Problem:** Projektregeln beeinflussen das Verhalten von Verdent nicht

    **Diagnose:**

    1. **Speicherort:** Die Datei muss sich im Stammverzeichnis des Projekts befinden
    2. **Syntax:** Gültiges Markdown (auf Syntaxfehler prüfen)
    3. **Eindeutigkeit:** Regeln müssen direktiv formuliert sein: „Immer X verwenden“ statt „Versuchen Sie, X zu verwenden“
    4. **Test:** Starten Sie eine neue Konversation, um die Anwendung neu zu testen

    **Rangfolge prüfen:**

    ```markdown
    # In AGENTS.md (highest priority)
    - Use 4-space indentation

    # In VERDENT.md (lower priority)
    - Use 2-space indentation

    # Result: 4-space indentation (AGENTS.md wins)
    ```
  </Tab>

  <Tab title="MCP-Verbindung">
    ### Verbindungsfehler bei MCP [#verbindungsfehler-bei-mcp]

    **Fehler:** Verbindung zum MCP-Server nicht möglich

    **Diagnoseschritte:**

    1. **mcp.json prüfen:** Gültige JSON-Syntax in `~/.verdent/mcp.json`
    2. **Server läuft:** Sicherstellen, dass der MCP-Serverprozess aktiv ist
    3. **Netzwerk:** Konnektivität zum Server-Endpunkt prüfen
    4. **Authentifizierung:** Bestätigen, dass die Anmeldedaten korrekt sind
    5. **Protokolle:** Serverprotokolle von MCP auf Fehlerdetails prüfen

    **Häufige Lösungen:**

    * MCP-Server neu starten
    * Format der Verbindungszeichenfolge prüfen
    * Firewall-Regeln prüfen, die MCP-Datenverkehr zulassen
    * API-Schlüssel oder Token validieren
  </Tab>
</Tabs>

***

## Bekannte Probleme und Workarounds [#bekannte-probleme-und-workarounds]

<Tabs>
  <Tab title="Binärdateien">
    ### Einschränkungen bei Binärdateien [#einschränkungen-bei-binärdateien]

    **Problem:** Bilder, PDFs oder kompilierte Binärdateien können nicht bearbeitet werden

    **Workaround:**

    ```bash
    # Use bash to call external tools
    bash("convert input.png -resize 50% output.png")
    bash("pdftotext document.pdf output.txt")
    ```

    <Info>
      Änderungen an Binärdateien erfordern externe, über bash-Befehle aufgerufene Werkzeuge.
    </Info>
  </Tab>

  <Tab title="Große Dateien">
    ### Umgang mit großen Dateien [#umgang-mit-großen-dateien]

    **Problem:** Dateien mit mehr als 10.000 Zeilen verursachen Kontextprobleme

    **Workaround:**

    ```bash
    # Always use line ranges for large files
    file_read("large.log", start_line=1000, max_lines=100)

    # Search first to find relevant sections
    grep_content("ERROR", glob="large.log")
    ```

    <Tip>
      Suchen Sie zunächst mit grep\_content nach den relevanten Zeilennummern und lesen Sie danach nur die betreffenden Bereiche.
    </Tip>
  </Tab>

  <Tab title="Plattformunterschiede">
    ### Plattformübergreifende Befehlsunterschiede [#plattformübergreifende-befehlsunterschiede]

    **Problem:** bash-Befehle unterscheiden sich zwischen Windows und Unix

    **Workaround:**

    ```bash
    # Use cross-platform tools when possible
    bash("npm run build")  # Works everywhere

    # Or conditional execution
    bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then ...; fi")
    ```

    **Empfehlung:** Verwenden Sie npm-Skripte für plattformübergreifende Kompatibilität.
  </Tab>
</Tabs>

***

## Weitere Unterstützung erhalten [#weitere-unterstützung-erhalten]

### Support-Kanäle [#support-kanäle]

**Für spezifische Probleme, die hier nicht behandelt werden:**

* **E-Mail:** [support@verdent.ai](mailto:support@verdent.ai)
* **Discord:** [Treten Sie der Verdent-Community bei](https://discord.com/invite/NGjXEZcbJq) für Support in Echtzeit
* **GitHub-Issues:** Fehler melden oder Funktionen anfragen

**Bitte geben Sie bei der Meldung von Problemen Folgendes an:**

1. Verdent-Version (aus dem Erweiterungsbereich)
2. VS Code-Version
3. Betriebssystem
4. Fehlermeldungen (genauer Wortlaut)
5. Schritte zur Reproduktion
6. Erwartetes und tatsächliches Verhalten

***

### Sammlung von Diagnoseinformationen [#sammlung-von-diagnoseinformationen]

**So helfen Sie dem Support bei der Diagnose:**

```bash
# VS Code version
bash("code --version")

# System info
bash("uname -a")  # Unix
bash("systeminfo")  # Windows

# Verdent logs location
# Check VS Code Output panel → Verdent
```

***

## Siehe auch [#siehe-auch]

<CardGroup cols="2">
  <Card title="FAQ" icon="circle-question" href="/docs/verdent-for-vscode/help-support/faqs">
    Häufig gestellte Fragen
  </Card>

  <Card title="Einschränkungen" icon="triangle-exclamation" href="/docs/verdent-for-vscode/help-support/limitations">
    Bekannte Einschränkungen und Beschränkungen
  </Card>
</CardGroup>