Security

Wird die Claude Code-Konfiguration 2026 vom Agenten überschrieben? SBPL gegen Manipulation

Wird die Claude Code-Konfiguration 2026 vom Agenten überschrieben? SBPL gegen Manipulation

Die Claude-Code-Konfiguration sollte nicht im selben beschreibbaren Bereich liegen wie der Agent. Für beaufsichtigte Einzelaufgaben genügt eine enge Kombination aus denyWrite und einem Fail-Closed-Verhalten; für Teams und unbeaufsichtigte Agenten gehören die zentralen Regeln in geschützte managed settings. Wenn auch die Claude-Code-Prozessdateien und ihre Unterprozesse eingeschränkt werden müssen, kann eine SBPL-Regel zusätzliche Kontrolle liefern. Für hohe Risiken ist ein unabhängiger Mac die belastbarere Grenze.

Dieser Beitrag richtet sich an Entwickler, die .claude/settings.json im echten Projektverzeichnis speichern und Claude Code Dateien automatisch bearbeiten lassen. Er ist ebenso für DevSecOps-Ingenieure gedacht, die verhindern müssen, dass Projektregeln Sicherheitsvorgaben abschwächen, sowie für Plattformverantwortliche, die einen Terminal-Agenten auf einem entfernten Mac dauerhaft oder unbeaufsichtigt betreiben.

Zuletzt aktualisiert: 15.09.2026. Die Angaben wurden gegen die offiziellen Dokumentationen zu Konfiguration, Berechtigungen, Sandboxing und Debugging sowie gegen die aktuelle Beschreibung von sandbox-exec geprüft.

Die eigentliche Schwachstelle ist der gemeinsame Schreibbereich

Ein Agent kann eine Datei nicht deshalb ändern, weil sie „Konfiguration“ heißt. Entscheidend ist, ob der ausführende Prozess Schreibrechte auf ihren Pfad besitzt. Liegt .claude/settings.json im Workspace und darf Claude Code diesen Workspace bearbeiten, befindet sich die Datei zunächst in derselben Vertrauenszone wie Quellcode, Tests und generierte Artefakte.

Das erzeugt einen gefährlichen Kreislauf:

  1. Die Konfiguration erlaubt bestimmte Werkzeuge oder Schreibpfade.
  2. Der Agent erhält Schreibzugriff auf das Projekt.
  3. Eine Aufgabe verändert .claude/settings.json, Hooks, Skills oder verwandte Dateien.
  4. Die nächste Aktion läuft bereits unter einer veränderten Regelbasis.

Ein solcher Ablauf ist nicht automatisch ein aktueller Claude-Code-Fehler. Einzelne Issue-Berichte von Entwicklern können lediglich auf bestimmte Versionen, Plattformen oder Fehlkonfigurationen bezogen sein. Als Bedrohungsmodell ist die Situation trotzdem relevant: Eine Regel, die der geschützte Prozess selbst ändern darf, ist keine unabhängige Sicherheitsgrenze.

Die offiziellen Berechtigungsregeln unterscheiden zwischen eingebauten Werkzeugen wie Edit und Write sowie Befehlen, die über Bash und dessen Unterprozesse ausgeführt werden. Diese Ebenen dürfen nicht vermischt werden. Eine Einschränkung für Bash bedeutet nicht automatisch, dass der gesamte Claude-Code-Prozess, seine Konfigurationsdateien oder jedes eingebundene Werkzeug identisch eingeschränkt ist. Die Dokumentation zu Claude-Code-Berechtigungen beschreibt diese Werkzeug- und Regelbereiche getrennt.

Für die Praxis bedeutet das:

  • .claude/settings.json ist eine Projektsteuerung, keine unveränderliche Policy.
  • Hooks und Skills können das Verhalten nachfolgender Sitzungen beeinflussen und müssen deshalb in die Prüfung einbezogen werden.
  • Ein erlaubter Workspace-Schreibzugriff darf nicht zugleich den Pfad mit den Sicherheitsregeln umfassen.
  • Ein Eintrag mit hoher Priorität schützt keine Datei vor Änderungen, wenn der Agent diese Datei weiterhin schreiben kann.

Kann Claude Code seine eigene settings.json ändern?
Ja, sofern das verwendete Werkzeug und die effektive Dateiregel den Schreibvorgang zulassen. Die Konfigurationspriorität entscheidet, welche Einstellung gilt; sie verhindert nicht automatisch, dass eine niedriger oder höher eingeordnete Datei verändert wird. Deshalb muss die Schreibbarkeit des Pfads separat geprüft werden.

