
2026/04/13 1:55
Show HN: クロードラバンド – パワーユーザー向けに最適化された「Claude Code」
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
Claudraband は、公式の Claude Code TUI をラップし、セッション間およびリモート環境間で回復性のある再開可能なワークフローを可能にする TypeScript ライブラリおよび CLI ツールです。認証済み @anthropic-ai/claude-code@2.1.96 バイナリをバンドルしており、CLAUDRABAND_CLAUDE_PATH を経由してパスの上書きをサポートします。認証処理は OAuth フローを変更せず、標準的な OAuth フローを維持します。インストールには Node.js または Bun が必要であり、既に認証済みの Claude Code インスタンス、および一級でローカルかつデーモン後援型のワークフローを実現するための tmux が必須です。実験的な
--backend xterm バックアップは動作が遅く、長期間にわたる対話型タスクには推奨されません。
このツールは、主に 2 つの使用方法をサポートしています:ローカルで永続的な tmux セッション、およびデーモン後援型のリモートセッション(デフォルトでは指定しない限り tmux ランタイムを使用)。このアーキテクチャにより ACP 統合が可能となり、Zed や Toad のようなエディターが claudraband を介して Claude Code を駆動する代替フロントエンドとして機能し、その下には実際の Claude Code ペインを維持できます。ライブセッションは
~/.claudraband/ に追跡され、cband continue コマンドを使用してライブでない既存のセッションも再開可能です(ただし cband attach はライブセッションのみに対して動作します)。ユーザーは cband continue の --select フラグを使用して特定のプロンプトを選択でき、すべての claudraband 制御下のセッションを cband sessions close --all で終了させることができます。
高度なユーザーは、CLI 引数(例:
-c "--model haiku";ACP モードでのデフォルトは opus)を通じてモデルをカスタマイズし、プログラム制御のために生デーモンエンドポイントにアクセスできます。プロジェクトにはコードレビュー、複数セッションの管理、セッションジャーナリング(examples/)を含む実行可能な TypeScript サンプルが含まれています。ドキュメントは docs/cli.md(CLI の詳細)、docs/library.md(完全な API)、および docs/daemon-api.md(生デーモンエンドポイント)に分割されています。全体として、Claudraband は一過性のコーディングインタラクションを管理可能な長寿プロジェクトに変換し、コード生成を既存の ACP パイプラインに統合する組織にとって理想的なソリューションです。本文
クロードコード向けパワーユーザー用 claudraband
実験的: このプロジェクトは、Claude Code および ACP クライアントのバージョンアップに伴い進化を続けています。
ナビゲーション
- コマンドラインインターフェース (CLI)
- ライブラリ
- デーモン API
- サンプルコード
claudraband は、公式の Claude Code TUI(ターミナルユーザーインターフェース)を管理されたターミナル環境にラップすることで、セッションを持続させたり、後ほど再開したり、未回答のプロンプトに応答したり、デーモン経由で公開したり、ACP(アプリケーションコマンドプロセッサ)から制御したりすることを可能にします。
以下の機能を 제공합니다:
- 中断可能な非対話型のワークフローの実現。本質的には
にセッション管理機能が追加されたものです:claude -pcband continue <session-id> 'research の結果はどうでしたか?' - リモートまたはヘッドレス(表示画面なし)なセッション制御のための HTTP デーモン
- エディターおよび代替フロントエンドとの統合を可能にする ACP サーバー
- これらのワークフローを自社のツールに組み込むための TypeScript ライブラリ
注意点
これは Claude SDK の代わりではありません。個人的で即興的な利用に最適化されています。OAuth プロセスは触っておらず、Claude Code TUI をバイパスする機能もありません。認証は必ず Claude Code を経由させる必要がありますし、すべての対話処理は実際の Claude Code セッションから実行されます。
設定方法
要件
- Node.js または Bun
- すでに認証された Claude Code
- ローカルのファーストクラスなワークフローおよびデーモンバックエンドのワークフローのための
tmux
インストールまたは実行
# 一時的な利用 (one-off) npx @halfwhey/claudraband "ステージ済み差分のレビュー" bunx @halfwhey/claudraband "ステージ済み差分のレビュー" # 一度インストールして利用 npm install -g @halfwhey/claudraband
パッケージには
claudraband と cband の両方がインストールされます。cband が推奨される簡潔なコマンドです。このパッケージは Claude Code (@anthropic-ai/claude-code@2.1.96) をバンドルします。バイナリのパスをカスタマイズする必要がある場合は、CLAUDRABAND_CLAUDE_PATH 環境変数を設定してください。
クイックスタート
ファーストクラスの使用方法は、「ローカルの tmux セッション」と「デーモンバックエンドによるセッション」の 2 つです。
ローカル永続セッション
cband "直近のコミットを監査し、リスクのある箇所を教えてください" cband sessions cband continue <session-id> "継続して進行" cband continue <session-id> --select 2
デーモンバックエンドによるセッション
cband serve --host 127.0.0.1 --port 7842 cband --connect localhost:7842 "マイグレーションプランを開始する" cband attach <session-id> cband continue <session-id> --select 2
デーモンはデフォルトで tmux をターミナルランタイムとして使用します(ローカルパスの場合と同じです)。
--connect オプションは新しいデーモンバックエンドセッションを作成する際にのみ使用してください。その後、追跡された continue、attach、および sessions コマンドは、自動的に記録された生所有者を介して実行されます。
実験的 xterm.js バックエンド
ローカルまたはデーモン利用のための
--backend xterm オプションも存在しますが、これは実験的な機能であり、tmux よりも遅いです。長期的な対話型のワークフローのデフォルトパスとしてではなく、ヘッドレス(表示画面なし)環境への代替手段が必要な場合に使用してください。現在の制限事項およびバックエンドの動作については docs/cli.md を参照してください。
ACP
別のツールが claudraband 経由で Claude を制御する必要がある場合に ACP を使用します。
cband acp --model opus
例:Toad の ACP による利用 Toad は
claudraband acp を Claude Code の代替フロントエンドとして利用できます。
この UI の下には、実際の Claude Code パネルがバックエンドとして機能しています。
uvx --from batrachian-toad toad acp 'cband acp -c "--model haiku"'
エディターおよび ACP クライアントのサポートはフロントエンドによって異なりますが、claudraband 自体は ACP を通じたセッションの追跡と再開をサポートしています。
セッションモデル
生きているセッション(アクティブなセッション)は
~/.claudraband/ に保存されます。
:現在アクティブな追跡セッションを一覧表示cband sessions
:セッションが終了した後でも、既存の Claude Code セッションを再開できるcontinue
:アクティブなセッションのみで機能するattach
:ローカルまたはデーモンバックエンドのどちらであっても、アクティブな追跡セッションを閉じるsessions close ...
例
自己対話(セルフインタロゲーション)
Claude が過去の自身のセッションを分析し、行った選択の正当性を説明できます。
Toad の ACP による利用
上記を参照してください。
Zed の ACP による利用
Zed も claudraband acp を代替フロントエンドとして利用できます。
ライブラリ
実行可能な TypeScript サンプルは
examples/ 配下にあります:
- コードレビューの例examples/code-review.ts
- マルチセッション処理の例examples/multi-session.ts
- セッションジャーナルの例examples/session-journal.ts
完全な API については docs/library.md を参照してください。CLI の詳細については docs/cli.md を、生のデーモンエンドポイントについては docs/daemon-api.md をご参照ください。
チートシート
一時的な利用またはインストール
npx @halfwhey/claudraband "ステージ済み差分のレビュー" bunx @halfwhey/claudraband "ステージ済み差分のレビュー" npm install -g @halfwhey/claudraband
ローカル永続セッション
cband "直近のコミットの監査" cband sessions cband sessions close --all # claudraband で制御されているすべてのセッションを閉じる cband continue <session-id> "継続して進行" cband continue <session-id> --select 2 cband continue <session-id> --select 3 "xyz"
デーモンモード
cband serve --host 127.0.0.1 --port 7842 cband --connect localhost:7842 "マイグレーションプランを開始する" cband attach <session-id>
ACP
cband acp --model opus