Konfiguration & Anpassung
Verdent an Ihren Workflow anpassen
Verdent for VS Code bietet umfangreiche Konfigurationsmöglichkeiten, um sich an Ihren Entwicklungsworkflow, Ihre Coding-Präferenzen und Teamstandards anzupassen. Konfigurieren Sie Einstellungen über die native Einstellungsoberfläche von VS Code, passen Sie Tastaturkürzel an und erstellen Sie Regeln und Subagenten für spezialisiertes Verhalten.
Was Sie lernen werden
- Konfigurieren der VS Code-Erweiterungseinstellungen für Verdent
- Anpassen von Tastaturkürzeln für einen effizienten Workflow
- Erstellen und Verwalten von Regeln für personalisiertes Agentenverhalten
- Erstellen benutzerdefinierter Subagenten für spezialisierte Aufgaben
Voraussetzungen
- Verdent for VS Code installiert und authentifiziert
- Zugriff auf die VS Code-Einstellungen (
Cmd+,oderCtrl+,) - Grundkenntnisse in JSON für Regeldateien (optional)
VS Code-Erweiterungseinstellungen
Die Einstellungen von Verdent for VS Code sind je nach Konfigurationstyp und -umfang an mehreren Stellen zugänglich.
Zugriff auf Einstellungen
Erweiterungseinstellungen (nativ in VS Code):
- Öffnen Sie die VS Code-Einstellungen:
Cmd+,(macOS) oderCtrl+,(Windows/Linux) - Suchen Sie in der Einstellungssuche nach „Verdent“
- Ändern Sie die Erweiterungseinstellungen (z. B.
verdent.enableCheckpoints)
Verdent-spezifische Einstellungen:
Klicken Sie auf die Schaltfläche Einstellungen in der oberen Leiste von Verdent, um Folgendes aufzurufen:
- Regeln – Benutzerregeln, Projektregeln, Plan-Regeln
- MCP-Server – Model-Context-Protocol-Konfigurationen
- Subagenten – Verwaltung benutzerdefinierter Subagenten
Steuerelemente im Chat:
Viele Einstellungen lassen sich direkt über das Eingabefeld unten im Verdent-Panel umschalten:
- Berechtigung wechseln – Manuelle Bestätigung, Auto-Run, Plan, Berechtigungen überspringen
- Modus wechseln – Agent-, Plan-, Chat-Modus
- KI-Modell wechseln/anpassen – Voreinstellungen für Performance, Balance, Efficiency
- Think Hard Mode – Maximales Denkbudget für komplexes Reasoning
- Kontext hinzufügen – Dateien über @-Erwähnungen anhängen
- Bilder oder Dateien hinzufügen – Screenshots oder Dokumente einfügen
- Subagent hinzufügen – Aufgaben an spezialisierte Subagenten delegieren
Einstellungsänderungen werden sofort wirksam, ohne dass ein Neustart von VS Code erforderlich ist.
Verfügbare Erweiterungseinstellungen
Verdent for VS Code bietet 2 zentrale Erweiterungseinstellungen, die über die Einstellungsoberfläche von VS Code konfiguriert werden können:
| Einstellung | Typ | Standard | Beschreibung |
|---|---|---|---|
verdent.enableCheckpoints | boolean | true | Ermöglicht der Erweiterung, während der Aufgabenbearbeitung Checkpoints des Arbeitsbereichs mittels Git zu speichern. Kann die Performance bei großen Arbeitsbereichen beeinträchtigen. |
verdent.enableProxy | boolean | true | Aktiviert Proxy-Unterstützung für Netzwerkverbindungen. Erforderlich für Nutzer hinter Unternehmens-Firewalls oder Proxy-Servern. |
Dies sind alle VS Code-Erweiterungseinstellungen für Verdent. Weitere Konfigurationsoptionen (Regeln, Subagenten, MCP-Server) werden über das Verdent-Einstellungsmenü in der oberen Leiste der Erweiterung verwaltet.
Referenz der Eingabefeld-Steuerelemente
Das Eingabefeld unten im Verdent-Panel bietet schnellen Zugriff auf Konfigurationssteuerelemente:
| Steuerelement | Zweck | Optionen |
|---|---|---|
| Kontext hinzufügen | Dateien über @-Erwähnungen anhängen | @Dateiname, @Ordnername |
| Bilder oder Dateien hinzufügen | Screenshots oder Dokumente einfügen | Bilder, PDFs, Textdateien hochladen |
| Subagent hinzufügen | An spezialisierte Agenten delegieren | @Verifier, @Explorer, @Code-reviewer, benutzerdefinierte Subagenten |
| Modus wechseln | Ausführungsmodus umschalten | Agent Mode, Plan Mode, Chat Mode |
| KI-Modell wechseln/anpassen | Modellvoreinstellung oder bestimmtes Modell auswählen | Performance (1-2-facher Preis), Balance (1-facher Preis), Efficiency (0,3-facher Preis) |
| Think Hard Mode | Erweitertes Reasoning aktivieren | Ein-/Ausschalten für komplexe Probleme |
| Berechtigung wechseln | Berechtigungsstufe ändern | Manuelle Bestätigung (Standard), Auto-Run, Plan, Berechtigungen überspringen |
Berechtigungsmodi
- Jede Operation erfordert eine Freigabe
- Vollständige Transparenz und Kontrolle
- Am besten geeignet zum Lernen, für unbekannte Codebasen und Produktionscode
- Befehle erfordern eine Freigabe, Dateioperationen erfolgen automatisch
- Weniger Berechtigungsabfragen
- Am besten geeignet für vertrauenswürdige Projekte und schnelles Prototyping
- Nur lesende Analyse und Planung
- Keine Codeänderungen während der Planung
- Am besten geeignet für komplexe Änderungen und architektonische Entscheidungen
- Vollständige Autonomie ohne Freigabeabfragen
- Schnellste Ausführung, aber höchstes Risiko
- Am besten geeignet für automatisierte Umgebungen und CI/CD
Modellvoreinstellungen
- Kosten: 1-fache Basislinie
- Modelle: Claude-4.5-sonnet
- Am besten geeignet für: Allgemeine Entwicklung, alltägliches Coding, Feature-Implementierung
- Kosten: 1- bis 2-fache Balance-Basislinie
- Modelle: Claude-4.5-sonnet-1m (1M Token Kontext)
- Am besten geeignet für: Komplexe Architektur, große Codebasen, Aufgaben über 200.000 Token
- Kosten: 3,2-mal effizienter als Sonnet (70 % Credit-Einsparung)
- Modelle: Claude-4.5-haiku
- Am besten geeignet für: Schnelle Fixes, einfache Aufgaben, Routineoperationen
Anpassung von Tastaturkürzeln
Standardkürzel
Primäres Tastenkürzel:
- macOS:
Cmd+L– Verdent-Panel öffnen/fokussieren - Windows/Linux:
Ctrl+L– Verdent-Panel öffnen/fokussieren- Befehl:
verdent.addToChat - Funktioniert über die Befehlspalette und den Editor-Kontext
- Befehl:
Dies ist das wichtigste Tastenkürzel, um von überall in VS Code schnell auf Verdent zuzugreifen, ohne Ihren Coding-Flow zu unterbrechen.
Weitere Befehle:
Verfügbar über die Befehlspalette (Standardtastenkürzel können angepasst werden):
verdent.addFeedBack– Feedback gebenverdent.addTerminalOutputToChat– Terminalausgabe zu Verdent hinzufügenverdent.addToChatBySearch– Per Suche zu Verdent hinzufügenverdent.centerButtonClicked– Benutzerzentrumverdent.historyButtonClicked– Projektverlaufverdent.mcpButtonClicked– MCP-Server hinzufügenverdent.openInNewTabByParams– In neuem Tab öffnenverdent.plusButtonClicked– Neue Sitzungverdent.rulesButtonClicked– Regeleinstellungenverdent.SettingClicked– Einstellungsmenüverdent.subagentButtonClicked– Subagent hinzufügen
Tastenkürzel anpassen
Alle Tastaturkürzel von Verdent können über das Standard-Keybinding-System von VS Code angepasst werden.
Für die meisten Nutzer empfohlen – visuelle Oberfläche zur Verwaltung von Tastenkürzeln.
Tastaturkürzel öffnen
Drücken Sie Cmd+K Cmd+S (macOS) oder Ctrl+K Ctrl+S (Windows/Linux)
Nach Verdent suchen
Geben Sie „Verdent“ in das Suchfeld ein, um Verdent-Befehle zu filtern
Tastenkürzel bearbeiten
Klicken Sie auf das Stiftsymbol neben einem Befehl, drücken Sie die gewünschte Tastenkombination und drücken Sie die Eingabetaste, um zu speichern
Für erfahrene Nutzer – direkte JSON-Konfiguration, versionskontrollfreundlich.
Befehlspalette öffnen
Drücken Sie Cmd+Shift+P (macOS) oder Ctrl+Shift+P (Windows/Linux)
Keybindings-JSON öffnen
Geben Sie „Preferences: Open Keyboard Shortcuts (JSON)“ ein und wählen Sie es aus
Benutzerdefiniertes Keybinding hinzufügen
{
"key": "cmd+shift+v",
"command": "verdent.addToChat"
}{
"key": "ctrl+shift+v",
"command": "verdent.addToChat"
}Anpassungsumfang:
- Alle Verdent-Befehle können neu zugewiesen werden
- Mehrere Tastenkürzel können demselben Befehl zugewiesen werden
- Standardtastenkürzel können entfernt werden
- Änderungen werden über VS Code Settings Sync auf mehreren Rechnern synchronisiert
Plattformspezifische Tastenkürzel
Verdent folgt den plattformspezifischen Tastaturkonventionen von VS Code:
| Plattform | Muster der Modifikatortaste |
|---|---|
| macOS | Cmd für primäre Tastenkürzel, Option für alternative |
| Windows/Linux | Ctrl für primäre Tastenkürzel, Alt für alternative |
Häufige Muster:
- Einstellungen:
Cmd+,(macOS) vs.Ctrl+,(Windows/Linux) - Befehlspalette:
Cmd+Shift+P(macOS) vs.Ctrl+Shift+P(Windows/Linux) - Tastaturkürzel:
Cmd+K Cmd+S(macOS) vs.Ctrl+K Ctrl+S(Windows/Linux)
Benutzerdefinierte Anweisungen & Personas
Verdent for VS Code unterstützt zwei Systeme zur Anpassung des KI-Verhaltens: Regeln für Präferenzen und Richtlinien sowie Subagenten für spezialisierte Aufgabenpersonas.
Regelsystem
Regeln definieren, wie sich Verdent während Coding-Sitzungen verhält und reagiert. Regeln werden in Markdown-Dateien gespeichert und durchgängig in Unterhaltungen angewendet.
Drei Arten von Regeln
1. Benutzerregeln (VERDENT.md):
- Speicherort:
~/.verdent/(globales Konfigurationsverzeichnis) - Umfang: Wird auf alle Unterhaltungen in allen Projekten angewendet
- Zweck: Persönliche Coding-Präferenzen, Kommunikationsstil, Dokumentationsstandards
2. Projektregeln (AGENTS.md):
- Speicherort: Projektstammverzeichnis oder Arbeitsbereich
- Umfang: Wird nur auf das aktuelle Projekt angewendet
- Versionskontrolle: Kann für teamweite Standards in Git committet werden
- Zweck: Projektspezifische Coding-Standards, architektonische Muster, Testanforderungen
3. Plan-Regeln (plan_rules.md):
- Speicherort:
~/.verdent/(globales Konfigurationsverzeichnis) - Umfang: Wird bei Verwendung von Plan Mode in allen Projekten angewendet
- Zweck: Anpassung von Planinhalt, -format und Detailgrad
Regeln erstellen und bearbeiten
Regeleinstellungen aufrufen
Klicken Sie auf die Schaltfläche Einstellungen in der oberen Leiste von Verdent und wählen Sie Regeln aus dem Dropdown-Menü
Regeltyp auswählen
Wählen Sie je nach Bedarf Benutzerregeln, Projektregeln oder Plan-Regeln
In Markdown bearbeiten
Regeldateien öffnen sich im VS Code-Editor. Verwenden Sie Markdown-Formatierung, um klare, direktive Anweisungen zu schreiben
Speichern und anwenden
Speichern Sie die Datei. Regeln werden sofort in aktuellen und zukünftigen Sitzungen angewendet – kein Neustart erforderlich
Beispiel für Benutzerregeln:
# Code Style Preferences
- Always use functional React components with hooks
- Prefer TypeScript over JavaScript
- Add JSDoc comments for all exported functions
- Provide explanations before showing codeBeispiel für Projektregeln:
## Testing instructions
- Run `pnpm turbo run test --filter <project_name>` to run all checks
- Fix test and type errors until suite is green
- Add or update tests for code changes
## PR instructions
- Title format: [<project_name>] <Title>
- Always run `pnpm lint` and `pnpm test` before committingSpeicherung und Anwendung von Regeln
| Regeltyp | Speicherort | Umfang | Versionskontrolle |
|---|---|---|---|
| Benutzerregeln | ~/.verdent/VERDENT.md | Alle Projekte | Persönlich, nicht geteilt |
| Projektregeln | <project>/AGENTS.md | Aktuelles Projekt | Kann für Teamkonsistenz committet werden |
| Plan-Regeln | ~/.verdent/plan_rules.md | Alle Projekte (Plan Mode) | Persönlich, nicht geteilt |
Konfigurationspriorität:
Bei widersprüchlichen Regeln wendet Verdent folgende Reihenfolge an:
- Projektregeln (AGENTS.md) – Höchste Priorität (projektspezifisch)
- Benutzerregeln (VERDENT.md) – Globale Benutzerpräferenzen
- Standardverhalten – Die integrierten Standardeinstellungen von Verdent
Committen Sie AGENTS.md in die Versionskontrolle, um projektspezifische Coding-Standards mit Ihrem gesamten Team zu teilen. Der Arbeitsbereich jedes Teammitglieds folgt automatisch den Projektregeln und behält gleichzeitig individuelle Präferenzen über VERDENT.md bei.
Subagenten
Subagenten sind spezialisierte KI-Agenten mit benutzerdefinierten Systemprompts und isolierten Kontextfenstern zur Bearbeitung bestimmter Aufgaben.
Integrierte Subagenten
Verdent enthält drei standardmäßige Subagenten, die ohne Konfiguration sofort verfügbar sind:
- Schnelle Codeprüfungen und Verifizierung
- Schnelle Validierung ohne vollständige Review
- Einsatz für: schnelle Plausibilitätsprüfungen, Syntaxvalidierung, Pre-Commit-Checks
- Schnelle Erkundung und Navigation der Codebasis
- Findet Dateien schnell und beantwortet Fragen zur Codebasis
- Einsatz für: Erkunden unbekannter Codebasen, Finden von Komponenten, Verstehen der Struktur
- Sofortige Bewertung der Codequalität
- Erkennt Probleme in Bezug auf Sicherheit, Wartbarkeit und Performance
- Einsatz für: Pre-Commit-Reviews, Sicherheitsaudits, Performance-Optimierung
Benutzerdefinierte Subagenten erstellen
Subagent-Einstellungen aufrufen
Klicken Sie auf Einstellungen → Subagenten in der oberen Leiste von Verdent
Neuen Subagenten erstellen
Erstellen Sie einen neuen Subagenten oder navigieren Sie zu ~/.verdent/subagents/ und erstellen Sie eine Markdown-Datei mit YAML-Frontmatter
Verhalten des Subagenten definieren
Schreiben Sie einen Systemprompt, der die Persönlichkeit, den Interpretationsstil und den Umgang des Subagenten mit Aufgaben festlegt
Aufrufrichtlinie festlegen
Definieren Sie, wann der Subagent verwendet werden soll (strikte oder flexible Aufrufregel)
Dateiformat für Subagenten:
---
name: security-reviewer
description: Security-focused code review specialist
---
# System Prompt
You are a security-focused code reviewer. When analyzing code:
- Prioritize security vulnerabilities (SQL injection, XSS, auth flaws)
- Use skeptical, critical tone - assume code is vulnerable until proven otherwise
- Provide specific remediation steps with code examples
- Reference OWASP Top 10 and security best practices
- Never approve code with unresolved security issues
Invocation policy (strict): Only run security-reviewer if user explicitly requests it.
When to use the security-reviewer agent:
- User requests security review of authentication/authorization logic
- User asks to audit code for vulnerabilities
- User needs security assessment before deployment
When NOT to use:
- General code review without security focus
- Opening or reading files without analysisSubagenten verwalten
Zugriff über Einstellungen → Subagenten für Folgendes:
- Bearbeiten: Systemprompts, Werkzeugberechtigungen, Konfigurationen ändern
- Kopieren: Subagenten für Varianten oder Vorlagen duplizieren
- Löschen: Nicht verwendete Subagenten entfernen
- Aktivieren/Deaktivieren: Verfügbarkeit umschalten, ohne zu löschen
Subagenten verwenden
Integrierte Subagenten:
- Mit @-Erwähnungen referenzieren:
@Verifier,@Explorer,@Code-reviewer - Werden automatisch aufgerufen, wenn passende Aufgabentypen erkannt werden
Benutzerdefinierte Subagenten:
- Klicken Sie auf die Schaltfläche Subagent hinzufügen im Eingabefeld
- Wählen Sie aus dem Dropdown-Menü
- Der Hauptagent delegiert passende Aufgaben automatisch
Subagent vs. Regeln
| Aspekt | Regeln | Subagenten |
|---|---|---|
| Wann angewendet | Durchgängig, bei jeder Antwort | Bei Bedarf für bestimmte Aufgaben |
| Kontext | Gemeinsames Hauptkontextfenster | Isolierter, separater Kontext |
| Verhalten | Präferenzen und Richtlinien | Aufgabenspezifische Verhaltenspersonas |
| Aufruf | Immer aktiv | Automatische oder manuelle Delegation |
| Zweck | Definiert, WAS Sie bevorzugen | Definiert, WER Aufgaben übernimmt und WIE |
Beispiel-Workflow:
- Benutzerregel: „Erstelle Unit-Tests für alle neuen Funktionen“
- Hauptagent: Erkennt den Bedarf an Testerstellung
- Delegiert an den Test-Generator-Subagenten: Spezialisierter, umfassender Testansatz
- Subagent: Erstellt eine vollständige Testsuite mit isoliertem Kontext
- Hauptagent: Erhält die Ergebnisse und fährt fort, ohne den Kontext zu belasten
Teilen Sie Subagenten mit Teammitgliedern über die Schaltfläche Kopieren unter Einstellungen → Subagenten, oder indem Sie Subagent-Markdown-Dateien direkt aus ~/.verdent/subagents/ teilen.
FAQs (Häufig gestellte Fragen)
Wann werden Konfigurationsänderungen wirksam?
Die meisten Einstellungen von Verdent werden sofort wirksam, ohne dass ein Neustart erforderlich ist:
- Berechtigungsmodi: Sofortiges Umschalten über das Eingabefeld
- Modellvoreinstellungen: Werden auf die nächste Anfrage angewendet
- Regeldateien: Werden auf neue Unterhaltungen angewendet (Speichern löst ein Reload aus)
- Subagenten: Sofort nach der Erstellung verfügbar
- Tastaturkürzel: Werden nach dem Speichern in VS Code angewendet
Ausnahme: Erweiterungseinstellungen von VS Code (wie verdent.enableCheckpoints) werden sofort wirksam, erfordern aber möglicherweise das erneute Öffnen von Dateien oder Sitzungen, um vollständig angewendet zu werden.
Was ist der Unterschied zwischen Regeln und Subagenten?
Regeln definieren, WAS Sie global bevorzugen:
- Durchgängige Anwendung auf alle Unterhaltungen
- Coding-Standards, Kommunikationsstil, Präferenzen
- Gespeichert in Markdown-Dateien (VERDENT.md, AGENTS.md, plan_rules.md)
- Immer im Hintergrund aktiv
Subagenten definieren, WER bestimmte Aufgaben übernimmt und WIE:
- Aufruf bei Bedarf für bestimmte Aufgabentypen
- Spezialisierte Verhaltenspersonas mit benutzerdefinierten Systemprompts
- Isolierte Kontextfenster (belasten nicht den Hauptkontext)
- Automatisch oder manuell über @-Erwähnungen delegiert
Beispiel: Eine Regel besagt: „Erstelle Unit-Tests für neue Funktionen.“ Ein Test-Generator-Subagent übernimmt die tatsächliche Testerstellung mit einer umfassenden Testmethodik.
Kann ich mehrere Berechtigungsmodi gleichzeitig verwenden?
Nein, Berechtigungsmodi schließen sich gegenseitig aus – Sie können immer nur EINEN gleichzeitig verwenden:
- Manuelle Bestätigung – Standard, maximale Kontrolle
- Auto-Run – Optimiert für vertrauenswürdige Projekte
- Plan – Nur lesender Planungsmodus
- Berechtigungen überspringen – Vollständige Autonomie
Sie können Modi sofort über die Schaltfläche Berechtigung wechseln im Eingabefeld umschalten. Die meisten Nutzer wechseln je nach Aufgabenkontext zwischen den Modi (z. B. Plan Mode für komplexe Features, Auto-Run für schnelle Fixes).
Wie wähle ich die richtige Modellvoreinstellung für meine Aufgabe?
Passen Sie die Modellvoreinstellung an die Aufgabenkomplexität und das Budget an:
Efficiency verwenden (3,2-mal effizienter als Sonnet):
- Schnelle Fehlerbehebungen und einfache Codegenerierung
- Routineoperationen und häufig wiederkehrende Aufgaben
- Wenn Geschwindigkeit wichtiger ist als Tiefe
Balance verwenden (1-fache Basislinie) – Standard:
- Allgemeine Entwicklung und alltägliches Coding
- Feature-Implementierung und Code-Reviews
- Ausgewogene Leistung für die meisten Szenarien
Performance verwenden (0,5-fache Effizienz, 2-fache Kosten):
- Komplexe architektonische Entscheidungen
- Große Codebasen, die umfangreichen Kontext benötigen (200.000+ Token)
- Anspruchsvolles Debugging und Refactoring
Profi-Tipp: Die meisten Nutzer behalten Balance als Standard bei und wechseln nur zu Performance, wenn sie an Kontextgrenzen stoßen oder tiefgehendes Reasoning benötigen.