Claude Code: Ausgabestile erklärt und angepasst

Was ein Ausgabestil in Claude Code ist

Ein Ausgabestil in Claude Code ist ein Anweisungsblock, den Claude Code an seinen System-Prompt anhängt. Er ändert, wie Claude Ihnen antwortet: welche Rolle Claude einnimmt und in welcher Form die Ausgabe erfolgt. Er vermittelt Claude kein Wissen über Ihre Codebasis und kann Claude keine Berechtigung zum Ausführen von Befehlen erteilen.

Claude Code enthält fünf integrierte Stile. Ihre Auswahl wird in einem Einstellungsschlüssel gespeichert: outputStyle. Dieser Schlüssel wird einmal beim Start der Sitzung gelesen. Das erklärt den größten Teil der Verwirrung rund um diese Funktion. Ein Stil, den Sie während einer laufenden Sitzung umstellen, wird gespeichert und bis zum Zurücksetzen ignoriert.

Auf einem VPS ist das mehr als eine kosmetische Einstellung. Das Transkript lesen Sie über eine SSH-Verbindung (Secure Shell), normalerweise innerhalb eines tmux-Fensters. Daher ist jede Zeile, die Claude ausgibt, eine Zeile, auf die Sie warten, und eine Zeile in einem Scrollback-Puffer mit fester Größe.

Wo die Einstellung outputStyle gespeichert wird

Wählen Sie im Menü /config unter Output style einen Stil aus. Claude Code speichert Ihre Auswahl im Projekt, in dem Sie arbeiten, in .claude/settings.local.json.

Der eigenständige Befehl /output-style existiert nicht mehr. Er wurde in v2.1.73 als veraltet markiert und in v2.1.91 entfernt. In einer aktuellen Version bewirkt er daher überhaupt nichts. Prüfen Sie vor dem Befolgen älterer Anleitungen, welche Version Sie verwenden. Die Versionen auf dieser Seite wurden im August 2026 geprüft.

claude --version

Sie können den Schlüssel auch manuell setzen. In vier Einstellungsdateien kann er enthalten sein. Die spezifischere Datei hat Vorrang vor der allgemeineren.

• ~/.claude/settings.json ist Ihre Benutzerdatei. Sie gilt für jedes Projekt auf diesem Rechner.
• .claude/settings.json ist die Projektdatei. Sie wird in git versioniert und gilt daher für alle, die das Repository klonen.
• .claude/settings.local.json ist die lokale Projektdatei. Sie wird nicht versioniert und überschreibt die beiden oben genannten Dateien. In diese Datei schreibt das Menü /config.
• Verwaltete Einstellungen, die ein IT-Team über einen Systempfad wie /etc/claude-code/ unter Linux bereitstellt, überschreiben alle anderen Einstellungen.

Der Wert des Schlüssels ist der Stilname:

{
  "outputStyle": "Concise"
}

Für eine einzelne Sitzung können Sie denselben Schlüssel in der Befehlszeile übergeben. Das Flag --settings erwartet einen Pfad oder eine eingebettete JSON-Zeichenfolge. Seine Werte überschreiben bei diesem Lauf die entsprechenden Schlüssel in den Einstellungsdateien:

claude --settings '{"outputStyle": "Concise"}'

Menübezeichnungen und Slash-Befehle wurden im Laufe der Entwicklung dieser Funktion mindestens einmal geändert. Der Schlüssel outputStyle wurde dagegen nicht geändert. Wenn ein Screenshot in einer Anleitung nicht mehr mit Ihrer Ansicht übereinstimmt, setzen Sie den Schlüssel direkt. Prüfen Sie ihn anschließend mit /status. Dieser Befehl listet die aktiven Einstellungsquellen auf.

Warum Ihr neuer Ausgabestil erst nach dem Löschen wirksam wird

Claude Code erstellt die Systemaufforderung einmal beim Start der Sitzung. Der Ausgabestil ist Bestandteil dieser Systemaufforderung. Wenn Sie die Einstellung während einer laufenden Sitzung ändern, wird der Wert zwar gespeichert, aber die Änderung bleibt unsichtbar. Die laufende Sitzung verwendet weiterhin die Aufforderung, die sie beim Start erstellt hat. Der neue Stil wird bei der nächsten /clear oder beim nächsten Start geladen.

/clear
/context

