429エラーが出ても自動で再試行される新機能

429エラーって何?

Claude Codeを使っていると、ごくまれに作業の途中で応答が止まって、エラーが表示されることがあります。その原因の一つが「429」というエラーです。これはサーバー側から「今ちょっとリクエストが多すぎるので、少し待ってください」と言われている状態のことです。

誤解されやすいのですが、この429は自分の利用上限(そのユーザーが契約しているプランの使用量制限)に達したという意味ではありません。サーバー側が一時的に混雑していて、瞬間的に処理しきれなかっただけの「一過性のエラー」です。混雑している道路で一瞬渋滞にはまるようなもので、しばらく待てば普通に流れ出すイメージに近いです。

これまでは何が起きていたか

v2.1.199より前は、この一時的な429が発生すると、その時点で作業(ターン)自体が失敗として終わってしまっていました。せっかくClaude Codeが何かを考えたり実行したりしている途中でも、サーバーが一瞬混雑しただけで「エラーです」と表示されてしまい、ユーザーはもう一度同じ指示を出し直す必要がありました。

ちょっとした通信の乱れのせいで作業がやり直しになるのは、地味にストレスがたまるポイントでした。

v2.1.199での変更点

今回のアップデートでは、この使用量とは無関係な一時的な429エラーが起きた場合、Claude Codeが自動的に少し時間を空けてから再試行するようになりました。これは有料プランを利用している人(subscriber)向けの改善です。

この「少し時間を空けてから」という部分は、専門的には「バックオフ」と呼ばれる仕組みです。すぐに何度も再試行すると余計にサーバーへ負荷をかけてしまうので、待つ時間を少しずつ調整しながらリトライすることで、成功する確率を上げつつサーバーにも配慮するという考え方です。

何が嬉しいのか

ユーザーから見ると、これまで手動でやり直していた「一瞬のエラーからの再実行」を、Claude Codeが裏側で勝手にやってくれるようになったということです。以下のように整理できます。

状況	これまで	v2.1.199以降
一時的な429が発生	ターンが失敗し、ユーザーが再度指示	自動的に待って再試行
利用上限に達した429	失敗として扱われる(今回の対象外)	今回の対象外(引き続き上限エラーとして扱われる)

特に、長めの作業をClaude Codeに任せているときや、コードのレビュー・大きめの変更をお願いしているときほど、途中でエラーになって最初からやり直すのは面倒です。今回の変更で、サーバー側のちょっとした混雑がユーザーの体験にそのまま跳ね返ってくる場面が減ります。

逆に言えば、これは「本当に使いすぎて上限に達した場合」まで自動でなんとかしてくれるわけではありません。あくまで一時的な混雑によるエラーが対象で、契約しているプランの使用量そのものを増やすような機能ではない点は覚えておくとよいでしょう。