Projektregeln sind flexibel, aber kein Selbstschutz

Projekt- und lokale Einstellungen sind sinnvoll, wenn ein Team reproduzierbare Arbeitsweisen benötigt oder ein Entwickler ein Experiment isoliert durchführen möchte. Sie lassen sich versionieren, reviewen und gemeinsam mit dem Repository ausliefern. Für die letzte Sicherheitslinie sind sie jedoch ungeeignet, sobald der Agent den betreffenden Pfad bearbeiten kann.

Eine belastbare Trennung sieht so aus:

  • Geschäftsregeln bleiben im Repository. Dazu zählen etwa bevorzugte Testbefehle, erlaubte Projektverzeichnisse und teaminterne Arbeitsabläufe.
  • Sicherheitsregeln liegen außerhalb der Agenten-Schreibzone. Dazu gehören Schreibverbote für Konfigurationspfade, ein verpflichtender Abbruch bei nicht verfügbarer Sandbox und das Verbot eines ungeschützten Fallbacks.
  • Betriebsregeln werden an der Ausführungsumgebung kontrolliert. Dazu zählen ein eigener Mac, getrennte Zugangsdaten, Wiederherstellungspunkte und die Entscheidung, ob ein Prozess überhaupt unbeaufsichtigt laufen darf.

Für eine erste Prüfung sollte der verantwortliche Entwickler nicht nur .claude/settings.json ansehen. Zu prüfen sind auch:

  • das gesamte .claude-Verzeichnis,
  • Hook-Skripte,
  • projektbezogene Skills,
  • lokale Einstellungsdateien,
  • Skripte, die Claude Code beim Start oder vor Befehlen aufruft,
  • Pfade außerhalb des Projekts, in denen Sicherheitsregeln abgelegt sind.

Die offizielle Konfigurationsübersicht ist dafür die richtige Referenz, weil sie die unterstützten Speicherorte und Geltungsbereiche trennt. Ein lokales JSON-Dokument darf nicht als Beweis dienen, dass genau diese Werte im laufenden Prozess tatsächlich maßgeblich sind.

Wie lässt sich verhindern, dass Claude Code in .claude schreibt?
Der Pfad muss in der effektiven Schreibregel ausdrücklich ausgeschlossen werden. Das kann über eine passende denyWrite-Regel und eine übergeordnete Policy erfolgen. Wichtig ist, den gesamten relevanten Pfad abzudecken, nicht nur eine einzelne Datei. Hooks, Skills und symbolische Verweise müssen zusätzlich geprüft werden. Ein Schreibverbot für .claude/settings.json ist zu schwach, wenn eine andere Datei im selben Verzeichnis das Verhalten verändern kann.

Verdeckte Erweiterungen entstehen durch das Zusammenführen der Ebenen

Die häufigste Fehlannahme lautet: „Die Datei mit der höchsten Priorität überschreibt einfach alle anderen Dateien.“ Für die Beurteilung einer laufenden Sitzung reicht diese Vereinfachung nicht aus. Claude Code kennt verwaltete, Benutzer-, Projekt- und lokale Einstellungen. Die Reihenfolge bestimmt, welche Quelle Vorrang erhält; einzelne Regeltypen können jedoch zusammengeführt werden.

Das ist besonders relevant bei Listen wie allowWrite. Eine zusätzliche Freigabe aus einem anderen Geltungsbereich kann die angenommene Grenze erweitern, wenn der Entwickler nur eine einzelne JSON-Datei betrachtet. Ein scheinbar restriktiver Projektwert beweist daher nicht, dass der Prozess insgesamt nur auf diesen Bereich schreiben kann.

Die sichere Kontrolle erfolgt in der laufenden Umgebung:

  1. Claude Code in der vorgesehenen Ausführungsart starten.
  2. Mit /status prüfen, welche Umgebung und welche relevanten Zustände erkannt werden.
  3. Mit /permissions die effektiven Berechtigungen und Regelquellen kontrollieren.
  4. Mit /doctor Konfigurations- und Umgebungsprobleme suchen.
  5. Einen harmlosen Testpfad verwenden, der keinen echten Quellcode, Schlüssel oder Systemdateien enthält.
  6. Die Ausgabe dokumentieren und erst danach die Policy für Team- oder Automationsbetrieb freigeben.

