この記事は、公式の唯一解を示すものではない。Claude Code＋Z AI（GLM-5.1）の環境で実際に429エラー（code:1302）に何度も遭遇し、試行錯誤した結果、いちばん効果が高かった回避策をまとめた体験談だ。同じ環境で悩んでいる人には、再現性がある可能性が高い。
Z AI（GLM-5.1）環境では、プラン範囲内の利用でも429エラーが頻発することがある。エラー自体は一時的なものだが、リトライ上限に達すると作業が完全にフリーズしてしまう。少なくとも自分の環境では、この「リトライ上限到達による作業停止」が一番の実害だった。settings.jsonにCLAUDE_CODE_MAX_RETRIESを100に設定したところ、リトライ上限に余裕ができ、作業停止が起きにくくなった。
どんなエラーか ― 429（code:1302）の症状
作業中のターミナルに、突然こんなメッセージが出る。
Error: Rate limit reached
HTTP 429 — Too Many Requests
Code: 1302
この「429」はHTTPステータスコードで、「リクエストが多すぎる」という意味。ブラウザで言えば、一度に開きすぎたタブをまとめてリロードした時みたいな状態だ。
大事なのは「code:1302」の部分。この1302はZ AI（GLM-5.1）固有のレートリミットコードで、Anthropic公式APIを直接使っている環境では出ない。あなたのClaude CodeがZ AI経由で動いているからこそ出るエラーだ。
よくある発生パターンは3つ。長い対話を続けている時、連続してコード生成させている時、そして何も特別なことをしていなくても突然——。5分おきに止まってはリトライ、また同じエラー。このループにハマった経験はないだろうか。
まず確認すること ― あなたの環境チェック
対処法が当てはまるか、3点だけ確認する。
① APIプロバイダーがZ AI（GLM-5.1）か
環境変数のANTHROPIC_BASE_URLがZ AIのエンドポイントを指していれば、Z AI経由で動いている。
② エラーメッセージにcode:1302が含まれているか
上で紹介したエラーの中に「Code: 1302」があるか。1302がなければ、別の原因の可能性が高い。
③ Windows 10/11環境か
この記事はWindows前提で書いている。
ついでにClaude Codeのバージョンも確認しておこう。コマンドプロンプトかPowerShellで：
claude --version
バージョンが表示されればインストール自体は問題ない。さらに詳しく設定状態を確認したい場合はclaude doctorも実行しておくとよい。
私の環境で起きていたこと ― 429の実害
Z AI（GLM-5.1）環境でClaude Codeを使い始めてすぐ、429（code:1302）が何度も出ることに気づいた。プランの範囲内で普通に使っているだけなのに、である。
429自体は一時的な制限で、少し待てば解除される。問題は、Claude Codeが自動リトライする回数に上限があり、その上限に達すると作業が完全に止まってしまうことだ。少なくとも自分の環境では、429が出ることよりも「リトライ上限に達して作業が停止する」ことの方が深刻だった。
Claude Codeには429エラーが出た時に自動でリトライする仕組みがあるが、デフォルトの回数はそれほど多くない。Z AIのレートリミットはAnthropic公式APIより厳しめに感じられ、デフォルトのリトライ回数だとあっさり上限に達してしまうことがあった。自動改札に例えると、切符が読み取れなくて数回だけリトライして「ダメなら締め出し」というルールなのに、改札自体が混み合っていて数回じゃ足りない状態だ。
これに加えて、Z AI側のリクエスト制限がAnthropic直結より厳しい傾向があることと、コード生成のような長いリクエストを連続すると1回で消費する枠が大きいことも要因として重なっている可能性がある。
現時点で最も効果を感じている対処 ― CLAUDE_CODE_MAX_RETRIESを100に設定
試した中でいちばん効果が高かったのが、settings.jsonにCLAUDE_CODE_MAX_RETRIESを追記すること。手順を順に追う。
大事な前提: これは429エラーを出なくする設定ではなく、429が出てもリトライ上限に達しにくくして、作業停止に直結しにくくする設定だ。429自体は依然として出るが、Claude Codeが自動でリトライを続けられるようになる。
settings.jsonの場所
Windowsの場合、Claude Codeの設定ファイルは以下の場所にある。
~/.claude/settings.json
~はユーザーフォルダ（WindowsではC:\Users\あなたのユーザー名）を表す。エクスプローラーのアドレスバーに%USERPROFILE%\.claudeと入力してEnterを押せば、対象のフォルダが開く。
補足: このフォルダに
settings.jsonが見つからない場合は、まだ設定ファイルが作られていない可能性がある。その場合は自分で新規作成して構わない。
バックアップを取る
編集前に、必ず元のファイルをコピーして別名で保存する。settings.jsonの横にsettings.json.bakとしてコピーすればよい。何かあった時、元に戻せる。
編集前のコード例
例として、既にいくつか設定が書かれている場合を想定する。
{
"permissions": {
"allow": [
"Bash(git:*)"
]
},
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_ZAI_API_KEY"
}
}
編集後のコード例
envオブジェクトの中に"CLAUDE_CODE_MAX_RETRIES": "100"を追記する。
{
"permissions": {
"allow": [
"Bash(git:*)"
]
},
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_ZAI_API_KEY",
"CLAUDE_CODE_MAX_RETRIES": "100"
}
}
ポイントはenvオブジェクトの中に書くこと。トップレベルに書いても認識されない。先ほどの自動改札の比喩で続けるなら、「リトライ回数を増やしてくれ」という設定を、正しい窓口に届けるイメージだ。
なぜ100なのか
100に厳密な理論的根拠はない。自分の環境では、429からの復帰に20回未満のリトライで済むことが多い。ただ、上限ギリギリだと「20回で戻ることもあるのに、たまに21回かかって停止」という事態が起きる。それを避けるため、余裕を持って100にしている。理論上の最適値ではなく、実運用で困りにくかった安全側の設定値と考えてほしい。環境によっては50や200でも良いかもしれない。
この設定について:
CLAUDE_CODE_MAX_RETRIESはClaude Codeで設定可能な環境変数で、settings.jsonのenvに書くことで反映される。自分の環境では、この値を増やすことで作業中の停止が起きにくくなった。
JSONの書き間違いに注意
初心者が一番つまずきやすいのがここ。
- カンマ忘れ:
"ANTHROPIC_AUTH_TOKEN": "YOUR_ZAI_API_KEY"の末尾にカンマが必要 - 余分なカンマ: 最後の項目の後ろにカンマは不要
- 括弧の対応:
{と}の数が合っているか
ダメな例（末尾カンマ忘れ）:
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_ZAI_API_KEY"
"CLAUDE_CODE_MAX_RETRIES": "100"
}
正しい例:
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_ZAI_API_KEY",
"CLAUDE_CODE_MAX_RETRIES": "100"
}
編集したら保存して閉じる。メモ帳でもVS Codeでも構わない。
設定が効いているか確認する
設定が終わったら、Claude Codeを一度完全に終了して再起動する。ターミナルを閉じて、新しいウィンドウを開けばよい。
起動したら、軽いテストプロンプトを投げてみる。
claude
> hello worldと表示するPythonスクリプトを書いて
429エラーが出ずに応答が返ってくれば設定は反映されている。
429が出た場合でも慌てる必要はない。リトライ上限を100に上げたので、一時的な制限超えならClaude Codeが自動でリトライして復帰しやすくなる。以前より作業停止に至りにくくなるはずだ。
成功の目安: 429エラーが出ても、数秒〜数十秒待てば自動で再開するようになればOK。
ダメな時の追加対策
MAX_RETRIESを100にしても429が頻発する場合、別の要因が重なっている可能性がある。上から順に試してほしい。
APIキーの確認
環境変数に正しいAPIキーが設定されているか。コマンドプロンプトで以下を実行：
echo %ANTHROPIC_AUTH_TOKEN%
何も表示されない、あるいは想定しているZ AIのAPIキーと違う値が表示されるなら、APIキー設定を見直す必要がある。Z AIのダッシュボードで正しいキーを確認し、設定し直そう。
Z AIのプラン制限を確認
Z AIのダッシュボード（利用状況ページ）で現在のプランと使用量を見る。無料プランと有料プランでレートリミット（単位時間あたりのリクエスト数）が異なる。無料枠の上限に達しているなら、制限がリセットされるまで待つか、プランを見直す。
リクエストを小分けにする
長い指示を一度に送らず、短い指示に分けて送ると制限に達しにくい。例えば「このファイル全体を書き直して」ではなく「まず関数Aを修正して」「次に関数Bを修正して」と分ける。1回のリクエストを軽くするほど、制限に引っかかりにくい。
それでもダメなら
上記を全部試しても改善しない場合、Z AI側に問題がある可能性がある。Z AIのサポート窓口かコミュニティフォーラムで、429エラー（code:1302）の多発を報告する。
解決したかどうかの判断基準と再発防止
「止まらなくなった」ではなく「止まっても自力で再開するようになった」が成功の目安だ。
再発防止のコツ:
– 長い指示は分割して送る（1回のリクエストを軽くする）
– 連続作業中は適度な間隔を空ける
– Z AIのプラン制限に近づいている時はリクエストを控えめにする
もし429以外のエラー（401認証エラー等）が出た場合は、この記事の対象外になる。APIキーやアカウント側の問題の可能性が高いので、別途対応が必要だ。
まとめ
Z AI（GLM-5.1）環境では、プラン範囲内の利用でも429エラー（code:1302）が頻発することがある。現時点で自分が最も効果を感じているのは、settings.jsonのenvオブジェクト内に"CLAUDE_CODE_MAX_RETRIES": "100"を追記して、リトライ上限到達による作業停止を避ける方法だ。100は理論上の最適値ではなく、実運用で困りにくかった安全側の設定値。この設定は429を出なくするものではなく、429が出ても作業停止に直結しにくくするものだ。CLAUDE_CODE_MAX_RETRIESはClaude Codeで設定可能な環境変数で、settings.jsonのenvに書ける。自分の環境では、この値を増やすことでリトライ上限到達による停止が起きにくくなった。設定後は、429が出ても自動で再開するようになれば成功だ。
