Verdent Docs
Ausführungsmodi und Berechtigungen

Ausführungsmodi & Berechtigungen

Die verschiedenen Ausführungsmodi verstehen und wissen, wann Sie sie einsetzen


Verdent for VS Code bietet mehrere Ausführungsmodi, die steuern, wie die KI mit Ihren Dateien interagiert und Befehle ausführt. Jeder Modus bietet unterschiedliche Abwägungen zwischen Kontrolle, Geschwindigkeit und Sicherheit.

Das lernen Sie

  • Wie jeder Ausführungsmodus funktioniert und wann Sie ihn einsetzen sollten
  • Berechtigungsmodelle und Sicherheitsaspekte
  • Modusvergleich und Wechselstrategien
  • Think Hard Mode für komplexe Denkaufgaben

Verfügbare Hauptmodi

Manual Accept Mode

Standardmodus mit Berechtigungsanfragen für jede geschützte Operation. Maximale Kontrolle und Aufsicht.

Auto-Run Mode

Automatische Dateioperationen, Berechtigung für Befehle erforderlich. Balanciert Geschwindigkeit und Sicherheit.

Skip Permission Mode

Volle Autonomie für isolierte Umgebungen. Keine Berechtigungsabfragen für irgendetwas.

Plan Mode

Nur-Lese-Planungsmodus. Vollständigen Plan vor Ausführungsbeginn prüfen.


Ausführungsmodi

Manual Accept Mode ist der Standard-Ausführungsmodus, der Kontrolle über Dateiänderungen und Befehlsausführung bietet.

Automatische Operationen:

  • Lesen von Dateien und Code-Analyse
  • Durchsuchen von Verzeichnissen

Erfordert Berechtigung:

  • Bearbeiten von Dateien (erstellen, ändern, löschen)
  • Befehlsausführung (Terminalbefehle, Tests, Builds)

Wenn Verdent eine geschützte Operation ausführen möchte, zeigt es an, welche Aktion durchgeführt werden soll und welche Datei bzw. welcher Befehl betroffen ist. Sie können jede Operation akzeptieren oder ablehnen.

Wichtig: Jede Berechtigung gilt nur für diese spezifische Operation. Manual Accept Mode erfordert für jede geschützte Operation während der gesamten Sitzung eine Freigabe.

Wann Sie diesen Modus verwenden sollten

  • Beim Kennenlernen der Fähigkeiten und Workflow-Muster von Verdent
  • Bei der Arbeit in unbekannten Codebasen, die sorgfältige Aufsicht erfordern
  • Bei kritischen Änderungen an Produktionscode oder sicherheitsrelevanten Bereichen
  • Bei Compliance-Anforderungen, die explizite Freigabenachweise benötigen

Aktivierung

Manual Accept Mode ist standardmäßig aktiv. So wechseln Sie zurück:

Berechtigungsmenü öffnen

Klicken Sie auf die Schaltfläche „Switch Permission" in der Eingabeleiste

Manual Accept Mode auswählen

Wählen Sie „Manual Accept Mode" aus dem Dropdown-Menü

Aktivierung überprüfen

Die Schaltfläche zeigt „Manual" an, um zu bestätigen, dass der Modus aktiv ist

Sicherheitsaspekte

Vorteile:

  • Freigabe bei erster Nutzung pro Werkzeugtyp (Dateibearbeitungen, Befehle, Werkzeuge)
  • Vollständige Transparenz vor der Gewährung des Zugriffs
  • Maximale Kontrolle und Transparenz

Einschränkungen:

  • Nach der ersten Freigabe eines Werkzeugtyps erfolgen weitere Nutzungen ohne Abfrage
  • Die Freigabe erfolgt pro Werkzeugtyp, nicht pro Operation
  • Starten Sie neue Sitzungen, wenn Sie an kritischem Code arbeiten, um die Werkzeugfreigaben zurückzusetzen

Auto-Run Mode genehmigt Dateioperationen automatisch, während für Befehle weiterhin eine Berechtigung erforderlich ist. Dies reduziert Berechtigungsabfragen für routinemäßige Dateiarbeiten und wahrt gleichzeitig die Sicherheit bei riskanten Operationen.