Die Anleitung zum Debuggen der Claude-Code-Konfiguration sollte bei jeder Änderung erneut herangezogen werden. Das ist kein überflüssiger Kontrollschritt: Eine Regel kann formal korrekt aussehen und trotzdem durch ihre Quelle, ihren Geltungsbereich oder die Zusammenführung anders wirken als erwartet.

Sind managed settings sicherer als Projekteinstellungen?
Für zentrale Sicherheitsvorgaben: ja. Die offiziellen Angaben ordnen managed settings mit der höchsten Priorität ein. Sie sind deshalb besser geeignet, wenn ein Projekt oder ein Agent die Policy nicht selbst abschwächen darf. Sie ersetzen allerdings keine Betriebshygiene. Wenn der Host, das Benutzerkonto oder der Prozessstart unter derselben Kontrolle stehen, muss auch diese Ebene abgesichert werden.

Die sinnvolle Aufteilung lautet: Projektdateien definieren den Arbeitsablauf; verwaltete Einstellungen definieren die nicht verhandelbaren Grenzen. Dadurch bleibt ein Repository flexibel, ohne dass eine Änderung im Repository automatisch die zentrale Sicherheitslinie verändert.

Fail-Closed entscheidet über den Wert der Sandbox

Eine Sandbox ist nur dann eine Sicherheitsgrenze, wenn ihr Ausfall nicht stillschweigend zu einem ungeschützten Prozess führt. Für Claude Code müssen mindestens drei unterschiedliche Situationen auseinandergehalten werden:

  • Die Sandbox initialisiert nicht.
  • Ein Befehl kann nicht innerhalb der Sandbox ausgeführt werden und wird in einen normalen Berechtigungsweg zurückgeführt.
  • Der Start erfolgt ausdrücklich ohne Sandbox oder mit einem erlaubten unsandboxed Fallback.

Diese Fälle haben nicht dieselbe Bedeutung. Der erste ist ein technischer Fehler. Der zweite kann ein bewusst vorgesehener Rückfall sein. Der dritte ist eine Betriebsentscheidung. In allen Fällen bleibt die zentrale Frage gleich: Darf der Agent danach weiterarbeiten, obwohl die angenommene Isolation nicht mehr besteht?

Für unbeaufsichtigte Prozesse ist ein Fail-Closed-Verhalten normalerweise die strengere Wahl. In den verwalteten Einstellungen müssen dafür die aktuell dokumentierten Felder und Standardwerte verwendet werden. Laut Aufgabenstand gehören dazu filesystem.denyWrite, failIfUnavailable und allowUnsandboxedCommands; die konkrete Wirkung ist vor der produktiven Einführung nochmals in der offiziellen Claude-Code-Sandbox-Dokumentation zu prüfen.

Eine sichere Policy vermeidet insbesondere:

  • einen unbemerkten Wechsel auf normale Host-Berechtigungen,
  • eine globale Freigabe für unsandboxed commands,
  • großzügige Ausnahmen, die nur wegen eines einzelnen problematischen Befehls eingeführt wurden,
  • unklare Zustände, in denen der Job zwar erfolgreich beendet wird, aber nicht mehr unter der erwarteten Isolation lief.

Ein Entwickler kann für eine beaufsichtigte Aufgabe bewusst eine Ausnahme genehmigen. Ein nächtlicher oder ereignisgesteuerter Agent sollte dagegen bei nicht verfügbarer Isolation abbrechen. Die Ausführung muss außerdem protokollieren, ob die Sandbox tatsächlich aktiv war. „Die Policy-Datei wurde nicht geändert“ ist kein ausreichender Nachweis, wenn der Prozess nach einem Sandbox-Fehler mit normalen Host-Rechten weiterlief.

SBPL schützt den Prozess weiter außen als die Bash-Sandbox

Die integrierte Bash-Sandbox und eine manuell gestartete SBPL-Sandbox liegen auf unterschiedlichen Ebenen. Die native Claude-Code-Sandbox konzentriert sich laut offizieller Dokumentation hauptsächlich auf Bash und dessen Unterprozesse. Eine mit sandbox-exec geladene SBPL-Regel wird dagegen vom Betriebssystem auf den gestarteten Prozess und dessen Kindprozesse angewendet.

Damit kann ein Betreiber den Schutz außerhalb der Agentenlogik ansetzen:

  • Claude Code selbst erhält die Prozessbeschränkung.
  • Bash-Unterprozesse erben den relevanten Sandboxing-Kontext.
  • Schreibzugriffe auf Konfigurationspfade können unabhängig von Projektregeln blockiert werden.
  • Ein Pfad außerhalb des Workspace kann ausdrücklich geschützt werden.

