# Häufig gestellte Fragen (/de/docs/verdent-for-vscode/help-support/faqs)

> Häufige Fragen zu den Funktionen, Fähigkeiten und der Nutzung von Verdent for VS Code



Antworten auf häufig gestellte Fragen zu den Funktionen, Fähigkeiten und der Nutzung von Verdent.

***

## Erste Schritte [#erste-schritte]

<Tip>
  Schließen Sie den Schnellstart-Guide ab, bevor Sie sich mit erweiterten Funktionen befassen – er behandelt wesentliche Konzepte, die in der gesamten Dokumentation vorkommen.
</Tip>

***

## Häufige Probleme (Top 4) [#häufige-probleme-top-4]

<Accordion title="Warum kann ich mich nicht bei Verdent for VS Code anmelden?">
  **Häufigste Ursache:** Problem mit der Proxy-Konfiguration

  **Lösung:**

  1. Öffnen Sie die VS Code-Einstellungen (`Cmd+,` auf macOS oder `Ctrl+,` auf Windows/Linux)
  2. Suchen Sie nach "useProxy" oder "verdent.enableProxy"
  3. Schalten Sie die Proxy-Einstellung um (Gegenteil des aktuellen Zustands)
  4. Versuchen Sie erneut, sich anzumelden

  **Erklärung:** Wenn Sie sich hinter einer Unternehmens-Firewall befinden, müssen Sie möglicherweise die Proxy-Einstellung aktivieren. In einem Heimnetzwerk sollten Sie versuchen, sie zu deaktivieren.
</Accordion>

<Accordion title="Warum habe ich meine kostenlosen Testguthaben (Credits) nicht erhalten?">
  **Fehler:** Kostenlose Testguthaben wurden nicht erhalten oder der Zugriff auf die kostenlose Testversion wurde verweigert

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

  **Lösung:** Wenden Sie sich für Unterstützung beim Zugriff auf Ihre kostenlose Testversion an [support@verdent.ai](mailto:support@verdent.ai). Das Support-Team prüft Ihr Konto und hilft bei der Lösung des Problems.
</Accordion>

<Accordion title="Warum ist meine Registrierung fehlgeschlagen?">
  **Fehler:** Die Kontoregistrierung wurde abgelehnt oder eingeschränkt

  **Grund:** Die Registrierung verstieß gegen die Nutzungsbedingungen von Verdent, was zu einer Zugriffsbeschränkung führte

  **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.
</Accordion>

<Accordion title="Warum finde ich Claude, GPT oder Gemini-Modelle nicht?">
  **Problem:** Bestimmte KI-Modelle sind im Modellauswahlmenü nicht auffindbar

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

  **Erklärung:** Einige Anbieter von KI-Modellen (Anthropic, OpenAI, Google) unterliegen regionalen Einschränkungen, die verhindern, dass bestimmte Modelle an bestimmten geografischen Standorten 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
  * Ihr Abonnementtarif und Ihre Credits sind davon nicht betroffen

  **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

  **Hinweis:** Regionale Einschränkungen werden von den Anbietern der KI-Modelle festgelegt, nicht von Verdent. Verdent kann diese Einschränkungen nicht außer Kraft setzen.
</Accordion>

***

<Accordion title="Was ist Visual Studio Code?">
  Visual Studio Code ist ein kostenloser, quelloffener Code-Editor, der von Microsoft entwickelt wurde. Es handelt sich um eine schlanke, aber leistungsstarke Entwicklungsumgebung, die mehrere Programmiersprachen unterstützt und Funktionen wie Debugging, Syntaxhervorhebung, intelligente Codevervollständigung und integrierte Versionskontrolle bietet. Verdent integriert sich direkt als Erweiterung in Visual Studio Code und fügt Ihrem bestehenden Workflow KI-gestützte Coding-Funktionen hinzu.
</Accordion>

<Accordion title="Was ist Verdent for VS Code?">
  Verdent ist eine KI-Coding-Assistant-Erweiterung für Visual Studio Code, die durch natürlichsprachliche Konversationen bei Codegenerierung, Refactoring, Debugging und Projektnavigation unterstützt.

  **Wichtige Fähigkeiten:**

  * Codegenerierung und -änderung über Dateiwerkzeuge
  * Codebase-Exploration mit spezialisierten Subagenten
  * Befehlsausführung über Bash-Integration
  * Individuelle Erweiterbarkeit über Regeln und MCP-Server
</Accordion>

<Accordion title="Welche Systemanforderungen gibt es?">
  **Mindestanforderungen:**

  * Visual Studio Code 1.90.0 oder höher
  * Aktives Verdent-Abonnement
  * Internetverbindung

  **Plattformunterstützung:** macOS, Windows, Linux, WSL
</Accordion>

