Deepseek ArtifactsDeepseek Artifacts
Konfigurations-Guide

Claude Code Settings: Das settings.json-Handbuch

Jede settings.json-Option, die zählt: die vier Konfigurationsdateien und ihre Rangfolge, Modell und Effort, Allow-/Deny-Regeln der Berechtigungen, der env-Block und ein echter Aufräum-Workflow für die settings.local.json — anhand der offiziellen Doku verifiziert.

Kurz zusammengefasst

  • Vier Dateien, eine Hierarchie: managed-settings.json schlägt Kommandozeile schlägt .claude/settings.local.json schlägt .claude/settings.json schlägt ~/.claude/settings.json. Allow-Listen werden über Dateien hinweg zusammengeführt statt einander zu überschreiben.
  • settings.json ist strenges JSON: keine Kommentare, keine Kommas am Ende. Ergänzen Sie die Zeile "$schema": "https://json.schemastore.org/claude-code-settings.json", und Ihr Editor vervollständigt jeden Schlüssel automatisch.
  • Deny-Regeln gewinnen immer. Eine Deny-Regel auf beliebiger Ebene überschreibt jede Allow-Regel — mit Read(./.env) und Bash(git push:*) haben Sie Ihre Secrets und Ihr Remote in zwei Zeilen geschützt.
  • settings.local.json ist Ihre Sandbox nur für diesen Rechner: Sie schlägt die geteilten Projekt-Einstellungen und wird automatisch in die .gitignore eingetragen — persönliche Pfade und Experimente landen nie im Repository.

Claude Code Configuration EP1: The Global Files Decoded (settings.json, CLAUDE.md, skills)

Kanal: Terminode AI2:31

Ansehen

Learning In Public: Cleaning Up Claude Code Settings

Kanal: Ben Nadel5:26

Ansehen

Settings — official documentation

Offizielle Doku: code.claude.com/docs

Ansehen

Settings reference — the full key table

Offizielle Doku: code.claude.com/docs

Ansehen

Environment variables — official reference

Offizielle Doku: code.claude.com/docs

Ansehen

Die Fakten auf dieser Seite sind gegen die offizielle Settings-Dokumentation verifiziert; die beiden Videos oben sind die visuellen Quellen und die Inspiration für den Audit-Workflow.

Screenshots werden ihren Urhebern zugeordnet, mit Deep-Links zu den exakten Zeitstempeln. Keine Kamera-Bilder von Gesichtern.

Die settings.json von Claude Code konfigurieren, Schritt für Schritt

Teil 1 — Die Konfigurationslandschaft kartieren

  1. 1

    Die vier Settings-Dateien kennen

    Claude Code liest Einstellungen aus vier Bereichen: ~/.claude/settings.json (Sie, in jedem Projekt), .claude/settings.json (mit dem Team geteilt, committen Sie sie), .claude/settings.local.json (Sie, nur dieses Projekt) und managed-settings.json (Ihre Organisation). Alles unter ~/.claude — CLAUDE.md, projects, skills, agents, plugins — gehört zur selben Landschaft.

    Claude Code global config map card listing settings.json, CLAUDE.md, projects, skills, agents, plugins and the .claude.json state file inside the ~/.claude directory
    Die globale Ebene auf einen Blick: jede Datei, die Claude Code beim Sitzungsstart aus ~/.claude liest.Ansehen bei 2:28
  2. 2

    ~/.claude/settings.json öffnen oder anlegen

    Auf Mac und Linux liegt die Datei unter ~/.claude/settings.json, auf Windows unter %USERPROFILE%\.claude\settings.json. Legen Sie sie an, falls sie fehlt — Claude Code übernimmt sie in der nächsten Sitzung. Setzen Sie CLAUDE_CONFIG_DIR, wenn der gesamte Konfigurationsordner woanders liegen soll.

    Claude Code settings.json card showing the ~/.claude/settings.json path on Mac and Linux and the Windows USERPROFILE location for themes, model choice and permissions
    Die settings.json steuert Themes, Modellwahl, Plugins, Umgebungsvariablen und Berechtigungen über alle Projekte auf Ihrem Rechner hinweg.Ansehen bei 0:20
  3. 3

    Modell und Effort-Level festzurren

    Setzen Sie "model" auf ein bestimmtes Modell oder auf "opusplan" (Opus plant, Sonnet führt aus) — damit gilt es als Standard für jede neue Sitzung, genau wie die interaktive Wahl über /model. Kombinieren Sie es mit "effortLevel", um das Standard-Grübeln von Claude zu begrenzen, und mit modelSettings für Übersteuerungen pro Modell.

  4. 4

    Den Befehlen den Durchblick geben, denen Sie vertrauen

    Im permissions-Block listet "allow" Tool-Regeln, die den Genehmigungs-Prompt überspringen: "Bash(npm run lint)", "Bash(npm run test *)", "Read(~/.zshrc)". Regeln sind werkzeugbezogene Muster — beim *-Wildcard braucht es ein Leerzeichen davor ("Bash(git push:*)"), damit er nicht längere Befehlsnamen verschluckt.

    Claude Code settings.local.json permissions allow list open in VS Code showing Bash git commands and WebFetch domain allow entries
    Eine echte Allow-Liste aus einer settings.local.json: jeder Eintrag hier war ein Genehmigungs-Prompt, der nie wieder erscheint.Ansehen bei 0:50

