Configured Agent für Claude Code
Offizieller Anthropic-Skill für konfigurierbare Plugin-Einstellungen und lokalen Zustand.
- Skill Road
- Configured Agent für Claude Code
Configured Agent ist die eindeutige Skill-Road-Zuordnung des Smithery-Slugs configured-agent zum offiziellen Anthropic-Pfad plugin-settings im Repository claude-code. Der Katalogname folgt der Registry-Bezeichnung, während die offizielle Primärquelle die fachliche Identität bestimmt. Anthropic beschreibt dort ein Muster, mit dem Claude-Code-Plugins projektbezogene Einstellungen und Zustand in einer Datei unter .claude speichern können. Die Datei trägt den Plugin-Namen mit dem Suffix .local.md, enthält YAML-Frontmatter für strukturierte Werte und kann darunter zusätzlichen Markdown-Kontext aufnehmen. Diese Ressource ist deshalb als Skill und nicht als eigenständiger Agent, Server oder ausführbares Plugin eingeordnet.
Zweck und fachliche Einordnung
Das Muster richtet sich an Plugin-Maintainer, Entwicklerinnen und Entwickler sowie Teams, die das Verhalten eines Plugins pro Projekt steuerbar machen wollen. Laut Anbieter können Hooks, Commands und Agents die Datei lesen und daraus erwartete Konfigurationswerte übernehmen. Ein fehlendes Dokument gilt als normaler Zustand. Ein Plugin kann dann sichere Defaults verwenden oder eine optionale Funktion überspringen. Diese Eigenschaft trennt gemeinsam ausgelieferte Plugin-Logik von lokalen Präferenzen und verhindert, dass der Zustand eines einzelnen Rechners unbemerkt zur Teamkonvention wird. Der Skill dokumentiert ein Dateimuster; er installiert keine Erweiterung und gewährt keine zusätzlichen Berechtigungen.
Aufbau und Arbeitsweise
Anthropic beschreibt YAML-Frontmatter zwischen zwei Begrenzungszeilen und einen Markdown-Teil für weitere Hinweise, Aufgabenbeschreibung oder Kontext. In der Konfiguration können beispielsweise Aktivierungsflags, Modi, Zahlenwerte, Textwerte und einfache Listen stehen. Verantwortungsvolle Implementierungen prüfen zunächst, ob die Datei existiert, lesen nur ein begrenztes Schema und validieren jeden Wert vor der Verwendung. Boolesche Werte sollten strikt verglichen werden, Zahlen benötigen nachvollziehbare Grenzen und Pfade dürfen keine unerwarteten Ziele oder Traversal enthalten. Ein erfolgreicher Lesevorgang ist noch keine fachliche Freigabe für einen Hook oder ein Skript.
Lebenszyklus und Teamgrenzen
Die Datei ist für ein einzelnes Projekt und lokale Anpassungen gedacht. Laut Anbieter soll sie nicht in Git eingecheckt werden; passende Regeln in .gitignore helfen gegen versehentliche Weitergabe. Nach einer Änderung muss Claude Code neu gestartet werden, damit Hooks die neue Konfiguration erkennen. Der Skill empfiehlt für Plugin-eigene Ressourcen die Variable CLAUDE_PLUGIN_ROOT statt hart codierter Pfade. Teams sollten Schema, Defaults, zulässige Werte, Laufzeitabhängigkeiten und Neustartverhalten im Plugin dokumentieren. Gemeinsame Standards gehören in versionierte Plugin-Dateien, nicht in lokale Zustandsdateien.
Dateiformat und Auslesen
Die Einstellungen liegen in einer Datei nach dem Muster .claude/plugin-name.local.md im Projekt. Sie besteht aus YAML-Frontmatter zwischen zwei Zeilen mit --- und freiem Markdown darunter. Typische Felder sind Wahrheitswerte wie enabled: true, Texte, Zahlen und Listen. Hooks lesen das Frontmatter in Bash mit sed aus und prüfen zuerst, ob die Datei existiert. Fehlt sie, beendet sich der Hook ohne Fehler. Die Dateien gehören in die .gitignore (.claude/*.local.md). Änderungen greifen erst nach einem Neustart von Claude Code, weil Hooks nicht während einer Sitzung ausgetauscht werden.
Sicherheit und Grenzen
Konfigurationsdateien sind Eingaben und können sensible oder missverständliche Inhalte enthalten. Geheimnisse, Tokens und Zugangsdaten gehören nicht in diese Datei. Vor einer Aktivierung müssen Hooks, Shell-Skripte, Netzwerkzugriffe, Schreiboperationen und Umgebungsvariablen separat geprüft werden. Das Frontmatter-Format verleiht keine Berechtigungen und beweist keine Vertrauenswürdigkeit. Ebenso ersetzt es keine zentrale Geheimnisverwaltung, keine Codeprüfung und keine Absicherung gegen Prompt-Injection. Skill Road führt den Eintrag laut Anbieterangaben als externen, verifizierten Anthropic-Skill und nennt keine konkreten Preise. Aktuelle Verfügbarkeit und Nutzungsbedingungen von Claude Code und verbundenen Diensten sind beim Anbieter zu prüfen.
Installationsanleitung
Schritt 1: Was ein Configured Agent für Claude Code ist und wofür er gebraucht wird
Ein Configured Agent bezeichnet in Claude Code einen benutzerdefinierten Subagenten, also einen spezialisierten KI-Assistenten mit eigenem Systemprompt, eigenem Werkzeugzugriff und eigenen Berechtigungen, der für einen bestimmten Aufgabentyp konfiguriert wurde. Laut der offiziellen Claude-Code-Dokumentation von Anthropic unter code.claude.com sind Subagenten dafür gedacht, Aufgaben zu übernehmen, die andernfalls die Hauptkonversation mit Suchergebnissen, Logs oder Dateiinhalten überfluten würden, die später nicht mehr benötigt werden. Der Subagent erledigt diese Arbeit in einem eigenen, isolierten Kontextfenster und liefert am Ende nur eine Zusammenfassung an die Hauptsitzung zurück. Das ist relevant, weil Claude Code als Coding-Agent bei komplexen, mehrstufigen Aufgaben schnell an die Grenzen des verfügbaren Kontextfensters stößt; ein gut konfigurierter Subagent hält die Hauptsitzung schlank, während er gleichzeitig auf ein enger gefasstes Set an Werkzeugen und Regeln beschränkt werden kann, was Kosten senkt und die Ergebnisqualität für wiederkehrende, klar abgegrenzte Aufgaben verbessert.
Schritt 2: Voraussetzungen
Voraussetzung ist eine installierte und lauffähige Version von Claude Code, da Subagenten eine reine Funktion dieses Produkts sind. Ein Subagent wird laut Dokumentation als einzelne Datei mit YAML-Frontmatter definiert, in der mindestens die Felder name und description gesetzt sein müssen; alle weiteren Felder wie tools, model oder permissionMode sind optional. Um Subagenten projektübergreifend wiederzuverwenden, empfiehlt sich das Ablegen auf Benutzerebene statt auf Projektebene, wofür Kenntnis der jeweiligen Verzeichnisstruktur von Claude Code nötig ist. Wer Subagenten mit eigenen MCP-Servern verknüpfen möchte, benötigt zusätzlich eine funktionierende MCP-Serverkonfiguration, und wer bestimmte Modelle wie Haiku für kostengünstigere Subagenten nutzen will, braucht Zugriff auf das entsprechende Anthropic-Modellkontingent.
Schritt 3: Einrichtung Schritt für Schritt
Ein neuer Subagent wird angelegt, indem eine Datei mit YAML-Frontmatter im entsprechenden Skills- beziehungsweise Agents-Verzeichnis von Claude Code erstellt wird; der Dateiname muss laut Dokumentation nicht mit dem name-Feld übereinstimmen, darf aber keinen Doppelpunkt enthalten, da dieser für plugin-eigene Bezeichner reserviert ist. Im ersten Schritt wird der Gültigkeitsbereich gewählt, also ob der Subagent nur für das aktuelle Projekt oder global für den Nutzer verfügbar sein soll. Anschließend wird eine kurze, präzise description formuliert, da Claude anhand dieser Beschreibung entscheidet, wann eine Aufgabe an den Subagenten delegiert wird; zu lange Beschreibungen aller Subagenten zusammen verbrauchen laut Anbieter ab etwa 15.000 Token spürbar Kontext und lösen eine Warnung beim Start aus. Danach werden optional das Werkzeug-Set über tools und disallowedTools eingeschränkt, ein Modell über model festgelegt und bei Bedarf ein Berechtigungsmodus über permissionMode gewählt. Abschließend kann der Subagent entweder automatisch durch Claude anhand der Beschreibung aufgerufen oder explizit vom Nutzer angesprochen werden.
Sicherheit und Best Practices
Aus Sicherheitssicht ist die wichtigste Stellschraube die gezielte Einschränkung des Werkzeugzugriffs über die Felder tools und disallowedTools, da ein Subagent standardmäßig alle für Subagenten verfügbaren Werkzeuge erbt, wenn nichts angegeben wird. Laut Dokumentation entfernt ein Eintrag mit Spezifizierer, etwa Bash(git push *), das gesamte zugehörige Werkzeug und nicht nur den angegebenen Teilbefehl, was bei der Konfiguration berücksichtigt werden sollte. Das Feld permissionMode erlaubt zusätzlich, einen Subagenten strenger als die Hauptsitzung laufen zu lassen, etwa im Plan-Modus ohne Ausführungsrechte. Der Anbieter empfiehlt außerdem, die maximale Anzahl an Turns über maxTurns zu begrenzen, um unkontrolliert lange Läufe zu vermeiden, sowie das Feld omitClaudeMd zu nutzen, wenn ein Subagent bewusst ohne projektspezifische CLAUDE.md-Regeln arbeiten soll, weil er alle nötigen Informationen bereits über den Delegationsprompt erhält.
Praxisbeispiel und Grenzen
Ein typisches Beispiel aus der offiziellen Dokumentation ist ein Code-Reviewer-Subagent, der ausschließlich Lese- und Analysewerkzeuge erhält und bei jeder Codeänderung automatisch delegierte Reviews durchführt, ohne selbst Schreibzugriff auf das Repository zu besitzen, oder ein Datenbank-Query-Validator, der Anfragen prüft, bevor sie ausgeführt werden. Die Grenzen liegen darin, dass Subagenten innerhalb einer einzelnen Sitzung arbeiten und sich nicht für vollständig unabhängige, parallel laufende Sitzungen eignen; dafür verweist die Dokumentation auf separate Konzepte wie Background Agents oder Agent Teams. Zudem verbraucht jede zusätzliche description Kontext bereits beim Start von Claude Code, weshalb eine zu große Zahl an Subagenten mit ausführlichen Beschreibungen selbst zum Performance-Problem werden kann.
- Anbieter
- Anthropic
- Lizenz
- Apache-2.0
- Zuletzt geprüft
- 09.09.2026
Repository und Dokumentation
Kategorien
Kompatibel mit
Passende Ratgeber
Anleitungen und Hintergrund, die zu diesem Eintrag passen.