Kontext-Meter: Claude Code Kontextnutzung in der Statuszeile

Das Kontext-Meter bringt die Claude Code Kontextnutzung in der Statuszeile unter. Es schreibt eine kompakte Zeile in die Statuszeile: ctx 42% · 5h 23% · 7d 61.5% · $1.20. Das ist der Füllstand des Kontextfensters, wie viel deiner 5-Stunden- und 7-Tage-Fenster des Plans du verbraucht hast (bei einem Abonnement) und was die Sitzung bisher gekostet hat. Erreicht der Kontext 80 Prozent, warnt dich ein Toast einmalig, damit du /compact oder /clear ausführen kannst, bevor Claude frühere Details verliert.

Der Sinn dahinter: Schluss mit dem Raten. Du musst nicht mehr /cost oder /context aufrufen, um zu wissen, ob eine lange Aufgabe noch hineinpasst, und die Warnung kommt früh genug, um selbst zu entscheiden, wann du kompaktierst. Benötigt Claude Code 2.1.287 oder neuer.

Die Aufnahme startet eine Sitzung mit geladener Mod. Die Statuszeile zeigt ctx – bis zur ersten Antwort und füllt nach dem Abschluss des Turns den Kontextprozentwert, die Planfenster und die Kosten aus.

Wähle eine der Methoden im Installationsblock. Konfigurieren musst du nichts; die Standardwerte zeigen alles, was dein Konto liefert.

Die ganze Mod besteht aus drei Hooks und einer Aktualisierungsfunktion. Aus hooks/register.ts:

async function refresh($: EngineInterface, meter: Meter): Promise<void> {
  // No `breakdown`: the status-line figures alone, which cost no request.
  const usage = await $.session.usage()
  $.ui.status(formatMeter(usage, meter))
  const percent = contextPercent(usage)
  const step = warnStep(percent, meter.warnAtPercent, meter.warned)
  meter.warned = step.warned
  if (step.toast) {
    $.ui.toast(`Context is ${percent}% full. Consider /compact or /clear soon.`)
  }
}

$.session.usage() liefert die Kontext-Tokens und das Kontextfenster, die Rate-Limits des Plans und die Kosten. Ohne Aufschlüsselung aufgerufen, liest es Zahlen, die Claude Code bereits hat – das Meter kann also so oft laufen, wie es will, ohne etwas zu kosten. formatMeter in hooks/format.ts baut den Text und lässt jeden Wert weg, den die Engine nicht hat, statt eine Null auszugeben. warnStep merkt sich, ob schon gewarnt wurde, sodass der Toast pro Überschreitung nur einmal erscheint; bringt eine Kompaktierung den Kontext wieder unter die Schwelle, kann erneut gewarnt werden.

refresh wird von session.start aufgerufen (das außerdem einen $.clock.every-Timer startet), von turn.complete nur für Turns der Hauptschleife und von session.compact. Da session.compact eine Kompaktierung abbrechen kann, wartet dieser Hook zuerst auf next(e) und hat einen .catch, der zurückgibt, was next ergeben hat. Das Meter hält eine Kompaktierung also nie auf.

Diese Optionen setzt du in /config. Mit format: verbose wird die Zeile ausgeschrieben als Context 42% (84k/200k) · 5-hour 23% · 7-day 61.5% · Cost $1.20. Die Beschriftungen stehen in der Tabelle LIMIT_LABELS in hooks/format.ts; dort benennst du also 5h oder 7d um. Der Warntext ist der Template-String innerhalb von refresh.

Das einzige Abzeichen ist Verändert die Oberfläche: Die Mod schreibt die Statuszeile und zeigt einen Toast. Sie führt keine Befehle aus, liest oder schreibt keine Dateien, nutzt kein Netzwerk, liest deine Prompts nicht und ruft das Modell nicht auf. Damit gehört sie zu den sichersten Mods, die du installieren kannst, und ist eine gute erste Wahl.

Zum Abschalten führst du /plugin disable cm-context-meter aus. Um eine Sitzung ganz ohne Mods zu starten, nutze claude --safe-mode.

Getestet mit Claude Code 2.1.291 im Terminal unter macOS. Wenn das Meter nicht erscheint:

• Prüfe claude --version; Mods brauchen 2.1.287 oder neuer.
• Stelle sicher, dass die Mod im Tab „Installed“ von /plugin aktiviert ist.
• Führe nach einer Installation über die Shell in bereits offenen Sitzungen /reload-plugins aus.
• Eine andere Mod oder ein eigener Statuszeilen-Befehl kann sich die Zeile teilen. Deaktiviere andere Status-Mods kurz, um zu sehen, ob der Text verdrängt wird.
• Dass mit einem API-Schlüssel keine Planwerte erscheinen, ist erwartetes Verhalten.

Der Kostenwert ist dieselbe Sitzungsschätzung, die /cost aufsummiert; er ist keine Rechnung.