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。