Claude Codeを使ってコードを書いている最中、突然「429」という数字とともに作業が止まったことはありませんか。これはアンソロピックのサーバーが一時的にあなたの命令を受け付けられなくなった合図です。
APIの利用制限を正しく理解すれば、このエラーを回避して快適に開発を進められます。この記事では、制限がかかる具体的な目安と、設定一つで通信量を減らす実践的なテクニックをまとめました。
Claude Codeの429エラーが起きる仕組み
プログラミングに没頭している時、突然エラーが出て作業が中断されるのは大きなストレスです。「さっきまで動いていたのになぜ」と首をかしげる方も多いでしょう。実は、AIが一度に処理できる情報の量には厳格な枠が決められています。この枠を越えないように作業をコントロールするのが、効率化のコツです。
リクエスト回数（RPM）の超過
短時間で何度もAIに命令を送ると、分間リクエスト制限に接触します。具体的には、小さな修正を数秒おきに繰り返すような使い方がこれに該当します。
AIが回答を生成している最中に次の命令を割り込ませたり、自動ループで何度もシェルコマンドを実行させたりすると、すぐに制限に達します。作業を細かく分けすぎず、一度の命令で複数の処理を完結させることが回避のポイントです。
分間トークン量（TPM）の限界
1分間に送受信できる文字数（トークン）の合計が上限に達すると、このエラーが吐かれます。Claude Codeはプロジェクト内のソースコードを丸ごと読み取って送信するため、大規模なフォルダでは一瞬で枠を使い切ります。
特に、画像ファイルや巨大なログファイルを読み込ませてしまうと、消費スピードが加速します。1回の通信で数万トークンを消費する環境では、数回のやり取りだけで制限がかかることも珍しくありません。
アンソロピックAPIのティアと制限の数値
AIの処理能力は、あなたがこれまでに支払った金額によって決まる「ティア」というランクに依存しています。初期状態ではこの枠が非常に小さいため、普通に使っているだけでもすぐに壁にぶつかってしまいます。自分が今どのランクにいて、どれくらいの余裕があるのかを数値で把握しておくことが、トラブルを防ぐ近道です。
ティアごとの制限値の一覧表
現在のティアを確認し、自分の作業量に見合った枠が確保されているかを照らし合わせてください。以下の数値はClaude 3.5 Sonnetを使用した場合の目安です。
| ティア | クレジット購入額 | 分間トークン制限（TPM） | 分間リクエスト制限（RPM） |
| Tier 1 | 5ドル以上 | 40,000 | 1,000 |
| Tier 2 | 50ドル以上 | 80,000 | 2,000 |
| Tier 3 | 200ドル以上 | 160,000 | 4,000 |
| Tier 4 | 1,000ドル以上 | 400,000 | 8,000 |
| Tier 5 | 5,000ドル以上 | 800,000 | 10,000 |
ティア1に昇格するための課金手順
初期状態のエラーを回避する最短の方法は、5ドル分のクレジットを購入してティア1に上がることです。無料枠のままでは実用的なコード生成には耐えられません。
- Anthropic Consoleの「Settings」から「Plans & Billing」を開く
- 「Add Credits」ボタンを押し、クレジットカードで5ドル以上をチャージする
- 購入完了後、数分から数十分で制限値が自動的に引き上げられる
一度チャージしてしまえば、残高がある限りティア1の恩恵を受けられます。自分への投資として最低額をチャージしておくことが、スムーズな開発環境を手に入れるための最低条件です。
制限を回避するためのファイル除外設定
AIに余計な情報を読み込ませない工夫も必要です。Claude Codeは初期設定のままだと、今開いているフォルダの中身をすべてスキャンしようとします。しかし、実際にはプログラムの動作に関係ない大きなファイルが混ざっていることが多いものです。これらを隠すだけで、1回のリクエストにかかる負担を劇的に減らせます。
.claudeignoreの作成
プロジェクトのルートディレクトリに .claudeignore という名前のファイルを作成します。これは .gitignore と同じ仕組みで、AIが無視すべきファイルやフォルダを指定するための設定書です。
ここに記述されたファイルは、AIとの通信から物理的に除外されます。AIの視界を必要なコードだけに絞ることで、トークン消費を抑えながら429エラーを防ぐことが可能になります。
node_modulesや巨大なデータの除外
ライブラリが詰まった node_modules や、コンパイル後の dist フォルダ、巨大な画像アセットなどは必ず除外リストに入れましょう。
node_modules/*.logbuild/.git/
これらを隠すだけで、1回のリクエストで消費されるTPMを節約できます。AIにとっても、ノイズが減ることでコードの修正精度が上がるというメリットがあります。
プロンプトキャッシュで効率を上げる
同じコードに対して何度も指示を出す場合、その都度すべての情報を送り直すのは非効率です。アンソロピックのシステムには、一度送った情報を一時的に記憶しておく仕組みがあります。この技術を賢く利用すれば、大規模なプロジェクトでも通信の制限を気にせずに開発を続けられるようになります。
キャッシュが機能する仕組み
同じプロジェクトで作業を続けている間、AIは「前回のコード」を記憶しています。2回目以降の命令では、変更のあった差分だけを実質的に処理するため、TPMの消費が抑えられます。
指示を出す際に、コードの共通部分を先頭に配置するよう意識してください。最初の20％程度の文章が一致していればキャッシュが効きやすくなるため、定型的な命令を頭に置くのが賢いやり方です。
通信負荷を減らすメリット
キャッシュが効いている間は、APIの利用料金が割引されるだけでなく、利用制限の計算からも外れやすくなります。これにより、429エラーに悩まされる頻度が激減します。
ただし、5分以上操作をしないとキャッシュは消滅します。まとめて集中して作業を行うほうが、断続的に指示を出すよりも効率的に制限を回避できる仕組みになっています。
少ない往復で成果を出す指示の出し方
AIとのやり取りの回数を減らすことも、制限を回避する有効な手段です。曖昧な指示を出して何度も修正を繰り返させると、その分だけリクエストが蓄積されてしまいます。一度の命令で100点の回答を引き出すための精密な指示文を組み立て、無駄な往復をカットしましょう。
1回のリクエストで完結させる命令
「ここを直して」の後に「あっちも直して」と続けるのではなく、最初から修正箇所をすべてリストアップして渡します。
# 命令
1. auth.ts のバリデーションにメールアドレス形式のチェックを追加してください。
2. それに伴い、login.tsx のエラーメッセージ表示部分を修正してください。
3. 最後に、npm test を実行してエラーが出ないか確認してください。
このように工程をセットで指示することで、リクエスト回数を1回に集約し、RPMの消費を最小限に抑えられます。
逐次確認を減らす自律型プロンプト
AIに対して「ファイルを書き換える前に、まずプランを提示して」と伝えると、無駄な書き込み通信を減らせます。プランに納得した段階で実行させることで、試行錯誤の回数を削ります。
AIの自律性を高める指示を出すことで、手動での細かな調整が不要になります。結果として、通信回数と精神的な負担の両方を低減することが可能です。
コンソールでの利用状況リアルタイム監視
自分が今どれくらいのリソースを使っているのか、感覚に頼るのは危険です。アンソロピックの管理画面には、現在の通信量をグラフで可視化する機能が備わっています。制限に近づいていることを事前に察知できれば、致命的なエラーが出る前に作業のペースを調整できます。
Usageタブの見方
Anthropic Consoleの「Usage」タブを開くと、過去数時間から数日間のトークン消費推移が確認できます。ここでTPMのグラフが上限に張り付いている場合は、設定の見直しが必要です。
自分がどの時間帯に激しく消費しているかを把握してください。消費のピークを特定することで、休憩を挟むタイミングや課金強化の判断を客観的に行えるようになります。
消費スピードの予測
現在のティアの制限値と、自分の1時間あたりの平均消費量を比較します。もし常に制限ギリギリで作業しているなら、上のティアへ昇格するための予算を確保すべきです。
作業が止まることによる損失を考えれば、数百ドルのデポジットは安い投資と言えます。自分の開発スピードに見合った「土俵」を整えることが、プロのエンジニアとしての正しい判断です。
予算制限の設定で課金トラブルを防ぐ
制限を回避しようと設定を強化していると、予期せぬ高額な請求が来るのではないかと不安になるかもしれません。これを防ぐために、あらかじめ「これ以上は使わない」という物理的な壁を作っておくことが重要です。金銭的な安全を確保しておくことで、心理的な負担なくAIを酷使できるようになります。
Monthly Budgetの入力
管理画面の「Billing」セクションで、1ヶ月の最大支出額を設定してください。たとえば30ドルと設定しておけば、それを超えた瞬間にAPIが停止し、課金がストップします。
「気づいたら数万円かかっていた」という事態を確実に回避できます。金銭的な不安を取り除くことが、AIを大胆に使いこなすための前提条件となります。
通知アラートの活用
予算の50％や80％に達したときに、メールで通知を受け取る設定も可能です。いきなり止まるのを防ぐため、早めにアラートを受け取れるようにしておきましょう。
アラートが来たら、その月の残り日数を考え、作業の優先順位を整理します。計画的なリソース管理を行うことで、月末に開発が止まるリスクを最小化できます。
AIツールの制限とコストの比較
Claude Code以外にもコード生成ツールは存在しますが、それぞれ制限の仕組みが異なります。自分の用途にはどのツールが最適か、特徴を整理して選ぶことが大切です。一つのツールに固執せず、状況に合わせて使い分けることで、制限によるストレスを分散させることができます。
CLIツール特有の負荷
Claude Codeのようなツールは、エディタ拡張機能に比べて一度に送信する情報の塊が大きくなる傾向があります。そのため、429エラーには最も遭遇しやすい部類に入ります。
その分、プロジェクト全体の整合性を保つ能力は群を抜いています。**「コストと引き換えに高い知能を借りている」**という認識を持ち、ここぞという場面で強力な命令を出すのが正解です。
| ツール名 | 主な制限 | コスト | 向いている用途 |
| Claude Code | APIティア依存 | 従量課金 | 大規模なリファクタリング、自律作業 |
| エディタ拡張型 | 月間の回数制限 | 月額固定 | 日常的なコード補完、UI操作 |
| ブラウザ版AI | メッセージ数制限 | 月額固定 | ドキュメント作成、小規模な修正 |
まとめ：賢く制限を回避して開発を止めない
Claude Codeで発生するエラー429は、ツールの故障ではなく、あなたが高度な作業を高速で行っている証拠です。この制限を「壁」と捉えるのではなく、正しく管理すべきリソースとして扱いましょう。
1〜2分待機してもエラーが消えない場合は、まず管理画面で残高を確認してください。5ドル以上のクレジットをチャージしてティア1へ昇格し、.claudeignoreを設定してAIに読ませるコードを最小限に絞ることが最も効果的です。制限の目安を把握し、これらの対策を講じることで、AIとの共同開発は驚くほど快適になります。
