Plugin Settings for Claude Code

Plugin Settings for Claude Code ist ein offizieller Skill aus dem Repository claude-plugins-official von Anthropic. Er beschreibt ein einfaches, projektbezogenes Muster, mit dem ein Claude-Code-Plugin konfigurierbare Einstellungen und verwalteten Zustand ablegen kann. Die zentrale Datei liegt im Projektverzeichnis unter .claude und folgt dem Namen des Plugins mit dem Zusatz .local.md. Sie verbindet YAML-Frontmatter für strukturierte Werte mit einem Markdown-Textkörper für zusätzlichen Kontext. Damit richtet sich der Skill an Entwicklerinnen, Entwickler, Maintainer und Coding-Agenten, die Plugin-Verhalten nachvollziehbar an ein Projekt anpassen wollen, ohne die eigentlichen Plugin-Dateien mit persönlichen oder lokalen Werten zu vermischen.

Zweck und Einordnung

Der Skill ist eine Dokumentation für ein Konfigurationsmuster, kein ausführbares Plugin und kein eigenständiger Agent. Er installiert keine Erweiterung und ersetzt weder Claude Code noch eine Sicherheitsprüfung. Laut Anbieter können Hooks, Commands und Agents die lokale Datei lesen und ihre Logik daran ausrichten. Ein fehlendes Einstellungsdokument soll dabei als normaler Zustand behandelt werden, sodass ein Plugin sinnvolle Standardwerte verwenden oder seine optionale Funktion überspringen kann. Diese Trennung zwischen Standardverhalten und lokaler Konfiguration erleichtert reproduzierbare Projekte und verhindert, dass ein einzelner Rechnerzustand unbemerkt zur Teamkonvention wird.

Dateiaufbau und Nutzung

Das Frontmatter wird zwischen zwei Begrenzungszeilen mit drei Bindestrichen geschrieben. Dort können etwa Aktivierungsflags, Modi, Zahlenwerte, Textwerte oder einfache Listen stehen. Nach dem abschließenden Begrenzungsabschnitt kann der Markdown-Körper Aufgabenbeschreibung, Projektkontext oder weitere Hinweise enthalten. Der Skill erklärt, wie Hooks und andere Plugin-Komponenten zunächst die Existenz der Datei prüfen, danach das Frontmatter lesen und schließlich einzelne Werte validieren. Für Commands und Agents dient dasselbe Muster als explizite Anweisung: Sie prüfen die Datei, übernehmen nur erwartete Einstellungen und wenden diese an der passenden Stelle an. Ein Plugin sollte nicht voraussetzen, dass jede Datei vollständig oder fehlerfrei ist.

Portabilität und Lebenszyklus

Die Datei ist für ein einzelnes Projekt gedacht und soll normalerweise nicht in Git eingecheckt werden. Laut Anbieter gehört die Endung .local.md zum Muster; passende Einträge in .gitignore schützen lokale Werte vor versehentlicher Weitergabe. Der Skill empfiehlt außerdem, Pfade nicht hart zu codieren und bei Zugriffen auf Plugin-eigene Ressourcen die Variable CLAUDE_PLUGIN_ROOT zu verwenden. Nach einer Änderung an Einstellungen ist ein Neustart von Claude Code erforderlich, damit Hooks neue Werte erkennen. Das ist eine bewusste Grenze des Musters: Es handelt sich nicht um eine hot-swappable Sitzungskonfiguration.

Validierung und Sicherheit

Konfigurationswerte müssen wie Eingaben behandelt werden. Ein Plugin sollte boolesche Werte strikt vergleichen, Zahlenbereiche prüfen und Dateipfade gegen Traversal sowie unerwartete Ziele absichern. Werden Werte aus Benutzereingaben geschrieben, müssen Anführungszeichen und Zeilenumbrüche sicher behandelt werden. Die Datei sollte nur für den zuständigen Benutzer lesbar sein, soweit die lokale Umgebung das erlaubt. Besonders wichtig ist die Prüfung von Hooks, Shell-Skripten, Netzwerkzugriffen und Schreiboperationen, denn das Einstellungsformat selbst gewährt keine Berechtigungen und beweist keine Vertrauenswürdigkeit. Der Skill ist daher eine praktische Architekturhilfe für konfigurierte Plugins, aber keine Freigabe für riskante Automatisierung.

Geeignete Einsatzgrenzen

Das Muster passt zu per-Projekt-Präferenzen, temporär aktivierbaren Hooks, Agentenzustand und ergänzendem Markdown-Kontext. Es passt nicht als Ersatz für zentrale Geheimnisverwaltung, als gemeinsamer Speicher für sensible Teamdaten oder als Begründung für unkontrollierte externe Aktionen. Teams sollten Schema, Defaults, erlaubte Werte, benötigte Laufzeitprogramme und Neustartverhalten im Plugin dokumentieren. Skill Road führt diese Ressource als externen, verifizierten Anthropic-Skill und nennt keine konkreten Preise. Verfügbarkeit und aktuelle Nutzungsbedingungen von Claude Code, Modellen und verbundenen Diensten sind separat beim Anbieter zu prüfen.