<Accordion title="Wie beginne ich mit der Nutzung von Verdent nach der Installation?">
  1. Installieren Sie die Erweiterung Verdent aus dem VS Code-Marketplace
  2. Melden Sie sich bei Aufforderung mit Ihrem Verdent-Konto an
  3. Öffnen Sie eine beliebige Codedatei oder ein Projekt
  4. Öffnen Sie die Chat-Ansicht und beginnen Sie das Gespräch mit Verdent

  **Vorschlag für die erste Aufgabe:** Bitten Sie Verdent, Ihre Projektstruktur zu erläutern oder eine bestimmte Datei zu überprüfen.
</Accordion>

<Accordion title="Wie überprüfe ich meine Visual Studio Code-Version?">
  Öffnen Sie Visual Studio Code und gehen Sie zu **Hilfe** → **Info** (oder **Code** → **Über Visual Studio Code** auf macOS). Die Versionsnummer wird im Dialogfeld angezeigt. Verdent erfordert Visual Studio Code Version 1.90.0 oder höher.

  Sie können dies auch über die Befehlszeile prüfen:

  ```bash
  code --version
  ```
</Accordion>

<Accordion title="Was sind Credits?">
  Siehe [Credits & Tarife](/docs/account-billing/credits-and-plans) für die gemeinsame Definition von Credits, Preisstufen und grundlegender Nutzung über alle Verdent-Produkte hinweg.
</Accordion>

<Accordion title="Was passiert, wenn mir die Credits ausgehen?">
  Siehe [Was passiert, wenn Ihre Credits aufgebraucht sind](/docs/account-billing/run-out-of-credits) für die gemeinsame Kontorichtlinie und Wiederherstellungsoptionen.
</Accordion>

<Accordion title="Lädt Verdent meine Bilder auf externe Server hoch?">
  Über die Zwischenablage eingefügte oder per Dateipfad referenzierte Bilder werden innerhalb Ihrer Konversationssitzung verarbeitet. Bilder werden nicht dauerhaft gespeichert und beim Start einer neuen Konversation gelöscht. Dateipfad-Referenzen lesen das Bild lokal, ohne es hochzuladen.
</Accordion>

<Accordion title="Was ist Plan Mode?">
  Plan Mode ist ein schreibgeschützter Ausführungsmodus, in dem Verdent Code analysiert, Recherchen durchführt und detaillierte Umsetzungspläne erstellt, ohne Dateien zu ändern oder Befehle auszuführen. Nach der Erstellung eines Plans bietet Verdent zwei Optionen an: **Bearbeiten** (um Änderungen anzufordern und den Plan zu verfeinern) oder **Umsetzung starten** (um zu Agent Mode zu wechseln und die Ausführung zu beginnen). Der Agent kann klärende Fragen stellen, um Unklarheiten vor der Ausführung zu beseitigen. Dieser Modus eignet sich ideal für komplexe Aufgaben, bei denen Sie den Ansatz überprüfen möchten, bevor Sie sich auf Änderungen festlegen, um sicherzustellen, dass Ihre Erwartungen mit der von Verdent vorgeschlagenen Lösung übereinstimmen.
</Accordion>

<Accordion title="Schreibt Plan Mode tatsächlich Code in meine Dateien?">
  **Nein.** Plan Mode ist strikt schreibgeschützt:

  * Verdent kann Dateien lesen, Code durchsuchen und Ihre Codebasis analysieren
  * **Es finden keine Dateischreibvorgänge, -änderungen oder -löschungen** während Plan Mode statt
  * Pläne werden nur in der Chat-Ansicht angezeigt
  * Die Codeausführung beginnt erst, nachdem Sie ausdrücklich zugestimmt und zu Agent Mode gewechselt haben

  **Sicherheitsgarantie:** Plan Mode kann Ihren Code nicht versehentlich ändern. Es ist für sicheres Erkunden und die Entwicklung von Strategien konzipiert.
</Accordion>

<Accordion title="Wie wechsle ich zwischen Plan Mode und Agent Mode?">
  **Der Wechsel erfolgt sofort über das Eingabefeld:**

  **So aktivieren Sie Plan Mode:**

  * Klicken Sie im Eingabefeld auf die Schaltfläche **Switch Mode**
  * Wählen Sie **Plan Mode** aus dem Dropdown-Menü
  * ODER sagen Sie: "Switch to Plan Mode"

  **So beenden Sie Plan Mode:**

  * Klicken Sie im Eingabefeld auf die Schaltfläche **Switch Mode**
  * Wählen Sie **Agent Mode** aus dem Dropdown-Menü
  * ODER wählen Sie **Umsetzung starten**, nachdem Sie einen Plan überprüft haben

  **Beibehaltung des Modus:**

  * Die Modusauswahl bleibt innerhalb der aktuellen Sitzung erhalten
  * Neue Sitzungen starten im Standardmodus Agent Mode
  * Sie können den Modus jederzeit frei wechseln

  **Typischer Workflow:** Plan Mode → Überprüfen → Agent Mode → Ausführen → zurück zu Plan Mode für die nächste komplexe Funktion.