/context zeigt an, welche Inhalte das Kontextfenster aktuell belegen, aufgeschlüsselt nach Kategorien und einschließlich der Systemaufforderung. Führen Sie den Befehl in einer neuen Sitzung für jeden Stil aus. Die Zeile zur Systemaufforderung ist die Eingabe für Ihren Vergleich. Damit können Sie auch am schnellsten prüfen, ob ein benutzerdefinierter Stil überhaupt geladen wurde. Einen umfassenderen Überblick darüber, welche Inhalte dieses Fenster füllen, finden Sie unter wie sich der Kontext in einer langen Claude-Code-Sitzung füllt.

Der verzögerte Wechsel hat einen technischen Grund. Die API bedient wiederholte Anfragen aus einem Prompt-Cache, der anhand des Anfangs jeder Anfrage abgeglichen wird. Die Systemaufforderung steht ganz am Anfang. Würde sie während des Gesprächs geändert, müsste der gesamte nachfolgende Inhalt verworfen werden. Beim nächsten Turn würde dann der vollständige bisherige Verlauf als neue Eingabe verarbeitet. Die Festlegung des Stils beim Sitzungsstart vermeidet diesen Aufwand. Zwischen Stilen zu wechseln ist kostengünstig. Sie müssen nur die Sitzung löschen.

Welche Änderungen die integrierten Ausgabestile am Transkript vornehmen

• Default ist der normale System-Prompt von Claude Code, der für Softwareentwicklungsaufgaben geschrieben wurde.
• Concise nennt zuerst das Ergebnis. Der Vorspann und die schrittweise Ablaufbeschreibung entfallen, und die Antworten bleiben kurz, bis Sie nach Details fragen. Die eigentliche Entwicklungsarbeit bleibt unverändert. Fehlermeldungen und Sicherheitswarnungen werden nie gekürzt. Vor einer destruktiven Aktion wird weiterhin vollständig nachgefragt. Dieser Stil erfordert Claude Code v2.1.237 oder höher.
• Explanatory fügt zwischen den Arbeitsschritten einer Aufgabe erklärende „Insights“ ein. Sie erläutern, warum eine Implementierungsentscheidung getroffen wurde und welches Muster Ihre Codebasis bereits verwendet. Das Transkript wird dadurch absichtlich länger.
• Learning geht noch weiter. Claude teilt diese Insights und fordert Sie anschließend auf, kleine Teile des Codes selbst zu schreiben. Jede solche Stelle wird mit einem TODO(human)-Kommentar in der Datei markiert.
• Proactive lässt Claude handeln, statt nachzufragen. Bei Routineentscheidungen trifft Claude angemessene Annahmen, anstatt auf eine Bestätigung zu warten.

Lesen Sie den letzten Punkt genau, denn er wird häufig missverstanden. Proactive ist eine Vorgabe im System-Prompt. Sie verändert, welche Aktionen Claude versucht. Der Berechtigungsmodus legt weiterhin fest, was tatsächlich ohne Rückfrage ausgeführt wird. Diese Einstellung ist auf einem Server relevant, den Sie unbeaufsichtigt laufen lassen. Das wird unter Automatikmodus und den Berechtigungsmodi von Claude Code behandelt.

Wie sich ein Ausgabestil von CLAUDE.md, einem Hook und einem Subagenten unterscheidet

Diese Mechanismen wirken alle so, als würden Sie Claude vorgeben, wie es sich verhalten soll. Sie greifen jedoch auf unterschiedlichen Ebenen.

• Ein Ausgabestil wird dem System-Prompt hinzugefügt. Er gilt für jede Antwort in der Hauptkonversation.
• CLAUDE.md wird nach dem System-Prompt als User-Nachricht hinzugefügt. Dort gehören Projektkonventionen und Fakten zur Codebasis hin.
• --append-system-prompt hängt Text für einen einzelnen Aufruf an den System-Prompt an, ohne etwas zu entfernen. Dies ist die einmalige Variante eines Ausgabestils.
• Ein Hook ist ein Shell-Befehl, den Claude Code selbst ausführt, sobald ein Ereignis eintritt. Er wird durch das Harness erzwungen und läuft daher unabhängig davon, ob Claude ihn ausgewählt hätte. Siehe was ein Claude-Code-Hook tun kann und was nicht.
• Ein Subagent läuft mit einem eigenen System-Prompt und einem eigenen Werkzeugsatz.

