Claude HUD macht Claude-Code-Sitzungen im Terminal sichtbar
Ein Claude Code-Plugin, das anzeigt, was passiert – Kontextnutzung, aktive Tools, ausgeführte Agents und Todo-Fortschritt.
Auf einen Blick
- Was ist das?
- A Claude Code plugin that shows what's happening - context usage, active tools, running agents, and offene Punkte progress.. Diese Einordnung trennt dokumentierte Funktionen von offenen Fragen und beschreibt den passenden Einsatzbereich.
- Für wen ist es gedacht?
- Geeignet ist claude-hud für Anwender, deren Umgebung zu den im README genannten Voraussetzungen passt und die den beschriebenen Arbeitsablauf benötigen. Ungeeignet ist es für Erwartungen, die das Material nicht belegt.
- Darf ich es kommerziell nutzen?
- Ja. MIT ist eine freizügige Lizenz: Sie dürfen darauf aufbauende Software nutzen, verändern und verkaufen, solange Sie die Urheberrechts- und Lizenzhinweise beibehalten.
- Wird es noch gepflegt?
- Ja. Die letzten Commits kamen vor 3 Tagen.
- In welcher Sprache ist es geschrieben?
- Hauptsächlich JavaScript, laut der Sprachstatistik von GitHub.
Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 15. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.
TIEFGEHENDE OPEN-SOURCE-ANALYSE
Eine Statuszeile, die beantwortet, was gerade passiert: claude-hud
Bei claude-hud ist dieser Punkt für die Einordnung des Projekts maßgeblich. Claude HUD ist ein Claude Code-Plugin, das eine dauerhafte Statuszeile unterhalb der Eingabe rendert. Das Standard-Layout mit zwei Zeilen zeigt in der ersten Zeile den Modellnamen, das Provider-Label, sofern eindeutig identifiziert, den Projektpfad und den Git-Zweig; die zweite Zeile zeigt einen Kontextbalken und Nutzungslimits. Optionale Zeilen können aktiviert werden, um Tool-Aktivität, laufende Agents und Aufgabenfortschritt anzuzeigen. Das README enthält Beispielausgaben für jede Option, etwa `◐ Edit: auth.ts | Read ×3 | Grep ×2` für Tools, eine Agentenzeile mit verstrichener Zeit und eine Aufgabenzeile mit Fortschrittszählern.
Die README-Angabe beschreibt damit eine konkrete Grenze und einen konkreten Einsatzweg von jarrodwatts/claude-hud. Sie ersetzt keine Aussage, die im Material nicht belegt ist; fehlende Details bleiben offen. Für eine Prüfung dieses Abschnitts gehören der Repository-Pfad jarrodwatts/claude-hud und die dort genannte Dokumentation zum sachlichen Bezug.
Installation über den Plugin-Marketplace: claude-hud
Bei claude-hud ist dieser Punkt für die Einordnung des Projekts maßgeblich. Die Installation erfolgt innerhalb von Claude Code. Das README nennt drei Schritte: Marketplace mit `/plugin marketplace add jarrodwatts/claude-hud` hinzufügen, Plugin mit `/plugin install claude-hud` installieren und dann `/claude-hud:setup` ausführen, um die Statuszeile zu konfigurieren. Danach übernimmt `/reload-plugins` die Änderung ohne Neustart. Terminalnutzer können dieselben Befehle über die CLI ausführen: `claude plugin marketplace add` und `claude plugin install`. Das README dokumentiert auch zwei plattformspezifische Hinweise: Linux-Nutzer älterer Claude Code-Versionen können einen EXDEV-Fehler erleben, weil `/tmp` ein separates Dateisystem ist, und Windows-Nutzer müssen möglicherweise Node.js LTS installieren, wenn das Setup keine JavaScript-Laufzeit meldet. Beide Workarounds sind detailliert beschrieben.
Wie das Plugin rendert und aktualisiert: claude-hud
Bei claude-hud ist dieser Punkt für die Einordnung des Projekts maßgeblich. Claude HUD verwendet die native Statuszeilen-API von Claude Code, benötigt also kein separates Fenster oder tmux. Es liest stdin-JSON für Token- und Rate-Limit-Daten, parst das transcript JSONL für Tool-, Agenten- und Aufgabenaktivitäten und schreibt eine gerenderte Zeichenkette nach stdout. Laut README wird die Anzeige nach jeder Interaktion neu gerendert (neue Assistentennachricht, `/compact`, Berechtigungsänderungen, Vim-Modus-Umschaltungen) mit einer Entprellung von 300 ms. Kontextprozente basieren auf nativen Tokendaten von Claude Code, nicht auf Schätzungen, und das Plugin skaliert mit der gemeldeten Kontextfenstergröße, einschließlich neuerer 1M-Kontextsitzungen.
Presets, geführte Konfiguration und manuelle Überschreibungen: claude-hud
Bei claude-hud ist dieser Punkt für die Einordnung des Projekts maßgeblich. Der Befehl `/claude-hud:configure` führt durch Layout, Labelsprache und allgemeine Anzeigeoptionen, mit Vorschau vor dem Speichern. Es gibt drei Presets: Full aktiviert alles, Essential zeigt Aktivitätszeilen plus Git-Status, Minimal zeigt nur Modellname und Kontextbalken. Nach der Auswahl eines Presets können einzelne Elemente ein- und ausgeschaltet werden. Erweiterte Einstellungen werden direkt in `~/.claude/plugins/claude-hud/config.json` bearbeitet, darunter `colors.*`, `pathLevels`, `maxWidth`, Schwellenwertüberschreibungen, `display.timeFormat` und `display.promptCacheTtlSeconds`. Das README sagt, dass die geführte Konfiguration diese manuellen Einstellungen beibehält, während Sprache, Layout und allgemeine Optionen weiterhin geändert werden können. Vereinfachte und traditionelle chinesische Labels sind optional; `zh` steht für vereinfachtes Chinesisch, `zh-TW` für traditionelles Chinesisch. Die geführte Konfiguration schreibt `zh-Hans` oder `zh-Hant`.
Nutzungslimits, Kosten und Prompt-Cache: claude-hud
Bei claude-hud ist dieser Punkt für die Einordnung des Projekts maßgeblich. Die Nutzungsanzeige ist standardmäßig aktiviert, wenn Claude Code Abonnenten-`rate_limits`-Daten über stdin liefert. Sie zeigt den Verbrauch der Rate-Limits in der zweiten Zeile; ein 7-Tage-Prozentsatz erscheint, wenn er über einem konfigurierbaren Schwellenwert (Standard 80%) liegt. Nur-API-Key-Nutzer sehen keine Nutzungsanzeige, da sie keinen Rate-Limits unterliegen. Bedrock- und Vertex-AI-Modelle verbergen Nutzung und Kosten standardmäßig, da die Abrechnung vom Cloud-Anbieter verwaltet wird; `display.showRoutedCost` aktiviert die Kostenanzeige für diese Anbieter wieder. Die Kostenanzeige bevorzugt das native Feld `cost.total_cost_usd` und fällt auf eine tokenbasierte Schätzung zurück, wenn dieses Feld fehlt. Das Prompt-Cache-Element ist vollständig optional und basiert auf dem Zeitstempel der letzten Assistentenantwort im transcript, mit einem Standard-TTL von 300 Sekunden.
Lokales Design und die extra-cmd-Sperre: claude-hud
Bei claude-hud ist dieser Punkt für die Einordnung des Projekts maßgeblich. Das README beschreibt Claude HUD als von Natur aus lokal: Es macht keine Netzwerkaufrufe, sammelt keine Zugangsdaten und ruft keine undokumentierten Claude-APIs auf. Es liest Statuszeilen-JSON von stdin, den Sitzungstranskriptpfad, ausgewählte Claude-Konfigurationsdateien unter `~/.claude` und Git-Metadaten. Cache-Dateien werden unter `~/.claude/plugins/claude-hud` mit privaten Berechtigungen auf POSIX-Dateisystemen geschrieben. Die Funktion `--extra-cmd` ist deaktiviert, es sei denn, die Umgebungsvariable `CLAUDE_HUD_ALLOW_EXTRA_CMD=1` (oder true/yes/on) ist vorhanden; das README warnt, diese Option als beliebige Codeausführung zu behandeln und keine Befehle aus nicht vertrauenswürdigen Quellen zu verwenden. Eine Umgebungsvariable `CLAUDE_HUD_DISABLE` kann das HUD für eine Sitzung unterdrücken.
Anforderungen, Entwicklung und Lizenz: claude-hud
Bei claude-hud ist dieser Punkt für die Einordnung des Projekts maßgeblich. Das README nennt Claude Code v1.0.80+ als Anforderung, Node.js 18+ oder Bun auf macOS/Linux und Node.js 18+ auf Windows. Für die Entwicklung werden nach dem Klonen `npm ci && npm run build` und `npm test` verwendet. Das Projekt ist unter der MIT-Lizenz lizenziert, die das Recht einräumt, Kopien der Software zu verwenden, zu kopieren, zu modifizieren, zu fusionieren, zu veröffentlichen, zu verteilen, zu unterlizenzieren und zu verkaufen, sofern der Urheberrechtshinweis und der Genehmigungshinweis enthalten sind. Der Lizenztext stellt die Software ausdrücklich "wie besehen" ohne jegliche Gewährleistung bereit, und das README macht keine Aussagen zu Support, Sicherheitsgarantien oder Produktionsreife über die Sicherheitshinweise hinaus.
Redaktionelles Fazit
Geeignet ist claude-hud für Anwender, deren Umgebung zu den im README genannten Voraussetzungen passt und die den beschriebenen Arbeitsablauf benötigen. Ungeeignet ist es für Erwartungen, die das Material nicht belegt. Vor dem Einsatz sollten der konkrete Einstieg von jarrodwatts/claude-hud, die genannte Konfiguration und die resultierende Ausgabe geprüft werden.
Community-Notizen