</Accordion>

<Accordion title="Wie starte ich eine neue Konversation mit sauberem Kontext?">
  Klicken Sie auf die Schaltfläche "New Session" in der oberen Leiste. Dies löscht den aktuellen Konversationsverlauf und gibt Verdent ein frisches Kontextfenster für Ihre nächste Aufgabe.
</Accordion>

<Accordion title="Kann ich Verdent gleichzeitig in mehreren Projekten verwenden?">
  Ja, jedes VS Code-Fenster arbeitet unabhängig. Sie können Verdent in mehreren Projekten geöffnet haben, wobei jedes seinen eigenen, separaten Konversationskontext beibehält.
</Accordion>

<Accordion title="Funktioniert Verdent mit GitHub, GitLab, Bitbucket und anderen Git-Plattformen?">
  Ja. Verdent verwendet Standard-Git-Befehle, sodass es mit jedem Git-Repository unabhängig von der Hosting-Plattform funktioniert. Zum Erstellen von Pull Requests verwendet Verdent die `gh`-CLI, die GitHub erfordert, aber alle anderen Git-Operationen funktionieren universell.
</Accordion>

***

## Werkzeuge & Fähigkeiten [#werkzeuge--fähigkeiten]

<Accordion title="Mit welchen Dateiformaten kann Verdent arbeiten?">
  **Unterstützt:** Alle textbasierten Dateiformate, einschließlich:

  * Quellcode (JavaScript, Python, TypeScript, Java, Go usw.)
  * Konfigurationsdateien (JSON, YAML, TOML, XML, ENV)
  * Dokumentation (Markdown, HTML, LaTeX)
  * Build-Dateien (package.json, Makefile, requirements.txt)

  **Nicht unterstützt:** Binärdateien (Bilder, Videos, PDFs, kompilierte Binärdateien, Office-Dokumente)

  **Umgehungslösung:** Binärdateien im Code referenzieren, aber Änderungen erfordern externe Werkzeuge.
</Accordion>

<Accordion title="Welche Programmiersprachen unterstützt Verdent am besten?">
  **Ausgezeichnete Unterstützung:**

  * JavaScript, TypeScript, Python, React, Vue, Angular
  * Node.js, Go, Java/Spring, C#/.NET
  * Swift, Kotlin, Flutter

  **Sehr gute Unterstützung:** Rust, C/C++, Ruby, R

  **Gute Unterstützung:** PHP, Assembly, Julia

  Verbreitete Sprachen werden aufgrund der umfangreichen Trainingsdaten stärker unterstützt.
</Accordion>

<Accordion title="Wie liest und ändert Verdent Dateien?">
  Drei Werkzeuge für Dateioperationen:

  * **file\_read:** Vollständige Dateien oder bestimmte Zeilenbereiche lesen
  * **file\_edit:** Bestimmte Textmuster ersetzen (gezielte Änderungen)
  * **file\_write:** Neue Dateien erstellen oder vollständige Dateien neu schreiben

  **Best Practice:** Verwenden Sie `file_edit` für Änderungen und `file_write` ausschließlich für neue Dateien.
</Accordion>

<Accordion title="Was ist Befehlsausführung?">
  Das Ausführen von Terminalbefehlen oder Shell-Skripten über Verdent, einschließlich Operationen wie dem Ausführen von Tests, der Installation von Paketen oder der Ausführung von Build-Befehlen. Die Befehlsausführung erfordert in den meisten Berechtigungsmodi eine Genehmigung, um unbeabsichtigte Systemänderungen zu verhindern.
</Accordion>

<Accordion title="Kann Verdent Befehle in meinem Terminal ausführen?">
  Ja, über das Werkzeug `bash`. Verdent kann Terminalbefehle ausführen mit:

  * Maximales Timeout: 120 Sekunden (2 Minuten)
  * Befehlsverkettung mit `&&`
  * Plattformübergreifende Unterstützung (Bash auf Unix, PowerShell auf Windows)

  **Sicherheit:** Befehle werden mit Ihren Benutzerberechtigungen ausgeführt. Nutzen Sie Manual Accept Mode, um sie vor der Ausführung zu überprüfen.
</Accordion>

<Accordion title="Wie lange können Bash-Befehle laufen?">
  **Maximales Timeout:** 120 Sekunden (2 Minuten)

  Befehle, die 2 Minuten überschreiten, werden automatisch beendet. Für länger dauernde Vorgänge sollten Sie Folgendes erwägen:

  **Alternativen:**

  * In kleinere Befehle aufteilen: `bash("task1") && bash("task2")`
  * In kleinere Operationen aufteilen
  * Im Hintergrund ausführen und Ergebnisse separat prüfen
</Accordion>

