Claude Codeのトークン消費を抑える文脈管理|/compactと/clearで作業を止めずに進める手順

Claude Codeのトークン消費を抑える文脈管理|/compactと/clearで作業を止めずに進める手順の要点を表すアイキャッチ
目次

結論

結論の図解
結論の要点を図解しています。

Claude Codeの会話が長くなるほどトークン消費が増えて動作が重くなる、という悩みは「/compact」「/clear」「CLAUDE.mdのスリム化」を場面ごとに使い分けることで解決できます。この記事は、長時間セッションでコンテキストが膨らんで困っている中級者以上の方を対象に、判断基準・再現手順・失敗例と対策までをまとめています。

なぜ文脈が膨らむと問題なのか

なぜ文脈が膨らむと問題なのかの図解
なぜ文脈が膨らむと問題なのかの要点を図解しています。

Claude Codeは毎回会話全体を送って処理するため、会話が長引くほど処理対象が大きくなり、応答が遅くなったりトークン消費が増えたりします。トークンを減らすにある通り、トークンは文脈の大きさに比例するため、関係のない話題を引きずったままだと無駄なコストと遅延が発生します。

また、長いセッションで使用量が増える理由にある通り、キャッシュの有効期間(サブスクは1時間、APIキーは既定で5分)より長く休んだ後の最初のメッセージは文脈全体を処理し直すため、休憩を挟んだ直後に重くなったと感じるのはこの仕組みが原因です。

判断基準:/compact・/clear・/rewindをどう選ぶか

判断基準:/compact・/clear・/rewindをどう選ぶかの図解
判断基準:/compact・/clear・/rewindをどう選ぶかの要点を図解しています。

3つのコマンドは似ているようで役割がまったく異なります。目的を取り違えると、残したい情報が消えたり、逆に不要な文脈を抱え続けたりします。

コマンド 何が起きるか 向いている場面
/compact ここまでの会話を要約して文脈の空きを作ります。残したい焦点を指示として渡せます 同じテーマで作業を続けたいが文脈が重くなってきたとき
/clear 空の文脈で新しい会話を始めます。直前の会話は /resume で戻れます 別のタスクに切り替えるとき
/rewind(またはEsc2回) 「コードと会話」「会話のみ」「コードのみ」を選んで巻き戻せます。Bashコマンドで変更したファイルは巻き戻せません 直前の変更や発言を取り消したいとき

この使い分けの根拠はcommandsとcheckpointingに記載があります。特に/rewindはBashコマンドで変更したファイルを戻せないという制限があるため、「会話は巻き戻せたのにファイルは元のまま」という事故が起きがちです。対策として、ファイル操作を伴う大きな変更の前には一度状態を確認し、戻したい範囲が会話だけなのかファイルも含むのかを意識してからコマンドを選ぶことが重要です。

再現可能な手順

再現可能な手順の図解
再現可能な手順の要点を図解しています。

以下は、長時間セッションでの標準的な進め方です。

  1. 作業の節目で/contextを打ち、色付きグリッドで文脈の使用量とCLAUDE.mdの読み込み状況を確認します。
  2. 同じテーマを続けるなら「/compact ここまでのAPI設計の決定事項だけ残してください」のように、残したい焦点を指示付きで実行します。
  3. 別タスクに移るなら「/clear」を打ちます。直前の会話が必要になれば「/resume」で戻せます。
  4. 誤った変更をしてしまったら、入力欄を空にしてEscを2回押すか「/rewind」を打ち、「コードと会話」「会話のみ」「コードのみ」から選んで戻します。

この図は、1回の長時間セッションの中で「作業開始→/context確認→/compactまたは/clear→必要なら/rewind」という時間の流れを軸に、どの手順を何回打つかの順序を示します。図の矢印の順番通りにコマンドを打てば、文脈を整理しながら作業を止めずに進められるので、次に/contextを実行する習慣を今日から始めてください。

具体例:指示文の書き方

具体例:指示文の書き方の図解
具体例:指示文の書き方の要点を図解しています。

/compactを使うとき、焦点を渡さずに実行すると重要な決定事項まで要約で薄まることがあります。以下のように具体的に指示すると安定します。

/compact 今のタスクで決まった仕様(APIのエンドポイント名、レスポンス形式)とエラー対応の方針だけを残してください。雑談や試行錯誤の過程は省いてください。

CLAUDE.mdのスリム化にも同じ考え方が使えます。memoryによると、CLAUDE.mdは1ファイル200行未満が目安で、同じミスが2回起きたときだけ追記する運用が推奨されています。肥大化してきたら「/doctor」を実行すると、コードから分かる内容を削る提案が出ます。

失敗例と対策

  • 失敗例1: /clearした直後に前の文脈が必要だと気づく
    対策として、/clearの直前に重要な結論だけメモ代わりに一言残しておくか、/resumeで直前の会話に戻れることを覚えておきます。
  • 失敗例2: /rewindでファイルが戻っていないと思い込む
    Bashコマンドで変更したファイルはcheckpointingの仕様上、巻き戻しの対象外です。戻したい変更がBash経由だった場合は、手動でファイルを確認し直す必要があります。
  • 失敗例3: 無関係なMCPサーバーを繋ぎっぱなしにして文脈を圧迫する
    costsにある通り、使っていないMCPサーバーは/mcpで無効にできます。使う予定のない接続は毎回オフにする習慣をつけます。

初心者向け最小構成