Teil 2 — Berechtigungen, env und Übersteuerungen

  1. 5

    Secrets mit Deny-Regeln schützen

    Deny-Regeln werden zuerst ausgewertet, und nichts auf keiner Ebene kann sie übersteuern. Beginnen Sie mit "Read(./.env)" und "Read(./.env.*)", damit API-Keys nie in den Kontext gelangen, dazu "Bash(git push:*)", damit das Veröffentlichen ins Remote eine menschliche Entscheidung bleibt. Ask-Regeln fangen anschließend die Grauzone ab.

  2. 6

    Rechner-lokale Übersteuerungen in settings.local.json aufbewahren

    Wenn Claude Code eine Berechtigung für Sie festhält, landet sie in .claude/settings.local.json — die ebenfalls automatisch in die .gitignore eingetragen wird. Nutzen Sie diese Datei für persönliche Pfade, Experiment-Flags und alles, was Sie Teammitgliedern nicht aufzwingen wollen. Geteilte, bewusste Regeln gehören in .claude/settings.json.

  3. 7

    Secrets und Schalter in den env-Block

    Das "env"-Objekt wendet Umgebungsvariablen auf jede Sitzung an: "ANTHROPIC_API_KEY", "DISABLE_TELEMETRY": "1", "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1" oder CLAUDE_CODE_MAX_OUTPUT_TOKENS. Eine praktische Faustregel aus der Doku: Schlüssel in GROSSBUCHSTABEN innerhalb der settings.json gehören fast immer in env.

  4. 8

    ~/.claude.json nicht mit den Einstellungen verwechseln

    ~/.claude.json ist Zustand, keine Konfiguration: OAuth-Token, MCP-Server-Registrierungen, Vertrauensentscheidungen pro Projekt und globale Schalter liegen dort. Absichten tragen Sie in der settings.json ein; .claude.json verwaltet Claude Code selbstständig — sichern Sie beide, denn cleanupPeriodDays legt auch fest, wie lange der Transkript-Verlauf erhalten bleibt.

    Terminal listing of the ~/.claude folder in Claude Code showing statsig feature flags, the plugins directory, shell snapshots and the .claude.json global state file
    Innerhalb von ~/.claude: Feature-Flags, Plugins, Shell-Snapshots und die Zustandsdatei .claude.json, die leicht für eine Settings-Datei gehalten wird.Ansehen bei 2:00

Teil 3 — Dauerhaft aufgeräumt bleiben

  1. 9

    Was sonst noch in ~/.claude liegt

    CLAUDE.md ist Ihre globale Anweisungsdatei, gelesen am Anfang jeder Sitzung. projects/ speichert Konversationsverlauf und Auto-Memory pro Repository, skills/ enthält SKILL.md-Workflows auf Abruf, agents/ definiert Subagents, plugins/ verfolgt installierte Plugins und statsig/ cached Feature-Flags. Die settings.json orchestriert alle.

    Claude Code CLAUDE.md global instruction file card with personal preferences, code style rules and testing patterns loaded at the start of every session
    CLAUDE.md ist die Geschwisterdatei, die viele für die Einstellungen halten: Sie trägt Präferenzen und Konventionen, keine Konfigurationsschlüssel.Ansehen bei 0:45
  2. 10

    Claude Ihre Allow-Liste prüfen lassen

    Allow-Listen wachsen Prompt um Prompt, bis sich niemand mehr daran erinnert, was darin steht. Öffnen Sie Claude Code und bitten Sie es, .claude/settings.local.json auf redundante, unnötige und riskante Einträge zu prüfen — Claude weiß, welche Tools eingebaut sind und welche Regeln sich überschneiden.

    Claude Code prompt asking Claude to review the permissions allow list in settings.local.json for redundant and overly permissive entries
    Der Audit-Prompt: die Allow-Liste durchsehen und markieren, was redundant ist, was eingebaute Tools dupliziert und was schlicht riskant ist.Ansehen bei 1:40
  3. 11

    Das Urteil wie ein Reviewer lesen

    Im echten Audit, das diese Seite ablichtet, fand Claude 41 Einträge und sortierte sie: ls, grep, find, echo und cd duplizieren eingebaute Tools; Wildcard-Einträge deckten explizite Befehle bereits ab; lokale absolute Pfade waren unnötig, weil Claude sein Arbeitsverzeichnis kennt; curl war der einzige Eintrag, der als wirklich zu weitreichend markiert wurde.

    Claude Code analysis table flagging unnecessary Bash ls, grep and find permission entries that duplicate built-in tools in settings.local.json
    Das Urteil: 41 Einträge sortiert in unnötig, redundant und riskant — mit dem Ersatz für jede Zeile.Ansehen bei 3:05
  4. 12

    Aufräumen anwenden und monatlich nachprüfen

    Genehmigen Sie die vorgeschlagenen Änderungen, und die Datei schrumpft von 41 auf 15 Einträge. Machen Sie es zur Gewohnheit: Eine Allow-Liste, die niemand mehr lesen kann, ist eine Angriffsfläche, die niemand mehr sieht. Führen Sie das Audit nach großen Projekten erneut aus und ziehen Sie eng gefasste Regeln wie Bash(git diff:*) Pauschal-Freigaben vor.

    Claude Code summary of permission changes removing curl, explicit home directory paths and one-off shell script entries from the settings allow list
    Die angewendete Bereinigung: curl, explizite Home-Pfade und Einmal-Shell-Skripte aus der Allow-Liste entfernt.Ansehen bei 4:50