<Accordion title="Was ist der Multipass-Generate-Test-Repair-Zyklus?">
  Ein iterativer Verifizierungsprozess, bei dem Code generiert, getestet und repariert wird, bis er eine umfassende Prüfung besteht. Verdent führt automatisch Tests aus, analysiert Fehler, behebt Probleme und testet in mehreren Durchgängen erneut, bis der Code korrekt funktioniert. Dies liefert produktionsreifen Code, nicht nur Vorschläge. Jedes Ergebnis enthält detaillierte Zusammenfassungen und Code-Diffs, die genau zeigen, was geändert wurde.
</Accordion>

<Check>
  Multipass-Testzyklen beheben und testen Code automatisch erneut, bis er die Prüfung besteht – so stellt Verdent die Produktionsreife sicher.
</Check>

***

## Subagenten & Ausführung [#subagenten--ausführung]

<Accordion title="Was sind Subagenten und wann sollte ich sie verwenden?">
  Subagenten sind spezialisierte KI-Agenten mit isolierten Kontextfenstern für bestimmte Aufgaben.

  **Integrierte Subagenten:**

  * **@Explorer:** Codebase-Suchen, Architekturfragen
  * **@Verifier:** Schnelle Validierungsprüfungen
  * **@Code-reviewer:** Sicherheits- und Qualitätsüberprüfungen

  **Wann verwenden:** Delegieren Sie Recherche-, Validierungs- oder Überprüfungsaufgaben, um Kontext in der Hauptkonversation zu sparen.

  **So erstellen Sie benutzerdefinierte Subagenten:**

  Erstellen Sie eine Markdown-Datei in `~/.verdent/subagents/`:

  ```markdown
  ---
  name: your-subagent
  description: Purpose description
  ---
  # System Prompt
  [Behavior definition and expertise]
  ```

  **Anwendungsfälle:** Domänenspezifisches Fachwissen (Finanzen, Gesundheitswesen), Team-Workflows, Technologie-Spezialisten.
</Accordion>

<Accordion title="Was ist Kontextverschmutzung?">
  Wenn frühere Aktionen und Informationen im Kontext unbeabsichtigte Verhaltensmuster erzeugen, die zukünftige Aufgaben beeinflussen. Wenn Sie beispielsweise wiederholt Code aktualisieren und ihn dann bereitstellen, kann der Agent beginnen, alle Code-Updates mit einer sofortigen Bereitstellung zu assoziieren, selbst wenn Sie nur experimentieren. Subagenten verhindern Kontextverschmutzung, indem sie mit isolierten Kontextfenstern arbeiten, sodass jede spezialisierte Aufgabe mit einem sauberen Kontext beginnen kann und eine Kreuzkontamination zwischen verschiedenen Arten von Arbeit vermieden wird.
</Accordion>

<Accordion title="Wie erkenne ich, in welchem Ausführungsmodus ich mich gerade befinde?">
  Sehen Sie sich das Eingabefeld unten im Verdent-Panel an. Die Schaltfläche "Switch Permission" zeigt Ihren aktuellen Modus an (z. B. "Manual", "Auto", "Plan"). Sie können darauf klicken, um den Modus zu wechseln.
</Accordion>

<Accordion title="Was ist der Unterschied zwischen Auto-Run Mode und Manual Accept Mode?">
  **Auto-Run Mode:**

  * Dateioperationen werden automatisch ohne Genehmigung ausgeführt
  * Befehle erfordern weiterhin eine Berechtigung
  * Schnellerer Workflow für vertrauenswürdige Codebasen
  * Am besten geeignet für Einzelprojekte mit Versionskontrolle

  **Manual Accept Mode:**

  * Jede geschützte Operation wird überprüft und genehmigt
  * Sicherer für gemeinsam genutzte Codebasen oder Produktionsumgebungen
  * Sie sehen genau, was vor der Ausführung ausgeführt wird

  Wechseln Sie den Modus über die Einstellungen oder die Befehlspalette.
</Accordion>

<Accordion title="Was sind sichere Operationen?">
  Operationen, die Daten nur lesen, ohne Änderungen vorzunehmen: Dateilesevorgänge und Websuchen. Diese werden in Auto-Run Mode automatisch genehmigt, während Dateiänderungen und Befehlsausführungen aus Sicherheitsgründen weiterhin eine Genehmigung erfordern.
</Accordion>

<Accordion title="Kann ich mehrere Berechtigungsmodi gleichzeitig verwenden?">
  Nein, Berechtigungsmodi schließen sich gegenseitig aus – Sie können jeweils nur EINEN verwenden:

  * **Manual Accept** – Standard, maximale Kontrolle
  * **Auto-Run** – Optimiert für vertrauenswürdige Projekte
  * **Plan** – Schreibgeschützter Planungsmodus
  * **Skip Permissions** – Volle Autonomie

  Sie können den Modus über die Schaltfläche **Switch Permission** im Eingabefeld sofort wechseln. Die meisten Nutzer wechseln je nach Aufgabenkontext zwischen den Modi (z. B. Plan Mode für komplexe Funktionen, Auto-Run für schnelle Korrekturen).
