Codexで長く作業していると出会う「context length exceeded」「コンテキストの上限に達しました」——会話やファイルの読み込みがCodexの記憶できる量の上限を超えたときのエラーです。
このエラーは故障ではなく、仕組み上必ず起きうるもの。そして上限に達しにくい使い方を知っていれば、頻度を大きく減らせます。この記事では、仕組みのかんたんな理解から、すぐ効く対処法7つまでを解説します。
この記事でわかること
- ✅ コンテキスト上限エラーが起きる仕組み(超入門)
- ✅ いますぐ効く対処法7つ
- ✅ 上限に達しにくい作業スタイル
- ✅ 「上限」と「他のエラー」の見分け方
⚠️ 本記事は OpenAI 公式とは無関係の解説記事です。
仕組みをざっくり:コンテキスト=Codexの「作業机」
Codexは、会話の履歴・読み込んだファイル・指示の内容を「コンテキスト」という作業スペースに載せて考えます。この机の広さには上限があり(単位は「トークン」と呼ばれます)、載せすぎると新しいものが置けなくなる——これが上限エラーの正体です。
机に載るものは主に3つ:
- 会話の履歴(長いやり取りほど溜まる)
- 読み込んだファイル(大きなファイル・大量のファイル)
- 指示文と作業結果
つまり対策は「載せるものを減らす・片づける」に尽きます。トークンなどの用語をもう少し知りたい方は 用語集 をどうぞ。
いますぐ効く対処法7つ
対処①:新しいセッションで仕切り直す(最速)
いちばん手軽な解決策です。今の会話を閉じて新しいセッションを開始すれば、机はまっさらに戻ります。
コツは「引き継ぎメモ」。閉じる前に「ここまでの作業内容と次にやることを短くまとめて」と頼み、その要約を新セッションの最初に貼れば、文脈を保ったまま再スタートできます。
対処②:見てほしいファイルを指定して、読み込む量を絞る(根本対策)
Codexは、頼まれた作業に必要なファイルを自分で探して読みます。「全体的に見て」「どこが悪いか調べて」のような広い頼み方をすると、探す範囲が広がり、時間もトークンもかかります。公式のプロンプトガイドでも、関係するコードを指して頼むことが勧められています。
- 「
src/auth.tsのログイン処理だけ見て」のように、ファイル名やフォルダ名を書いて頼む - CLIでは、
@を打つとファイル名の候補が出て、ファイルを指定して渡せます(公式) - VS Code拡張は開いているファイルを自動で渡すので、関係のないタブは閉じておく(公式)
- AGENTS.md に「
node_modulesやdistは自動生成物なので読まなくてよい」と書いておく(指示なので、絶対に読まないという保証ではありません)
⚠️ 訂正(2026年10月10日):当サイトは以前、「
.codexignoreというファイルで読み込むファイルを除外できる」と案内していました。しかし、2026年10月時点の公式ドキュメントとCodexのソースコードには、この仕組みは見当たりませんでした。誤った案内をお詫びし、公式の案内に沿った方法に改めました。
これは 動作が遅いときの対策 とも共通の対策です。会話が長くなったら、公式のコマンド /compact(会話を要約して空きを作る)も使えます。
対処③:タスクを小さく分割する
「アプリ全体を改修して」のような大きな依頼は、大量のファイル読み込みと長い作業履歴を生み、机をすぐ埋めます。
- ❌ 「全ページのデザインを直して」
- ⭕ 「まずトップページだけ直して」→ 完了 → 新しい気持ちで次へ
分割のコツは プロンプト技10選 で詳しく紹介しています。
対処④:対象ファイルを明示して余計な読み込みを防ぐ
「◯◯を修正して」とだけ頼むと、Codexは関係ありそうなファイルを幅広く読みに行くことがあります。「src/app/page.tsx の◯◯を修正して」のようにファイルを指定すれば、机に載る量を最小限にできます。
対処⑤:AGENTS.mdに前提を書いて毎回の説明を減らす
毎セッションで長々とプロジェクトの説明をしていませんか? プロジェクトの前提・ルールを AGENTS.md に書いておけば、会話で繰り返す必要がなくなり、履歴の消費を節約できます。書き方は AGENTS.md完全ガイド へ。
対処⑥:長時間の自走タスクは要約させながら進める
Goal mode などで長く自走させる場合、途中で「ここまでの経過を要約して続きを進めて」と挟むと、履歴が整理されて上限に達しにくくなります。
対処⑦:重い調査は Cloud・Web版に外出しする
大量のファイルを読む調査系タスクは Codex Cloud に投げる、単発の相談は Web版 で済ませる——と役割を分ければ、メインの作業セッションの机を温存できます。
そもそも上限に達しにくい作業スタイル
- 1セッション1テーマ:機能Aの作業とバグBの調査を同じ会話でやらない
- こまめに完了させる:「作って→確認して→コミット」の小さいサイクルを回す(クラッシュ対策にもなります)
- セッションの寿命を意識する:長い会話は劣化のサイン。キリの良いところで①の引き継ぎメモ→新セッションを習慣に
「上限」ではない似たエラーとの見分け方
| エラー表示 | 正体 | 対処記事 |
|---|---|---|
| context length / 上限 | この記事 | — |
| rate limit / 制限に達した | 利用枠切れ | レート制限の対処 |
| 応答が返ってこない | 処理中・混雑 | 遅い・固まる |
| PCが重くなる | マシン負荷 | 軽量化ガイド |
「limit」つながりでレート制限と混同しやすいですが、コンテキスト上限=机の広さ、レート制限=利用回数の枠で別物です。
上限に達しにくい使い方をさらに詳しく知りたい方は トークンを節約する方法(公式推奨5選) もどうぞ。
よくある質問(FAQ)
Q. 上限は増やせないのですか?
A. モデルやプランによってコンテキストの広さは異なります。より広いモデルを選べる場合もあるので、モデル選びガイド を参考にしてください。ただし「広い机」に頼るより、この記事の節約術のほうが安定します。
Q. エラーが出たら会話は全部消えますか?
A. 消えません。それ以上「新しく載せられない」だけです。要約を頼んでから新セッションに移行すれば、実質的な損失はほぼゼロにできます。
Q. どのくらいで上限に達しますか?
A. 読み込むファイルの量と会話の長さ次第です。見てほしいファイルを絞った使い方なら、上限に達しにくくなります。頻発するなら②と③を見直してください。
Q. 画像を渡すとコンテキストを消費しますか?
A. はい、画像入力 もコンテキストを使います。大量のスクリーンショットを一度に渡すのは避け、必要なものに絞りましょう。
Q. 上限エラーが出やすくなった気がします
A. プロジェクトの成長でファイルが増えている可能性が高いです。調べる範囲の絞り込み(対処②)と、対象ファイルの明示(対処④)を試してください。
まとめ
コンテキスト上限エラーは「Codexの作業机が満杯」のサイン。新セッションで仕切り直す(引き継ぎメモつき)のが即効薬、調べる範囲を絞ることとタスク分割が根本対策です。上限に達しにくい作業スタイルを身につければ、エラーはほとんど見なくなります。
あわせて読みたい:プロンプト技10選 / AGENTS.md完全ガイド / トラブル総合ガイド