WissenClaude Code & Vibe Coding
Claude Code Statusline anpassen, was du im Blick behalten solltest
Die Zeile unten im Terminal kann mehr als nur den Ordnernamen zeigen. Wie du sie einrichtest und welche Werte für dich als Solo wirklich zählen.
Beim Autofahren schaust du nicht ständig unters Lenkrad, um zu prüfen wie viel Sprit noch da ist. Ein Blick aufs Armaturenbrett reicht. Die Statusline in Claude Code ist genau das für deine Arbeit im Terminal: eine Zeile ganz unten, die dir zeigt, was gerade zählt, ohne dass du extra nachfragen musst.
Kurz gesagt
Die Statusline ist die anpassbare Zeile am unteren Rand von Claude Code. Standardmäßig zeigt sie wenig, du kannst sie aber per Skript mit eigenen Werten füllen, etwa dem verwendeten Modell, der Auslastung des Kontextfensters, den Kosten der Sitzung oder dem aktuellen Git-Branch. Am schnellsten richtest du sie mit dem Befehl /statusline und einer Beschreibung in normaler Sprache ein, ganz ohne selbst ein Skript zu schreiben.
Wie die Statusline technisch funktioniert
Claude Code schickt bei jeder Aktualisierung ein JSON-Objekt mit dem aktuellen Zustand der Sitzung an ein Skript, das du in deiner settings.json hinterlegst, entweder projektweit oder global unter ~/.claude/settings.json. Was dieses Skript ausgibt, erscheint als Statusline. Aktualisiert wird sie beim Start oder der Wiederherstellung einer Sitzung, bei jeder neuen Antwort von Claude, nach einer Komprimierung des Kontexts sowie bei einem Wechsel des Berechtigungsmodus. Zusätzlich lässt sich über das Feld refreshInterval ein festes Zeitintervall einstellen, falls du etwa eine Uhr anzeigen willst.
Welche Werte tatsächlich in dem JSON-Objekt stecken
Das übergebene Objekt enthält unter anderem den Namen des Modells, die Auslastung des Kontextfensters in Prozent, die bisherigen Kosten der Sitzung in US-Dollar, die Nutzungsgrenze für das laufende Fünf-Stunden-Fenster sowie den aktuellen Git-Branch inklusive Worktree-Namen. Aus diesen Rohdaten baust du dir eine Zeile, die genau das zeigt, was für deine Arbeit relevant ist, statt allgemeiner Werte, die dich nicht interessieren.
Der schnelle Weg ohne eigenes Skript
Du tippst /statusline gefolgt von einer Beschreibung, zum Beispiel "zeig mir Modell, Kontextauslastung und den aktuellen Git-Branch", und Claude Code schreibt das Skript sowie die passende Einstellung selbst. Für die meisten Solos reicht das völlig, ein Blick auf existierende Vorlagen aus der Community lohnt sich nur, wenn du etwas sehr Spezifisches willst, etwa eine grafische Fortschrittsanzeige.
Was du als Solo wirklich im Blick behalten solltest
Am wichtigsten ist die Auslastung des Kontextfensters: läuft sie voll, komprimiert Claude Code automatisch, was Details aus dem Gespräch verlieren kann. Ein zweiter wichtiger Wert ist die Nutzungsgrenze deines Abos, gerade wenn du im Fünf-Stunden-Fenster nah an die Grenze kommst. Kosten in Dollar sind vor allem relevant, wenn du über die API arbeitest, nicht bei einem festen Abo. Der Git-Branch ist ein guter dritter Kandidat, damit du nicht aus Versehen im falschen Branch arbeitest.
Ich denke, die meisten fertigen Statuslines aus der Community sind hübsch, zeigen aber zu viel auf einmal. Sinnvoller ist eine kurze eigene Liste von zwei bis drei Werten, die wirklich eine Entscheidung beeinflussen, etwa ob du jetzt komprimieren solltest oder noch Zeit hast.
Quellen: Customize your status line (Claude Code Docs) · Claude Code Status Line - Complete Guide: all fields, config, ready-to-use scripts (Gist, AKCodez)
Häufige Fragen
Muss ich selbst ein Skript schreiben, um die Statusline anzupassen?
Nein. Der Befehl /statusline in Claude Code nimmt eine Beschreibung in normaler Sprache entgegen und schreibt das Skript sowie die passende Einstellung in deiner settings.json selbst.
Wie oft aktualisiert sich die Statusline?
Bei jeder neuen Antwort, beim Start oder der Wiederherstellung einer Sitzung, nach einer Komprimierung des Kontexts und bei einem Wechsel des Berechtigungsmodus. Zusätzlich lässt sich ein Zeitintervall einstellen, falls du zeitabhängige Werte anzeigen willst.
Kostet mich eine aufwendige Statusline zusätzliche Leistung?
Kaum spürbar. Das Skript läuft kurz bei jeder Aktualisierung und läuft außerhalb des eigentlichen Gesprächs mit Claude, es verbraucht also keine Token aus deinem Nutzungslimit.
Willst du das bei dir umsetzen?
In der Community zeige ich, was bei mir hält. Im Erstgespräch schauen wir uns dein Vorhaben konkret an.