</Accordion>

<Accordion title="Wann sollte ich den Explorer-Agent verwenden, statt Dateien direkt zu laden?">
  Verwenden Sie den Explorer-Agent für Entdeckungs- und Suchaufgaben, ohne den Hauptkontext zu belegen. Laden Sie Dateien nur dann direkt über @-Erwähnungen, wenn Sie sie ändern müssen. Explorer ist ideal für Fragen wie "Finde alle Dateien, die...", während @-Erwähnungen für Aufgaben wie "Aktualisiere diese bestimmte Datei" geeignet sind.
</Accordion>

<Accordion title="Kann ich benutzerdefinierte Subagenten für mein Projekt erstellen?">
  Ja! Erstellen Sie benutzerdefinierte Subagenten in `~/.verdent/subagents/`:

  ```markdown
  ---
  name: your-subagent
  description: Purpose description
  ---
  # System Prompt
  [Behavior definition and expertise]
  ```

  **Anwendungsfälle:** Domänenspezifisches Fachwissen (Finanzen, Gesundheitswesen), Team-Workflows, Technologie-Spezialisten.
</Accordion>

<Accordion title="Kann ich Verdent mitten in einer mehrstufigen Aufgabe anhalten?">
  Ja. Sie können die Ausführung jederzeit unterbrechen. Verdent wird den aktuellen Schritt, an dem gerade gearbeitet wird, abschließen und dann stoppen. Der bis dahin erzielte Fortschritt bleibt erhalten. Sie können überprüfen, was bereits erledigt wurde, Anpassungen vornehmen und entweder fortfahren oder einen anderen Ansatz wählen.
</Accordion>

<Accordion title="Wie erkenne ich, was Verdent gerade in einer langen Aufgabe tut?">
  Beobachten Sie die Aufgabenliste (Todo-Liste). Sie zeigt den Status in Echtzeit an, wobei jeweils ein Element als "in Bearbeitung" markiert ist. Das aktive Element zeigt genau, an was Verdent gerade arbeitet. Abgeschlossene Elemente sind als erledigt markiert, und ausstehende Elemente zeigen, was noch übrig ist.
</Accordion>

<Accordion title="Committet Verdent meine Änderungen automatisch?">
  Nein. Verdent erstellt Commits nur, wenn Sie diese ausdrücklich anfordern. Sie behalten die volle Kontrolle darüber, wann Änderungen committet werden. Fragen Sie einfach "Alle Änderungen stagen und einen Commit erstellen", wenn Sie bereit sind.
</Accordion>

<Accordion title="Pusht Verdent Änderungen ohne Rückfrage zu Remote-Repositorys?">
  Nein. Verdent pusht nur zu Remote-Repositorys, wenn Sie dies ausdrücklich anfordern. Alle Git-Operationen (Commit, Push, Merge, Rebase) erfordern aus Sicherheitsgründen Ihre ausdrückliche Anweisung.
</Accordion>

***

## Anpassung & Integration [#anpassung--integration]

<Accordion title="Wie passe ich das Verhalten von Verdent für mein Team an?">
  Drei Anpassungsmethoden:

  1. **VERDENT.md:** Persönliche globale Einstellungen (`~/.verdent/VERDENT.md`)
  2. **AGENTS.md:** Projektspezifische Team-Standards (Projektstammverzeichnis, versionskontrolliert)
  3. **plan\_rules.md:** Ausgabeformat für Plan Mode (`~/.verdent/plan_rules.md`)

  AGENTS.md hat für die Team-Konsistenz Vorrang vor VERDENT.md.
</Accordion>

<Accordion title="Wann werden Konfigurationsänderungen wirksam?">
  Die meisten Verdent-Einstellungen werden sofort wirksam, ohne dass ein Neustart erforderlich ist:

  * **Berechtigungsmodi:** Sofortiger Wechsel über das Eingabefeld
  * **Modell-Voreinstellungen:** Wirksam ab der nächsten Anfrage
  * **Regeldateien:** Wirksam für neue Konversationen (Speichern löst ein Neuladen aus)
  * **Subagenten:** Sofort nach der Erstellung verfügbar
  * **Tastenkombinationen:** Wirksam nach dem Speichern in VS Code

  **Ausnahme:** Einstellungen der VS Code-Erweiterung (wie `verdent.enableCheckpoints`) werden sofort wirksam, erfordern aber möglicherweise ein erneutes Öffnen von Dateien oder Sitzungen für die vollständige Anwendung.
</Accordion>

