Ausgabestile
Passen Sie Claude Code für Anwendungsfälle über Softwareentwicklung hinaus an
Ausgabestile ändern, wie Claude antwortet, nicht was Claude weiß. Sie legen Claudes Rolle, Ton und Ausgabeformat für jede Antwort fest. 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 gibt Claude Ihre eigenen Anweisungen 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 sein Standard-Anweisungssatz, der 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:
-
/output-styleBefehl: Führen Sie/output-style <style>aus, um zu wechseln, zum Beispiel/output-style concise. Ohne Argument listet der Befehl die Stile auf, die Sie auswählen können, und markiert den aktuellen. Claude Code speichert Ihre Auswahl in.claude/settings.local.jsonauf der lokalen Projektebene.Der Befehl funktioniert auch im nicht-interaktiven Modus und Agent SDK-Sitzungen sowie über die mobile App oder das Web über Remote Control, wo Sie nur integrierte Stile auflisten und auswählen können. Erfordert Claude Code v2.1.269 oder später.
-
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. Informationen zu den Kosten dieser ersten Nachricht für Prompt Caching finden Sie unter Ausgabestil ändern. 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 für Claude.
In der VS Code-Erweiterung können Sie die Datei auch über das Menü Output styles erstellen, anstatt sie von Hand zu schreiben. Dies erfordert Claude Code v2.1.261 oder später.
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 /output-style <style> im Terminal aus, oder führen Sie /config 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
Ein Ausgabestil ändert die Anweisungen, die Claude Code Claude gibt.
- Claude Code sendet die Anweisungen des aktiven Stils mit jeder Anfrage.
- 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 für das Hauptgespräch und für einen Fork, der die vollständige Konversation und Systemaufforderung des übergeordneten Elements erbt. Andere Subagents führen ihre eigene Systemaufforderung aus, daher ändern Stile nicht, wie sie reagieren.
Die Tokennutzung hängt vom Stil ab. Die Anweisungen eines Stils erhöhen 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. 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 Standardanweisungen von Claude Code und gelten für jede Antwort. Die anderen fügen Anweisungen hinzu, ohne die Standardanweisungen zu ändern, oder begrenzen sie auf eine bestimmte Aufgabe.
| Funktion | Wie es funktioniert | Verwenden Sie es, wenn |
|---|---|---|
| Ausgabestile | Ändert die Standardanweisungen von Claude Code | 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, die als CLI-Flag beim Start übergeben wird |
| 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