Kann SBPL den gesamten Claude-Code-Prozess beim Schreiben beschränken?
Ja, als Betriebssystemregel kann SBPL den gestarteten Prozess und seine Unterprozesse mit einer engeren Schreibpolicy versehen. Das ist stärker als eine Regel, die nur einen einzelnen Bash-Befehl betrifft. Es ist aber kein Freibrief: Ein fehlerhaftes Profil kann den Prozess unbrauchbar machen, und sandbox-exec ist laut aktueller Xcode-Manpage als veraltet beziehungsweise „deprecated“ gekennzeichnet.

„Heute aufrufbar“ und „langfristig von Apple unterstützt“ sind daher zwei verschiedene Aussagen. Die Beschreibung des macOS-Sandbox-Systems erklärt den zugrunde liegenden Mechanismus, garantiert aber keine dauerhafte Zukunft von sandbox-exec. Für eine neue Plattformarchitektur sollte die Abhängigkeit dokumentiert und regelmäßig auf Kompatibilität geprüft werden.

Ein ungefährliches Laborprofil kann so aussehen:

(version 1)
(deny default)

(allow process-exec)
(allow process-fork)
(allow signal (target self))

(allow file-read*
    (subpath "/tmp/claude-sbpl-lab"))

(allow file-write*
    (subpath "/tmp/claude-sbpl-lab"))

(allow file-read*
    (literal "/tmp/claude-sbpl-lab/test-policy.txt"))

(deny file-write*
    (literal "/tmp/claude-sbpl-lab/test-policy.txt"))

Dieses Beispiel ist absichtlich klein. Es verwendet nur einen temporären Laborpfad und eine fiktive Testdatei. Es schützt keine echten API-Schlüssel, keine Systemkonfiguration und kein Produktions-Repository. Vor einem Start muss der konkrete Pfad geprüft werden; ein Profil darf nicht blind in ein Alias kopiert werden.

Ein vorsichtiges Alias folgt diesem Muster:

alias claude-sbpl='sandbox-exec -f "$HOME/.config/claude/lab.sb" claude'

Das Alias sollte zunächst nur mit einer temporären Datei getestet werden. Danach sind Schreibversuche innerhalb und außerhalb des Laborpfads zu prüfen. Erst wenn der Prozess erwartungsgemäß blockiert und ein Abbruch korrekt sichtbar wird, kann eine verwaltete Variante in Betracht gezogen werden. Für produktive Flotten ist ein solcher Alias allein zu schwach, weil Benutzer ihn umgehen oder durch einen anderen Startweg ersetzen können.

Anthropic stellt mit dem offiziellen Sandbox-Runtime-Repository eine weitere Referenz für die macOS-Implementierung bereit. Auch dort muss zwischen der Runtime, dem Seatbelt-Mechanismus, sandbox-exec und der Claude-Code-eigenen Bash-Sandbox unterschieden werden. Diese Begriffe bezeichnen nicht automatisch dieselbe Schutzschicht.

Von der Projektdatei zur unabhängigen Umgebung

Die richtige Maßnahme hängt nicht nur vom gewünschten Schreibpfad ab. Entscheidend sind auch Überwachung, Wiederherstellung und die Frage, ob andere Aufgaben denselben Host verwenden.

Für die Entscheidung gelten folgende Abstufungen:

  • Beaufsichtigte Einzelentwicklung: Projektregeln können im Repository bleiben. denyWrite sollte die Policy-Dateien ausschließen. Ein Entwickler bestätigt Ausnahmen manuell und prüft die effektiven Regeln.
  • Teamaufgaben: Sicherheitsvorgaben gehören in managed settings. Änderungen müssen zentral verteilt, nachvollziehbar geprüft und bei Bedarf zurückgerollt werden.
  • Unbeaufsichtigte Agenten: Fail-Closed, kein unkontrollierter unsandboxed Fallback und eine Prozess- oder Host-Isolation sind wichtiger als maximale Befehlskompatibilität.
  • Hohe Auswirkungen: Ein eigener Mac oder eine klar getrennte Mac-Umgebung bietet bessere Wiederherstellbarkeit und verhindert, dass fremde Projekte dieselbe Sicherheitszone teilen.

Die folgende Entscheidungstabelle verbindet Strategieort, Schreibschutz und Betriebsmodell:

