AI News HubLIVE
站内改写2 分で読了

Claude-bridge:claude -p の代替ツール、6月15日以降利用可能

claude-bridge は、claude -p の自動化を置き換えるブリッジツールです。tmux 内でインタラクティブな Claude Code セッションを起動し、プロンプトを送信、トランスクリプトをキャプチャ、応答をフォーマットして終了します。プリントモード、ストリーミング、JSON Schema 検証などをサポートし、スクリプト内での claude -p の直接的な代替を目指しています。

ソースHacker News AI著者: tarasyarema

claude-bridge は、claude -p コマンドの代替として設計されたオープンソースのブリッジツールです。tmux ペイン内でインタラクティブな Claude Code セッションを起動し、プロンプトを tmux 経由で送信し、Claude のディスク上のトランスクリプトファイルを追跡して応答をフォーマットし、ターン終了時に終了します。これにより、プロンプトのディスパッチ、トランスクリプトのキャプチャ、出力形式の処理、プロセス終了動作がすべてブリッジにカプセル化されます。

このツールは、claude -p を直接使用する際の制限(複数のステップやトランスクリプト管理が必要)に対処します。claude-bridge は、Claude の UI をブロックする可能性のあるプロンプトを事前にクリアし、Claude のグローバル設定を編集して信頼ダイアログやプロジェクトオンボーディングを受け入れ、ワークディレクトリにローカル設定を設定して権限をバイパスします。その後、--dangerously-skip-permissions フラグで Claude を起動し、tmux 経由でテーマやセキュリティの開始プロンプトを自動確認します。

claude-bridge を使用するには、Bun(バージョン 1.1 以上)、tmux、Claude CLI(バージョン 2.1.80 以上)が必要で、Claude Code の認証が必須です。bunx でインストールせずに実行することも、npm や Bun にグローバルインストールすることもできます。

プリントモードは claude-bridge の核となる機能で、claude -p をスクリプトで使用する場合の代替として機能します。--output-format パラメータで text、json、stream-json を選択でき、デフォルトは text です。json と stream-json は Claude ネイティブの形式と互換性があり、--desplega-format フラグを使用するとブリッジ固有のコンシューマ向けのカスタムエンベロープが出力されます。

認証については、claude-bridge は Anthropic API を直接呼び出さず、ローカルの Claude CLI の認証に依存します。ローカルマシンでは claude が正常に動作することを確認するだけでよく、ヘッドレス CI の場合は claude setup-token で生成された長期 OAuth トークンを使用します。デフォルトでは、ANTHROPIC_API_KEY などの環境変数はクリアされ、異なる認証パスを誤って使用しないようにしますが、--desplega-local-auth フラグでローカル認証を有効にできます。

構造化 JSON 出力は claude-bridge の重要な機能です。--json-schema パラメータで JSON Schema を指定すると、ブリッジはシステムプロンプトを追加して Claude にスキーマに準拠した JSON を出力するよう促し、最終応答から JSON を抽出して Zod で検証します。さらに、グローバルな Claude Code 停止フックをインストールし、スキーマ実行中は Claude が停止するのを防ぎ、有効な JSON が出力されるまで追加のターンを許可します。