SpyBara
Go Premium

statusline.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 130 additions and 35 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58

Passen Sie Ihre Statuszeile an

Konfigurieren Sie eine benutzerdefinierte Statusleiste zur Überwachung der Kontextfensternutzung, Kosten und Git-Status in Claude Code

Die Statuszeile ist eine anpassbare Leiste am unteren Rand von Claude Code, die jedes Shell-Skript ausführt, das Sie konfigurieren. Sie empfängt JSON-Sitzungsdaten auf stdin und zeigt alles an, was Ihr Skript ausgibt, und bietet Ihnen eine persistente, auf einen Blick sichtbare Ansicht der Kontextnutzung, Kosten, Git-Status oder alles andere, das Sie verfolgen möchten.

Statuszeilen sind nützlich, wenn Sie:

  • Die Kontextfensternutzung während der Arbeit überwachen möchten
  • Sitzungskosten verfolgen müssen
  • Über mehrere Sitzungen hinweg arbeiten und diese unterscheiden müssen
  • Git-Branch und Status immer sichtbar haben möchten

Die Statuszeile wird in ihrer eigenen Zeile über den integrierten Fußzeilenabzeichen gerendert und ersetzt diese nicht. Mit einer konfigurierten benutzerdefinierten Statuszeile zeigt Claude Code die meisten Tastaturhinweise der Fußzeile nicht mehr an, einschließlich esc zum Unterbrechen, des ? für Verknüpfungen Fallbacks und des Leertaste halten zum Sprechen Sprachdiktierhinweises. Um anklickbare Link-Abzeichen in der Fußzeile hinzuzufügen, wenn eine ID im Gespräch angezeigt wird, ohne ein Skript zu schreiben, konfigurieren Sie stattdessen footerLinksRegexes.

Hier ist ein Beispiel einer mehrzeiligen Statuszeile, die Git-Informationen in der ersten Zeile und einen farbcodierten Kontextbalken in der zweiten Zeile anzeigt.

Eine mehrzeilige Statuszeile, die Modellname, Verzeichnis, Git-Branch in der ersten Zeile und einen Kontextnutzungs-Fortschrittsbalken mit Kosten und Dauer in der zweiten Zeile anzeigt

Diese Seite führt Sie durch das Einrichten einer grundlegenden Statuszeile, erklärt wie die Daten fließen von Claude Code zu Ihrem Skript, listet alle Felder auf, die Sie anzeigen können, und bietet einsatzbereite Beispiele für häufige Muster wie Git-Status, Kostenverfolgung und Fortschrittsbalken.

Richten Sie eine Statuszeile ein

Verwenden Sie den /statusline Befehl, um Claude Code ein Skript für Sie generieren zu lassen, oder erstellen Sie manuell ein Skript und fügen Sie es zu Ihren Einstellungen hinzu.

Verwenden Sie den /statusline Befehl

Der /statusline Befehl akzeptiert Anweisungen in natürlicher Sprache, die beschreiben, was Sie angezeigt haben möchten. Claude Code generiert eine Skriptdatei in ~/.claude/ und aktualisiert Ihre Einstellungen automatisch:

/statusline show model name and context percentage with a progress bar

Genehmigen Sie die Dateibearbeitungs-Eingabeaufforderungen, wenn Claude Code während der Einrichtung um Genehmigung fragt.

Statuszeile manuell konfigurieren

Fügen Sie ein statusLine Feld zu Ihren Benutzereinstellungen (~/.claude/settings.json, wobei ~ Ihr Heimatverzeichnis ist) oder Projekteinstellungen hinzu. Setzen Sie type auf "command" und verweisen Sie command auf einen Skriptpfad oder einen Inline-Shell-Befehl. Eine vollständige Anleitung zum Erstellen eines Skripts finden Sie unter Erstellen Sie eine Statuszeile Schritt für Schritt.

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

Das command Feld wird in einer Shell ausgeführt, sodass Sie auch Inline-Befehle anstelle einer Skriptdatei verwenden können. Dieses Beispiel verwendet jq, um die JSON-Eingabe zu analysieren und den Modellnamen und den Kontextprozentsatz anzuzeigen:

{
  "statusLine": {
    "type": "command",
    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'"
  }
}

Das optionale padding Feld fügt zusätzlichen horizontalen Abstand (in Zeichen) zum Inhalt der Statuszeile hinzu. Standardmäßig 0. Dieser Abstand wird zusätzlich zum integrierten Abstand der Benutzeroberfläche hinzugefügt, sodass er die relative Einrückung steuert, anstatt den absoluten Abstand vom Terminalrand.

Das optionale refreshInterval Feld führt Ihren Befehl zusätzlich zu den ereignisgesteuerten Aktualisierungen alle N Sekunden erneut aus. Das Minimum ist 1. Setzen Sie dies, wenn Ihre Statuszeile zeitbasierte Daten wie eine Uhr anzeigt, oder wenn Hintergrund-Subagenten den Git-Status ändern, während die Hauptsitzung untätig ist. Lassen Sie es ungesetzt, um nur bei Ereignissen auszuführen.

Das optionale hideVimModeIndicator Feld unterdrückt den integrierten -- INSERT -- Text unter der Eingabeaufforderung. Setzen Sie dies auf true, wenn Ihr Skript vim.mode selbst rendert, sodass der Modus nicht zweimal angezeigt wird.

Deaktivieren Sie die Statuszeile

Führen Sie /statusline aus und bitten Sie es, Ihre Statuszeile zu entfernen oder zu löschen (z. B. /statusline delete, /statusline clear, /statusline remove it). Sie können auch das statusLine Feld manuell aus Ihrer settings.json löschen.

Erstellen Sie eine Statuszeile Schritt für Schritt

Diese Anleitung zeigt, was unter der Haube passiert, indem Sie manuell eine Statuszeile erstellen, die das aktuelle Modell, das Arbeitsverzeichnis und den Prozentsatz der Kontextfensternutzung anzeigt.

Diese Beispiele verwenden Bash-Skripte, die auf macOS und Linux funktionieren. Unter Windows finden Sie unter Windows-Konfiguration PowerShell- und Git Bash-Beispiele.

Eine Statuszeile, die Modellname, Verzeichnis und Kontextprozentsatz anzeigt
1

Erstellen Sie ein Skript, das JSON liest und Ausgabe druckt

Claude Code sendet JSON-Daten über stdin an Ihr Skript. Dieses Skript verwendet jq, einen Befehlszeilen-JSON-Parser, den Sie möglicherweise installieren müssen, um den Modellnamen, das Verzeichnis und den Kontextprozentsatz zu extrahieren, und druckt dann eine formatierte Zeile.