Option Ablage der Sicherheitsregeln Schutz gegen Selbständerung Geeignet für Hauptrisiko
Projektkonfiguration Repository, etwa .claude Gering, wenn der Agent den Workspace schreiben darf Beaufsichtigte Entwicklung Policy und Arbeitsdateien liegen in derselben Zone
managed settings Außerhalb der Projektkontrolle Hoch gegenüber Projektänderungen Teams und standardisierte Tasks Host- oder Startprozess bleibt ein möglicher Umgehungspunkt
managed settings plus SBPL Zentral verwaltet und zusätzlich prozessnah begrenzt Höher, sofern das Profil korrekt getestet wird Sensible Automationsläufe sandbox-exec ist veraltet und kann Kompatibilitätsprobleme verursachen
Unabhängiger Mac Getrennte Umgebung mit eigener Wiederherstellung Am stärksten auf Umgebungsebene Unbeaufsichtigte oder risikoreiche Agenten Zusätzlicher Betriebsaufwand und getrennte Zugangsdaten erforderlich

Bei einer entfernten Umgebung müssen außerdem Datenschutz und Zugriffskette geprüft werden. API-Schlüssel sollten nicht im Projekt-Workspace liegen. Sitzungsprotokolle, temporäre Dateien und Wiederherstellungspunkte brauchen eine eigene Aufbewahrungsregel. Für europäische Teams gehören DSGVO-Anforderungen, Datenstandort und Zugriff durch Administratoren in die Freigabeentscheidung. Informationen zu Kontozugriff und Datenschutz finden Sie bei Bedarf in den Datenschutzhinweisen von ProxyMac und in der Hilfe für die Mac-Nutzung.

Wer einen dedizierten Mac für längere Tests erwägt, sollte zuerst drei Fragen schriftlich beantworten:

  1. Welche Dateien darf der Agent verändern?
  2. Welche Policy darf der Agent niemals selbst erreichen?
  3. Was soll passieren, wenn Sandbox oder Netzwerkisolation nicht verfügbar sind?

Erst danach lässt sich beurteilen, ob ein Projektprofil reicht, managed settings notwendig sind oder ein eigener Ausführungsort sinnvoller ist. Für eine kurzfristige Validierung kann eine gemietete Mac-Umgebung den Aufbau eines separaten Testpfads erleichtern; für dauerhaft hohe Last, lokale Hardwareanforderungen oder physische Schnittstellen ist eine eigene Maschine oft die passendere Lösung. Eine Übersicht der verfügbaren Verwaltungswege bietet die ProxyMac-Konsole.

Ein reines Projekt-Setup bleibt langfristig die schwächste Variante, wenn derselbe Agent seine .claude-Dateien, Hooks oder Skills bearbeiten darf. Die integrierte Bash-Sandbox löst dieses Problem nicht automatisch, weil sie nicht mit einem Schutz des gesamten Claude-Code-Prozesses gleichgesetzt werden darf. SBPL kann die Grenze erweitern, bindet den Betreiber aber an eine veraltete macOS-Schnittstelle und verlangt sorgfältige Tests. Für Teams und unbeaufsichtigte Abläufe ist deshalb die Kombination aus geschützten managed settings, Fail-Closed und einer klar getrennten Mac-Umgebung in vielen Fällen die vernünftigere Sicherheitsentscheidung.

Wer jetzt einen langfristigen Claude-Code-Betrieb plant, sollte nicht mit einem allgemeinen Rechenpaket beginnen. Zuerst gehören Policy-Dateien, unbeaufsichtigter Status, erlaubte Schreibpfade und Wiederherstellung festgelegt. Wenn dafür eine isolierte Testumgebung ohne gemeinsame Entwickler-Workspaces benötigt wird, kann ProxyMac als gemietete Mac-Umgebung die Validierung vereinfachen. Entscheidend ist nicht, möglichst viel Zugriff zu buchen, sondern den Agenten so zu platzieren, dass eine veränderte Projektdatei nicht zugleich die Sicherheitsgrenze verändern kann.

Ihre unabhängige Mac-Umgebung für sichere Agentenaufgaben

Mit ProxyMac erhalten Sie einen dedizierten Mac mini M4 für kontrollierte Entwicklungs-, Test- und Automatisierungsprozesse.
Führen Sie unbeaufsichtigte Aufgaben in einer getrennten Umgebung aus, ohne Ihre lokale Arbeitsstation unnötig zu belasten.