Berechtigungen und Hooks in Claude Code konfigurieren

Direkte Antwort

Führe /permissions in Claude Code aus, um Berechtigungsregeln anzuzeigen und zu verwalten. Um sie dauerhaft zu speichern, füge allow, ask und deny in settings.json ein. Hooks verwenden dieselben Einstellungsdateien und führen Formatierung, Tests oder Sicherheitsprüfungen rund um Tool-Aufrufe aus. Die Berechtigungsreihenfolge lautet deny → ask → allow; eine Allow-Regel kann daher keine Deny-Regel überschreiben.

Diese Einstellungen steuern lokale Tools auf deinem Computer. BetterToken ändert nur Modell-API-Base-URL, API Key und Routing; es umgeht keine lokalen Berechtigungen und führt keine Hooks für dich aus.

Berechtigungen oder Hooks wählen

Anforderung	Verwenden
Bestimmten Befehl ohne Nachfrage ausführen	permissions.allow
Vor jeder Operation nachfragen	permissions.ask
Sensible Dateizugriffe oder gefährliche Befehle blockieren	permissions.deny
Nach einer Dateiänderung formatieren oder testen	PostToolUse-Hook
Aktion vor ihrer Ausführung prüfen oder blockieren	PreToolUse-Hook
Dem Modell Team-Konventionen erklären	CLAUDE.md, keine Berechtigungsregel

Den richtigen Geltungsbereich wählen

Datei	Geltungsbereich	Ins Repository einchecken?
~/.claude/settings.json	Alle Projekte des aktuellen Nutzers	Nein
.claude/settings.json	Aktuelles Projekt und Team	Ja
.claude/settings.local.json	Aktuelles Projekt auf diesem Rechner	Nein

Lege Berechtigungen, Hooks und Umgebungsvariablen in settings.json ab, nicht in ~/.claude.json. Letztere Datei speichert Anwendungsstatus und UI-Einstellungen.

Minimale Berechtigungsregeln konfigurieren

Vorhandene Regeln mit /permissions prüfen

Führe in Claude Code Folgendes aus:

/permissions

Die UI zeigt Allow-, Ask- und Deny-Regeln mit ihren Quelldateien. Prüfe vorhandene Team- oder verwaltete Regeln, bevor du eine Nutzer- oder Projekteinstellung wählst.

Eng gefasste Regeln hinzufügen

Dieses Beispiel auf Projektebene erlaubt gängige Tests und Linting, fragt vor jedem git push nach und blockiert das Lesen von .env:

{
  "permissions": {
    "allow": [
      "Bash(npm run lint *)",
      "Bash(npm test *)"
    ],
    "ask": [
      "Bash(git push *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

Ersetze die Befehle durch Skripte, die in deinem Projekt existieren. Aktiviere bypassPermissions nicht nur, um Nachfragen zu entfernen; die offizielle Dokumentation beschränkt diesen Modus auf isolierte Container oder VMs.

In /permissions prüfen

Speichere die Datei und führe /permissions erneut aus. Bestätige, dass jede Regel unter der erwarteten Quelle erscheint, und löse dann je einen Allow-, Ask- und Deny-Fall aus, um das Verhalten zu prüfen.

Kopierbaren Formatierungs-Hook hinzufügen

Dieses Beispiel führt den Projekt-Formatter aus, nachdem Claude Code Edit oder Write verwendet:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npm run format"
          }
        ]
      }
    ]
  }
}

Wenn die Datei bereits permissions enthält, führe hooks im selben JSON-Objekt der obersten Ebene zusammen. Erstelle keine eigenständige .claude/hooks.json. Führe zuerst npm run format manuell aus, um den Erfolg zu bestätigen.

Befehlshooks laufen mit den Berechtigungen deines Systemnutzers. Verwende nur Skripte, die du geprüft hast, und gib aus einem Hook niemals API Keys, Tokens, .env-Inhalte oder andere Secrets aus.

Hook überprüfen

1. Führe /hooks in Claude Code aus.
2. Öffne PostToolUse und bestätige, dass Edit|Write und npm run format aufgeführt sind.
3. Bitte Claude, eine Testdatei zu bearbeiten.
4. Prüfe die Hook-Ausgabe und das Dateiformat und bestätige, dass der Hook einmal fehlerfrei ausgeführt wurde.

Claude Code lädt Einstellungsänderungen normalerweise automatisch neu. Falls nicht, beende die Sitzung und starte Claude Code neu.

Häufige Fehler

Symptom	Ursache	Lösung
Berechtigungsregeln greifen nie	Sie liegen in ~/.claude.json oder im falschen Verzeichnis	Verschiebe sie nach ~/.claude/settings.json, .claude/settings.json oder .claude/settings.local.json
Eine erlaubte Aktion wird weiterhin blockiert	Sie entspricht einer Deny- oder verwalteten Regel	Prüfe die Quellen in /permissions; Deny hat Vorrang vor Ask und Allow
Ein Hook wird nie ausgeführt	Ereignis oder Matcher passt nicht zum Tool	Prüfe /hooks; PreToolUse läuft vor der Ausführung, PostToolUse nach Erfolg, und Matcher unterscheiden Groß- und Kleinschreibung
Der Hook läuft, aber der Befehl schlägt fehl	Falsches Skript, Arbeitsverzeichnis oder Abhängigkeit	Führe denselben Befehl zuerst manuell aus dem Projektverzeichnis aus
Nach Verbindung mit BetterToken bleiben Nachfragen	API-Provider und lokale Berechtigungen sind getrennt	Behalte die BetterToken Base URL bei und konfiguriere enge Claude-Code-Berechtigungen separat
Du musst alle Hooks vorübergehend deaktivieren	Ein Hook kann die Fehleranalyse stören	Füge "disableAllHooks": true hinzu und entferne es nach der Fehleranalyse oder setze es auf false

BetterToken-Grenzen

BetterToken übernimmt Modell-API-Zugriff, Modellrouting, Guthaben und Nutzung für Claude Code. Claude Code steuert weiterhin:

• Lese- und Schreibzugriff auf Dateien
• Bestätigungsverhalten für Bash
• Wann Hooks laufen und welche Skripte sie ausführen
• Sandbox, MCP und Projektregeln

Bei 401-, Base-URL- oder Modellzuordnungsfehlern lies die Claude-Code-Einrichtungsanleitung. Für Befehlsnachfragen und Automatisierung prüfe hier Berechtigungen und Hooks.

Verwandte Dokumentation

• Claude Code mit BetterToken einrichten
• Was ist CLAUDE.md in Claude Code?
• Warum Claude Code viele Tokens nutzt
• Claude Code MCP und API Key/Base URL im Vergleich

Referenzen

• Claude-Code-Berechtigungen
• Claude-Code-Hooks-Anleitung
• Claude-Code-Hooks-Referenz
• Claude-Code-Konfiguration debuggen