Zum Inhalt springen
Dev-ToolsErklärt

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

5 Min. Lesezeit

XLinkedIn

Maschinell übersetzt aus dem englischen Original, das Claire Whitmore auf Fakten geprüft und redigiert hat. Es gilt die englische Fassung. So arbeiten wir

Screenshot of the Claude Code Docs page "Configure permissions", with the Permissions and sandboxing menu open on the left.

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.

ModusWas ohne Rückfrage läuftAm besten für
default (angezeigt als Manual)Lesezugriffe; jedes andere Tool fragt bei der ersten NutzungUnbekannte Repos
acceptEditsLesezugriffe, Dateiänderungen sowie mkdir, touch, mv, cp im ArbeitsordnerSitzungen mit vielen Änderungen, die Sie beobachten
planLesezugriffe und schreibgeschützte Shell-Befehle; keine Änderungen an QuelldateienPlanung vor Änderungen
autoAlles, mit einer Prüfung im Hintergrund bei Shell- und NetzwerkaktionenLange Aufgaben, denen Sie vertrauen
dontAskNur vorab genehmigte Tools; alles, was eine Rückfrage auslösen würde, wird abgelehntSkripte und CI
bypassPermissionsAlles außer Aktionen, die kein Modus automatisch genehmigtNur 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.

TestRegelnBefehlErgebnis
Aallow Bash(echo hello)echo helloAusgeführt
Ballow Bash(echo hello), deny Bash(echo *)echo helloAbgelehnt
Callow Bash(echo hello), ask Bash(echo *)echo helloAbgelehnt
Dkeine Regelnecho helloAusgeführt
Eallow Bash(cat *), deny Read(./secret.txt)cat secret.txtAbgelehnt
Fallow 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

  1. Configure permissions - Claude Code Docs
  2. Claude Code settings - Claude Code Docs
  3. Choose a permission mode - Claude Code Docs
  4. Claude Code Permission Rules & settings.json Guide - AI Arte
  5. Claude Code settings.json Permissions: Control Exactly What AI Can Do - Vincent's Blog

Ähnliche Artikel