Claude Code の /compact は、それまでの会話を要約して、会話の文脈(コンテキスト)の空きを作るコマンドです。
使い方は入力欄に /compact と打つだけで、後ろに残したいことを書き添えると、要約に残す内容を指定できます。
文脈が上限に近づくと自動でも要約(圧縮)され、いまの残りは /context で確かめられます。
ただし要約で細部を失う可能性はあるため、重要な条件はファイルにも残し、圧縮後に確認します。
/compact:会話を要約して空きを作り、同じ作業を続ける/compact 残したいこと:要約に残す内容を指定する/context:今どれだけ使っているかを、項目ごとに表示する/clear:会話を空にして新しく始める(前の会話は /resume で戻れる)- 自動圧縮の発動点は /autocompact で変えられる(10万〜100万トークン)
この記事は、Claude Code の公式ドキュメント(日本語版、2026年11月16日に照合)にもとづいています。
手元の確認は、2026年9月29日に Windows 11 の Claude Code 2.1.284 で、練習用のフォルダー(C:\demo\cc-b)を使って行いました。
/compactの使い方
/compact 認証まわりの修正の経緯を残して/compact のあとに書いた指示で、要約で何を残すかを決められます。
何も書かずに実行したときは、自動圧縮と同じく、重要だと推測された内容が要約に残ります。
書き添える指示の例
/compact 認証まわりの修正の経緯と、まだ直していないテストの名前を残して
/compact 決まった仕様と、試してだめだった方法を残す。調べたログは要らない
/compact focus on the API changes最後の行は、公式ドキュメントにある書き方の例です。
上の2行は書き方の例で、当方の環境ではこの指示での要約結果を確かめていません。
残したいもの(決まったこと・未完了の作業・ファイル名)と、要らないものを具体的に書くと、焦点が伝わりやすくなります。
使うタイミング
- 長い新しいタスクを始める前(公式ドキュメントが挙げる使いどころ)
- 調べものや試行錯誤が一区切りして、結論だけを持ち越したいとき
- しばらく席を離れる前(/usage の提案にも「Compact before you step away」という行がある)
話題がまったく変わるときは、/compact より /clear のほうが向いています。
/compact は要約のために会話全体を読み込むので、それ自体が大きなリクエストになります。
続きが要らないなら、公式のコストのページのとおり /clear にはこの費用がかかりません。
毎回の圧縮で残すことをCLAUDE.mdに書く
CLAUDE.md に「Compact Instructions」の節を書いておくと、毎回の圧縮で残すことを指示できます。
公式のコストのページには、プロジェクトのルートの CLAUDE.md に次のように書く例があります。
# Compact instructions
When you are using compact, please focus on test output and code changes日本語にすると「圧縮するときは、テストの出力とコードの変更に絞って残す」という指示です。
当方の環境では、この節を書いた状態での圧縮結果は確かめていません。
圧縮で消えるもの・残るもの
- 依頼と主なコードの断片は要約に残るが、会話の早い段階の細かな指示は失われることがある
- プロジェクトルートのCLAUDE.md・無条件のrulesと自動メモリは、圧縮のあとディスクから読み直される
- paths 付きのrulesと下の階層のCLAUDE.mdは、該当するファイルをまた触ったときに読み直される
- 読んだ・編集したファイルから更新の新しい順に最大5つを再読込み。5,000トークンを超えるファイルは本文でなくパス参照になる
- 使ったスキルの本文は、1つ5,000トークン・合計25,000トークンまで戻され、超えた分は古いものから外れる
いつも守らせたい決まりは、会話ではなく CLAUDE.md に書きます。
CLAUDE.md の書き方は、CLAUDE.mdの書き方と置き場所で紹介しています。
/contextで残りを確かめる
MSYS_NO_PATHCONV=1 claude -p "/context"練習用のフォルダーで実行すると、次のように出ました(MCP のツールの内訳は省いています)。
## Context Usage
**Model:** claude-opus-5
**Tokens:** 29k / 1m (3%)
| Category | Tokens | Percentage |
|----------|--------|------------|
| System prompt | 3.2k | 0.3% |
| System tools | 20.3k | 2.0% |
| MCP tools (deferred) | 5.6k | 0.6% |
| System tools (deferred) | 19.7k | 2.0% |
| Custom agents | 45 | 0.0% |
| Skills | 5.3k | 0.5% |
| Messages | 8 | 0.0% |
| Free space | 938k | 93.8% |
| Autocompact buffer | 33k | 3.3% |会話を始める前から、システムの指示やツールの説明で約29,000トークンを使っていました。
自作のサブエージェント(Custom agents)やスキル(Skills)も、説明の分だけ文脈を使います。
Git Bash では /context がパスに書き換えられるので、MSYS_NO_PATHCONV=1 を付けています(PowerShell なら不要)。
対話中の全画面表示(フルスクリーンモード)では内訳が折りたたまれるので、/context all で広げます。
自動圧縮はいつ起きる?発動点の変え方
発動点を設定していないときは、会話がモデルのコンテキスト上限に達した時点で圧縮されます。
公式ドキュメントが挙げる例外は、次の3つです。
- もともと100万トークンの窓を持つモデル(Fable、Sonnet 5以降、Haiku 5.5、Opus 4.7以降):約967Kトークン
- 拡張コンテキストを使わない Sonnet 4.6・Opus 4.6:200Kトークン
- クラウドセッション:上限に近づいた時点
発動点は、次の方法で変えられます。
| 方法 | 働き |
|---|---|
| /autocompact 500k | 現在のモデル用に保存(2.1.288以降はmodelSettings配下。以前は全モデル共通) |
claude --autocompact 500k | その起動だけ |
| CLAUDE_CODE_AUTO_COMPACT_WINDOW | 有効な値なら最優先。2.1.304以降はk/M接尾辞も可。接尾辞なしはトークン数 |
| CLAUDE_AUTOCOMPACT_PCT_OVERRIDE | 対応するセッションの発動点を1〜100%で早める。既定より遅くはできない |
| DISABLE_AUTO_COMPACT=1 | 自動圧縮と放置時の圧縮を止める(手での /compact は使える) |
| DISABLE_COMPACT=1 | 手での /compact も含めて、すべての圧縮を止める |
/autocompactで指定する窓は10万〜100万トークンの範囲で、モデルのコンテキスト上限にも制限されます。
保存値と実際の発動点は同一とは限りません。
出力例の Autocompact buffer(33k)は、100万トークンから約967Kを引いた分と同じ大きさです。
上位設定や環境変数による上書きも確認します。
放置したときにも圧縮される
最後のリクエストから約1時間たつと、待っている間に会話が圧縮されることがあります(アイドル時の圧縮)。
対象は、対話型のターミナルなどで1時間のプロンプトキャッシュを使い、コンテキストが20万トークン(初期値)に達した会話です。
止めたいときは、/config の Idle compaction(v2.1.302以降)か、設定の idleCompaction を false にします。
/clear・/rewindとの違い
| コマンド | 会話はどうなるか | 向いている場面 |
|---|---|---|
/compact | 要約して続ける | 同じ作業を続けたまま空きを作る |
/clear | 空にして新しく始める(別名 /reset・/new) | 関係のない作業に切り替える |
/rewind | 選んだメッセージから先、または前だけを要約する | 一部だけ要約したい、途中に戻りたい |
/clear のあとも、前の会話は /resume で開き直せます。
/rewind でメッセージを選ぶと、Summarize from here(ここから先を要約)と Summarize up to here(ここより前を要約)を選べます。
戻し方は、Claude Codeで間違えたときに戻すで紹介しています。
文脈を食わないコツ
- CLAUDE.mdは1ファイル200行以下が目安。単にrulesや@参照へ分割しても総量は減らないため、必要に応じてパス条件付きrulesやスキルに分ける
- CLAUDE.mdのブロック単位のHTMLコメントは自動読込み時に除かれる。コードブロック内やReadで直接読む場合は残る
- 使わないプラグインや MCP サーバーは外す
- 大量の調べものはサブエージェントに任せる(読んだファイルが自分の文脈に残らない)
サブエージェントの設定は、Claude Codeのサブエージェントの設定で紹介しています。
1つのファイルや出力が大きすぎて要約してもすぐ満杯になる場合は、数回試したあと自動圧縮が止まり、エラーになります。
上限に当たってエラーになったときは、Context limit のエラーの対処法で紹介しています。
プランの使用量の上限については、Claudeの利用制限で説明しています。
まとめ
- /compact で会話を要約して空きを作る
- 残したいことは /compact のあとに書き添える
- /context(全画面なら /context all)で残りと内訳を見る
- 話を変えるなら /clear、一部だけ要約するなら /rewind
- いつも守らせる決まりは CLAUDE.md に
参考:Claude Code公式ドキュメント(日本語版)の「コマンド」「コンテキストウィンドウを探索する」「モデル設定」「コストを効果的に管理する」(2026年11月16日に照合)と、Claude Code 2.1.284 での実行結果。
よくある質問:Claude Codeの/compact
/compact とは、何をするコマンドですか?
ここまでの会話を要約して、コンテキストの空きを作るコマンドです。
それまでの会話は要約に置き換わり、同じ会話のまま作業を続けられます。
/compact で、残したいことを指定できますか?
/compact 認証まわりの修正の経緯を残して のように、後ろに書き添えて指定します。
毎回同じことを残したいなら、CLAUDE.md に「Compact Instructions」の節を書きます。
自動圧縮はいつ起きますか? 止められますか?
設定していなければ、会話がモデルの上限に達した時点(100万トークンの窓を持つモデルは約967K)で起きます。
DISABLE_AUTO_COMPACT を 1 にすると止まり、手での /compact は引き続き使えます。
/clear と /compact は、どう使い分けますか?
同じ作業を続けるなら /compact、関係のない作業に移るなら /clear です。
/clear のあとも、前の会話は /resume で戻れます。
圧縮すると、CLAUDE.md の指示は消えますか?
プロジェクトルートの CLAUDE.md は、圧縮のあとディスクから読み直されます。
会話の中だけで伝えた指示は消えることがあるので、続けたい決まりは CLAUDE.md に書きます。