Speichern Sie dies unter ~/.claude/statusline.sh (wobei ~ Ihr Heimatverzeichnis ist, z. B. /Users/username auf macOS oder /home/username auf Linux):

#!/bin/bash
# Read JSON data that Claude Code sends to stdin
input=$(cat)

# Extract fields using jq
MODEL=$(echo "$input" | jq -r '.model.display_name')
DIR=$(echo "$input" | jq -r '.workspace.current_dir')
# The "// 0" provides a fallback if the field is null
PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)

# Output the status line - ${DIR##*/} extracts just the folder name
echo "[$MODEL] 📁 ${DIR##*/} | ${PCT}% context"
2

Machen Sie es ausführbar

Markieren Sie das Skript als ausführbar, damit Ihre Shell es ausführen kann:

chmod +x ~/.claude/statusline.sh
3

Zu Einstellungen hinzufügen

Teilen Sie Claude Code mit, dass es Ihr Skript als Statuszeile ausführen soll. Fügen Sie diese Konfiguration zu ~/.claude/settings.json hinzu, die type auf "command" setzt (was bedeutet „diesen Shell-Befehl ausführen") und command auf Ihr Skript verweist:

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

Ihre Statuszeile wird am unteren Rand der Benutzeroberfläche angezeigt. Claude Code lädt Einstellungen automatisch neu und führt Ihr Skript aus, sobald Sie die Datei speichern.

Wie Statuszeilen funktionieren

Claude Code führt Ihr Skript mit JSON-Sitzungsdaten auf stdin aus und zeigt alles an, was das Skript auf stdout druckt.

Wann es aktualisiert wird

Ihr Skript wird einmal ausgeführt, wenn eine Sitzung startet, auch wenn Sie eine fortsetzen. Danach wird es erneut ausgeführt, wenn:

  • Eine neue Assistentnachricht ankommt
  • /compact abgeschlossen ist
  • Der Berechtigungsmodus sich ändert
  • Der Vim-Modus umgeschaltet wird
  • Sie den command in Ihren statusLine-Einstellungen ändern
  • Ein refreshInterval-Timer abläuft, falls Sie einen festgelegt haben
  • Ein Rate-Limit-Fenster in den Daten, die Ihr Skript zuletzt erhalten hat, seine resets_at-Zeit erreicht
  • Ein warmer Prompt-Cache in den Daten, die Ihr Skript zuletzt erhalten hat, seine expires_at-Zeit erreicht

Claude Code entprellt Aktualisierungen bei 300 ms, sodass schnelle Änderungen zusammengefasst werden und Ihr Skript einmal ausgeführt wird, nachdem die Änderungen aufgehört haben. Eine Änderung des command selbst überspringt die Entprellung: Claude Code führt den neuen Befehl sofort aus. Wenn eine neue Aktualisierung ausgelöst wird, während Ihr Skript noch läuft, bricht Claude Code das laufende Skript ab. Wenn Sie Ihr Skript bearbeiten, werden die Änderungen beim nächsten Mal angezeigt, wenn ein Aktualisierungs-Trigger es erneut ausführt.

Die ereignisgesteuerten Trigger können ruhig werden, wenn die Hauptsitzung untätig ist, beispielsweise während ein Koordinator auf Hintergrund-Subagenten wartet. Um zeitbasierte oder extern bezogene Segmente während untätiger Perioden aktuell zu halten, setzen Sie refreshInterval, um den Befehl auch auf einem festen Timer erneut auszuführen.

Was Ihr Skript ausgeben kann

Ausgabe an die Terminalgröße anpassen

Claude Code erfasst die Ausgabe Ihres Skripts, anstatt sie direkt mit dem Terminal zu verbinden, daher können tput cols und sprachgestützte Breitenerkennung die Terminalgröße nicht von innerhalb des Skripts lesen. Lesen Sie stattdessen die Umgebungsvariablen COLUMNS und LINES. Claude Code setzt diese auf die aktuellen Terminaldimensionen, bevor Ihr Skript ausgeführt wird.

Verfügbare Daten

Claude Code sendet die folgenden JSON-Felder über stdin an Ihr Skript:

Feld Beschreibung
model.id, model.display_name Aktuelle Modellkennung und Anzeigename
cwd, workspace.current_dir Aktuelles Arbeitsverzeichnis. Beide Felder enthalten denselben Wert; workspace.current_dir wird für Konsistenz mit workspace.project_dir bevorzugt.
workspace.project_dir Verzeichnis, in dem Claude Code gestartet wurde, das sich von cwd unterscheiden kann, wenn sich das Arbeitsverzeichnis während einer Sitzung ändert
workspace.added_dirs Zusätzliche Verzeichnisse, die über /add-dir oder --add-dir hinzugefügt wurden. Leeres Array, wenn keine hinzugefügt wurden
workspace.git_worktree Git-Worktree-Name, wenn sich das aktuelle Verzeichnis in einem verknüpften Worktree befindet, der mit git worktree add erstellt wurde. Fehlt im Haupt-Worktree. Wird für jeden Git-Worktree gefüllt, im Gegensatz zu worktree.*, das nur während einer Worktree-Sitzung vorhanden ist.
workspace.repo.host, workspace.repo.owner, workspace.repo.name Repository-Identität, die aus dem origin Remote geparst wird, zum Beispiel "github.com", "anthropics", "claude-code". Fehlt außerhalb eines Git-Repositorys oder wenn kein origin Remote konfiguriert ist
cost.total_cost_usd Geschätzte Sitzungskosten in USD, berechnet auf der Client-Seite zum Listenpreis, es sei denn, eine modelPricing Tabelle ist in Kraft. Kann sich von Ihrer tatsächlichen Rechnung unterscheiden. Wird auf $0 zurückgesetzt, wenn /clear eine neue Sitzung startet. Vor v2.1.211 wurde die Summe nach /clear beibehalten
cost.total_duration_ms Gesamtverstrichene Zeit seit Sitzungsbeginn in Millisekunden
cost.total_api_duration_ms Gesamtzeit, die auf API-Antworten wartet, in Millisekunden
cost.total_lines_added, cost.total_lines_removed Geänderte Codezeilen
context_window.total_input_tokens, context_window.total_output_tokens Token-Zählungen, die sich derzeit im Kontextfenster befinden, aus der letzten API-Antwort. Die Eingabe umfasst Cache-Lesevorgänge und -Schreibvorgänge
context_window.context_window_size Maximale Kontextfenstergröße in Token. Standardmäßig 200.000 oder 1.000.000 für Modelle mit erweitertem Kontext.
context_window.used_percentage Vorberechneter Prozentsatz der Kontextfensternutzung
context_window.remaining_percentage Vorberechneter Prozentsatz des verbleibenden Kontextfensters
context_window.current_usage Token-Zählungen aus dem letzten API-Aufruf, beschrieben in Kontextfenster-Felder
exceeds_200k_tokens Ob die Gesamttoken-Zählung (Eingabe-, Cache- und Ausgabe-Token kombiniert) aus der letzten API-Antwort 200k überschreitet. Dies ist ein fester Schwellenwert unabhängig von der tatsächlichen Kontextfenstergröße.
fast_mode Ob Schnellmodus für die Sitzung aktiviert ist
effort.level Aktueller Reasoning-Aufwand (low, medium, high, xhigh oder max). Spiegelt den Live-Sitzungswert wider, einschließlich Änderungen von /effort während der Sitzung. Ultracode ist keine separate Stufe und wird als xhigh gemeldet. Fehlt, wenn das aktuelle Modell den Effort-Parameter nicht unterstützt
thinking.enabled Ob erweitertes Denken für die Sitzung aktiviert ist
rate_limits.five_hour.used_percentage, rate_limits.seven_day.used_percentage Prozentsatz des 5-Stunden- oder 7-Tage-Ratenlimits verbraucht, von 0 bis 100
rate_limits.five_hour.resets_at, rate_limits.seven_day.resets_at Unix-Epochensekunden, wenn das 5-Stunden- oder 7-Tage-Ratenlimit-Fenster zurückgesetzt wird
rate_limits.spend_limit.used_percentage, rate_limits.spend_limit.resets_at Hinter einem Claude-Apps-Gateway, der Prozentsatz des Ausgabenlimits, das für Sie gilt, und die Unix-Epochensekunden, wenn sein Zeitraum zurückgesetzt wird. Der Prozentsatz reicht von 0 bis 100 oder über 100, sobald Sie das Limit überschreiten. Erfordert Claude Code v2.1.251 oder später
prompt_cache Die Prompt-Cache Statistiken der Sitzung für die Hauptkonversation: Hit-Ratio, Misses und ob der Cache warm ist. Siehe Prompt-Cache-Felder für jedes Feld. Fehlt bis zur ersten API-Antwort der Hauptkonversation. Erfordert Claude Code v2.1.251 oder später
session_id Eindeutige Sitzungskennung
session_name Sitzungsname. Verwendet den benutzerdefinierten Namen, der mit dem --name Flag oder /rename gesetzt wurde, wenn einer vorhanden ist, andernfalls den von der KI generierten Sitzungstitel. Der Standard-Anzeigename, wie my-app-3f, füllt dieses Feld nicht. Fehlt, wenn die Sitzung weder einen benutzerdefinierten Namen noch einen von der KI generierten Titel hat
prompt_id UUID, die die Benutzereingabe identifiziert, die gerade verarbeitet wird. Entspricht dem prompt.id Attribut auf OpenTelemetry-Ereignissen. Fehlt bis zur ersten Benutzereingabe. Erfordert Claude Code v2.1.196 oder später
transcript_path Pfad zur Gesprächstranskriptdatei
version Claude Code-Version
output_style.name Name des aktuellen Ausgabestils
vim.mode Aktueller Vim-Modus (NORMAL, INSERT, VISUAL oder VISUAL LINE), wenn Vim-Modus aktiviert ist
agent.name Agent-Name bei Ausführung mit dem --agent Flag oder konfigurierter Agent-Einstellung
pr.number, pr.url Offener Pull Request für den aktuellen Branch. Spiegelt das PR-Badge in der Fußzeile wider. In einem Repository mit einem GitLab-Remote füllt Claude Code diese Felder stattdessen aus der offenen Merge Request des Branches, daher ist pr.number die Merge-Request-Nummer. Merge-Request-Daten erfordern Claude Code v2.1.234 oder später. Fehlt, wenn nicht in einem Git-Repository, bis ein Pull Request oder eine Merge Request gefunden wird, oder sobald sie zusammengeführt oder geschlossen wird
pr.review_state Review-Status des offenen PR: approved, pending, changes_requested oder draft. Kann unabhängig fehlen, auch wenn pr vorhanden ist
pr.kind mr, wenn pr eine GitLab-Merge-Request beschreibt. Fehlt bei GitHub-Pull-Requests, daher funktionieren Skripte, die vor diesem Feld geschrieben wurden, weiterhin. Für eine Merge Request setzt Claude Code review_state auf approved, wenn GitLab meldet, dass sie zusammenführbar ist, pending für jeden anderen offenen Status und draft für einen Entwurf. Erfordert Claude Code v2.1.234 oder später
worktree.name Name des aktiven Worktree. Nur während einer Worktree-Sitzung vorhanden
worktree.path Absoluter Pfad zum Worktree-Verzeichnis
worktree.branch Git-Branch-Name für den Worktree (zum Beispiel "worktree-my-feature"). Fehlt bei Hook-basierten Worktrees
worktree.original_cwd Das Verzeichnis, in dem Claude sich befand, bevor es den Worktree betrat
worktree.original_branch Git-Branch, der vor dem Betreten des Worktree ausgecheckt wurde. Fehlt bei Hook-basierten Worktrees
Vollständiges JSON-Schema

Ihr Statuszeilen-Befehl empfängt diese JSON-Struktur über stdin:

{
"cwd": "/current/working/directory",
"session_id": "abc123...",
"session_name": "my-session",
"prompt_id": "550e8400-e29b-41d4-a716-446655440000",
"transcript_path": "/path/to/transcript.jsonl",
"model": {
"id": "claude-opus-5",
"display_name": "Opus"
},
"workspace": {
"current_dir": "/current/working/directory",
"project_dir": "/original/project/directory",
"added_dirs": [],
"git_worktree": "feature-xyz",
"repo": {
"host": "github.com",
"owner": "anthropics",
"name": "claude-code"
}
},
"version": "2.1.90",
"output_style": {
"name": "default"
},
"cost": {
"total_cost_usd": 0.01234,
"total_duration_ms": 45000,
"total_api_duration_ms": 2300,
"total_lines_added": 156,
"total_lines_removed": 23
},
"context_window": {
"total_input_tokens": 15500,
"total_output_tokens": 1200,
"context_window_size": 200000,
"used_percentage": 8,
"remaining_percentage": 92,
"current_usage": {
"input_tokens": 8500,
"output_tokens": 1200,
"cache_creation_input_tokens": 5000,
"cache_read_input_tokens": 2000
}
},
"exceeds_200k_tokens": false,
"prompt_cache": {
"warm": true,
"caching_observed": true,
"ttl": "1h",
"expires_at": 1738429200,
"requests": 14,
"misses": 2,
"expected_rebuilds": 1,
"hit_ratio": 0.91,
"cache_write_tokens": 352000,
"miss_recache_tokens": 310200,
"last_miss_at": 1738425230,
"last_miss_cause": {
"causes": ["tools_changed"],
"tools_added": 2,
"tools_removed": 0
},
"miss_causes": {
"tools_changed": 2
},
"recache_tokens_if_cold": 45000
},
"fast_mode": false,
"effort": {
"level": "high"
},
"thinking": {
"enabled": true
},
"rate_limits": {
"five_hour": {
"used_percentage": 23.5,
"resets_at": 1738425600
},
"seven_day": {
"used_percentage": 41.2,
"resets_at": 1738857600
},
"spend_limit": {
"used_percentage": 62.8,
"resets_at": 1740787200
}
},
"vim": {
"mode": "NORMAL"
},
"agent": {
"name": "security-reviewer"
},
"pr": {
"number": 1234,
"url": "https://github.com/anthropics/claude-code/pull/1234",
"review_state": "pending"
},
"worktree": {
"name": "my-feature",
"path": "/path/to/.claude/worktrees/my-feature",
"branch": "worktree-my-feature",
"original_cwd": "/path/to/project",
"original_branch": "main"
}
}

Felder, die möglicherweise fehlen (nicht in JSON vorhanden):

  • session_name: erscheint, wenn ein benutzerdefinierter Name mit --name oder /rename gesetzt wurde, oder sobald ein von der KI generierter Sitzungstitel vorhanden ist. Der Standard-Anzeigename, wie my-app-3f, füllt dieses Feld nicht
  • prompt_id: erscheint nur nach der ersten Benutzereingabe
  • workspace.git_worktree: erscheint nur, wenn sich das aktuelle Verzeichnis in einem verknüpften Git-Worktree befindet
  • workspace.repo: erscheint nur in einem Git-Repository mit einem konfigurierten origin Remote
  • effort: erscheint nur, wenn das aktuelle Modell den Reasoning-Effort-Parameter unterstützt
  • vim: erscheint nur, wenn Vim-Modus aktiviert ist
  • agent: erscheint nur bei Ausführung mit dem --agent Flag oder konfigurierter Agent-Einstellung
  • pr: erscheint nur, während ein offener PR oder eine GitLab-Merge-Request für den aktuellen Branch gefunden wird, und wird entfernt, sobald sie zusammengeführt oder geschlossen wird. pr.review_state und pr.kind können unabhängig fehlen
  • worktree: erscheint nur während einer Worktree-Sitzung. Wenn vorhanden, können branch und original_branch auch bei Hook-basierten Worktrees fehlen
  • rate_limits: erscheint nur für Claude.ai Pro und Max Abonnenten, oder hinter einem Claude-Apps-Gateway, das ein Ausgabenlimit für Sie setzt, und nur nach der ersten API-Antwort in der Sitzung. Jedes Fenster (five_hour, seven_day, spend_limit) kann unabhängig fehlen, und Claude Code verwirft ein Fenster, sobald seine resets_at Zeit verstrichen ist. Verwenden Sie jq -r '.rate_limits.five_hour.used_percentage // empty', um Abwesenheit elegant zu handhaben.
  • prompt_cache: erscheint nach der ersten API-Antwort der Hauptkonversation. Siehe Prompt-Cache-Felder

Felder, die null sein können:

  • context_window.current_usage: null vor dem ersten API-Aufruf in einer Sitzung und erneut nach /compact, bis der nächste API-Aufruf es erneut füllt
  • context_window.used_percentage, context_window.remaining_percentage: können früh in der Sitzung null sein

Behandeln Sie fehlende Felder mit bedingtem Zugriff und Null-Werte mit Fallback-Standardwerten in Ihren Skripten.

Kontextfenster-Felder

Das context_window Objekt beschreibt das Live-Kontextfenster aus der letzten API-Antwort.

  • Kombinierte Summen (total_input_tokens, total_output_tokens): Token, die sich derzeit im Kontextfenster befinden. total_input_tokens ist die Summe von input_tokens, cache_creation_input_tokens und cache_read_input_tokens; total_output_tokens sind die Ausgabe-Token aus der letzten Antwort. Beide sind 0 vor der ersten API-Antwort.
  • Pro-Komponenten-Nutzung (current_usage): die gleichen Token-Zählungen nach Kategorie aufgeschlüsselt. Verwenden Sie dies, wenn Sie Cache-Treffer separat von frischer Eingabe benötigen.

Das current_usage Objekt enthält:

  • input_tokens: Eingabe-Token im aktuellen Kontext
  • output_tokens: generierte Ausgabe-Token
  • cache_creation_input_tokens: Token, die in den Cache geschrieben wurden
  • cache_read_input_tokens: Token, die aus dem Cache gelesen wurden

Für die Bedeutung der Cache-Felder und deren Abrechnung siehe Cache-Leistung überprüfen.

Das used_percentage Feld wird nur aus Eingabe-Token berechnet: input_tokens + cache_creation_input_tokens + cache_read_input_tokens. Es enthält keine output_tokens.

Wenn Sie den Kontextprozentsatz manuell aus current_usage berechnen, verwenden Sie die gleiche Eingabe-only-Formel, um used_percentage zu entsprechen.

Das current_usage Objekt ist null vor dem ersten API-Aufruf in einer Sitzung und erneut unmittelbar nach /compact, bis der nächste API-Aufruf es erneut füllt.

Prompt-Cache-Felder

Das prompt_cache Objekt fasst zusammen, wie die Hauptkonversation der Sitzung den Prompt-Cache nutzt. Claude Code berechnet es aus den Cache-Token-Zählungen in den API-Antworten, daher funktioniert es bei jedem Anbieter.

Das Objekt erscheint nach der ersten API-Antwort der Hauptkonversation. Claude Code zählt Subagent-Anfragen nicht in diese Statistiken ein. Erfordert Claude Code v2.1.251 oder später.

Die Tabelle listet jedes Feld mit seiner Bedeutung auf. Zeitstempel sind Unix-Epochensekunden, die gleiche Einheit wie rate_limits.*.resets_at. Eine kurze Statuszeile zeigt normalerweise ein oder zwei davon; warm und hit_ratio fassen den Cache-Status am direktesten zusammen.

Feld Beschreibung
warm Ob das zwischengespeicherte Präfix noch innerhalb seiner TTL liegt. false, wenn die letzte Antwort keine Cache-Token gemeldet hat, auch wenn caching_observed true ist
caching_observed Ob eine Antwort dieser Sitzung Cache-Token gemeldet hat. false bedeutet, dass Prompt-Caching ausgeschaltet ist, oder Ihr Anbieter oder Gateway meldet es nicht
ttl Cache-Lebensdauer des aktuellen zwischengespeicherten Präfix: "5m" oder "1h"
expires_at Wann das zwischengespeicherte Präfix seine TTL verlässt und kalt wird, in Epochensekunden. null, wenn die letzte Antwort keine Cache-Token gemeldet hat
requests API-Anfragen, die für die Hauptkonversation dieser Sitzung aufgezeichnet wurden
misses Anfragen, die Inhalte erneut verarbeitet haben, die der Cache bereits enthielt: mehr als 5% und mindestens 2.000 Token von dem, was die Anfrage aus dem Cache hätte lesen können, ohne dass eine Komprimierung oder ein Löschen von alten Tool-Ergebnissen den Mangel an Cache-Lesevorgängen erklärt
expected_rebuilds Cache-Neuerstellungen, die einer Komprimierung oder einem Löschen von alten Tool-Ergebnissen folgten
hit_ratio Cache-Read-Token als Bruchteil aller Eingabe-Token dieser Sitzung, von 0 bis 1. Der Nenner zählt Cache-Lesevorgänge, Cache-Schreibvorgänge und nicht zwischengespeicherte Eingaben. null, während diese Zählungen alle null sind
cache_write_tokens Alle Token, die diese Sitzung in den Cache geschrieben wurden, einschließlich des anfänglichen Schreibvorgangs der ersten Anfrage
miss_recache_tokens Token, die von den als Misses gezählten Anfragen in den Cache geschrieben wurden
last_miss_at Wann der letzte Miss aufgetreten ist, in Epochensekunden. null, während die Sitzung keine Misses hat
last_miss_cause Was Claude Code als wahrscheinliche Ursache des letzten Miss identifiziert hat, beschrieben unter Letzte Miss-Ursache. Erfordert Claude Code v2.1.260 oder später
miss_causes Wie viele der diagnostizierten Misses dieser Sitzung jede Ursache hatten, nach den gleichen Ursachennamen wie last_miss_cause verschlüsselt. Erfordert Claude Code v2.1.260 oder später
recache_tokens_if_cold Token, die die nächste Anfrage erneut zwischenspeichert, wenn der Cache bis dahin kalt geworden ist. null unmittelbar nach einer Komprimierung oder einem Löschen von alten Tool-Ergebnissen, bis die nächste Anfrage die Größe der umgeschriebenen Konversation aufzeichnet

Claude Code zeigt die gleichen Statistiken im Terminal auf der /usage Befehlszeile Prompt cache (main).

Letzte Miss-Ursache

Das last_miss_cause Objekt meldet, was Claude Code als wahrscheinliche Ursache des letzten Miss identifiziert hat. Sein causes Array enthält einen oder mehrere Ursachennamen, wie tools_changed, system_prompt_changed, ttl_expired_5m oder likely_server_side. Das Objekt ist null, bis der erste Miss der Sitzung auftritt, und erneut, wenn Claude Code keine Ursache für den letzten Miss identifizieren konnte. Erfordert Claude Code v2.1.260 oder später.

Zwei Ursachen fügen Zählungen zum Objekt hinzu:

  • tools_added und tools_removed: mit tools_changed, wie viele Tools zur Anfrage hinzugefügt oder aus ihr entfernt wurden
  • system_char_delta: mit system_prompt_changed, die Änderung der Länge des System-Prompts in Zeichen

Beispiele

Diese Beispiele zeigen häufige Statuszeilen-Muster. Um ein Beispiel zu verwenden:

  1. Speichern Sie das Skript in einer Datei wie ~/.claude/statusline.sh (oder .py/.js)
  2. Machen Sie es ausführbar: chmod +x ~/.claude/statusline.sh
  3. Fügen Sie den Pfad zu Ihren Einstellungen hinzu

Die Bash-Beispiele verwenden jq zum Analysieren von JSON. Python und Node.js haben integriertes JSON-Parsing.

Kontextfensternutzung

Zeigen Sie das aktuelle Modell und die Kontextfensternutzung mit einem visuellen Fortschrittsbalken an. Jedes Skript liest JSON von stdin, extrahiert das used_percentage Feld und erstellt einen 10-Zeichen-Balken, wobei gefüllte Blöcke (▓) die Nutzung darstellen:

Eine Statuszeile, die Modellname und einen Fortschrittsbalken mit Prozentsatz anzeigt 
#!/bin/bash
# Read all of stdin into a variable
input=$(cat)

# Extract fields with jq, "// 0" provides fallback for null
MODEL=$(echo "$input" | jq -r '.model.display_name')
PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)

