Häufig gestellte Fragen

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.

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. Das Support-Team prüft Ihr Konto und hilft bei der Lösung des Problems.

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. Das Support-Team kann Ihre Registrierung prüfen und Ihnen Hinweise zur Lösung des Problems geben.

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, 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.

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.

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

Mindestanforderungen:

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

Plattformunterstützung: macOS, Windows, Linux, WSL

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.

Ö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:

code --version

Siehe Credits & Tarife für die gemeinsame Definition von Credits, Preisstufen und grundlegender Nutzung über alle Verdent-Produkte hinweg.

Siehe Was passiert, wenn Ihre Credits aufgebraucht sind für die gemeinsame Kontorichtlinie und Wiederherstellungsoptionen.

Ü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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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.

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/:

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

Anwendungsfälle: Domänenspezifisches Fachwissen (Finanzen, Gesundheitswesen), Team-Workflows, Technologie-Spezialisten.

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.

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.

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.

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.

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).

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.

Ja! Erstellen Sie benutzerdefinierte Subagenten in ~/.verdent/subagents/:

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

Anwendungsfälle: Domänenspezifisches Fachwissen (Finanzen, Gesundheitswesen), Team-Workflows, Technologie-Spezialisten.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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