Automatisch:

  • Lesen, Bearbeiten, Erstellen und Löschen von Dateien innerhalb des Arbeitsbereichs
  • Verschieben, Umbenennen und Organisieren von Dateien innerhalb des Arbeitsbereichs
  • Dateisuche und Navigationsoperationen

Erfordert Berechtigung:

  • Jeder Befehl, der Pfade außerhalb des aktuellen Arbeitsbereichs betrifft
  • Gefährliche Bash-Befehle: rm -rf, git commit, git push usw.
  • Befehlsausführung (Terminal, Skripte, Builds)
  • Paketinstallation und Systemänderungen

Wann Sie diesen Modus verwenden sollten

Auto-Run verwenden fürNicht verwenden für
Vertrauenswürdige Codebasen mit VersionskontrolleUnbekannte Codebasis
Schnelles Prototyping und ExperimentierenKritischen Produktionscode
Refactoring über mehrere Dateien (15+ Dateien = 15 eingesparte Abfragen)Kein Sicherheitsnetz durch Versionskontrolle
Fokussierte Entwicklung mit minimalen UnterbrechungenCompliance-Anforderungen

Aktivierung

Berechtigungsmenü öffnen

Klicken Sie auf die Schaltfläche „Switch Permission", die den aktuellen Modus anzeigt

Auto-Run Mode auswählen

Wählen Sie „Auto-Run Mode" aus dem Dropdown-Menü

Aktivierung überprüfen

Die Schaltfläche zeigt „Auto" an, um zu bestätigen, dass der Modus aktiv ist

Bleibt über Sitzungen und Neustarts von VS Code hinweg erhalten. Gilt global für alle Arbeitsbereiche.

Beispiel-Workflow

Erstellen eines POST /api/tasks-Endpunkts:

  1. Auto-Run Mode aktivieren
  2. Eingeben: „Erstelle einen POST /api/tasks-Endpunkt, der prüft, ob die Kategorie existiert, und in der Datenbank speichert"
  3. Verdent liest 5+ Dateien, ändert automatisch 3 Dateien (keine Abfragen)
  4. Änderungen im Source-Control-Panel prüfen
  5. Tests anfordern: „Führe die Tests für die Tasks-API aus"
  6. Berechtigungsabfrage für den Befehl npm test – Akzeptieren
  7. Validierung hinzufügen: „Füge eine Validierung für leere Titel hinzu"
  8. Verdent bearbeitet automatisch (keine Abfrage)
  9. Tests erneut anfordern – Berechtigungsabfrage – Akzeptieren
  10. Diffs prüfen, Änderungen committen

Ergebnis: 3 Befehlsabfragen, 0 Dateiabfragen. Bei Manual Accept wären 4 zusätzliche Dateiabfragen erforderlich gewesen.

Sicherheitsaspekte

Vorteile:

  • Änderungen sofort in VS Code sichtbar
  • Auf den Arbeitsbereich beschränkt (kann Systemdateien nicht beeinflussen)
  • Git bietet ein Sicherheitsnetz zum Zurückrollen

