Codexで長く作業していると出会う「context length exceeded」「コンテキストの上限に達しました」——会話やファイルの読み込みがCodexの記憶できる量の上限を超えたときのエラーです。
このエラーは故障ではなく、仕組み上必ず起きうるもの。そして上限に達しにくい使い方を知っていれば、頻度を大きく減らせます。この記事では、仕組みのかんたんな理解から、すぐ効く対処法7つまでを解説します。
この記事でわかること
- ✅ コンテキスト上限エラーが起きる仕組み(超入門)
- ✅ いますぐ効く対処法7つ
- ✅ 上限に達しにくい作業スタイル
- ✅ 「上限」と「他のエラー」の見分け方
⚠️ 本記事は OpenAI 公式とは無関係の解説記事です。
仕組みをざっくり:コンテキスト=Codexの「作業机」
Codexは、会話の履歴・読み込んだファイル・指示の内容を「コンテキスト」という作業スペースに載せて考えます。この机の広さには上限があり(単位は「トークン」と呼ばれます)、載せすぎると新しいものが置けなくなる——これが上限エラーの正体です。
机に載るものは主に3つ:
- 会話の履歴(長いやり取りほど溜まる)
- 読み込んだファイル(大きなファイル・大量のファイル)
- 指示文と作業結果
つまり対策は「載せるものを減らす・片づける」に尽きます。トークンなどの用語をもう少し知りたい方は 用語集 をどうぞ。
いますぐ効く対処法7つ
対処①:新しいセッションで仕切り直す(最速)
いちばん手軽な解決策です。今の会話を閉じて新しいセッションを開始すれば、机はまっさらに戻ります。
コツは「引き継ぎメモ」。閉じる前に「ここまでの作業内容と次にやることを短くまとめて」と頼み、その要約を新セッションの最初に貼れば、文脈を保ったまま再スタートできます。
対処②:`.codexignore` で読み込むファイルを絞る(根本対策)
上限エラー常連の最大原因は、node_modules などの巨大フォルダを机に載せてしまうことです。プロジェクト直下に .codexignore を作成:
node_modules/
dist/
build/
.next/
*.log
*.lock
.git/
これは 動作が遅いときの対策 と共通の、最も費用対効果の高い設定です。
対処③:タスクを小さく分割する
「アプリ全体を改修して」のような大きな依頼は、大量のファイル読み込みと長い作業履歴を生み、机をすぐ埋めます。
- ❌ 「全ページのデザインを直して」
- ⭕ 「まずトップページだけ直して」→ 完了 → 新しい気持ちで次へ
分割のコツは プロンプト技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」つながりでレート制限と混同しやすいですが、コンテキスト上限=机の広さ、レート制限=利用回数の枠で別物です。
よくある質問(FAQ)
Q. 上限は増やせないのですか?
A. モデルやプランによってコンテキストの広さは異なります。より広いモデルを選べる場合もあるので、モデル選びガイド を参考にしてください。ただし「広い机」に頼るより、この記事の節約術のほうが安定します。
Q. エラーが出たら会話は全部消えますか?
A. 消えません。それ以上「新しく載せられない」だけです。要約を頼んでから新セッションに移行すれば、実質的な損失はほぼゼロにできます。
Q. どのくらいで上限に達しますか?
A. 読み込むファイルの量と会話の長さ次第です。.codexignore を設定した普通の使い方なら、1日の作業で達することはまれです。頻発するなら②と③を見直してください。
Q. 画像を渡すとコンテキストを消費しますか?
A. はい、画像入力 もコンテキストを使います。大量のスクリーンショットを一度に渡すのは避け、必要なものに絞りましょう。
Q. 上限エラーが出やすくなった気がします
A. プロジェクトの成長でファイルが増えている可能性が高いです。.codexignore の見直しと、対象ファイルの明示(対処④)を試してください。
まとめ
コンテキスト上限エラーは「Codexの作業机が満杯」のサイン。新セッションで仕切り直す(引き継ぎメモつき)が即効薬、.codexignoreとタスク分割が根本対策です。上限に達しにくい作業スタイルを身につければ、エラーはほとんど見なくなります。
あわせて読みたい:プロンプト技10選 / AGENTS.md完全ガイド / トラブル総合ガイド