Einstellungen

settings.json enthält die Konfiguration des Claude Code-Harness: Hook-Verdrahtung, Tool-Berechtigungen, Umgebungsvariablen und Statuszeilen-Einstellungen.

Die vollständige kanonische Referenz liegt unter settings-reference.md. Diese Seite fasst den Vertrag zusammen und verweist auf die ausführlichere Referenz.

AbschnitteCopy Anchor Link

Invariante der einzelnen VorlageCopy Anchor Link

Der Claude Code-Adapter liefert eine einzige settings.json-Vorlage aus. Hook-Befehle verwenden die Exec-Form (command plus args) statt shell-spezifischer Befehlszeichenketten, sodass das betriebssystemübergreifende Verhalten in einer einzigen Datei geprüft wird. Neue Berechtigungseinträge und Hook-Ereignisse landen atomar in dieser Datei.

Zusammenführen mit Ihrer eigenen Settings-DateiCopy Anchor Link

settings.json ist auch Ihre Datei. Die Installation führt die Vorlage in sie zusammen, statt sie zu ersetzen, und hält im Installations-Ledger (~/.apothem/state/<harness>/ledger.jsonl) genau fest, welche Schlüssel und Listeneinträge sie hinzugefügt hat:

• permissions.allow und permissions.deny werden als Vereinigungsmenge zusammengeführt: Ihre Regeln bleiben vorn, und die von Apothem werden angehängt. Eine Deny-Regel, die Sie geschrieben haben, bleibt immer erhalten, und Claude Code wendet Deny-Regeln vor Allow-Regeln an.
• Ihre eigenen Hook-Handler bleiben an Ort und Stelle. Ein Handler gilt nur dann als Apothems, wenn er ein Skript ausführt, das Apothem unter der Harness-Wurzel installiert hat; ein Handler, der irgendein anderes hooks/dispatch.py aufruft, gehört also Ihnen.
• Eine erneute Installation ersetzt nur, was Apothem beim letzten Mal hinzugefügt hat; ein Eintrag, den die Vorlage nicht mehr enthält, wird also entfernt, und ein Eintrag, den Sie hinzugefügt haben, bleibt erhalten.
• Die Deinstallation entfernt nur die Einträge, die das Ledger als Apothems verzeichnet. Eine Regel, die zufällig einer von Apothems Regeln gleicht (zum Beispiel Read in Ihrer eigenen allow-Liste vor der ersten Installation), bleibt erhalten. Die Datei wird nur gelöscht, wenn Apothem sie erstellt hat und nichts von Ihnen übrig ist.

Dieselben Regeln gelten für die anderen Settings-Dateien, in die Apothem zusammenführt, etwa die MCP-Server-Maps in der settings.json von Qwen Code und in der opencode.json von OpenCode.