WIKI // AI CODING TROUBLESHOOTING
AI 编程限流与成本报错速查库
写代码或跑 Agent 时突然遇到限流、配额提前耗尽或费用异常飙升?选择下方对应报错,直接获取一句话原因、恢复时间计算入口与实操解决步骤。
- Claude Code / Claude Pro / Max
You’ve reached your 5-hour usage limitClaude Code 提示 5 小时使用上限(5-hour limit reached)何时恢复与排查
Claude 的 5 小时限额采用「滑动窗口」而非报错时刻起算:恢复时间 = 本轮窗口内第一条有效请求时间 + 5 小时,而不是触发报错的时间加 5 小时。
查看排查步骤与计算工具 → - Claude Pro / Max (7-Day Rolling)
Weekly usage limit reachedClaude Pro / Max 周度限额(Weekly Limit)提前耗尽怎么办
Claude 周度限额按 7 天周期独立计算,即使 5 小时窗口已恢复,周限额未刷新前仍会被拦截;建议将每日消耗控制在剩余天数的均摊上限内,或对比按量 API 临时兜底。
查看排查步骤与计算工具 → - OpenAI Codex (ChatGPT Plus / Pro)
Codex usage limit exceededOpenAI Codex 额度耗尽报错与 Reset Card(重置卡)使用排查
Codex 触顶后请先区分「官方全局重置」与「Reset Card(重置卡)」:重置卡是针对特定订阅层级或活动发放的补偿资格,通常需按原帖说明领取或核销,不会自动刷新全部账号。
查看排查步骤与计算工具 → - Claude / OpenAI API & Coding Agents
Low Prompt Cache Hit Rate / Cost SpikePrompt Caching 缓存未命中导致 AI 编程费用暴涨排查指南
在长上下文 AI 编程中,正常缓存读占比应达到 80%–95%;一旦因为动态系统提示词、频繁切换模型或超出缓存 TTL 导致命中率跌破 30%,单次任务费用会立即暴涨 5–8 倍。
查看排查步骤与计算工具 → - Cursor Pro (500 Fast Requests / 30d)
Fast requests limit reachedCursor 500 次 Fast Requests 耗尽后如何规划节奏与评估替代方案
Cursor Pro 30 天周期平均每天约 16 次快速请求;若前半月高强度用 Composer/Agent 模式极易提前耗尽。建议开启 30 天规划器控速,并用成本计算器评估超出后买按量或切工具的账单差异。
查看排查步骤与计算工具 →
