Claude Code: Berechtigungen erklärt
Claude Code prüft erst deny-, dann ask-, dann allow-Regeln, und ein enges allow schlägt nie ein breites deny. Sechs Tests von Tech AI Wire zeigen, wo die Regeln enden.
Von Claire Whitmore
5 Min. Lesezeit
Maschinell übersetzt aus dem englischen Original, das Claire Whitmore auf Fakten geprüft und redigiert hat. Es gilt die englische Fassung. So arbeiten wir

Die Berechtigungen von Claude Code sind die Regeln, die festlegen, was der Coding-Agent von Anthropic selbstständig tun darf. Sie legen auch fest, wonach er vorher fragen muss und was er nie tun darf. Sie stehen in JSON-Einstellungsdateien als drei Listen: allow, ask und deny. Ein Berechtigungsmodus bestimmt, was mit allem geschieht, auf das keine Regel passt. Wer sie falsch setzt, versinkt entweder in Rückfragen oder lässt den Agenten Befehle ausführen, die er nie genehmigen wollte.
So funktionieren die Berechtigungen von Claude Code
Jede Regel nennt ein Tool, optional mit einem Muster in Klammern. Bash(npm run test *) passt auf jeden Shell-Befehl, der mit npm run test beginnt. Read(./.env) passt auf eine Datei. WebFetch(domain:example.com) passt auf eine Website. Ein bloßer Tool-Name wie Bash passt auf jede Nutzung dieses Tools.
Am wichtigsten ist die Reihenfolge. Anthropics Seite zu Berechtigungen sagt: „Regeln werden in dieser Reihenfolge ausgewertet: deny, dann ask, dann allow. Der erste Treffer in dieser Reihenfolge bestimmt das Ergebnis, und die Spezifität einer Regel ändert die Reihenfolge nicht.“ Ein breites deny wie Bash(aws *) blockiert also auch aws s3 ls, selbst wenn ein engeres allow genau diesen Befehl nennt. In den Worten der Dokumentation: „Eine allow-Regel kann keine Ausnahme aus einer deny-Regel herausschneiden.“
Nicht jeder Leitfaden sieht das so. Ein Beitrag vom April 2026 im Blog von Vincent Qiao sagt, Claude Code „wertet zuerst die spezifischste Regel aus“. Die offizielle Seite und der Test von Tech AI Wire weiter unten sagen beide etwas anderes.
Regeln stammen aus mehreren Dateien, und ihre Listen werden zusammengeführt statt ersetzt. Die Seite zu den Einstellungen nennt die Reihenfolge für Einzelwerte, die höchste zuerst: „verwaltete Einstellungen, Kommandozeile, lokales Projekt, geteiltes Projekt, Benutzer.“ Verwaltete Einstellungen legt ein Arbeitgeber fest, und sie lassen sich nicht überschreiben. Die geteilte Projektdatei .claude/settings.json ist dafür gedacht, in Git eingecheckt zu werden. Die lokale Datei .claude/settings.local.json ist für eine einzelne Person gedacht und bleibt außerhalb von Git. Und ein deny in einer beliebigen Datei gewinnt, denn „deny-Regeln aus jedem Scope werden vor allow-Regeln ausgewertet.“
Die sechs Berechtigungsmodi
Ein Modus ist die Rückfallebene für Aufrufe, auf die keine Regel passt. Claude Code 2.1.325 akzeptiert sechs davon über das Flag --permission-mode. Diese Tabelle fasst jeden Modus anhand der Dokumentation von Anthropic zusammen.
| Modus | Was ohne Rückfrage läuft | Am besten für |
|---|---|---|
default (angezeigt als Manual) | Lesezugriffe; jedes andere Tool fragt bei der ersten Nutzung | Unbekannte Repos |
acceptEdits | Lesezugriffe, Dateiänderungen sowie mkdir, touch, mv, cp im Arbeitsordner | Sitzungen mit vielen Änderungen, die Sie beobachten |
plan | Lesezugriffe und schreibgeschützte Shell-Befehle; keine Änderungen an Quelldateien | Planung vor Änderungen |
auto | Alles, mit einer Prüfung im Hintergrund bei Shell- und Netzwerkaktionen | Lange Aufgaben, denen Sie vertrauen |
dontAsk | Nur vorab genehmigte Tools; alles, was eine Rückfrage auslösen würde, wird abgelehnt | Skripte und CI |
bypassPermissions | Alles außer Aktionen, die kein Modus automatisch genehmigt | Nur isolierte Container und VMs |
Laut der Seite zu den Berechtigungsmodi blockieren deny-Regeln weiterhin in jedem Modus, auch in bypassPermissions.
Test von Tech AI Wire: sechs Regeln, sechs Ergebnisse
Der Test lief am 18. November 2026 unter macOS 26.6 mit Claude Code 2.1.325 in einem leeren Git-Ordner. Jeder Durchlauf nutzte claude -p mit --permission-mode dontAsk, sodass ein Aufruf, der eine Rückfrage ausgelöst hätte, stattdessen abgelehnt wurde. Das Flag --settings lieferte die Regeln, und --setting-sources local hielt die eigenen Einstellungen des Rechners heraus. Das Modell Haiku sollte einen Befehl ausführen, und die JSON-Ausgabe wurde auf permission_denials geprüft.
| Test | Regeln | Befehl | Ergebnis |
|---|---|---|---|
| A | allow Bash(echo hello) | echo hello | Ausgeführt |
| B | allow Bash(echo hello), deny Bash(echo *) | echo hello | Abgelehnt |
| C | allow Bash(echo hello), ask Bash(echo *) | echo hello | Abgelehnt |
| D | keine Regeln | echo hello | Ausgeführt |
| E | allow Bash(cat *), deny Read(./secret.txt) | cat secret.txt | Abgelehnt |
| F | allow Bash(python3 *), deny Read(./secret.txt) | python3 -c "print(open('secret.txt').read())" | Ausgeführt, Datei ausgegeben |
Die Tests B und C bestätigen die Reihenfolge: Das breitere deny und das breitere ask schlagen beide das exakte allow. Test D lief ganz ohne Regeln, weil echo zu den eingebauten schreibgeschützten Befehlen von Claude Code gehört. Test E zeigt, dass ein Read-deny auch cat abdeckt. Die Dokumentation sagt dasselbe über head, tail, sed und tee.
Test F zeigt die Lücke. Die Dokumentation warnt, dass Datei-denies nicht „ein Python- oder Node-Skript, das Dateien selbst öffnet“ erreichen. Hier las ein einzeiliges Python-Skript die „abgelehnte“ Datei und gab sie aus.
Was sich wann geändert hat
Die Berechtigungen haben sich 2026 oft geändert. Laut der Seite zu den Einstellungen wirkt bypassPermissions seit Version 2.1.257 nicht mehr, wenn es in Projekt- oder lokalen Einstellungen steht. Seit 2.1.283 ist auto der Standardmodus für interaktive Terminal- und VS-Code-Sitzungen. Seit 2.1.302 starten Läufe von claude -p ohne gesetzten Modus stattdessen in Manual.
Tech AI Wire hat über die Einstellungen rund um diese Regeln berichtet. Claude Code begann im August damit, Commits standardmäßig einen Sitzungslink hinzuzufügen. In Version 2.1.277 begann es, AGENTS.md als Fallback zu lesen. Der Leitfaden von Tech AI Wire zu Plugins für Claude Code behandelt Erweiterungen, die Tools hinzufügen, für die eigene Regeln nötig sind. Die Form mcp__<server>__<tool> bezeichnet ein Tool von einem MCP-Server, einer Tool-Quelle ähnlich einem Plugin.
Was das für Entwickler bedeutet
Schreiben Sie deny-Regeln für das, was nie passieren darf, und halten Sie sie breit: Bash(git push *) statt eines einzelnen Branch-Namens. Ein breites deny lässt sich durch ein enges allow nicht aufheben, also können Sie darin keine Ausnahmen schaffen. Nutzen Sie ask für Aktionen, die Sie prüfen wollen, denn auch ein ask schlägt ein passendes allow.
Betrachten Sie ein Read-deny nicht als Schutz für ein Geheimnis. Test F zeigt, dass jedes Skript, das der Agent ausführen darf, die Datei trotzdem öffnen kann. Die Dokumentation sagt, eine Bash-Regel sei „keine Sicherheitsgrenze um das Programm“. Für echte Grenzen fügen Sie die Sandbox hinzu, die auf Ebene des Betriebssystems einschränkt, was Shell-Befehle erreichen können. Noch besser: Halten Sie Geheimnisse aus dem Projektordner heraus.
Checken Sie Ihre Einstellungen als .claude/settings.json in Git ein, damit das ganze Team dieselben denies erhält. Persönliche Genehmigungen gehören in settings.local.json. Für CI-Jobs nutzen Sie dontAsk mit einer expliziten allow-Liste, damit ein unerwarteter Befehl fehlschlägt, statt an einer Rückfrage hängen zu bleiben. Reservieren Sie bypassPermissions für Wegwerf-Container.
Quellen
- Configure permissions - Claude Code Docs
- Claude Code settings - Claude Code Docs
- Choose a permission mode - Claude Code Docs
- Claude Code Permission Rules & settings.json Guide - AI Arte
- Claude Code settings.json Permissions: Control Exactly What AI Can Do - Vincent's Blog
Ähnliche Artikel

Claude-Code-Erweiterung in Cursor platzierte SSH-Hintertüren
Manipulierte Builds 2.1.312 und 2.1.313 der Claude-Code-Erweiterung waren am 29. Oktober etwa 11 Stunden im Marktplatz von Cursor abrufbar. Sie fügten einen SSH-Schlüssel und einen Reverse-Tunnel hinzu.

Android Studio Rabbit 2 öffnet die IDE für mehr als 40 Agenten
Android Studio Rabbit 2 ist stabil und unterstützt mehr als 40 externe Coding-Agenten, darunter Claude und Codex. Android CLI lässt sich jetzt als Plugin für beide installieren.

Perplexity stellt die SPACE-Sandbox für KI-Agenten als Open Source bereit
Perplexity hat SPACE, die Firecracker-Sandbox hinter seinem Agenten Computer, am 15. Oktober unter Apache 2.0 veröffentlicht. Eigene Tests ergaben 0 Ausbrüche in 108 Versuchen.