产品简介
claude-auto-retry 一款专为Claude Code设计的自动化重试工具。它能自动检测使用限制、API过载等错误,在限制重置后自动发送“继续”指令,无需人工守候。尤其适合需要长时间运行任务或暂时离开电脑的Claude Code用户,确保任务不间断。
核心功能
- 零工作流改变:保持原有`claude`命令和操作界面
- 自动检测限制:识别多种使用限制与API错误信息
- 智能等待与继续:计算重置时间并自动发送“继续”指令
- 支持tmux会话:保持任务在后台稳定运行,即使断开连接
- 过载回退机制:对API过载错误实施可配置的指数退避重试
快速开始
- 使用npm全局安装:`npm i -g claude-auto-retry`
- 运行安装命令:`claude-auto-retry install`
- 之后像往常一样使用`claude`命令启动会话
界面预览
与其他方案对比
| 对比项 | claude-auto-retry | 同类方案 |
|---|---|---|
| 离线/断开连接后的任务保持 | 通过后台tmux会话与监控进程,任务在SSH断开、笔记本休眠等情况下仍可保持运行并等待恢复。 | 简单的wrapper脚本通常依赖前台终端,连接中断后进程终止,任务丢失。 |
适合谁用
- 需要长时间运行Claude Code任务的开发者
- 希望离线时Claude Code仍能工作的用户
下载与版本
当前最新版本为 v0.6.1,发布于 2026-07-23。支持 Windows、macOS、Linux。
⚠️ 注意:本项目仅提供源代码下载,不包含可直接运行的安装包(exe/dmg/apk 等。下载后需要自行编译构建才能使用,适合有一定开发经验的用户。如果你不熟悉编译流程,建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用,请遵守相关法律法规。
- 请尊重内容创作者版权,勿将下载内容用于商业或非法传播。
- 项目源码地址:https://github.com/cheapestinference/claude-auto-retry