中継経由の Claude Code で 1M コンテキスト：ゲートウェイが 200K までの場合の対処

2.1.285（2026-09-29 リリース）以降、Claude Code は独自の ANTHROPIC_BASE_URL の後ろでも Anthropic API と同じウィンドウを当てはめるからです。Opus 4.7 以降、Sonnet 5 以降、Fable 系は [1m] を選ばなくても 1M です。Opus 4.6 と Sonnet 4.6 は [1m] を付けたときだけ 1M で、付けなければ 200K です。公式のコンテキストウィンドウのページでは Claude Sonnet 4.5 と Claude Haiku 4.5 は 200k とされています。これはクライアント側の見積もりで、ゲートウェイが 1M を通すことの保証ではありません。

上限を超えたリクエストはゲートウェイに拒否されます。Claude Code が認識できる長すぎるエラーは Prompt is too long で、対話セッションでは Context limit reached · /compact or /clear to continue と表示されます。ゲートウェイがエラーを ContextWindowExceededError のような独自の文言に書き換えると、Claude Code はそれを認識できず、自動で圧縮して再試行しません。どちらの場合もまず /compact で復旧し、公式の勧めどおり圧縮のしきい値を 200K に下げてください。

必ずしもそうではありません。2.1.288（2026-10-02 リリース）以降、/autocompact はウィンドウをモデルごとにユーザー設定へ保存するので、モデルを切り替えたら設定し直す必要があります。それ以前は全モデル共通の一つの値でした。全モデルをまとめて押さえるには ~/.claude/settings.json に "autoCompactWindow": 200000 と書くか、環境変数 CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 を設定します。環境変数はコマンド・起動フラグ・設定より優先され、整数のみを受け付けます。

2.1.283 でゲートウェイ向けヒントヘッダーに加わったランダムな UUID です。一つのユーザープロンプトに対応するリクエスト（そのプロンプトが起動したサブエージェントのターンも含む）が同じ値を共有するため、ゲートウェイがまとめて扱えます。Anthropic API への直接接続では既定で送られますが、独自 base URL では既定でオフです。未知のヘッダーを拒否するプロキシだとリクエストが失敗するためで、送るには CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 を設定します。公式は、これらのヒントヘッダーにプロンプト本文やファイルの内容は決して含まれないと明記しています。

529 過負荷のリクエストを再試行するときのバックオフの基準遅延を長めに設定するための変数で、2.1.292（2026-10-06 リリース）で加わりました。既定値は公表されていません。別件として、2.1.286 以降は一回のモデル呼び出し全体で一つの再試行上限を共有し、既定の設定では失敗した呼び出しが送るリクエストは最大 14 件です。無人で動かすジョブには CLAUDE_CODE_RETRY_WATCHDOG があり、429 と 529 の容量エラーを無期限に再試行します。

本ページはそれを約束しません。Claude Code はモデルが Anthropic API で持つウィンドウを前提に見積もりますが、ゲートウェイ側のより低い上限は検出できません。接続は ANTHROPIC_BASE_URL に https://api.qcode.cc/api、ANTHROPIC_AUTH_TOKEN に cr_ キーを設定します。コンテキスト超過のエラーが出たら、まず /compact でセッションを復旧し、公式の推奨どおり /autocompact でしきい値を実際に通る大きさまで下げてください。