<Accordion title="Was ist MCP und wie verwende ich es?">
  Model Context Protocol (MCP) erweitert Verdent um externe Werkzeuge und Dienste:

  **Konfiguration:** `~/.verdent/mcp.json` über Einstellungen → MCP-Server

  **Fähigkeiten:**

  * Datenbankverbindungen (PostgreSQL, MySQL, MongoDB)
  * Cloud-Dienste (AWS, Azure, GCP)
  * Projektmanagement-Werkzeuge (Jira, Linear)
  * CI/CD-Pipelines (Jenkins, GitHub Actions)

  **Status:** Integrationsdokumentation für MCP in Entwicklung. Wenden Sie sich für Unterstützung bei der Einrichtung an [support@verdent.ai](mailto:support@verdent.ai).
</Accordion>

***

## Best Practices & Leistung [#best-practices--leistung]

<Tip>
  Überwachen Sie die Credit-Nutzung im Benutzerbereich (User Center), um Verbrauchsmuster zu verfolgen und Ihren Workflow für mehr Effizienz zu optimieren.
</Tip>

<Accordion title="Was ist ein Token?">
  Die Maßeinheit für Kontextfenster. Tokens repräsentieren Textteile (Wörter, Wortbestandteile oder Zeichen), die das KI-Modell verarbeitet. Kontextgrenzen werden in Tokens statt in Zeichen oder Wörtern gemessen, wobei typische Konversationen tausende Tokens verbrauchen.
</Accordion>

<Accordion title="Was zählt zu meinem Kontextfenster?">
  Alles in Ihrer Sitzung: alle Nachrichten in der Konversation, in den Kontext geladene Dateiinhalte, Werkzeugausgaben (Grep-/Suchergebnisse, Dateilesevorgänge), Systemprompts und -anweisungen sowie MCP-Serverdefinitionen. Jedes davon verbraucht Tokens Ihrer gesamten Kontextkapazität.
</Accordion>

<Accordion title="Was ist der Unterschied zwischen 200K- und 1M-Kontextfenstern?">
  Standardmodelle (Claude 4.5 Sonnet, Haiku, GPT-5, GPT-5-Codex, MiniMax-M2) verfügen über Kontextfenster mit `200K` Tokens, die für die meisten Aufgaben ausreichen. Claude Sonnet 4.5 bietet einen erweiterten Kontext mit `1M` Tokens (5-mal größer) für große Codebasen mit `1000+` Dateien, komplexem dateiübergreifendem Refactoring oder langen Entwicklungssitzungen. Der erweiterte Kontext (`1M`) aktiviert sich automatisch, wenn die Eingabe `200K` Tokens überschreitet, oder kann explizit ausgewählt werden.
</Accordion>

<Accordion title="Wie viele Dateien kann ich sicher in den Kontext laden?">
  Es gibt kein festes Dateilimit – es hängt von den Dateigrößen und der Gesamtzahl der Tokens ab. Vermeiden Sie bei Kontexten mit `200K` das Laden von `20+` großen Dateien (jeweils `>1000` Zeilen). Konzentrieren Sie sich auf Dateien, die für Ihre aktuelle Aufgabe direkt relevant sind. Verwenden Sie `@-mentions` selektiv und nutzen Sie `AGENTS.md`-Dokumentation, statt viele Beispieldateien zu laden. Bei Kontext mit `1M` wird die Dateiauswahl deutlich weniger kritisch.
</Accordion>

<Accordion title="Wie erkenne ich, wann ich mich den Kontextgrenzen nähere?">
  Anzeichen dafür sind langsamere Antwortzeiten, Sitzungen, die mehrere Stunden laufen, oder viele geladene große Dateien. Überwachen Sie Ihre Sitzungsdauer und Dateianzahl. Wenn Sie eine Leistungsverschlechterung feststellen, schließen Sie Ihre aktuelle Aufgabe ab, committen Sie Ihren Fortschritt und starten Sie eine neue Sitzung mit sauberem Kontext.
</Accordion>

<Accordion title="Wie vermeide ich eine Erschöpfung des Kontextfensters?">
  **Strategien:**

  1. **Strategisches Dateilesen:** Verwenden Sie Zeilenbereiche für große Dateien
  2. **An Subagenten delegieren:** Explorer/Verifier für Hintergrundrecherche
  3. **Vor dem Lesen suchen:** Verwenden Sie `grep_file`, um relevante Dateien zu identifizieren
  4. **Operationen aufteilen:** Verwenden Sie `todo_update`, um mehrstufige Aufgaben zu verfolgen

  **Faustregel:** Dateien mit über 500 Zeilen sollten Zeilenbereiche verwenden.
</Accordion>

<Accordion title="Sollte ich den Kontext manuell zurücksetzen, oder erledigt Verdent das automatisch?">
  Sie müssen manuell eine neue Sitzung starten, um den Kontext zurückzusetzen – Verdent löscht den Kontext nicht automatisch. Best Practice: Setzen Sie den Kontext zurück, nachdem Sie eine in sich geschlossene Arbeitseinheit abgeschlossen, getestet und in die Versionskontrolle committet haben. Bei Kontexten mit `1M` Tokens sind Rücksetzungen deutlich seltener erforderlich.
