claude-auto-retry
在訂閱速率限制、API 超載 (529/5xx) 和安全防護誤判時自動重試 Claude Code — 等待列印的重置、指數退避、tmu
claude-auto-retry 是什麼?
在訂閱速率限制、API 超載 (529/5xx) 和安全防護誤判時自動重試 Claude Code — 等待列印的重置、指數退避、基於 tmux
claude-auto-retry 概覽
這是什麼
claude-auto-retry 是一個工具,能在 Claude Code 工作階段因 Anthropic 訂閱速率限制、API 超載錯誤(529/5xx)或安全防護誤判而中斷時,自動重試。它會等待畫面上顯示的重置時間,採用指數退避,並利用 tmux 讓工作階段在斷線後仍保持存活。此工具無依賴項,也無需改變工作流程——安裝後即可忘記。自 Claude Code v2.1.234(2026 年 10 月)起,原生自動繼續功能已能處理互動式訂閱工作階段的核心用量限制等待,但 claude-auto-retry 涵蓋原生功能未處理的情境:在 SSH 斷線或終端機關閉時保持等待存活、從未啟動的等待(超過 24 小時的每週重置、模型特定限制、Remote Control 工作階段),以及其他失敗模式(API 超載、安全防護誤判、串流中斷、接近限制的收尾提示)。
主要功能
- 等待畫面上顯示的用量限制重置時間,並自動送出「continue」。- tmux 包裝器讓 Claude Code 工作階段及等待過程在 SSH 斷線或終端機關閉後仍能存活。
- 處理超過 24 小時的每週重置、模型特定限制,以及原生自動繼續不會啟動的 Remote Control 工作階段。
- 在 Claude Code 內部重試放棄後,對終端 API 超載(529/5xx)進行指數退避。
- 對安全防護/AUP 誤判進行有限次數的重送。
- 可設定的 maxRetries(預設 5 次),用於恢復後重複遇到限制。
- 可安全地與原生自動繼續並行執行;監控器會在原生功能啟動時讓步,並作為備援。
使用情境
- 在夜間、透過 SSH 或無人看管的情況下執行長時間的 Claude Code 任務。
- 當原生自動繼續功能未啟動時:超過 24 小時的每週重置、執行其他模型時的模型特定限制、Remote Control 工作階段,或無頭模式
claude -p執行。 - 當工作階段可能因 SSH 斷線、終端機關閉或電腦休眠而中斷時——tmux 包裝器可保持其存活。
- 處理 API 超載(529/5xx)、安全防護誤判、串流中斷,以及接近限制的收尾提示。
快速開始
bashnpm i -g claude-auto-retryclaude-auto-retry install然後像平常一樣輸入 claude。
授權與價格
本專案為開放原始碼,採用 MIT 授權。
內容整理自該專案公開的 README 與儲存庫資訊。