テック技報最新号へ →
AIコーディング

Claude Code: コンパクト後も残るもの・消えるもの(大事な指示は SKILL.md の先頭とルート CLAUDE.md に)

コンパクトの後に「さっき言ったルールを忘れた」と感じたら、そのルールがどこに書いてあったかを見る。ルートの CLAUDE.md・paths: のないルール・auto memory・プランはディスクから読み直されるが、paths: 付きルールやサブフォルダの CLAUDE.md、会話の中で伝えた指示は要約に溶ける。

@lydiahallie · 投稿 2026-11-02
#ai-coding#claude-code#compaction#skills#CLAUDE.md

残るもの(ディスクから入れ直される)

  • ルートの CLAUDE.md、paths: のないルール(.claude/rules/)、auto memory、プラン
  • skill の説明文(description)は作り直される(v2.1.304 以降)
  • 最近読んだファイル最大5件は読み直される。ただし 5,000 トークンを超えるファイルは「Referenced file」と名前だけになる
  • 呼び出し済みの skill 本文も入れ直されるが、1つ 5,000 トークン・合計 25,000 トークンまで。古いものから落ち、長い本文は先頭から残して後ろが切れる

消えるもの(要約される)

  • paths: 付きのルールと、サブフォルダの CLAUDE.md(該当ファイルを触ると再び読み込まれる)
  • hook が足した文脈。ただし SessionStart hook は source が compact でもう一度走るので、毎回入れたい情報はそこで出す
  • 会話の中で口頭で伝えた指示

使い方

  1. 絶対に守らせたい規則は、ルート CLAUDE.md か paths: なしのルールに移す
  2. SKILL.md は大事な手順と禁止事項を先頭に書く。長い参考資料は別ファイルにして必要な時に読ませる
  3. コンパクト後にも必ず欲しい情報(現在のブランチ、作業中チケットなど)は SessionStart hook(matcher compact)で出す
  4. 手で圧縮するなら /compact <残したい観点> で焦点を指定する。/rewind で途中から要約する方法や /autocompact 500k のような閾値設定もある

注意点

  • 数値(5件・5,000・25,000 トークン)はドキュメント記載時点のもの。今後のバージョンで変わりうる
  • 「要約される」は「消える」ではないが、細かい条件は要約で落ちやすい

出典

X の元の投稿を開く