核心用法
Redline 是一套面向 Claude.ai (Max/Pro) 和 OpenAI/ChatGPT/Codex (Plus/Pro) 用户的实时用量监控与自动节流系统。通过两条 CLI 脚本(claude-usage 和 openai-usage)获取官方 API 的实时用量数据,结合四色分级策略(GREEN/YELLOW/ORANGE/RED)动态调整 AI 代理的工作强度。
技术实现:
claude-usage:从 macOS Keychain 读取 Claude Code OAuth token,调用 Anthropic 用量 APIopenai-usage:从 OpenClaw 认证配置读取 token,调用 OpenAI 用量 API- 支持
--json输出供程序化集成
四级节流策略:
| 层级 | 剩余额度 | 行为模式 |
|------|---------|---------|
| GREEN | >50% | 正常运营,全功能可用 |
| 🟡 YELLOW | 25-50% | 跳过子代理,推迟非紧急研究 |
| 🟠 ORANGE | 10-25% | 仅响应必要请求,禁止主动检查 |
| 🔴 RED | <10% | 仅处理关键任务,立即告警用户 |
显著优点
1. 预防性设计:在触及硬性限制前主动降级,避免服务中断
2. 双平台覆盖:同时支持 Anthropic 和 OpenAI 两大主流生态
3. 零侵入集成:通过 HEARTBEAT.md 心跳机制嵌入现有工作流,无需改造核心架构
4. 精细化数据:返回包含重置时间戳、多时间窗口利用率、额外额度等完整元数据
潜在局限
- 平台锁定:Claude 脚本依赖 macOS Keychain,Linux/Windows 用户需手动适配
- 认证依赖:需要预先配置 Claude Code 或 OpenClaw 的 OAuth 流程
- 被动监控:仅读取用量而非真正拦截请求,极端并发下仍可能超限
- 企业级缺失:无团队配额管理、无历史趋势分析、无自动扩容建议
适合人群
- 重度 Claude Max/Pro 或 ChatGPT Plus/Pro 个人用户
- 运行长时自动化任务(如代码审查、批量文档处理)的开发者
- 对服务连续性敏感,不愿因 rate limit 中断工作流的效率追求者
常规风险
- Token 泄露风险:脚本需要读取 OAuth token,需确保 Keychain/配置文件权限正确(建议
chmod 600) - API 变更风险:官方用量 API 非公开文档化端点,存在随时变更或限流可能
- 误节流风险:阈值设置偏保守可能导致过早降级,影响用户体验;偏激进则失去保护意义
- 单点故障:若用量 API 暂时不可用,系统无法获取准确状态,需设计降级默认策略