文章摘要
Claude Auto-Resume 是一个 Shell 脚本工具,用于在 Claude CLI 任务因使用限制中断后自动恢复执行。它能够检测到 Claude 的使用限制,智能等待并在限制解除后自动恢复任务。该脚本在执行 Claude 命令时使用了 --dangerously-skip-permissions 标志,意味着任务会跳过权限检查自动执行,因此建议仅在受信任的环境中使用,并仔细审查提示内容。适用于开发环境中因使用限制中断的任务恢复,但不建议在生产系统或涉及敏感数据时使用。
文章总结
项目概述
项目名称: Claude Auto-Resume
项目地址: GitHub - terryso/claude-auto-resume
项目简介: Claude Auto-Resume 是一个 Shell 脚本工具,用于在 Claude CLI 任务因使用限制被中断后,自动检测限制解除并恢复任务执行。
安全警告
⚠️ 安全警告:
- 该脚本在执行 Claude 命令时使用了 --dangerously-skip-permissions 标志,这意味着:
- Claude 代码将无需权限确认直接执行任务。
- 文件操作、系统命令和代码更改将自动运行。
- 仅在受信任的环境中使用,并仔细检查提示词。
推荐使用场景: - 在隔离的开发环境中使用。 - 避免在生产系统或涉及敏感数据时使用。 - 使用具体的提示词以限制操作范围。
使用场景
- 任务因使用限制中断: 当 Claude Code 显示
Claude usage limit reached.但任务未完成时。 - 自动任务恢复: 在项目根目录运行
claude-auto-resume,脚本将在使用限制解除后自动恢复未完成的任务。
功能
- 🔄 自动检测 Claude CLI 使用限制。
- ⏰ 智能等待并显示倒计时。
- 🚀 自动恢复任务。
- 🖥️ 跨平台支持(Linux/macOS)。
- 📦 无外部依赖(仅需标准 Unix 工具)。
安装方法
使用 Makefile(推荐):
- 全局安装:
sudo make install - 自定义安装路径:
sudo make install PREFIX=/opt/local - 卸载:
sudo make uninstall
- 全局安装:
手动安装:
- 复制到系统路径:
sudo cp claude-auto-resume.sh /usr/local/bin/claude-auto-resume - 创建符号链接:
sudo ln -s $(pwd)/claude-auto-resume.sh /usr/local/bin/claude-auto-resume
- 复制到系统路径:
直接使用(无需安装):
- 使脚本可执行:
chmod +x claude-auto-resume.sh - 直接运行:
./claude-auto-resume.sh
- 使脚本可执行:
使用方法
基本用法:
- 启动新会话:
claude-auto-resume - 使用自定义提示词:
claude-auto-resume "implement user authentication" - 继续之前的会话:
claude-auto-resume -c "please continue the previous task"
- 启动新会话:
本地使用(安装前):
- 启动新会话:
./claude-auto-resume.sh - 使用自定义提示词:
./claude-auto-resume.sh "create login page"
- 启动新会话:
工作原理
- 检测限制: 执行
claude -p 'check'命令。 - 解析输出: 查找
Claude AI usage limit reached|<timestamp>格式的消息。 - 计算等待时间: 根据时间戳计算所需等待时间。
- 显示倒计时: 实时显示剩余等待时间。
- 自动恢复: 自动执行
claude --dangerously-skip-permissions -p "<custom-prompt>"或claude -c --dangerously-skip-permissions -p "<custom-prompt>"。
命令行选项
- 无参数: 使用默认提示词 "continue" 启动新会话。
- 单参数: 使用自定义提示词启动新会话。
- -p, --prompt: 使用标志指定自定义提示词。
- -c, --continue: 继续之前的会话。
- -h, --help: 显示帮助信息。
会话类型
- 启动新会话(默认): 使用
claude命令,不带-c标志。 - 继续之前的会话: 使用
claude -c命令。
要求
- Claude CLI: 必须安装并在 PATH 中可用。
- 标准 Unix 工具:
grep,date,sleep,awk(通常已预装)。
安全考虑
- 权限绕过: 使用
--dangerously-skip-permissions标志,Claude 将无需确认直接执行命令。 - 最佳实践: 在开发/测试环境中使用,仔细检查提示词,备份工作,监控执行过程。
错误处理
- 退出代码 1: Claude CLI 执行失败。
- 退出代码 2: 无法提取有效的时间戳。
- 退出代码 4: 恢复命令执行失败。
测试
- 语法检查:
make test或bash -n claude-auto-resume.sh
项目结构
claude-auto-resume/
├── claude-auto-resume.sh # 主脚本
├── Makefile # 安装/卸载脚本
├── docs/ # 项目文档
│ ├── architecture.md # 架构文档
│ ├── prd.md # 产品需求文档
│ └── stories/ # 用户故事
├── CLAUDE.md # Claude Code 指南
└── README.md # 项目描述
贡献指南
- Fork 项目。
- 创建特性分支:
git checkout -b feature/AmazingFeature - 提交更改:
git commit -m 'Add some AmazingFeature' - 推送分支:
git push origin feature/AmazingFeature - 创建 Pull Request。
许可证
该项目采用 MIT 许可证,详情见 LICENSE 文件。
支持
如遇问题或有建议: 1. 查看现有 Issues。 2. 创建新 Issue 描述问题。 3. 或提交 Pull Request。
Star 历史
注意: 该工具依赖于 Claude CLI 的输出格式。如果 Claude CLI 更新导致输出格式变化,脚本可能需要相应更新。
评论总结
主要观点总结:
Claude的使用体验与限制
- 正面评价:用户zackify表示从Max降级到Pro后,使用Sonnet 4的频率很高,且未遇到使用限制,认为Gemini CLI的发布使得使用额度非常充足。
- 引用:“Since downgrading from max to pro.... i have been using sonnet 4 a TON and i havent even been limited yet.”
- 负面评价:subarctic指出API按使用量计费比每月20美元的套餐贵得多,用户可能在一天内就消耗掉20美元的使用量。
- 引用:“Why is the API usage-based billing so much more expensive than the $20/month tier?”
- 正面评价:用户zackify表示从Max降级到Pro后,使用Sonnet 4的频率很高,且未遇到使用限制,认为Gemini CLI的发布使得使用额度非常充足。
多账户切换与自动化工具
- raylad提到拥有多个Claude账户,并建议添加在不同账户之间切换的功能,以便在一个账户耗尽时继续使用另一个。
- 引用:“If other people have a couple of accounts then that would be a nice feature to add to this: switching between accounts.”
- mehdibl分享了自己在VSCode中使用的扩展,支持自动恢复和暂停功能,并计划发布基于相同语法的CLI工具。
- 引用:“My extension in vscode have auto resume already, you use GUI to write workflows and run them right them.”
- raylad提到拥有多个Claude账户,并建议添加在不同账户之间切换的功能,以便在一个账户耗尽时继续使用另一个。
对LLM的依赖与担忧
- 担忧:magic_man认为过度依赖LLM会导致人们忘记如何编程,且LLM有时会生成错误代码或使用错误的API版本。
- 引用:“This over reliance on llms is crazy. People are going to forget how to code.”
- 实际应用限制:oc1指出,Claude生成代码虽然简单,但需求收集、指导Claude、审查输出等仍然是瓶颈,AI目前无法替代人类的全职监督。
- 引用:“Letting Claude code is the easy part of the job... Unfortunately, no AI can't steer the ship currently.”
- 担忧:magic_man认为过度依赖LLM会导致人们忘记如何编程,且LLM有时会生成错误代码或使用错误的API版本。
LLM的未来发展与定价模型
- martinald认为当前LLM的定价模式仍处于早期阶段,未来可能会推出更动态的定价模型,例如在特定时间段提供更便宜的使用额度。
- 引用:“Feels like we are incredibly early into pricing LLM usage... Think a more dynamic model for users would make a lot more sense.”
- bko提出疑问,是否有项目尝试长时间运行LLM以完成复杂任务(如开发操作系统),但也担心可能会陷入无限递归循环。
- 引用:“I would love to see what a system like Claude Code could cook up running continuously for weeks.”
- martinald认为当前LLM的定价模式仍处于早期阶段,未来可能会推出更动态的定价模型,例如在特定时间段提供更便宜的使用额度。
幽默与调侃
- bad_haircut72调侃需要一个自动按“y”键的小鸟,类似于《辛普森一家》中的场景。
- 引用:“I need this plus a little drinky-drinky bird to keep pressing 'y' for me.”
- bravura提到,即使告诉Claude“直到GitHub变绿才停止”,它有时仍会停下来等待指令。
- 引用:“Claude Code with an API token... will sometimes just stop and wait to be told to continue.”
- bad_haircut72调侃需要一个自动按“y”键的小鸟,类似于《辛普森一家》中的场景。