</Accordion>

<Accordion title="Geht durch das Zurücksetzen des Kontexts meine Arbeit verloren?">
  Nein – das Zurücksetzen des Kontexts löscht nur den Konversationsverlauf und die aus dem Speicher geladenen Dateien. Ihre tatsächlichen Codeänderungen, Commits und Dateiänderungen bleiben erhalten. Committen Sie Ihre Arbeit vor dem Zurücksetzen des Kontexts sicherheitshalber immer in die Versionskontrolle. Zurücksetzen → neue Sitzung starten → mit der nächsten Aufgabe weiterarbeiten.
</Accordion>

<Accordion title="Wie spezifisch sollten meine Prompts sein?">
  Seien Sie spezifisch genug, um Mehrdeutigkeiten auszuschließen, aber erklären Sie offensichtliche Details nicht übermäßig. Geben Sie Folgendes an: genaue Dateipfade, den Umsetzungsansatz, erwartete Ergebnisse und Einschränkungen. Schlecht: "Behebe den Code" – zu vage. Gut: "Füge dem E-Mail-Feld in `ContactForm.js` eine Eingabevalidierung hinzu, um ungültige E-Mail-Formate abzulehnen" – klarer Umfang und klares Ziel. Im Zweifelsfall lieber zu spezifisch als zu vage sein.
</Accordion>

<Accordion title="Was ist der Unterschied zwischen @-Erwähnungen und automatischem Dateiladen?">
  Verdent lädt automatisch Dateien, die in Prompts namentlich erwähnt werden, sowie verwandte Dateien im selben Verzeichnis. `@-mentions` (`@filename.js`) garantieren ausdrücklich, dass sich eine Datei im Kontext befindet, was entscheidend ist, wenn Sie mit eng verknüpften Dateien arbeiten, Muster aus einer Datei referenzieren, um sie auf eine andere anzuwenden, oder wenn die automatische Erkennung in großen Codebasen den Kontext möglicherweise übersieht. Verwenden Sie immer `@-mentions`, wenn Sie Verdent bitten, "dem gleichen Muster wie..." zu folgen, um eine exakte Codereferenz sicherzustellen.
</Accordion>

<Accordion title="Muss ich den Projektkontext in jedem Prompt einer Sitzung wiederholen?">
  Nein – Verdent behält den Konversationskontext innerhalb einer Sitzung bei, sodass Sie bereits besprochene Architekturdetails oder Konventionen nicht wiederholen müssen. Bei kritischen Einschränkungen oder wenn Sitzungen sehr lang werden (`100+` Nachrichten), sollten Sie wichtigen Kontext jedoch erneut nennen. Besserer Ansatz: Verwenden Sie Projektregeln (`AGENTS.md`), um dauerhaften Kontext wie Tech-Stack, Coding-Standards und Muster zu dokumentieren – dann müssen Sie diese nie wiederholen.
</Accordion>

<Accordion title="Was, wenn Verdent meinen Prompt nicht richtig versteht oder befolgt?">
  Nutzen Sie iterative Verfeinerung: Überprüfen Sie die Ausgabe, identifizieren Sie, was falsch ist, und geben Sie dann Korrekturen in einem Folge-Prompt an. Beispiel: "Die Validierungslogik ist gut, aber verwende Joi-Schema-Validierung statt manueller Prüfungen. Entspreche dem Validierungsmuster in `ProductController.js`." Sie können auch um Erklärungen bitten: "Warum hast du Redux statt Context API verwendet?" und dann basierend auf dem Verständnis verfeinern. Wiederholen Sie nicht denselben Prompt – passen Sie ihn basierend auf dem an, was fehlgeschlagen ist.
</Accordion>

<Accordion title="Wann sollte ich Plan Mode statt des normalen Modus verwenden?">
  Verwenden Sie Plan Mode für: große Refactorings oder Architekturänderungen, dateiübergreifende Änderungen, bei denen Sie den Umfang vor der Ausführung überprüfen möchten, komplexe Aufgaben, bei denen Sie sich der Anforderungen nicht sicher sind, oder wenn Sie möchten, dass Verdent Sie vor der Umsetzung mit klärenden Fragen befragt. Verzichten Sie auf Plan Mode bei: einfachen, klar definierten Aufgaben, schnellen Fehlerkorrekturen oder Routineoperationen. Plan Mode bringt zusätzlichen Aufwand, verhindert aber kostspielige Fehler bei komplexer Arbeit.
</Accordion>

