Was Claudraband macht

Claudraband ist eine Wrapper-Anwendung für die offizielle Claude Code TUI, die sie in einer kontrollierten Terminalumgebung ausführt. Dies ermöglicht Entwicklern, persistente Claude Code-Sitzungen aufrechtzuerhalten, später fortzusetzen, ausstehende Eingabeaufforderungen zu beantworten, Sitzungen über einen Daemon freizugeben oder sie über das Anthropic Client Protocol (ACP) zu steuern.

Hauptfunktionen und Befehle

Das Tool bietet mehrere spezifische Fähigkeiten:

• Wiederaufnehmbare nicht-interaktive Workflows: Im Wesentlichen claude -p mit Sitzungsunterstützung. Beispiel: cband continue <session-id> 'was war das Ergebnis der Recherche?'
• HTTP-Daemon für Fern- oder Headless-Sitzungssteuerung: Starten mit cband serve --host 127.0.0.1 --port 7842, dann verbinden mit cband --connect localhost:7842 "starte einen Migrationsplan"
• ACP-Server für Editor- und alternative Frontend-Integration: Ausführen von cband acp --model opus oder cband acp --model haiku, um Integration mit Tools wie Toad oder Zed zu ermöglichen
• TypeScript-Bibliothek zum Einbauen dieser Workflows in benutzerdefinierte Tools
• Sitzungsverwaltung: cband sessions listet live verfolgte Sitzungen auf, cband sessions close --all schließt alle kontrollierten Sitzungen

Einrichtung und Anforderungen

Anforderungen umfassen Node.js oder Bun, eine bereits authentifizierte Claude Code-Installation und tmux für erstklassige lokale und daemon-gestützte Workflows. Installationsoptionen:

# einmalige Nutzung
npx @halfwhey/claudraband "überprüfe die gestagte Diff"

global installieren
npm install -g @halfwhey/claudraband

Das Paket installiert sowohl claudraband als auch cband (empfohlene Kurzform). Es enthält Claude Code @anthropic-ai/[email protected], erlaubt aber Überschreiben mit der Umgebungsvariable CLAUDRABAND_CLAUDE_PATH.

Workflow-Beispiele

Die Quelle zeigt mehrere praktische Anwendungsfälle:

• Lokale persistente Sitzungen: cband "prüfe den letzten Commit und sage mir, was riskant aussieht"
• Selbstbefragung: Claude kann eine ältere Claude-Sitzung befragen und die getroffenen Entscheidungen rechtfertigen
• Alternative Frontends: Toad oder Zed können claudraband acp als alternatives Frontend für Claude Code verwenden
• Bibliotheksintegration: TypeScript-Beispiele umfassen Code-Review, Multi-Sitzungsverwaltung und Sitzungsprotokollierung

Technische Details

Sitzungen werden in ~/.claudraband/ verfolgt. Der Daemon verwendet standardmäßig tmux als Terminal-Laufzeitumgebung. Eine experimentelle --backend xterm-Option existiert als Headless-Fallback, ist aber langsamer als tmux. Das Projekt ist als experimentell markiert und entwickelt sich weiter, während Claude Code und ACP-Clients sich ändern.

Wichtiger Hinweis: Dies ist kein Ersatz für das Claude SDK und ist auf persönliche, ad-hoc-Nutzung ausgelegt. Es behandelt kein OAuth oder umgeht die Claude Code TUI - jede Interaktion läuft durch eine echte Claude Code-Sitzung.