Ein kurzer Test unterscheidet zwischen den ersten beiden. Fakten zu Ihrem Projekt gehören in CLAUDE.md, weil Claude sie kennen muss. Formulierungen gehören in einen Ausgabestil, weil es dabei darum geht, wie die Antwort formuliert ist. Alles, was unabhängig von der Entscheidung des Modells bei jedem einzelnen Durchlauf geschehen muss, ist ein Hook. Auf welcher Ebene die jeweilige Oberfläche angesiedelt ist, ist eine Eigenschaft von dem Programm, das das Modell ausführt, nicht des Modells selbst. Deshalb kann ein Stil nur Einfluss nehmen, während ein Hook Vorgaben erzwingen kann.

Ausgabestile gelten nur für die Hauptkonversation. Ein Subagent übernimmt Ihren Stil nicht, weil er eine eigene Konversation mit einem eigenen System-Prompt startet. Eine Abzweigung der aktuellen Konversation ist die Ausnahme, da sie den System-Prompt des übergeordneten Gesprächs exakt übernimmt. Wenn ein Subagent auf eine Weise schreibt, die Ihnen nicht gefällt, bearbeiten Sie die Datei dieses Agents und nicht Ihren Stil. Eine zweite Claude-Code-Sitzung auf demselben Rechner folgt derselben Abgrenzung. Sie liest ihre Einstellungsdateien beim Start selbst ein. Wenn Sie Arbeit an eine parallel laufende Sitzung übergeben, kommen deren Antworten daher in dem Stil zurück, den diese Sitzung geladen hat, nicht in Ihrem.

So schreiben Sie Ihren eigenen Ausgabestil

Ein benutzerdefinierter Ausgabestil ist eine Markdown-Datei mit Frontmatter. Speichern Sie sie in Ihrem Home-Verzeichnis, um sie in jedem Projekt zu verwenden, oder im Repository, damit sie zusammen mit dem Code versioniert wird. Das Benutzerverzeichnis ist ~/.claude/output-styles/ und das Projektverzeichnis ist .claude/output-styles/.

mkdir -p ~/.claude/output-styles
cat > ~/.claude/output-styles/terse-ops.md <<'EOF'
---
name: Terse ops
description: Command first, explanation after, for SSH sessions
keep-coding-instructions: true
---

Lead with the command or the file change. Put the explanation after it, in two sentences or fewer.

Do not narrate what you are about to do. Report what you did.

When a command can fail, print the one check that proves it worked and say what a healthy result looks like.
EOF

Starten Sie eine Sitzung und öffnen Sie /config. Ihr Stil erscheint mit der von Ihnen angegebenen Beschreibung in der Liste Output style. Wenn er fehlt, wird die Datei nicht eingelesen: Prüfen Sie den Pfad und stellen Sie sicher, dass der ----Frontmatter-Block an erster Stelle der Datei steht. Der Dateiname wird zum Namen des Stils, sofern im Frontmatter nicht name gesetzt ist. Dieser Stil heißt daher Terse ops und nicht terse-ops.

Wählen Sie ihn aus oder setzen Sie den Schlüssel auf genau diesen Namen und leeren Sie:

{
  "outputStyle": "Terse ops"
}

Ein Feld legt fest, ob Ihre Datei eine Ergänzung oder ein Ersatz ist. keep-coding-instructions verwendet standardmäßig false. Das bedeutet, dass ein benutzerdefinierter Stil die integrierten Anweisungen für die Softwareentwicklung von Claude Code entfernt und ausschließlich mit Ihrem Text arbeitet. Diese integrierten Anweisungen legen fest, wie Claude den Umfang einer Änderung bestimmt und die Ergebnisse überprüft. Lassen Sie das Feld bei einem Schreibassistenten oder Datenanalysten weg, wenn diese Vorgaben nicht zutreffen. Setzen Sie es bei allem, was weiterhin Code betrifft, auf true. Andernfalls wundern Sie sich möglicherweise, warum ein sorgfältig arbeitender Entwickler plötzlich seine eigene Arbeit nicht mehr überprüft. Wenn Sie eigentlich keine andere Ausdrucksweise, sondern eine präzisere Festlegung des angemessenen Arbeitsumfangs benötigen, gehört das in die Anweisungen für die Softwareentwicklung und nicht in die Stil-Datei: der Ponytail-Skill ist ein ausgearbeitetes Beispiel dafür. Er besteht aus einer einzigen Regel, die einen Agenten zur kleinsten funktionierenden Änderung anhält.

description ist die Zeile, die der /config-Auswahldialog neben dem Namen anzeigt. Formulieren Sie sie für den Moment, in dem Sie sechs Monate später zwischen zwei eigenen Stilen wählen.

