Claudrabandの機能

Claudrabandは公式のClaude Code TUIを制御されたターミナル環境で実行するラッパーです。これにより、開発者は永続的なClaude Codeセッションを維持し、後で再開したり、保留中のプロンプトに回答したり、デーモンを通じてセッションを公開したり、Anthropic Client Protocol（ACP）を通じて駆動したりできます。

主な機能とコマンド

このツールは以下の具体的な機能を提供します：

• 再開可能な非対話型ワークフロー：基本的にはセッションサポート付きのclaude -pです。例：cband continue <session-id> '研究の結果はどうなりましたか？'
• リモートまたはヘッドレスセッション制御のためのHTTPデーモン：cband serve --host 127.0.0.1 --port 7842で起動し、cband --connect localhost:7842 "マイグレーション計画を開始してください"で接続
• エディターおよび代替フロントエンド統合のためのACPサーバー：cband acp --model opusまたはcband acp --model haikuを実行して、ToadやZedなどのツールとの統合を有効化
• カスタムツールにこれらのワークフローを構築するためのTypeScriptライブラリ
• セッション管理：cband sessionsで追跡中のライブセッションを一覧表示、cband sessions close --allですべての制御セッションを閉じる

セットアップと要件

要件にはNode.jsまたはBun、すでに認証済みのClaude Codeインストール、および第一級のローカルおよびデーモンバックドワークフローのためのtmuxが含まれます。インストールオプション：

# 一回限りの使用
npx @halfwhey/claudraband "ステージングされた差分をレビューしてください"

グローバルインストール
npm install -g @halfwhey/claudraband

パッケージはclaudrabandとcband（推奨される短縮形）の両方をインストールします。Claude Code @anthropic-ai/[email protected]をバンドルしていますが、CLAUDRABAND_CLAUDE_PATH環境変数でオーバーライドできます。

ワークフローの例

ソースではいくつかの実用的なユースケースを示しています：

• ローカルの永続的セッション：cband "最後のコミットを監査して、リスクが高そうな点を教えてください"
• 自己問い合わせ：Claudeは古いClaudeセッションを問い詰め、その選択を正当化できます
• 代替フロントエンド：ToadやZedはclaudraband acpをClaude Codeの代替フロントエンドとして使用できます
• ライブラリ統合：TypeScriptの例にはコードレビュー、マルチセッション管理、セッションジャーナリングが含まれます

技術的詳細

セッションは~/.claudraband/で追跡されます。デーモンはデフォルトでtmuxをターミナルランタイムとして使用します。ヘッドレスフォールバック用の実験的な--backend xtermオプションが存在しますが、tmuxより遅いです。このプロジェクトは実験的とマークされており、Claude CodeとACPクライアントの変化に伴って進化しています。

重要な注意点：これはClaude SDKの代替ではなく、個人的なアドホックな使用を目的としています。OAuthを処理せず、Claude Code TUIをバイパスしません - すべてのインタラクションは実際のClaude Codeセッションを通じて実行されます。