settings.json vs. CLAUDE.md vs. ~/.claude.json vs. /config

Vier Oberflächen fühlen sich alle wie „Claude-Code-Einstellungen“ an — austauschbar sind sie nicht. Welche Datei wofür zuständig ist:

  • 1settings.json (alle Bereiche) — deklarative Konfiguration: model, effort, permissions, env, hooks, statusLine, plugins. Strenges JSON, schema-validiert, commit-sicher (außer der .local-Variante).
  • 2CLAUDE.md — Anweisungen und Konventionen in natürlicher Sprache. Sie formt Verhalten, nicht Konfiguration; es gibt keinen Schlüssel-Wert-Vertrag, und gelesen wird sie in jeder Sitzung.
  • 3~/.claude.json — Maschinenzustand: OAuth-/Sitzungsdaten, MCP-Registrierungen, Vertrauen pro Projekt, Onboarding-Flags. Claude Code schreibt sie; von Hand bearbeiten sollten Sie sie nicht.
  • 4/config — das interaktive Panel. Es ist ein UI über dieselben Schlüssel: Die meisten Schalter schreiben in ~/.claude/settings.json, einige (etwa Show tips) in settings.local.json, und globale Optionen landen in ~/.claude.json.
  • 5managed-settings.json — die Organisationsebene. Sie übersteuert alles (mit wenigen Sicherheitsausnahmen, bei denen der strengere Wert gewinnt) — deshalb kann Ihre lokale Modellwahl auf dem Arbeitsrechner lautlos untergehen.

Faustregel: Verhalten gehört in CLAUDE.md, Konfiguration in settings.json — und wenn ein Wert Sie scheinbar ignoriert, prüfen Sie, ob ~/.claude.json oder eine verwaltete Datei die Entscheidung bereits getroffen hat.

Einstellungen greifen nicht? Erste Hilfe

Die meisten settings.json-Probleme laufen auf fünf Ursachen hinaus. Gehen Sie sie der Reihe nach durch:

  • 1JSON-Syntaxfehler. settings.json ist strenges JSON — ein Komma zu viel oder ein //-Kommentar, und die ganze Datei wird verworfen. Fügen Sie sie in einen Validator ein oder ergänzen Sie die $schema-Zeile, damit Ihr Editor Fehler schon beim Tippen markiert.
  • 2Eine strengere Regel über Ihnen. Verwaltete Einstellungen und sicherheitsrelevante Schlüssel (etwa disableClaudeAiConnectors oder useAutoModeDuringPlan) schlagen Ihre Datei in jedem Fall. Prüfen Sie, ob ein Arbeitsrechner Sie übersteuert.
  • 3Falsche Datei, falscher Bereich. Regeln in .claude/settings.json gelten nur innerhalb dieses Projekts; defaultMode-Werte wie auto und bypassPermissions werden in Dateien auf Projektebene absichtlich ignoriert.
  • 4Env-Werte am falschen Ort. Schlüssel in GROSSBUCHSTABEN gehören in den env-Block, nicht auf die oberste Ebene. Wenn ANTHROPIC_API_KEY oder DISABLE_TELEMETRY ignoriert scheinen, liegen sie vermutlich eine Ebene zu hoch.
  • 5Stillschweigend verworfene Einträge. Führen Sie claude doctor aus, um Settings-Einträge aufzulisten, die die Validierung nicht bestanden haben, und /status in einer Sitzung, um zu sehen, welche Dateien tatsächlich geladen wurden.

Weiterhin blockiert? Löschen Sie Ihre letzte Änderung, bestätigen Sie mit /status, dass die Datei lädt, und spielen Sie die Änderung dann Schlüssel für Schlüssel erneut ein — die Datei halbieren schlägt sie anzustarren.

Häufige Fragen

Weitere Claude-Code-Guides