Warum ein knapper Stil über SSH anders ist

Auf einem VPS lesen Sie das Sitzungsprotokoll über mehrere Ebenen, die ein lokales Terminal nicht hat. Jede dieser Ebenen macht ausführliche Ausgaben kostspieliger.

Scrollback ist der erste Punkt. In tmux hält jedes Pane eine feste Anzahl von Zeilen vor, die durch history-limit festgelegt wird und standardmäßig 2000 beträgt. Ein ausführlich kommentiertes Protokoll füllt diesen Puffer schneller. Dadurch werden die früheren Teile Ihrer Sitzung schneller entfernt, und die Ausgabe, zu der Sie zurückscrollen wollten, ist nicht mehr verfügbar. Erhöhen Sie den Wert, wenn Sie mehr Platz benötigen:

echo 'set -g history-limit 20000' >> ~/.tmux.conf
tmux source-file ~/.tmux.conf

Danach erstellte Panes behalten jeweils 20000 Zeilen vor. Dafür wird pro Pane zusätzlicher Speicher benötigt. Bereits geöffnete Panes behalten das alte Limit, weil die Puffergröße beim Erstellen des Panes festgelegt wird. Wenn Sie das Sitzungs-Layout noch erstellen, beschreibt Claude Code in tmux auf einem VPS ausführen die Vorgehensweise.

Latenz ist der zweite Punkt. Die Antwort wird während ihrer Erstellung in Ihr Terminal übertragen. Bei einer Verbindung mit hoher Round-Trip-Zeit sehen Sie länger zu, wie Text eintrifft, bevor die Antwort erscheint.

Output-Tokens sind der dritte Punkt. Jede kommentierte Zeile wird als Output abgerechnet. Explanatory und Learning sind absichtlich ausführlicher. Concise ist absichtlich kürzer, weil Claude angewiesen wird, Antworten standardmäßig kurz zu halten.

Verlassen Sie sich auf keine Prozentangabe, auch nicht auf die Angaben auf dieser Seite. Wie groß der Unterschied ist, hängt von Ihren Prompts, Ihrem Modell und der angeforderten Arbeit ab. Messen Sie deshalb selbst vor und nach der Änderung. Führen Sie dieselbe reale Aufgabe in zwei neuen Sitzungen aus, einmal mit Default und einmal mit Concise, und vergleichen Sie die Ergebnisse. Eine Statuszeile ist dafür die einfachste Messmethode, weil Claude Code Ihrem Skript ein JSON-Objekt über stdin übergibt, das bereits den Stilnamen und die Token-Zähler enthält:

cat > ~/.claude/statusline.sh <<'EOF'
#!/bin/bash
input=$(cat)
style=$(echo "$input" | jq -r '.output_style.name // "default"')
out=$(echo "$input" | jq -r '.context_window.total_output_tokens // 0')
cost=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
echo "style=$style out=$out cost=$cost"
EOF
chmod +x ~/.claude/statusline.sh

Verweisen Sie die Einstellung statusLine darauf:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

Die Leiste am unteren Rand der Sitzung zeigt nun den aktiven Stil neben der Anzahl der erzeugten Tokens. Genau diese Werte benötigen Sie für den Vergleich. Das Skript benötigt jq, den JSON-Parser für die Befehlszeile. Installieren Sie ihn daher zuerst mit sudo apt install -y jq. Wenn die Leiste leer bleibt, führen Sie das Skript manuell aus und leiten Sie JSON hinein. Ein Statuszeilenskript, das mit einem Fehlercode ungleich 0 beendet wird, gibt nichts aus und meldet nichts. Eine benutzerdefinierte Claude-Code-Statuszeile beschreibt die übrigen Felder dieses Objekts. Für die Abrechnung statt für die Sitzung lesen Sie wohin die Tokens von Claude Code tatsächlich gehen und die Werkzeuge zur Erfassung der Claude-Code-Kosten.

Welche Ausgabestil-Einstellung ist tatsächlich geladen?

Verwenden Sie diese Prüfungen, statt zu raten.

• /status listet die für diese Sitzung wirksamen Einstellungsquellen auf. Dazu gehört auch die Information, ob verwaltete Einstellungen einer Organisation aktiv sind.
• /context zeigt den geladenen System-Prompt als Kategorie in der Aufschlüsselung des Kontextfensters an.
• claude doctor wird in der Shell ausgeführt, ohne eine Sitzung zu starten. Der Befehl gibt Diagnoseinformationen zur Installation und zu den Einstellungen aus und meldet ungültige Einstellungsdateien.

