本文へ移動

Claude Codeのコンテキスト整理。圧縮・リセット・利用枠を分けて考える

· · ENDY

Claude Codeが遅い原因をコンテキストだけに決めつけず、/context・/compact・/clearの役割を整理。作業の引き継ぎ、読み込む範囲、サブエージェントの利用量まで、公式情報から確認します。

この記事でわかること

会話が長くなったとき、何を残して何を整理すればよいのでしょうか。コンテキスト、利用上限、動作の遅さは、いったん別の問題として考えると切り分けやすくなります。

情報

  • /context で、何が会話の容量を使っているか確認する
  • 同じ作業の続きを残すなら /compact、無関係な仕事へ切り替えるなら /clear
  • 圧縮やリセットをしても、契約の利用枠が回復するわけではない

2026年10月13日にClaude Code公式のコスト管理ガイドを確認しました。以下は運用の提案で、処理時間や節約率を測定した結果ではありません。

コンテキストは、その会話で扱う情報の範囲

会話の履歴だけでなく、読み込んだファイルやツールの結果も判断材料になります。必要な資料を広げる作業机を想像すると、整理の意味をつかみやすくなります。

ただし、長い会話が原因で必ず遅くなる、と単純には言えません。通信、サービスの混雑、実行中のコマンドなども分けて確認する必要があります。

確認したいこと最初に見るもの
会話で何が容量を使うか/context
契約や利用量の状況/usage の表示
作業が止まった理由実行状況とエラー

画面の警告文は省略せずに読みます。「コンテキストが多い」と「利用上限に達した」では、必要な対処が異なるためです。

内訳を変えたときの残り容量を、下の仮想例で試せます。実モデルの上限や自動圧縮のタイミングを再現するものではなく、文字数からトークン数を推定する機能でもありません。

動かして、理解する

コンテキストの内訳を動かしてみる

上限16,000トークンを含め、すべて架空の練習用数値です。実際のモデル上限や料金・利用枠を示しません。

入力したtokensの配分(架空の予算例)

予算線:16,000 tokens

図の右端:16,000 tokens。超過時は図を広げ、予算線を内側に表示します。

指示
1,000 tokens
会話履歴
4,000 tokens
ツール・ファイル
3,000 tokens
出力の予約
2,000 tokens
残り
6,000 tokens
予算超過
0 tokens

図と初期値はこのまま読めます。表示範囲に入ると操作を準備します。

計算条件

全体 16,000 tokens に対し、予約を含む配分は 10,000 tokens。残りは 6,000 tokens、予算超過はありません。

計算の前提と、結果の読み方
  • 初期値は操作説明のための架空例です。特定モデルの上限や実際のAPI消費量を示しません。
  • すべてtokens単位の明示入力です。文字数からの換算やモデル仕様の推定は行いません。
  • 出力の予約は未使用でも予算から差し引きます。実際のサービスの制約や計数方法とは異なる場合があります。

同じ作業を続けるなら、残す情報を指定する

/compact は会話を要約して整理するための操作です。細部まで完全に保存される保証とは区別してください。

plaintext
/compact 変更したファイル、テスト結果、未解決の問題、次の作業を残してください

この例は、引き継ぎに必要な項目を示しています。デザイン作業なら採用した方針、調査なら出典と未確認事項など、仕事内容に合わせて変えます。

  • 何を達成する作業か
  • すでに変更した場所はどこか
  • 何を確認し、何が未確認か
  • 次に何をするか

重要な決定は作業メモにも残します。ただし、ファイルがあるだけで次の会話が必ず読むわけではありません。再開時には、そのメモの場所を明示しましょう。

別の仕事へ移るなら、会話を区切る

/clear は新しい文脈で始めるときの選択肢です。前の作業と無関係な依頼を同じ会話へ積み重ねる前に、必要な記録を保存します。

公式には、名前を付ける /rename と、会話を戻す /resume も案内されています。整理と削除を混同せず、あとで追いたい仕事を見つけられる状態にします。

  • 前の仕事の結果を確認
  • 続きが必要なら引き継ぎメモを保存
  • 新しい仕事の目的と対象を明示

切り替え後も、変更済みのファイルは残っています。「会話を新しくした」からといって、作業ディレクトリまで初期状態になるわけではありません。

読む量を減らすより、読む対象を明確にする

必要な資料を省略すると、誤った判断につながります。節約のために情報を隠すのではなく、最初の探索範囲を絞る考え方が役立ちます。

たとえば「このエラーを直して」だけでなく、再現手順、失敗したコマンド、関係するファイルを渡します。全ログが必要なら、保存先を伝えて必要な部分を調べられるようにします。

  1. 再現条件を伝える

    何をしたときに、期待と違う結果になったかを短く整理します。

  2. 関連する情報の場所を伝える

    コード、ログ、仕様のどこを確認すればよいかを示します。

  3. 不足している情報を追加する

    最初の仮説だけに固執せず、必要になった範囲を広げます。

サブエージェントは、全体の消費をゼロにしない

調査やログの処理を分けると、主会話へ大量の出力を持ち込まずに済みます。一方、別のエージェント自身の処理も利用量を消費します。

そのため「任せれば必ず安くなる」「これが一番節約できる」とは言えません。分ける価値がある仕事か、返してほしい結論が明確かで判断します。

任せる前に決めること例
調べる範囲失敗したテストの原因
返してほしい結果原因候補と根拠
触ってよい範囲調査のみか修正も含むか

単純な一箇所の確認なら、自分の会話で済ませた方が手順が少ないこともあります。並列化そのものを目標にせず、作業の見通しをよくするために使います。

毎回読み込むルールも整理する

CLAUDE.mdへ作業履歴を追加し続けると、恒常的なルールと一時的なメモが混ざります。繰り返し必要な内容と、今回だけの記録を分けます。

あわせて読みたい

CLAUDE.mdを小さく保つ書き方と確認方法

  • 警告の種類を確認してから対処する
  • 圧縮では残す情報を指定する
  • 新しい仕事には、目的と対象を改めて伝える
  • 節約率や速度は測定していないため保証しない

更新メモ:「遅さはすべてコンテキストが原因」「私が毎日実践」「これが一番効く」という未検証の説明を除き、操作の確認方法と利用量の区別を追加しました。

関連記事