Claude Code CLAUDE.md clear compact Context low MCPサーバー コンテキスト管理 トークン消費

「Context low(0%remaining)」はコンテキスト上限に達したという意味 — まず /compact を実行する

このメッセージは、Claude Code が会話で保持できる作業記憶(コンテキストウィンドウ)を使い切った状態を示します。表示のとおり、まず /compact を実行してください。直前までのやり取りが要約され、空いた領域で会話を続けられます。多くの場合はこれだけで復帰します。

先に誤解を解いておくと、これはネットワークやAPIキー、モデルの障害ではありません。長い会話や大きなファイルの読み込みでコンテキストが埋まっただけで、設定ミスではないのが普通です。ログを漁る前に、コマンドを一本打ちましょう。

/compact しても改善しない・すぐ再発するときの原因と対処

/compactを打ってもすぐ「0% remaining」に戻るなら、要約後もなお一回のやり取りで大量のトークンを消費しています。典型は、巨大なログやビルド成果物、依存関係一式をまるごと読ませているケースです。/contextを実行すると、システムプロンプト・ツール・会話履歴などが今どれだけコンテキストを消費しているかの内訳を確認できます。何が容量を食っているのかの犯人探しは、ここから始めるのが確実です。

再発が止まらないなら、圧縮より/clearでの作り直しが早いこともあります。

圧縮で消える情報と、消したくない情報を守る /clear との使い分け

/compactは履歴を要約するので、細かな指示や試行錯誤の経緯は削られ、要点だけが残ります。対して/clearは会話を完全に破棄します。判断の分かれ目はこうです。

  • 作業の文脈を引き継ぎたい:/compact
  • 別タスクに移る・履歴が汚れて混乱している:/clear

なお/compactには引数で「何を残すか」を指示できます。たとえば/compact 認証バグ修正の経緯とテスト結果を残してのように打てば、要約時にその部分が優先的に保持されます。消えて困る情報があるなら、黙って圧縮するのではなく指示を添えるのが安全です。

要約で消えると困る前提(コーディング規約や対象ファイルの一覧など)は、会話ではなくCLAUDE.mdのようなプロジェクト直下の指示ファイルに書いておきます。ここに置けば圧縮やクリアの影響を受けず、毎回読み込まれます。実運用ではこの一手が効きます。

加えて、計画や進捗のように更新され続ける情報は、会話に溜め込まず進捗用のmdファイルに定期的に書き出しておくと安全です。要約や/clearで今どこまで進んだかが飛んでも、そのファイルを読み直せば途中から作業を再開できます。

そもそも上限に張り付かせないための会話設計

根本対策は、一度に読ませる量を絞ることです。ディレクトリ全体ではなく対象ファイルだけを指定する、長いログは必要な行だけ渡す——この程度の配慮で消費は大きく変わります。外部ツール連携で必要な情報を都度取りに行く構成にすれば、会話本体は軽く保てます。設定手順はClaude CodeでMCPサーバーを設定する手順が参考になります。

設定で緩和する手もあります。Claude Codeには、コンテキストが上限に近づくと自動で履歴を要約するオートコンパクト機能があり、既定で有効です。settings.jsonのautoCompactEnabledで切り替えられるほか、/configからも同じ項目を確認・変更できます。自動で要約されるタイミングを自分で制御したい場合はfalseにして手動/compact運用に切り替える、という使い方もできます。

タスクの区切りごとに/clearで仕切り直す習慣をつければ、そもそも「0% remaining」に達しにくくなります。長い一本の会話より、短く切ったほうが結果的に速いです。

上限そのものを広げる — 1Mコンテキストモデルという選択肢

運用を工夫してもなお頻繁に上限へ張り付くなら、コンテキストウィンドウ自体が大きいモデルへの切り替えが根本的な緩和になります。Claude Codeでは/modelコマンドやsettings.jsonのモデル設定でopus[1m]のように[1m]サフィックスを付けると、対応モデル(Opus 4.6以降)を100万トークンのコンテキストウィンドウで利用できます。Sonnet 5は最初から100万トークンなのでサフィックスの指定は不要です。

大きなコードベースの横断調査や長時間の作業セッションでは、この切り替えだけでContext lowの発生頻度が大きく下がります。利用できるモデルは契約プランによって異なるため、/modelで選択肢を確認してください。