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.
- Starte Claude Code in einem Test-Projekt im Standard-Modus (manuell) und bitte um eine kleine Code-Änderung – beobachte die Bestätigungs-Nachfrage.
- 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.
- 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
- Claude Code Doku: Berechtigungs-Modus wählen ↗ code.claude.com
- Claude-Doku: Permissions im Agent SDK ↗ platform.claude.com