Wenn ein Stil nicht angewendet wird, gibt es fast immer eine von zwei Ursachen. Erstens wurde der Stil während der Sitzung geändert. Führen Sie dann /clear aus. Zweitens liegt es an der Priorität: .claude/settings.local.json überschreibt .claude/settings.json, und beide überschreiben ~/.claude/settings.json. Da der Auswahlmechanismus /config in die lokale Datei schreibt, wird ein Stil, den Ihr Team in .claude/settings.json versioniert hat, auf jedem Rechner stillschweigend überschrieben, auf dem jemand zuvor das Menü verwendet hat. /status zeigt, welche Quelle Vorrang hat.

Ein JSON-Syntaxfehler führt zum gleichen Symptom, erfordert aber eine andere Behebung. claude doctor nennt die Datei, die nicht geparst werden konnte. Führen Sie den Befehl aus, bevor Sie nach komplizierteren Ursachen suchen.

FAQ

Warum funktioniert der Befehl /output-style nicht mehr?

Er wurde in v2.1.73 als veraltet markiert und in v2.1.91 entfernt. In einem Build aus Mitte 2026 ist der Befehl daher nicht mehr vorhanden. Führen Sie claude --version aus, um Ihre Version zu prüfen. Wählen Sie den Stil unter Output style in /config aus, oder setzen Sie den Schlüssel outputStyle in einer Einstellungsdatei. Der Schlüssel besteht länger als der Befehl. Wenn Sie ihn direkt setzen, ist das die Anweisung, die Sie in Ihren eigenen Notizen festhalten sollten.

Ich habe meinen Ausgabestil geändert, aber es ist nichts passiert. Warum?

Der Ausgabestil ist Bestandteil des System-Prompts. Claude Code erstellt den System-Prompt einmal beim Start der Sitzung. Eine Änderung während der Sitzung wird gespeichert, aber nicht angewendet, weil die laufende Sitzung weiterhin den beim Start erstellten Prompt sendet. Führen Sie /clear aus oder starten Sie eine neue Sitzung. Wenn die Änderung weiterhin nicht angewendet wird, führen Sie /status aus, um zu prüfen, welche Einstellungsquelle Vorrang hat. .claude/settings.local.json überschreibt .claude/settings.json, und beide überschreiben ~/.claude/settings.json.

Spart der Ausgabestil Concise Kosten?

Er verringert die Anzahl der Ausgabetokens in der erwarteten Richtung, weil er Claude standardmäßig zu kurzen Antworten anweist. Wie groß die Einsparung ist, hängt von Ihren Prompts und Ihrem Modell ab. Behandeln Sie daher jeden veröffentlichten Prozentsatz als Messwert aus der Arbeit einer anderen Person. Messen Sie Ihre eigenen Werte: Führen Sie in einer neuen Sitzung unter jedem Stil /context für die Eingabeseite aus. Führen Sie anschließend dieselbe Aufgabe unter jedem Stil aus und vergleichen Sie die Anzahl der Ausgabetokens. Concise kürzt weder eine Fehlermeldung noch eine Sicherheitswarnung. Die Teile, die Sie am dringendsten lesen müssen, bleiben daher vollständig erhalten.

Ändert ein Ausgabestil die Schreibweise meiner Subagents?

Nein. Ausgabestile gelten nur für die Hauptkonversation. Ein Subagent startet eine eigene Konversation mit einem eigenen System-Prompt und einem eigenen Toolset. Eine Abspaltung der aktuellen Konversation ist die Ausnahme, da sie den System-Prompt der übergeordneten Konversation exakt übernimmt. Um die Antworten eines Subagents zu ändern, bearbeiten Sie die eigene Datei dieses Agents.

Kann ein Ausgabestil Claude erlauben, Befehle ohne Nachfrage auszuführen?

Nein. Ein Ausgabestil ist Text im System-Prompt und kann daher nur beeinflussen, was Claude zu tun versucht. Der Stil Proactive veranlasst Claude, bei routinemäßigen Entscheidungen eher Annahmen zu treffen und zu handeln, statt zu warten. Er kann einen Befehl jedoch weiterhin nicht genehmigen. Der Berechtigungsmodus legt fest, welche Befehle ohne Nachfrage ausgeführt werden. Diese Einstellung sollten Sie prüfen, bevor Sie eine Sitzung auf einem Server weiterlaufen lassen.