promptgarten 🌱
🌍 EN
Guide●●○5 Min · +40 XP

Berechtigungs-Modi für Agenten

Von 'jede Aktion bestätigen' bis Auto-Modus: Berechtigungs-Modi legen fest, wie oft ein Agent dich vor einer Aktion um Erlaubnis fragt.

Das Grundproblem

Ein Agent, der Dateien ändern, Befehle ausführen oder Netzwerk-Anfragen stellen kann, braucht Regeln: Was darf er ohne Nachfrage tun, wofür braucht er deine Zustimmung? Diese Regeln heißen Berechtigungs-Modi (Permission Modes).

Die wichtigsten Modi bei Claude Code

  • Manuell (Standard): Nur Lesen ist erlaubt, jede Datei-Änderung und jeder Befehl wird vorher bestätigt.
  • Accept Edits: Datei-Änderungen und einfache Dateisystem-Befehle (z. B. Ordner anlegen) laufen ohne Nachfrage, alles andere wird weiter bestätigt.
  • Plan-Modus: Der Agent darf nur recherchieren und einen Plan schreiben, keine Änderungen vornehmen – gut zum Erkunden vor dem eigentlichen Bauen.
  • Auto-Modus: Fast alles läuft ohne Nachfrage, ein zusätzliches Prüfmodell im Hintergrund blockt riskante Aktionen (z. B. Produktions-Deploys, Force-Push).
  • Bypass Permissions: Alle Prüfungen sind aus – nur für isolierte Umgebungen wie Container ohne Internet gedacht.

Wie man wechselt

In der Kommandozeile wechselt man mit Shift+Tab zwischen den Modi, oder startet direkt mit einem Flag wie --permission-mode plan.

Die Faustregel

So wenig Rechte wie möglich, so viele wie nötig (Prinzip der geringsten Rechte). Für sensible Arbeit oder unbekannten Code: manueller Modus. Für Routine-Änderungen, die du danach ohnehin per Diff prüfst: Accept Edits. Bypass Permissions nur in einer echten Sandbox, nie auf deinem eigentlichen Rechner.

BEISPIEL

Start mit "claude --permission-mode plan" für eine neue, unbekannte Codebasis. Der Agent erkundet und schlägt einen Plan vor. Erst nach deiner Bestätigung wechselst du (z. B.) in den Accept-Edits-Modus, damit er die Änderungen tatsächlich schreibt – ohne dass du jede einzelne Datei-Änderung einzeln bestätigen musst.

🛠️ ÜBUNG — MACH DAS BEI DIR

Wechsle in einer laufenden Claude-Code-Session bewusst zwischen zwei Berechtigungs-Modi und beobachte den Unterschied.

  1. Starte Claude Code in einem Test-Projekt im Standard-Modus (manuell) und bitte um eine kleine Code-Änderung – beobachte die Bestätigungs-Nachfrage.
  2. Wechsle mit Shift+Tab in den Accept-Edits-Modus und bitte um dieselbe Art Änderung – vergleiche, was jetzt ohne Nachfrage läuft und was weiterhin bestätigt wird.
  3. Wechsle in den Plan-Modus und bitte um eine größere Änderung – prüfe, dass wirklich keine Datei geändert wird, bis du den Plan akzeptierst.

SELBST-CHECK

  • Konntest du benennen, welche Aktionen im Accept-Edits-Modus automatisch liefen und welche trotzdem nachgefragt haben?
  • Hast du verstanden, warum Plan-Modus nichts verändert, obwohl der Agent Dateien liest und Befehle ausführt?
  • Weißt du, warum Bypass Permissions nur in einer isolierten Umgebung sinnvoll ist?

KURZ-QUIZ

Was ist die Faustregel bei der Wahl eines Berechtigungs-Modus?

QUELLEN

VERWANDTE THEMEN

Guardrails für autonome Agenten ●●●Sicherheit bei Vibe Coding ●●○Claude Code: Der CLI-Agent von Anthropic ●●○Agent festgefahren? So kommst du raus ●●○