Risiken:

  • Keine Aufsicht über Dateioperationen
  • Unerwarteter Umfang (z. B. könnte „Rename User to Account" Dutzende von Dateien ändern)
  • Löschung von Dateien während der Bereinigung möglich
  • Könnte sensible Dateien ändern, wenn danach gefragt wird

Risikominderung:

  • Klare, spezifische Prompts verwenden
  • Source-Control-Panel nach Abschlüssen prüfen
  • Häufig committen für saubere Checkpoints
  • Plan Mode zuerst für komplexe Operationen verwenden
  • .gitignore konfigurieren, um sensible Dateien zu schützen

Skip Permission Mode umgeht alle Berechtigungsabfragen und ermöglicht vollständige Autonomie. Nur in isolierten, entbehrlichen Umgebungen verwenden.

Alle Operationen automatisch:

  • Dateioperationen
  • Befehlsausführung
  • Paketinstallation
  • Operationen auf Systemebene

Dieser Modus entfernt alle Sicherheitsvorkehrungen. Nur in vollständig isolierten, entbehrlichen Umgebungen verwenden, in denen Fehler keine Konsequenzen haben. Niemals in der Produktion oder in einer Codebasis verwenden, die Ihnen wichtig ist.

Wann Sie diesen Modus verwenden sollten

Skip Permission verwenden fürNIEMALS verwenden für
Automatisierte CI/CD-Pipelines in isolierten ContainernProduktionsumgebungen
Entbehrliche Entwicklungscontainer (nach dem Experimentieren gelöscht)Entwicklungsumgebungen mit wichtigem Code
Sandbox-Umgebungen ohne ProduktionsverbindungenJede Codebasis, die Ihnen wichtig ist
Skriptgesteuerte Workflows, bei denen menschliche Freigabe dem Zweck widersprichtGemeinsam genutzte Repositories
Umgebungen mit sensiblen Daten

Aktivierung

Berechtigungsmenü öffnen

Klicken Sie auf die Schaltfläche „Switch Permission"

Skip Permission Mode auswählen

Wählen Sie „Skip Permission Mode" aus dem Dropdown-Menü

Aktivierung überprüfen

Die Schaltfläche zeigt „Skip" an, um zu bestätigen, dass der Modus aktiv ist

Sicherheitsprüfung vor der Aktivierung:

  • Ist dies ein entbehrlicher Container oder eine entbehrliche VM?
  • Kann diese Umgebung ohne Konsequenzen gelöscht werden?
  • Gibt es hier Produktions- oder wichtigen Code?

Wenn die erste oder zweite Frage mit „Nein" oder die dritte mit „Ja" beantwortet wird, NICHT aktivieren.

Sicherheitswarnungen

ALLE Sicherheitsvorkehrungen entfernt:

  • Befehle werden sofort mit Systemberechtigungen ausgeführt
  • Dateien können ohne Warnung geändert oder gelöscht werden
  • Datenbankoperationen und Git-Operationen (einschließlich Force Push) laufen ohne Freigabe ab
  • Es könnten schädliche Pakete installiert oder Zugangsdaten offengelegt werden

Nur sicher, wenn:

  • Die Umgebung vollständig entbehrlich ist
  • Kein wichtiger Code oder wichtige Daten vorhanden sind
  • Keine Verbindung zu Produktionssystemen besteht
  • Sie akzeptieren, dass alles zerstört werden kann

Plan Mode

Plan Mode ist ein Nur-Lese-Interaktionsmodus, in dem Verdent Code analysiert, detaillierte Pläne erstellt und klärende Fragen stellt, aber keine Dateien ändern oder Befehle ausführen kann, bis Sie zustimmen.

Funktionsweise

  1. Analyse – Liest automatisch Dateien
  2. Planung – Erstellt einen strukturierten Plan mit To-do-Liste
  3. Klärung – Stellt Fragen, um Unklarheiten zu beseitigen
  4. Freigabe – Sie prüfen den Plan und entscheiden, ob fortgefahren wird
  5. Ausführung – Wechselt zu Ihrem Berechtigungsmodus zur Ausführung

Der Plan zeigt zu ändernde Dateien, Umsetzungsschritte, Abhängigkeiten und die Verifizierungsstrategie.

Wann Sie diesen Modus verwenden sollten

  • Komplexe Änderungen über mehrere Dateien (Umfang verstehen, bevor Sie sich festlegen)
  • Unbekannte Codebasen (sichere Erkundung ohne Risiko)
  • Architekturentscheidungen (Ansatz vor der Umsetzung prüfen)
  • Vermeidung von Ermüdung durch Manual Accept (einmal prüfen statt 50 einzelner Abfragen)
  • Risikoreiche Produktionsänderungen (volle Transparenz vor der Ausführung)

Aktivierung

Modusmenü öffnen

Klicken Sie auf die Schaltfläche „Switch Mode" in der Eingabeleiste

Plan Mode auswählen

Wählen Sie „Plan Mode" aus dem Dropdown-Menü

Aktivierung überprüfen

Die Modusanzeige wechselt zu „Plan", um zu bestätigen, dass der Modus aktiv ist

Wenn aktiv, analysiert Verdent und erstellt Pläne, ändert aber keine Dateien und führt keine Befehle aus, bis Sie zustimmen. Nach der Freigabe wechselt der Modus zu Ihrem Standard-Berechtigungsmodus (Manual Accept oder Auto-Run).

Sicherheitsaspekte

Vorteile:

  • Kein Ausführungsrisiko während der Planung
  • Volle Transparenz vor dem Festlegen
  • Interaktive Klärung beseitigt Unklarheiten
  • Sicher für Produktionsanalysen

Einschränkungen:

  • Eine Freigabe garantiert keine Korrektheit (Pläne können logische Fehler enthalten)
  • Die Ausführungssicherheit hängt vom gewählten Berechtigungsmodus nach der Freigabe ab
  • Die Planqualität hängt von der Klarheit des Prompts ab

Best Practices:

  • Pläne auf logische Fehler oder Missverständnisse prüfen
  • Bei Unklarheiten Rückfragen stellen
  • Prompts verfeinern, bevor Sie die Ausführung freigeben
  • Überlegen, welcher Berechtigungsmodus die Ausführung übernimmt (Manual Accept für Aufsicht, Auto-Run für Geschwindigkeit)

Think Hard Mode

Think Hard Mode stellt maximale Rechenressourcen für komplexe Denkaufgaben bereit. Das Modell untersucht mehrere Ansätze und liefert gründlichere Lösungen.

Merkmale:

  • Verlängerte Denkzeit
  • Tiefere Analyse mehrerer Lösungsansätze
  • Bessere Handhabung komplexer Logik, Randfälle und Architekturentscheidungen
  • Höhere Credit-Kosten pro Anfrage

Wann Sie diesen Modus verwenden sollten

Think Hard Mode verwenden fürNicht verwenden für
Komplexe Architekturentscheidungen mit mehreren AbwägungenEinfache, unkomplizierte Aufgaben
Anspruchsvolles Debugging mit mehreren möglichen UrsachenZeitkritische Anfragen
Algorithmusdesign, das eine Optimierungsanalyse erfordertBegrenztes Credit-Budget
Kritische Geschäftslogik, bei der Korrektheit entscheidend istWenn der Standardmodus ausreicht
Leistungsoptimierung komplexer Engpässe

Aktivierung

Verwenden Sie die UI-Schaltfläche zur Aktivierung pro Anfrage:

Think Hard aktivieren

Klicken Sie auf die Schaltfläche/den Umschalter „Think Hard" in der Eingabeleiste

Prompt absenden

Geben Sie Ihre Anfrage ein und senden Sie sie ab

Nur einmalige Anfrage

Gilt nur für diese spezifische Anfrage – nicht dauerhaft

Funktioniert mit allen KI-Anbietern. Nicht dauerhaft – muss bei jeder Anfrage, die tieferes Denken erfordert, erneut aktiviert werden.

Fügen Sie Denk-Schlüsselwörter in Ihren Prompt ein:

Think: Design the optimal database schema for this multi-tenant SaaS application

Oder für maximales Denken:

Ultrathink: Analyze the trade-offs between different authentication approaches

„Think" und „ultrathink" sind modellspezifische Fähigkeiten von Claude. Diese Schlüsselwörter aktivieren tieferes Denken in Claude-Modellen (Sonnet, Opus), funktionieren aber möglicherweise nicht mit anderen KI-Anbietern (GPT-5, MiniMax).

Nur Aktivierung pro Anfrage – nicht dauerhaft wie Manual Accept oder Auto-Run.


Modusvergleich

ModusKontrolleGeschwindigkeitAm besten fürVermeiden bei
Manual AcceptMaximalAm langsamstenLernen, unbekannter Code, kritische ÄnderungenVertrauenswürdige Projekte, schnelle Iteration
Auto-RunModeratSchnellVertrauenswürdige Codebasen, Prototyping, Arbeit mit mehreren DateienUnbekannter Code, keine Versionskontrolle
Skip PermissionKeineAm schnellstenCI/CD, entbehrliche Container, SandboxesProduktion, wichtiger Code
Plan ModeVorab-PrüfungN/AKomplexe Änderungen, ArchitekturentscheidungenEinfache Aufgaben
Think HardPro AnfrageLangsamerKomplexes Denken, Algorithmen, kritische LogikEinfache Aufgaben, zeitkritisch

Wann welcher Modus einzusetzen ist

SzenarioManual AcceptAuto-RunSkip PermissionPlan Mode
Verdent kennenlernen
Unbekannte Codebasis
Vertrauenswürdige Codebasis mit Git
Kritischer/Produktionscode
Schnelles Prototyping
Refactoring über mehrere Dateien
Komplexe Architekturplanung
CI/CD-Pipelines (isoliert)
Entbehrliche Container
Compliance-Anforderungen

Best Practices für Sicherheit

Sicherheitshierarchie (von am sichersten bis am wenigsten sicher)

Das Verständnis der Sicherheitseinstufung jedes Modus hilft Ihnen, den passenden Modus für unterschiedliche Risikostufen zu wählen.

  1. Plan Mode – Nur lesend, bis freigegeben. Kein Ausführungsrisiko während der Planung.
  2. Manual Accept Mode – Kontrolle pro Operation mit Freigabe bei erster Nutzung pro Werkzeugtyp.
  3. Auto-Run Mode – Dateiautonomie mit Befehlsfreigabe. Git-Sicherheitsnetz erforderlich.
  4. Skip Permission Mode – Volle Autonomie. Nur für isolierte Umgebungen.

Passen Sie Ihren Modus an das Risikoniveau an: Kritischer Code nutzt die sichersten Modi (Plan, Manual Accept), vertrauenswürdiger Code nutzt schnellere Modi (Auto-Run), entbehrliche Umgebungen nutzen den schnellsten Modus (Skip Permission).

Allgemeine Best Practices

Wesentliche Praktiken, die unabhängig vom verwendeten Ausführungsmodus gelten.

Für alle Modi:

  1. Versionskontrolle verwenden – Initialisieren Sie Git, bevor Sie freizügigere Modi verwenden, committen Sie häufig, prüfen Sie Diffs vor dem Commit
  2. Klare Prompts schreiben – Seien Sie spezifisch beim Umfang, geben Sie Dateigrenzen explizit an, verwenden Sie @-Erwähnungen für Kontext
  3. Vor dem Committen prüfen – Prüfen Sie das Source-Control-Panel nach Abschlüssen, prüfen Sie alle Diffs sorgfältig, testen Sie die Änderungen
  4. Neue Sitzungen starten – Löschen Sie den Kontext zwischen größeren Aufgaben, setzen Sie Werkzeugfreigaben für sensible Arbeiten zurück, vermeiden Sie Kontextverunreinigung
  5. Modus an das Risiko anpassen – Kritischer Code → Manual Accept oder Plan Mode, vertrauenswürdiger Code → Auto-Run, Experimente → Auto-Run mit Git, entbehrlich → nur Skip Permission

Sicherheitshinweise:

  • Committen Sie niemals sensible Dateien (.env, Zugangsdaten)
  • Konfigurieren Sie .gitignore, bevor Sie Auto-Run verwenden
  • Prüfen Sie Befehlsberechtigungen sorgfältig
  • Verwenden Sie Plan Mode für Änderungen, die die Sicherheit betreffen
  • Neue Sitzungen setzen die Werkzeugfreigaben in Manual Accept zurück
Progressive Permission Model

Das Verständnis der Funktionsweise des Berechtigungssystems von Verdent hilft Ihnen, es effektiv zu nutzen.

So funktioniert es:

  1. Erste Nutzung – Das System fragt nach einer Berechtigung, wenn Sie jeden Werkzeugtyp zum ersten Mal verwenden (Dateibearbeitungen, Befehlsausführungen, Werkzeugnutzung)
  2. Weitere Nutzungen – Nach der ersten Freigabe läuft dieser Werkzeugtyp für den Rest der Sitzung ohne Abfragen weiter
  3. Neue Sitzung – Der Start einer neuen Sitzung setzt alle Freigaben zurück, sodass Sie neu beginnen können

Kernprinzip: Dieses Modell balanciert Sicherheit mit Produktivität. Sie prüfen und genehmigen Werkzeugtypen einmal und arbeiten dann effizient innerhalb dieses Freigabekontexts. Für sensible Arbeiten starten Sie eine neue Sitzung, um die Freigaben zurückzusetzen.

So setzen Sie Freigaben zurück: Starten Sie eine neue Sitzung


Siehe auch