Zenn Ai Review Rate Limit Fallback
AIレビューはレート制限で詰む — Claude / Codex / Gemini を可用性で多重化する
- URL: https://zenn.dev/minewo/articles/ai-review-rate-limit-fallback
- 日付: 2026-06-10
- Tier: Tier 3
- 要旨: 複数AI（Claude・Codex・Gemini）でレビューしようとするとレート制限（429）・認証エラーで止まる。「賢い1体」ではなく「落ちても回る複数体」として設計するためのL1/L2/L3可用性レイヤー設計を提案。
詳細
実際に起きた問題：
- Gemini CLI：
429 You have exhausted your capacity on this modelで停止 - flashモデルに切替：所見が浅い＋存在しない記述への言及など的外れ指摘
- Codex CLI：使用制限に到達
- 結果：外部CLIによるレビューが揃わず、PR連動のbotレビューのみで進行
可用性L1/L2/L3分類：
| 層 | 実体 | 落ちたとき |
|---|---|---|
| L1 | 自前で起動・制御しやすい独立エージェント | 止める |
| L2 | PR連動のbotレビュー | PRがなければskip |
| L3 | Codex CLI/Gemini CLIなどの外部CLI | 429や認証エラーなら即skip |
L1は観点別エージェントチームにする： Claude Codeのサブエージェントを並列で動かし、correctness・security・design・testabilityの各観点を独立エージェントに担わせる。これが可用性も独立性も確保できる設計。
L3を「落ちたら困る主経路」にしないことが鍵。外部CLIは「回れば強いが落ちても止めない補助枠」として扱う。