「コンテキスト上限に達したのでセッションをリセットしてください」
Claude Codeを使い始めて3週間が経ったある晩、初めてこのメッセージに遭遇しました。
3秒くらい、フリーズしました。「コンテキスト…上限…？」と画面を見つめながら、何を意味するのかさっぱり分からない。焦って「コンテキスト上限 Claude Code」で検索して、ようやく意味が分かりました。
今日は非エンジニア向けに、この「コンテキスト上限」とは何か、そして長時間作業を続けるためのコツを書きます。
「コンテキスト」を、難しく考えなくていい
専門用語をひとまず忘れて、ざっくり言うとこうです。
「Claude Codeが、いまの会話の中で覚えていられる情報量の上限」
人間も、30分話した後で「さっき最初の方に言ってたこと何だっけ」となることがありますよね。それと同じで、Claude Codeにも「この量までは覚えていられる」というラインがあります。そのラインを「コンテキストウィンドウ」と呼びます。
AI業界の用語なので、覚えなくて大丈夫。「記憶の容量みたいなもの」と理解すれば十分です。
普通に使っていたら引っかかることはほぼない
Claude Codeのコンテキスト量は、かなり広いです。本にすると数十ページ分くらいは覚えていられます。
普通に1時間くらい作業しているだけなら、まず上限には達しません。僕も最初の2週間はこの概念を気にしたことすらなかった。
引っかかるのは、こういう場面です。同じセッションで2〜3時間以上ぶっ続けで作業した時。数千行あるような大きなコードファイルを何度も読み込ませた時。それくらいの使い方をした時に、初めて遭遇します。
副業で夜に1〜2時間作業するくらいなら、当面は気にしなくていいレベルです。
上限に達した時の対処法4つ
実際に引っかかった時の対処法を、僕がやっている順番で書きます。
まず一番シンプルなのはセッションをリセットすることです。Claude Codeに「/clear」と打つか、セッションを終了して開き直せばリセットされます。記憶がゼロに戻るので、新しい状態から作業できます。
ただ、リセットすると「今まで話した内容」が全部消えます。長時間作業の途中だと、また最初から説明し直す手間があります。そこで使えるのが次の方法です。
上限が近づいた時に、Claude Codeに「今までの作業内容と、今後やる予定を3行でまとめて」と頼みます。要約が出てきたら、それをメモかテキストファイルにコピーしておく。新しいセッションを始める時に「以下の作業の続きをやります」と添えて貼り付けると、スムーズに引き継げます。
一番効果が大きい「CLAUDE.md」という方法
これは少し手間がかかりますが、効果は一番大きい方法です。
作業しているプロジェクトのフォルダの中に「CLAUDE.md」というファイルを作ります。そこに「このプロジェクトで使っている技術」「重要なルール」「基本的な情報」を書いておく。
Claude Codeはセッション開始時にこのファイルを自動で読み込んでくれます。つまり、セッションが切り替わっても「プロジェクトの基本情報」は毎回最初から把握してくれる、という仕組みです。
僕の場合、あるプロジェクトのフォルダに「使用言語：Python」「主な処理：CSVの集計・出力」「文字コード：UTF-8固定」みたいな情報を書いたCLAUDE.mdを置いています。これがあるだけで、毎回の説明が省けます。
作業を30分〜1時間で区切る
最後の対処法は、そもそも長時間連続で作業しないことです。
本業のある平日は「昼休みに30分」「夜に1時間」という感じで、自然とセッションが分かれます。これが結果的にコンテキスト上限対策になっていました。
副業の時間制約がプラスに働くというのは、最初は気づかなかった発見でした。
「Rate Limit」と混同しないように注意
似た言葉で混乱しやすいのが「Rate Limit」です。
コンテキスト上限は「1セッション内で覚えていられる量の限界」。Rate Limitは「時間あたりの使用回数の上限」。どちらも「使えなくなる」状況ではありますが、原因と対処法が全然違います。
エラーメッセージを見て「コンテキスト上限」か「Rate Limit」かを判別できると、余計に焦らずに対処できます。Rate Limitは「しばらく待てば戻る」、コンテキスト上限は「セッションをリセットすれば即解決」という違いが目安です。
長時間作業の前のチェックリスト
今では、長い作業を始める前にこの4つを確認しています。
CLAUDE.mdに必要な情報がまとめてあるか。30分〜1時間で区切る予定があるか。区切りごとに要約を取る準備があるか。Gitコミットを定期的にしているか（万が一の保険として）。
売場で言うと「長い作業に入る前に、やることの段取りを確認してから始める」感覚と同じです。準備があると、途中でつまずいても慌てない。
この4つを意識するだけで、コンテキスト上限に振り回されることはほぼ無くなりました。
次の記事は、Claude Codeを使い続けて1ヶ月、40代の僕が挫折しなかった理由を書きます。「続けるコツ」という話で、再現性があると思っていることだけを正直にまとめるつもりです。
コメント