Claude Code＋Z AIで429（code:1302）が出るときの確認手順

429は、一定時間内のリクエスト数やトークン量など、接続先が定めるレート制限に達したことを示すことがあります。Z.AIの現行エラー表では、HTTP 429のbusiness error code 1302を「Rate limit reached for requests」と説明しています。HTTPステータスとJSON内のerror.codeは別の値なので、両方を記録してください。Z.AIのErrorsとClaude Code連携ガイドを一次資料にします。Anthropic公式のClaude APIと同じ上限・再試行条件になるとは限らないため、両方の公式資料を照合します。

まず確認する

エラーの番号と、制限を返した接続先を先に確定します。

1. 1記録するHTTP状態、本文のerror.code、時刻、接続先を控える。
2. 2制限を確認そのプロバイダーの利用枠と待機案内を確認。
3. 3負荷を下げる不要な再試行を止め、同時実行や入力を絞る。
4. 4案内に沿って再試行待機後に結果を確認し、続く場合は記録を添えて調査。

HTTP 429と本文の1302は別の値です。/doctorで第三者サービスの利用枠を増やすことはできません。

429の全文、HTTPヘッダー、発生時刻、モデル名、リクエスト頻度、課金プラン、CLIバージョンを控えます。APIキー、プロンプト、個人情報はログや問い合わせへそのまま貼りません。短時間に再試行を繰り返すと制限を延ばすことがあるため、接続先が示すRetry-Afterや待機時間に従います。

/doctor
/help

/doctorはCLI側の設定・接続の診断に使えますが、第三者サービスの利用枠や内部制限を修復するものではありません。ベースURL、認証方式、モデル識別子、環境変数の優先順位を確認し、Anthropicのエンドポイントへ誤って送っていないか切り分けます。WindowsとWSL2では環境変数が分かれる点にも注意します。

実務的な対策

同時実行数とプロンプトサイズを下げ、不要な自動再試行を止め、接続先が案内するバックオフを使います。上限や利用量はZ AI側の管理画面・公式サポートで確認します。モデルを変えるだけで解決するとは限らず、料金・契約・データ利用条件も再確認します。ネットワーク設定、トラブルシューティング、ログイン方法を併読してください。

このページは特定の日付・モデルでの体験談を、すべての第三者プロバイダーの公式解として扱いません。Z.AIの連携ガイドはモデルマッピングや環境変数を更新することがあるため、GLM-5.1など過去のモデル名を固定せず、現行ページの設定例を使います。仕様や上限が更新されたら、発生条件と公式回答を記録してから内容を更新します。