直接回答
model window は表示中の user text だけではありません。system instruction、history、MCP tool、repository file、image、予定出力が同じ budget を使います。
このガイドで解決できること
重要情報を維持しながら context_length_exceeded と token window error を解決する。
症状と影響範囲を確認する
長い session または大規模 repository scan 後、model context window 超過で request が拒否されます。
同じ model の新規 session は成功し、history、tool、generated directory、大きい file を戻すと再発します。
- 設定を変更する前に、ステータスまたは例外、レスポンス本文、request ID、UTC 時刻、クライアント版、最終ホストを保存します。
- 最小リクエストと失敗するワークフローを比較し、全体障害、モデル固有、機能固有のどれかを切り分けます。
- 認証情報、完全なプロンプト、顧客データ、非公開ファイルをスクリーンショットやサポート資料に含めません。
主な原因と責任境界
エラーは一つのレイヤーから得た証拠であり、下流全体の故障を証明するものではありません。まず次の可能性を順に検証します。
- 会話履歴と system・project instruction が蓄積している。
- 大きい file、build output、vendor code、generated artifact が含まれる。
- MCP tool definition と JSON schema が大量の hidden context を使う。
- 入力が予定 output と reasoning 用の空きを残していない。
レイヤー別に最小診断を行う
可変要素が最も少ないリクエストから開始します。アカウント、API ホスト、対象モデルは維持し、任意機能だけを外します。
一度に一項目だけ変更し、元のステータス、ヘッダー、本文、所要時間を残します。これによりクライアントのシリアライズとゲートウェイ・上流の挙動を分離できます。
- 01境界を確定実 provider と client state から現在の model window を確認します。
- 02基準を作成instruction、history、tool、file、output reserve を別々に見積もります。
- 03一項目を比較同じ model で新しい session と最小 task を作ります。
- 04決定的な証拠を記録context source を一種類ずつ戻し、最大要因を特定します。
find . -type f -size +1M -not -path './.git/*' -print | head -50
git status --short
# Claude Code 会话中使用 /context。
# Codex 任务只指定当前问题需要的目录和文件。
確認した根本原因に修正を適用する
証拠で確定したレイヤーだけを最小限変更します。決定的な設定エラーを広範な再試行や検証無効化で隠さないでください。
- 01障害レイヤーを修正generated、vendor、binary、無関係 file を task context から除外します。
- 02必要な動作を復元完了作業を review 済み handoff にまとめ、焦点を絞った session を開始します。
- 03一時回避策を除去必要 tool だけを読み込み、予定 output の空きを明示的に確保します。
目标：<当前唯一目标>
已确认事实：<3-5 条>
涉及文件：<精确路径>
未解决风险：<仍需验证的假设>
下一步命令：<可执行验证>
不要保留：<旧日志、无关工具输出、已否定方案>一度の成功ではなく修正結果を検証する
最小確認が成功したら元の経路を再実行し、通常のストリーミング、同時実行数、タイムアウト条件でも安定することを確認します。
- 入力見積もりと output reserve の合計が実 model limit 未満。
- 要求結果を生成する十分な output space がある。
- task に必要な MCP tool・schema だけが読み込まれる。
- 長期作業が無制限 history ではなく明示成果物で段階化されている。
セキュリティ境界とエスカレーション資料
認証、通信、権限、検証を弱めず、かつ機密情報を公開しない範囲で、再現とエスカレーションに必要な証拠を収集します。
- context 削減で security constraint・approval requirement を落とさない。
- handoff summary を authoritative に使う前に review する。
- token 見積もりのため private file を upload しない。
- model ID、context source、概算 size、最小 task を機密除去して共有する。
公式情報と検証範囲
本ガイドはプロトコル仕様とクライアント公式文書を根拠にしています。エラー文、再試行ヘッダー、設定項目はサービスやバージョンで変わるため、参照元を確認し、ログとリクエスト例を秘匿してから共有してください。
技術検証方法を見る