最初から全部を使い分けようとせず、次の2つだけ覚えれば十分です。

  • 別の作業に移るときは「/clear」
  • 同じ作業を続けながら重くなったら「/compact」に一言焦点を添えて実行

/rewindは慣れてから使えば十分で、まずは「会話が重くなったらどちらかを打つ」という条件反射を作ることを優先してください。

中上級者向け応用:仕組みとして定着させる

文脈管理は一度覚えて終わりではなく、仕組みに組み込むと再現性が上がります。筆者はClaude Codeを単発の回答ツールではなく、ルール・判断・成果物をローカルのMarkdownへ残し、次回の仕事へ再利用する環境として運用しています。この考え方に基づくと、文脈管理のコマンドも「毎回判断し直す」のではなく、CLAUDE.mdに判断基準そのものを書いておくほうが再現性が高くなります。

例えば、CLAUDE.mdに次のようなルールを書いておくと、Claude自身が状況に応じた提案をしやすくなります。

## 文脈管理のルール
- 別タスクに切り替わったと判断したら/clearを提案する
- 同じタスクで文脈が重いと感じたら、残す焦点を聞いた上で/compactを提案する
- ファイルを伴う変更の前には、Bash経由かEdit経由かを明示する

また、作業の分担という観点では、sub-agentsにある通り、サブエージェントは自分専用の文脈で作業し、要約だけを本体の会話に返すため、検索結果やログで本体の会話を埋めずに済みます。調査やテストのように結果だけ欲しい作業は、最初からサブエージェントに任せることで、そもそも文脈を圧迫させない設計にできます。

この図は、目の前の作業が「別タスクへの切り替え」「同じタスクの継続」「調査やログ処理のような結果だけ欲しい作業」のどれに当てはまるかを軸にして、/clear・/compact・サブエージェント委任のどれを選ぶかの分岐を示します。自分の今の作業がどの枝に当てはまるかを確認し、該当するコマンドをその場で打ってみてください。

実践で分かったこと

筆者はClaude CodeをObsidianのVaultを作業対象にして半年ほど運用しており、文脈管理についても実際の運用ルールをCLAUDE.mdに固定しています。

1つ目は、長い作業では現在地の確認、文脈の整理、必要ならセッションを分けるという順番を徹底していることです。会話の取り消しとファイル変更の復元は別物だと理解した上で、戻せる範囲を確認してから/rewindや/clearを使うようにしています。これにより、巻き戻したつもりがファイルは変わっていなかった、という食い違いを防げています。

2つ目は、定期タスクでの文脈管理です。YouTubeの伸びている動画の定点観測は3日に1回9:00に実行し、外部の動画冒頭リサーチは毎月1日と15日の11:00に実行しています。これらは独立したタスクとして都度新しい文脈で走らせており、前回のリサーチの会話を持ち越さない運用にしています。理由は、定点観測の判定基準(再生数が登録者数の3倍以上・投稿から90日以内・5分超・5,000再生以上)を毎回同じ条件で適用したいためで、前のセッションの文脈が残っていると判断がぶれる可能性があるため、都度/clear相当の新規実行にしています。これにより、判定基準がセッションをまたいで曖昧になることを防げています。

一般的なやり方と運営者の運用の比較

項目 一般的な手順 運営者の運用と理由
定期リサーチの文脈 同じ会話の中で継続して複数回リサーチを行う 3日に1回・毎月1日と15日という独立した定期タスクとして都度新規に実行。判定基準を毎回同じ条件で適用し、前回の文脈による判断のぶれを防ぐため
CLAUDE.mdの追記タイミング 気づいたルールを都度追記する 同じミスが2回起きたときだけ昇格させる運用にし、曖昧な指示ではなく出力形式・禁止事項・完了条件を具体化してから追記。CLAUDE.mdの肥大化と指示の形骸化を防ぐため

FAQ

Q. /compactと/clearのどちらを先に試すべきですか

A. 同じタスクを続けるかどうかで決めます。続けるなら/compact、別タスクに移るなら/clearを使うと判断に迷いません。

Q. /rewindを使えばファイルも必ず元に戻りますか

A. いいえ、戻りません。checkpointingにある通り、Bashコマンドで変更したファイルは巻き戻しの対象外なので、戻したい変更の手段を確認してから使う必要があります。

Q. CLAUDE.mdを整理したいときはどうすればいいですか

A. /doctorを実行すると、コードから分かる内容を削る提案が出ます。あわせて1ファイル200行未満を目安に、同じミスが2回起きたものだけを残す運用がmemoryで推奨されています。

Q. MCPサーバーをつないだままにすると文脈に影響しますか

A. 影響します。使っていないMCPサーバーは/mcpで無効にできるので、使う予定がないときはオフにしておくと文脈を圧迫しません。

まとめ

長時間のClaude Codeセッションで感じる重さや遅延は、/compact・/clear・/rewindの役割の違いを理解し、場面に応じて選ぶことで大きく改善できます。CLAUDE.mdのスリム化とサブエージェントへの作業委任を組み合わせれば、文脈管理は一度きりの対処ではなく、繰り返し使える仕組みとして定着します。

公式LINEで「Claude Code×ひとり起業 10大キット」を無料で受け取る

一次情報

文脈管理の判断基準を自分の作業に落とし込む具体的な型が欲しい方は、公式LINEで「Claude Code×ひとり起業 10大キット」を無料で受け取れます。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次