<Accordion title="Wie wähle ich die richtige Modell-Voreinstellung für meine Aufgabe?">
  Passen Sie die Modell-Voreinstellung an die Aufgabenkomplexität und das Budget an:

  **Efficiency verwenden (3,2-mal effizienter als Sonnet):**

  * Schnelle Fehlerkorrekturen und einfache Codegenerierung
  * Routineoperationen und häufig wiederkehrende Aufgaben
  * Wenn Geschwindigkeit wichtiger ist als Tiefe

  **Balance verwenden (1x Basislinie) – Standard:**

  * Allgemeine Entwicklung und alltägliches Coding
  * Funktionsimplementierung und Code-Reviews
  * Ausgewogene Leistung für die meisten Szenarien

  **Performance verwenden (0,5x Effizienz, 2x Kosten):**

  * Komplexe Architekturentscheidungen
  * Große Codebasen, die umfangreichen Kontext erfordern (200k+ Tokens)
  * Anspruchsvolles Debugging und Refactoring

  **Profi-Tipp:** Die meisten Nutzer behalten Balance als Standard und wechseln nur zu Performance, wenn sie an Kontextgrenzen stoßen oder tiefgreifendes Reasoning benötigen.
</Accordion>

***

## Fehlerbehebung [#fehlerbehebung]

<Accordion title="Wie behebe ich Firewall- oder Verbindungsprobleme?">
  Wenn Verdent keine Verbindung zu KI-Diensten herstellen kann, prüfen Sie diese häufigen Probleme:

  **Grundlegende Konnektivität testen:**

  * Überprüfen Sie, ob Sie aktiven Internetzugang haben
  * Versuchen Sie, auf andere HTTPS-Dienste zuzugreifen, um zu bestätigen, dass ausgehende Verbindungen funktionieren

  **Unternehmens-/Enterprise-Umgebungen:**

  * Wenden Sie sich an Ihren Netzwerkadministrator, um die API-Endpunkte von Verdent auf die Whitelist zu setzen
  * Stellen Sie sicher, dass ausgehender HTTPS-Verkehr durch Ihre Firewall zugelassen ist
  * Prüfen Sie, ob Proxyserver korrekt konfiguriert sind, um API-Anfragen durchzulassen
  * Bei der SSL/TLS-Inspektion sind möglicherweise Ausnahmen für Verdent-Endpunkte erforderlich

  **Häufige Symptome:**

  * Die Erweiterung scheint hängen zu bleiben oder ein Timeout zu haben
  * Authentifizierungsfehler trotz korrekter Anmeldedaten

  Wenn die Probleme nach der Firewall-Konfiguration weiterhin bestehen, wenden Sie sich an den Verdent-Support für konkrete Endpunktdetails zur Freigabe.
</Accordion>

<Accordion title="Meine AGENTS.md-Regeln werden nicht angewendet. Warum?">
  **Prüfen Sie:**

  * **Speicherort:** Datei im Projektstammverzeichnis
  * **Syntax:** Gültiges Markdown
  * **Spezifität:** Regeln sind direktiv ("Verwende immer..." statt "Versuche...")
  * **Neuer Test:** Starten Sie eine neue Konversation, um die Anwendung zu testen

  **Vorrang:** AGENTS.md hat für projektspezifisches Verhalten Vorrang vor VERDENT.md.
</Accordion>

<Accordion title="Wie behebe ich den Fehler 'file_edit failed to find exact match'?">
  **Ursachen:**

  * Text seit dem letzten Lesevorgang geändert
  * Unterschiede bei Leerzeichen (Leerzeichen vs. Tabulatoren)
  * String ist in der Datei nicht eindeutig

  **Lösungen:**

  * Datei erneut lesen, um den aktuellen Inhalt zu erhalten
  * Größeren Kontextstring für Eindeutigkeit angeben
  * Verwenden Sie `replace_all=true` für mehrere identische Strings
  * Überprüfen Sie, ob file\_path korrekt ist
</Accordion>

<Accordion title="Warum wird mein benutzerdefinierter Subagent nicht automatisch aufgerufen?">
  **Prüfen Sie:**

  * **Speicherort:** Datei in `~/.verdent/subagents/[name].md`
  * **Aufrufrichtlinie:** Strikte Richtlinie erfordert eine explizite @-Erwähnung
  * **YAML-Frontmatter:** Gültige Syntax
  * **"Wann verwenden"-Richtlinien:** Stimmen mit Ihrem Anfragemuster überein

  **Test:** Verwenden Sie eine explizite @-Erwähnung, um zu überprüfen, ob der Subagent funktioniert: `@your-subagent do task`
</Accordion>

***

## Siehe auch [#siehe-auch]

<CardGroup cols="2">
  <Card title="Werkzeugreferenz" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    Vollständige Werkzeugfähigkeiten
  </Card>

  <Card title="Fehlerbehebung" icon="triangle-exclamation" href="/docs/verdent-for-vscode/help-support/common-issues">
    Häufige Probleme und Lösungen
  </Card>
</CardGroup>