Claude Codeの429は2種類ある——usage枠とthroughput制限を取り違えた代償

Claude CodeのAPIエラー「429」には、分単位で回復するスループット制限と、時間・週次で管理される使用量枠の2種類があることを解説しています。エラー表示が区別しないため、混同によるトラブル事例を基に対処法を提示しています。

• Claude CodeのAPIエラー「429」には「Throughput制限」と「Usage枠」の2種類存在。
• Throughput制限は速度上限、Usage枠は総量上限で、回復方法が真逆。
• エラーメッセージに区別がなく、状況証拠（リセット時刻、待機時間）での判別が必要。
• 75体のSubagent並列実行で両方の制限を同時に超過した実測例を紹介。
• Subagentのmodel指定漏れや思考トークン消費がUsage枠超過の主な原因と指摘。