Ausgabestile
Passen Sie Claude Code für Anwendungsfälle über Softwareentwicklung hinaus an
Ausgabestile ändern, wie Claude antwortet, nicht was Claude weiß. Sie ändern die Systemaufforderung, um Rolle, Ton und Ausgabeformat festzulegen. Verwenden Sie einen, wenn Sie sich in jedem Durchgang immer wieder nach derselben Stimme oder demselben Format erkundigen, oder wenn Sie möchten, dass Claude als etwas anderes als ein Softwareentwickler fungiert.
Ein benutzerdefinierter Ausgabestil fügt Ihre Anweisungen zur Systemaufforderung hinzu und lässt Sie wählen, ob Sie die integrierten Softwareentwicklungsanweisungen von Claude Code beibehalten möchten. Behalten Sie sie, wenn Sie ändern, wie Claude kommuniziert, aber immer noch codiert, z. B. immer mit einem Diagramm antwortet. Lassen Sie sie weg, wenn Claude überhaupt keine Softwareentwicklung durchführt, z. B. als Schreib-Assistent oder Datenanalyst.
Für Anweisungen zu Ihrem Projekt, Konventionen oder Ihrer Codebasis verwenden Sie stattdessen CLAUDE.md.
Integrierte Ausgabestile
Der Standard-Ausgabestil von Claude Code ist die vorhandene Systemaufforderung, die Ihnen helfen soll, Softwareentwicklungsaufgaben effizient zu bewältigen.
Es gibt vier zusätzliche integrierte Ausgabestile:
-
Proaktiv: Claude führt sofort aus, trifft vernünftige Annahmen statt bei Routineentscheidungen zu pausieren, und bevorzugt Handeln gegenüber Planung. Dies ist eine stärkere Anleitung zur autonomen Ausführung als Auto-Modus bietet, und es funktioniert ohne Änderung Ihres Berechtigungsmodus, sodass Ihr Berechtigungsmodus weiterhin entscheidet, was ausgeführt wird, ohne Sie zu fragen.
-
Prägnant: Claude führt mit dem Ergebnis an, überspringt Präambel und Erzählung, und hält Antworten standardmäßig kurz, während die Softwareentwicklungsarbeit genauso gründlich wie im Standard-Stil durchgeführt wird. Wenn Sie um eine Erklärung oder mehr Details bitten, antwortet Claude vollständig. Claude behält immer den vollständigen Inhalt von Fehlerberichten, Sicherheitswarnungen und Bestätigungen für destruktive Aktionen. Erfordert Claude Code v2.1.237 oder später.
-
Explanatory: Bietet pädagogische „Insights" zwischen der Unterstützung bei Softwareentwicklungsaufgaben. Hilft Ihnen, Implementierungsentscheidungen und Codebase-Muster zu verstehen.
-
Learning: Kollaborativer, Lern-durch-Tun-Modus, in dem Claude nicht nur „Insights" beim Codieren teilt, sondern Sie auch auffordert, kleine, strategische Codestücke selbst beizutragen. Claude Code fügt
TODO(human)-Marker in Ihren Code ein, damit Sie diese implementieren können.
Ändern Sie Ihren Ausgabestil
Wählen Sie einen Stil auf eine dieser Arten:
- Terminal: Führen Sie
/configaus und wählen Sie Output style, um einen Stil aus einem Menü auszuwählen. Claude Code speichert Ihre Auswahl in.claude/settings.local.jsonauf der lokalen Projektebene. - VS Code-Erweiterung: Öffnen Sie das Befehlsmenü mit
/und wählen Sie Output styles, um einen Stil auszuwählen, einschließlich Ihrer benutzerdefinierten Stile. Claude Code speichert Ihre Auswahl in.claude/settings.local.json, derselben Datei, in die das Terminal-Menü schreibt. Erfordert Claude Code v2.1.257 oder später. - Desktop-App: Legen Sie das Feld
outputStylein einer Einstellungsdatei fest, beispielsweise.claude/settings.local.json, die Datei, in die das Terminal-Menü schreibt. Wenn Sie dort/configausführen, öffnet Claude Code Einstellungen > Claude Code statt eines Menüs.
Um einen Stil ohne Menü festzulegen, bearbeiten Sie das Feld outputStyle direkt in einer Einstellungsdatei:
{
"outputStyle": "Explanatory"
}
Wenn Sie Stile während einer Sitzung wechseln, verwendet Claude den neuen Stil ab Ihrer nächsten Nachricht. Der Stil ist Teil der Systemaufforderung, daher wird die Prompt-Cache bei dieser ersten Nachricht einmal neu erstellt. Vor v2.1.251 wurde der neue Stil erst nach dem Ausführen von /clear oder dem Starten einer neuen Sitzung angewendet.
Erstellen Sie einen benutzerdefinierten Ausgabestil
Ein benutzerdefinierter Ausgabestil ist eine Markdown-Datei: Frontmatter für Metadaten, dann die Anweisungen, die zur Systemaufforderung hinzugefügt werden.
Erstellen Sie eine Markdown-Datei
Speichern Sie sie auf einer von drei Ebenen. Der Dateiname wird zum Stilnamen, es sei denn, Sie legen name im Frontmatter fest.
- Benutzer:
~/.claude/output-styles - Projekt:
.claude/output-styles - Verwaltete Richtlinie:
.claude/output-stylesim Verzeichnis für verwaltete Einstellungen
Projekt-Ausgabestile werden aus jedem .claude/output-styles/ zwischen dem Arbeitsverzeichnis und dem Repository-Root geladen. Wenn mehr als eines dieser verschachtelten Verzeichnisse einen Stil mit demselben Namen definiert, verwendet Claude Code denjenigen, der dem Arbeitsverzeichnis am nächsten ist.
Fügen Sie Frontmatter und Anweisungen hinzu
Entscheiden Sie, ob Sie die Softwareentwicklungsanweisungen von Claude Code beibehalten möchten. Setzen Sie keep-coding-instructions: true, wenn Sie ändern, wie Claude kommuniziert, aber möchten, dass es auf die gleiche Weise codiert. Lassen Sie es weg, wenn Claude keine Softwareentwicklung durchführt.
Dieses Beispiel leitet jede Erklärung mit einem Diagramm ein und behält Claudes Codierungsverhalten bei:
---
name: Diagrams first
description: Lead every explanation with a diagram
keep-coding-instructions: true
---
When explaining code, architecture, or data flow, start with a Mermaid diagram showing the structure, then explain in prose.
## Diagram conventions
Use `flowchart TD` for control flow and `sequenceDiagram` for request paths. Keep diagrams under 15 nodes.
Wechseln Sie zu Ihrem Stil
Führen Sie /config im Terminal aus und wählen Sie Ihren Stil unter Output style. Claude verwendet den neuen Stil ab Ihrer nächsten Nachricht. Im Terminal liest Claude Code Stildateien beim Start, daher müssen Sie Claude Code neu starten, wenn Sie eine Datei während einer laufenden Sitzung erstellen oder bearbeiten, um die Änderung zu übernehmen.
Plugins können auch Ausgabestile in einem output-styles/-Verzeichnis bereitstellen.
Frontmatter
Ausgabestil-Dateien unterstützen diese Frontmatter-Felder:
| Frontmatter | Zweck | Standard |
|---|---|---|
name |
Name des Ausgabestils, falls nicht der Dateiname | Wird vom Dateinamen geerbt |
description |
Beschreibung des Ausgabestils, angezeigt in der /config-Auswahl |
Keine |
keep-coding-instructions |
Behalten Sie die integrierten Softwareentwicklungsanweisungen von Claude Code | false |
force-for-plugin |
Nur Plugin-Ausgabestile: Wenden Sie diesen Stil automatisch an, wenn das Plugin aktiviert ist, ohne dass Benutzer ihn auswählen müssen. Überschreibt die outputStyle-Einstellung des Benutzers. Wenn mehrere aktivierte Plugins dies festlegen, verwendet Claude Code das zuerst geladene. |
false |
Wie Ausgabestile funktionieren
Ausgabestile ändern direkt die Systemaufforderung von Claude Code.
- Claude Code fügt die benutzerdefinierten Anweisungen des Ausgabestils zur Systemaufforderung hinzu.
- Wenn Sie einen anderen Stil als Standard wählen, erinnert Claude Code Claude während des Gesprächs auch an den Stil.
- Benutzerdefinierte Ausgabestile lassen die integrierten Softwareentwicklungsanweisungen von Claude Code weg, z. B. wie man Änderungen begrenzt, Kommentare schreibt und Arbeiten überprüft, es sei denn,
keep-coding-instructionsist auftruegesetzt.
Ausgabestile gelten nur für das Hauptgespräch: Ein Subagent führt seine eigene Systemaufforderung aus, daher ändern Stile nicht, wie Subagents reagieren. Ein Fork ist die Ausnahme, da er die vollständige Systemaufforderung des übergeordneten Elements erbt.
Die Tokennutzung hängt vom Stil ab. Das Hinzufügen von Anweisungen zur Systemaufforderung erhöht die Eingabe-Token, obwohl Prompt Caching diese Kosten nach der ersten Anfrage in einer Sitzung reduziert. Die integrierten Explanatory- und Learning-Stile erzeugen absichtlich längere Antworten als Standard, was die Ausgabe-Token erhöht, und der Concise-Stil bewirkt das Gegenteil, indem Claude angewiesen wird, Antworten standardmäßig kurz zu halten. Bei benutzerdefinierten Stilen hängt die Tokennutzung für die Ausgabe davon ab, was Ihre Anweisungen Claude zu produzieren sagen.
Vergleiche mit verwandten Funktionen
Mehrere Funktionen passen an, wie sich Claude Code verhält. Ausgabestile ändern die Systemaufforderung direkt und gelten für jede Antwort. Die anderen fügen Anweisungen hinzu, ohne die Standard-Systemaufforderung zu ändern, oder begrenzen sie auf eine bestimmte Aufgabe.
| Funktion | Wie es funktioniert | Verwenden Sie es, wenn |
|---|---|---|
| Ausgabestile | Ändert die Systemaufforderung | Sie möchten in jedem Durchgang eine andere Rolle, einen anderen Ton oder ein anderes Standard-Antwortformat |
| CLAUDE.md | Fügt eine Benutzernachricht nach der Systemaufforderung hinzu | Claude sollte immer Ihre Projektkonventionen und Codebase-Kontext kennen |
--append-system-prompt |
Hängt an die Systemaufforderung an, ohne etwas zu entfernen | Sie möchten eine einmalige Ergänzung für einen einzelnen Aufruf |
| Agents | Führt einen Subagent mit seiner eigenen Systemaufforderung, seinem Modell und seinen Tools aus | Sie möchten einen separat definierten Helper für eine fokussierte Aufgabe |
| Skills | Lädt aufgabenspezifische Anweisungen, wenn aufgerufen oder relevant | Sie haben einen wiederverwendbaren Workflow |
Verwandte Ressourcen
- Settings: wo das Feld
outputStylelebt und wie die Einstellungspriorität funktioniert - Permission modes: wie der Proactive-Stil den Auto-Modus vergleicht
- Plugins: Verpacken und verteilen Sie Ausgabestile zusammen mit Skills, Hooks und Agents
- Debug your configuration: Diagnostizieren Sie, warum ein Ausgabestil nicht wirksam wird