Plugin Settings for Claude Code

Offizieller Anthropic-Skill für projektbezogene Plugin-Konfiguration und Zustandsdateien mit YAML-Frontmatter.

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.

Installationsanleitung

Dieser Ratgeber überträgt die offizielle Anthropic-Dokumentation zum Plugin-Settings-Muster in einen kontrollierten Arbeitsablauf. Ziel ist eine lokale Konfiguration, die verständlich, portabel und aus dem Team-Repository ausgeschlossen bleibt.

Schritt 1: Konfigurationsschema festlegen

Definieren Sie zuerst die wenigen Werte, die ein Plugin wirklich benötigt. Benennen Sie Typen, zulässige Werte und Defaults. Ein fehlendes Dokument muss einen sicheren und fachlich brauchbaren Standardpfad auslösen. Vermeiden Sie sensible Inhalte und speichern Sie keine Zugangsdaten in einer Projektdatei.

Lokale Datei anlegen

Legen Sie im Projektverzeichnis den Ordner .claude an und verwenden Sie den Plugin-Namen mit dem Suffix .local.md. Schreiben Sie strukturierte Werte zwischen die beiden Frontmatter-Begrenzer und nutzen Sie den Markdown-Körper nur für ergänzenden Kontext. Ergänzen Sie passende .gitignore-Regeln, damit lokale Dateien nicht versehentlich versioniert werden.

Lesen und validieren

Lesen Sie die Datei erst nach einer Existenzprüfung. Begrenzen Sie das erwartete Schema, prüfen Sie boolesche und numerische Werte und behandeln Sie ungültige Angaben mit Defaults oder einem klaren Abbruch. Pfade benötigen eine eigene Prüfung gegen Traversal und unerwartete Schreibziele. Hooks, Commands und Agents dürfen aus der Datei keine zusätzlichen Berechtigungen ableiten.

Schritt 2: Änderung aktivieren

Dokumentieren Sie, dass eine Änderung einen Neustart von Claude Code erfordert. Prüfen Sie nach dem Neustart, ob das Plugin die erwartete Konfiguration liest und bei fehlender Datei weiterhin sicher arbeitet. Testen Sie jede optionale Funktion getrennt von der Konfigurationsdatei, damit ein erfolgreicher Lesevorgang nicht mit einer fachlichen oder sicherheitstechnischen Freigabe verwechselt wird.

Schritt 3: Weitergabe prüfen

Lesen Sie alle Hooks und Skripte vor einer Teamfreigabe. Prüfen Sie Netzwerkzugriffe, Dateischreibvorgänge, Umgebungsvariablen, Laufzeitabhängigkeiten und mögliche Prompt-Injection-Pfade. Halten Sie die lokale Datei aus Git und teilen Sie sensible Werte über dafür vorgesehene Mechanismen. Der Anbieter beschreibt das Muster als Plugin-Konfiguration und Zustand; es ersetzt keine zentrale Geheimnisverwaltung.

Kostenlos
Anbieter
Anthropic
Lizenz
Apache-2.0
Zuletzt geprüft
09.09.2026

Repository und Dokumentation

Kategorien

Kompatibel mit

Claude Code