Claude-bridge:可替代 claude -p 的橋接工具,自6月15日起可用
claude-bridge 是一個橋接工具,可替代常見的 claude -p 自動化。它透過 tmux 啟動互動式 Claude Code 會話,傳送提示、捕獲轉錄、格式化回覆並自動退出。支援列印模式、流式輸出、JSON Schema 驗證等功能,旨在作為指令碼中 claude -p 的直接替代品。
claude-bridge 是一個開源的橋接工具,旨在作為 claude -p 命令的替代品,用於自動化 Claude Code 互動。它透過在 tmux 面板中啟動互動式 Claude Code 會話,將提示透過 tmux 傳送,然後跟蹤 Claude 的磁碟轉錄檔案,格式化回覆並在對話輪次結束時退出。這種方法將提示分發、轉錄捕獲、輸出格式處理和程序退出行為都封裝在橋接器中。
該工具解決了直接使用 claude -p 時的一些限制,例如需要處理多個步驟和轉錄管理。claude-bridge 的工作原理如下:首先,它會預先清除可能阻止 Claude 介面的提示,編輯 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。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 輸出符合 Schema 的 JSON,然後從最終回覆中提取 JSON 並使用 Zod 進行驗證。它還安裝了一個全域性的 Claude Code 停止鉤子,在 Schema 執行期間阻止 Claude 停止,直到輸出有效 JSON。