# Build progress bar: printf -v creates a run of spaces, then
# ${var// /▓} replaces each space with a block character
BAR_WIDTH=10
FILLED=$((PCT * BAR_WIDTH / 100))
EMPTY=$((BAR_WIDTH - FILLED))
BAR=""
[ "$FILLED" -gt 0 ] && printf -v FILL "%${FILLED}s" && BAR="${FILL// /▓}"
[ "$EMPTY" -gt 0 ] && printf -v PAD "%${EMPTY}s" && BAR="${BAR}${PAD// /░}"

echo "[$MODEL] $BAR $PCT%"

Git-Status mit Farben

Zeigen Sie Git-Branch mit farbcodierten Indikatoren für bereitgestellte und geänderte Dateien an. Dieses Skript verwendet ANSI-Escape-Codes für Terminalfarben: \033[32m ist Grün, \033[33m ist Gelb und \033[0m setzt auf Standard zurück.

Eine Statuszeile, die Modell, Verzeichnis, Git-Branch und farbcodierte Indikatoren für bereitgestellte und geänderte Dateien anzeigt

Jedes Skript prüft, ob das aktuelle Verzeichnis ein Git-Repository ist, zählt bereitgestellte und geänderte Dateien und zeigt farbcodierte Indikatoren an:

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
DIR=$(echo "$input" | jq -r '.workspace.current_dir')

GREEN='\033[32m'
YELLOW='\033[33m'
RESET='\033[0m'

if git rev-parse --git-dir > /dev/null 2>&1; then
BRANCH=$(git branch --show-current 2>/dev/null)
STAGED=$(git diff --cached --numstat 2>/dev/null | wc -l | tr -d ' ')
MODIFIED=$(git diff --numstat 2>/dev/null | wc -l | tr -d ' ')

GIT_STATUS=""
[ "$STAGED" -gt 0 ] && GIT_STATUS="${GREEN}+${STAGED}${RESET}"
[ "$MODIFIED" -gt 0 ] && GIT_STATUS="${GIT_STATUS}${YELLOW}~${MODIFIED}${RESET}"

echo -e "[$MODEL] 📁 ${DIR##*/} | 🌿 $BRANCH $GIT_STATUS"
else
echo "[$MODEL] 📁 ${DIR##*/}"
fi

Kosten- und Dauer-Verfolgung

Verfolgen Sie die API-Kosten und verstrichene Zeit Ihrer Sitzung. Das cost.total_cost_usd Feld sammelt die geschätzten Kosten aller API-Aufrufe in der aktuellen Sitzung. Das cost.total_duration_ms Feld misst die Gesamtverstrichene Zeit seit Sitzungsbeginn, während cost.total_api_duration_ms nur die Zeit verfolgt, die auf API-Antworten wartet.

Jedes Skript formatiert Kosten als Währung und konvertiert Millisekunden in Minuten und Sekunden:

Eine Statuszeile, die Modellname, Sitzungskosten und Dauer anzeigt 
#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
COST=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
DURATION_MS=$(echo "$input" | jq -r '.cost.total_duration_ms // 0')

COST_FMT=$(printf '$%.2f' "$COST")
DURATION_SEC=$((DURATION_MS / 1000))
MINS=$((DURATION_SEC / 60))
SECS=$((DURATION_SEC % 60))

echo "[$MODEL] 💰 $COST_FMT | ⏱️ ${MINS}m ${SECS}s"

Mehrere Zeilen anzeigen

Ihr Skript kann mehrere Zeilen ausgeben, um eine reichhaltigere Anzeige zu erstellen.

Eine mehrzeilige Statuszeile, die Modellname, Verzeichnis, Git-Branch in der ersten Zeile und einen Kontextnutzungs-Fortschrittsbalken mit Kosten und Dauer in der zweiten Zeile anzeigt

Dieses Beispiel kombiniert mehrere Techniken: schwellenwertbasierte Farben (Grün unter 70%, Gelb 70-89%, Rot 90%+), einen Fortschrittsbalken und Git-Branch-Informationen. Jede print oder echo Anweisung erstellt eine separate Zeile:

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
DIR=$(echo "$input" | jq -r '.workspace.current_dir')
COST=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)
DURATION_MS=$(echo "$input" | jq -r '.cost.total_duration_ms // 0')

CYAN='\033[36m'; GREEN='\033[32m'; YELLOW='\033[33m'; RED='\033[31m'; RESET='\033[0m'

# Pick bar color based on context usage
if [ "$PCT" -ge 90 ]; then BAR_COLOR="$RED"
elif [ "$PCT" -ge 70 ]; then BAR_COLOR="$YELLOW"
else BAR_COLOR="$GREEN"; fi

FILLED=$((PCT / 10)); EMPTY=$((10 - FILLED))
printf -v FILL "%${FILLED}s"; printf -v PAD "%${EMPTY}s"
BAR="${FILL// /█}${PAD// /░}"

MINS=$((DURATION_MS / 60000)); SECS=$(((DURATION_MS % 60000) / 1000))

BRANCH=""
git rev-parse --git-dir > /dev/null 2>&1 && BRANCH=" | 🌿 $(git branch --show-current 2>/dev/null)"

echo -e "${CYAN}[$MODEL]${RESET} 📁 ${DIR##*/}$BRANCH"
COST_FMT=$(printf '$%.2f' "$COST")
echo -e "${BAR_COLOR}${BAR}${RESET} ${PCT}% | ${YELLOW}${COST_FMT}${RESET} | ⏱️ ${MINS}m ${SECS}s"

Dieses Beispiel erstellt einen anklickbaren Link zu Ihrem GitHub-Repository. Halten Sie Cmd (macOS) oder Strg (Windows/Linux) gedrückt und klicken Sie, um den Link in Ihrem Browser zu öffnen.

Eine Statuszeile, die einen anklickbaren Link zu einem GitHub-Repository anzeigt

Jedes Skript ruft die Git-Remote-URL ab, konvertiert das SSH-Format in HTTPS und umhüllt den Repository-Namen mit OSC 8 Escape-Codes. Die Bash-Version verwendet printf '%b', das Backslash-Escapes zuverlässiger interpretiert als echo -e über verschiedene Shells hinweg:

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')

# Convert git SSH URL to HTTPS
REMOTE=$(git remote get-url origin 2>/dev/null | sed 's/git@github.com:/https:\/\/github.com\//' | sed 's/\.git$//')

if [ -n "$REMOTE" ]; then
REPO_NAME=$(basename "$REMOTE")
# OSC 8 format: \e]8;;URL\a then TEXT then \e]8;;\a
# printf %b interprets escape sequences reliably across shells
printf '%b' "[$MODEL] 🔗 \e]8;;${REMOTE}\a${REPO_NAME}\e]8;;\a\n"
else
echo "[$MODEL]"
fi

Ratenlimit-Nutzung

Zeigen Sie die Ratenlimit-Nutzung des Claude.ai-Abonnements in der Statuszeile an. Das rate_limits Objekt enthält ein rollierendes five_hour Fenster und ein wöchliches seven_day Fenster. Jedes Fenster bietet used_percentage (0 bis 100) und resets_at (Unix-Epochensekunden, wenn das Fenster zurückgesetzt wird).

Hinter einem Claude-Apps-Gateway mit Ausgabenlimits enthält rate_limits spend_limit mit den gleichen zwei Feldern für das Ausgabenlimit, das für Sie gilt, außer dass sein used_percentage über 100 gehen kann, sobald Sie das Limit überschreiten. Erfordert Claude Code v2.1.251 oder später.

Das rate_limits Objekt ist nur für Claude.ai Pro und Max Abonnenten oder hinter einem Claude-Apps-Gateway mit Ausgabenlimits vorhanden und nur nach der ersten API-Antwort. Jedes Skript behandelt das fehlende Feld elegant:

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
# "// empty" produces no output when rate_limits is absent
FIVE_H=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
WEEK=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')

LIMITS=""
[ -n "$FIVE_H" ] && LIMITS="5h: $(printf '%.0f' "$FIVE_H")%"
[ -n "$WEEK" ] && LIMITS="${LIMITS:+$LIMITS }7d: $(printf '%.0f' "$WEEK")%"

[ -n "$LIMITS" ] && echo "[$MODEL] | $LIMITS" || echo "[$MODEL]"

Teure Operationen zwischenspeichern

Ihr Statuszeilen-Skript wird während aktiver Sitzungen häufig ausgeführt. Befehle wie git status oder git diff können langsam sein, besonders in großen Repositories. Dieses Beispiel speichert Git-Informationen in einer temporären Datei und aktualisiert sie nur alle 5 Sekunden.

Der Cache-Dateiname muss über Statuszeilen-Invokationen innerhalb einer Sitzung stabil sein, aber eindeutig über Sitzungen hinweg, damit gleichzeitige Sitzungen in verschiedenen Repositories nicht den Cache-Git-Status des anderen lesen. Prozessbasierte Identifikatoren wie $$, os.getpid() oder process.pid ändern sich bei jeder Invokation und besiegen den Cache. Verwenden Sie stattdessen die session_id aus der JSON-Eingabe: Sie ist stabil für die Lebensdauer einer Sitzung und eindeutig pro Sitzung.

Jedes Skript prüft, ob die Cache-Datei fehlt oder älter als 5 Sekunden ist, bevor Git-Befehle ausgeführt werden:

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
DIR=$(echo "$input" | jq -r '.workspace.current_dir')
SESSION_ID=$(echo "$input" | jq -r '.session_id')

CACHE_FILE="/tmp/statusline-git-cache-$SESSION_ID"
CACHE_MAX_AGE=5  # seconds

cache_is_stale() {
[ ! -f "$CACHE_FILE" ] || \
# stat -c %Y (Linux) or stat -f %m (macOS) prints the file's last-modified
# time. The Linux form must run first: on Linux, the macOS form prints a
# filesystem report to stdout before failing, and that output would be
# captured by the command substitution and break the arithmetic.
[ $(($(date +%s) - $(stat -c %Y "$CACHE_FILE" 2>/dev/null || stat -f %m "$CACHE_FILE" 2>/dev/null || echo 0))) -gt $CACHE_MAX_AGE ]
}

if cache_is_stale; then
if git rev-parse --git-dir > /dev/null 2>&1; then
BRANCH=$(git branch --show-current 2>/dev/null)
STAGED=$(git diff --cached --numstat 2>/dev/null | wc -l | tr -d ' ')
MODIFIED=$(git diff --numstat 2>/dev/null | wc -l | tr -d ' ')
echo "$BRANCH|$STAGED|$MODIFIED" > "$CACHE_FILE"
else
echo "||" > "$CACHE_FILE"
fi
fi

IFS='|' read -r BRANCH STAGED MODIFIED < "$CACHE_FILE"

if [ -n "$BRANCH" ]; then
echo "[$MODEL] 📁 ${DIR##*/} | 🌿 $BRANCH +$STAGED ~$MODIFIED"
else
echo "[$MODEL] 📁 ${DIR##*/}"
fi

Windows-Konfiguration

Unter Windows führt Claude Code Statuszeilen-Befehle über Git Bash aus, wenn Git Bash installiert ist, oder über PowerShell, wenn Git Bash nicht vorhanden ist.

Git Bash behandelt unquotierte Backslashes als Escape-Zeichen, daher erreicht ein Windows-Pfad wie C:\Users\username\script.mjs den Skript-Runner mit entfernten Trennzeichen und der Befehl schlägt ohne sichtbaren Fehler fehl. Schreiben Sie Dateipfade in der command Zeichenkette mit Schrägstrichen, wie in den folgenden Beispielen gezeigt. Die ~ Abkürzung funktioniert auch und wird zu Ihrem Windows-Basisverzeichnis erweitert.

Um ein PowerShell-Skript als Statuszeile auszuführen, rufen Sie es über powershell auf. Dies funktioniert, ob Claude Code den Befehl über Git Bash oder PowerShell leitet:

{
"statusLine": {
"type": "command",
"command": "powershell -NoProfile -File C:/Users/username/.claude/statusline.ps1"
}
}

Oder führen Sie ein Bash-Skript direkt aus:

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

Subagent-Statuszeilen

Die subagentStatusLine Einstellung rendert einen benutzerdefinierten Zeilenkörper für jeden Subagenten, der im Agent-Panel unterhalb der Eingabeaufforderung angezeigt wird. Verwenden Sie sie, um die Standard-name · description · token count Zeile durch Ihre eigene Formatierung zu ersetzen.

{
  "subagentStatusLine": {
    "type": "command",
    "command": "~/.claude/subagent-statusline.sh"
  }
}

Der Befehl wird einmal pro Aktualisierungstick mit allen sichtbaren Subagenten-Zeilen ausgeführt, die als einzelnes JSON-Objekt auf stdin übergeben werden. Die Eingabe enthält die Basis-Hook-Felder, ein columns Feld mit der nutzbaren Zeilenbreite und ein tasks Array. Jede Aufgabe hat id, name, type, status, description, label, startTime, model, effort, contextWindowSize, tokenCount, tokenSamples und cwd.

Das model Feld pro Aufgabe ist die aufgelöste Modell-ID, auf der die Aufgabe ausgeführt wird. contextWindowSize ist das Kontextfenster dieses Modells in Token, berechnet auf die gleiche Weise wie das context_window.context_window_size der Hauptstatuszeile, sodass Sie einen Prozentsatz pro Zeile aus tokenCount rendern können. Beide Felder erfordern Claude Code v2.1.205 oder später und werden für eine Aufgabe weggelassen, deren Modell noch nicht aufgelöst ist.

Das effort Feld pro Aufgabe ist der Reasoning-Aufwand, der für diesen Subagenten festgelegt ist, in seiner Definition Frontmatter oder beim einzelnen Aufruf. Der Wert ist entweder einer der Aufwand-Level-Strings low, medium, high, xhigh oder max, oder ein numerisches Token-Budget. Das Feld meldet den konfigurierten Wert wie geschrieben: Wenn das Modell diesen Level nicht unterstützt, kann sich der Aufwand, den Claude Code tatsächlich anwendet, unterscheiden. Das Feld erfordert Claude Code v2.1.214 oder später und fehlt, wenn der Subagent den Aufwand-Level der Sitzung erbt.

Schreiben Sie eine JSON-Zeile auf stdout pro Zeile, die Sie überschreiben möchten, in der Form {"id": "<task id>", "content": "<row body>"}. Der content String wird wie vorhanden gerendert, einschließlich ANSI-Farben und OSC 8 Hyperlinks. Lassen Sie die id einer Aufgabe weg, um die Standard-Rendering für diese Zeile zu behalten; geben Sie einen leeren content String aus, um sie auszublenden.

Die gleichen Vertrauens-, disableAllHooks- und allowManagedHooksOnly Gates, die für statusLine gelten, gelten auch hier. Plugins können eine Standard-subagentStatusLine in ihrer settings.json versenden, aber im Gegensatz zu Hooks werden Plugin-Werte nicht unter allowManagedHooksOnly ausgeführt, auch wenn das Plugin in verwalteten Einstellungen enabledPlugins erzwungen aktiviert ist.

Tipps

  • Mit Mock-Eingabe testen: echo '{"model":{"display_name":"Opus"},"workspace":{"current_dir":"/home/user/project"},"context_window":{"used_percentage":25},"session_id":"test-session-abc"}' | ./statusline.sh
  • Ausgabe kurz halten: Die Statusleiste hat begrenzte Breite, daher kann lange Ausgabe abgeschnitten oder unangenehm umgebrochen werden
  • Langsame Operationen zwischenspeichern: Ihr Skript wird während aktiver Sitzungen häufig ausgeführt, daher können Befehle wie git status zu Verzögerungen führen. Siehe das Caching-Beispiel für die Handhabung.

Community-Projekte wie ccstatusline und starship-claude bieten vorkonfigurierte Konfigurationen mit Designs und zusätzlichen Funktionen.

Fehlerbehebung

Statuszeile wird nicht angezeigt

  • Überprüfen Sie, dass Ihr Skript ausführbar ist: chmod +x ~/.claude/statusline.sh
  • Überprüfen Sie, dass Ihr Skript auf stdout ausgibt, nicht auf stderr
  • Führen Sie Ihr Skript manuell aus, um zu überprüfen, dass es Ausgabe erzeugt
  • Unter Windows mit installiertem Git Bash werden Backslashes im command-Pfad wahrscheinlich als Escape-Zeichen verarbeitet, bevor das Skript ausgeführt wird. Verwenden Sie Schrägstriche im Pfad. Siehe Windows-Konfiguration.
  • Wenn disableAllHooks nach Anwendung der Einstellungspriorität außerhalb verwalteter Einstellungen auf true gesetzt ist, führt Claude Code nur eine statusLine aus verwalteten Einstellungen aus, und ohne verwaltete statusLine ist die Statuszeile deaktiviert. Entfernen Sie die Einstellung oder setzen Sie sie auf false in der Datei, die sie setzt, um sie erneut zu aktivieren. Siehe disableAllHooks.
  • Wenn Ihre Organisation allowManagedHooksOnly in verwalteten Einstellungen setzt, verschwindet Ihre benutzerdefinierte Statuszeile ohne Warnung: Sie können nur eine Statuszeile aus einem statusLine-Wert in diesen verwalteten Einstellungen erhalten. Siehe was unter allowManagedHooksOnly ausgeführt wird für das vollständige Verhalten, und fragen Sie Ihren Administrator, ob diese Einstellung für Sie gilt.
  • Führen Sie claude --debug aus, um den Exit-Code und stderr aus der ersten Statuszeilen-Invokation in einer Sitzung zu protokollieren
  • Bitten Sie Claude, Ihre Einstellungsdatei zu lesen und den statusLine-Befehl direkt auszuführen, um Fehler zu finden

Statuszeile zeigt -- oder leere Werte

  • Felder können null sein, bevor die erste API-Antwort abgeschlossen ist
  • Behandeln Sie Null-Werte in Ihrem Skript mit Fallbacks wie // 0 in jq
  • Starten Sie Claude Code neu, wenn Werte nach mehreren Nachrichten leer bleiben

Kontextprozentsatz zeigt unerwartete Werte

  • Verwenden Sie used_percentage für den einfachsten genauen Kontextzustand
  • Der Kontextprozentsatz kann sich von der /context-Ausgabe unterscheiden, je nachdem, wann jeder berechnet wird

OSC 8-Links nicht anklickbar

  • Überprüfen Sie, dass Ihr Terminal OSC 8-Hyperlinks unterstützt (iTerm2, Kitty, WezTerm)

  • Terminal.app unterstützt keine anklickbaren Links

  • Wenn Link-Text angezeigt wird, aber nicht anklickbar ist, hat Claude Code möglicherweise keine Hyperlink-Unterstützung in Ihrem Terminal erkannt. Setzen Sie die FORCE_HYPERLINK-Umgebungsvariable, um die Erkennung zu überschreiben, bevor Sie Claude Code starten:

    FORCE_HYPERLINK=1 claude

    In PowerShell setzen Sie die Variable zuerst in der aktuellen Sitzung:

    $env:FORCE_HYPERLINK = "1"; claude

  • SSH- und tmux-Sitzungen können OSC-Sequenzen je nach Konfiguration entfernen

  • Wenn Escape-Sequenzen als Literaltext wie \e]8;; angezeigt werden, verwenden Sie printf '%b' anstelle von echo -e für zuverlässigere Escape-Behandlung

Anzeigeglitches mit Escape-Sequenzen

  • Komplexe Escape-Sequenzen (ANSI-Farben, OSC 8-Links) können gelegentlich zu beschädigter Ausgabe führen, wenn sie mit anderen UI-Aktualisierungen überlappen
  • Wenn Sie beschädigten Text sehen, versuchen Sie, Ihr Skript auf einfache Textausgabe zu vereinfachen
  • Mehrzeilige Statuszeilen mit Escape-Codes sind anfälliger für Rendering-Probleme als einzeilige einfache Texte

Workspace-Vertrauen erforderlich

  • Da statusLine einen Shell-Befehl ausführt, führt Claude Code ihn unter der gleichen Workspace-Vertrauensregel wie Hooks in Einstellungsdateien aus. Das Akzeptieren des Dialogs für den Ordner oder für ein übergeordnetes Verzeichnis, dessen Vertrauen sich auf ihn erstreckt, ist ausreichend.
  • Bis dahin bleibt die Statuszeile leer, und claude --debug protokolliert Status line command skipped: workspace trust not accepted. Starten Sie Claude Code neu und akzeptieren Sie den Vertrauensdialog, um ihn zu aktivieren.

Skriptfehler oder Hängen

  • Skripte, die mit Nicht-Null-Codes beendet werden oder keine Ausgabe erzeugen, führen dazu, dass die Statuszeile leer wird
  • Langsame Skripte blockieren die Statuszeilen-Aktualisierung, bis sie abgeschlossen sind. Halten Sie Skripte schnell, um veraltete Ausgabe zu vermeiden.
  • Wenn eine neue Aktualisierung ausgelöst wird, während ein langsames Skript läuft, wird das laufende Skript abgebrochen
  • Testen Sie Ihr Skript unabhängig mit Mock-Eingabe, bevor Sie es konfigurieren

Benachrichtigungen teilen sich die Statuszeilen-Zeile

Außerhalb des Vollbildmodus zeigt Claude Code Benachrichtigungen in der gleichen Zeile wie Ihre Statuszeile an. Im Vollbildmodus gibt Claude Code Benachrichtigungen eine eigene Zeile.

  • Systembenachrichtigungen wie MCP-Serverfehler und automatische Updates werden auf der rechten Seite der Zeile angezeigt. Vorübergehende Benachrichtigungen wie die Kontext-niedrig-Warnung zirkulieren auch durch diesen Bereich.
  • Das Aktivieren des ausführlichen Modus fügt einen Token-Zähler zu diesem Bereich hinzu
  • Auf schmalen Terminals können diese Benachrichtigungen Ihre Statuszeilen-Ausgabe abschneiden