CLAUDE.mdが3か月で7万字に太っていたので、ルールだけ残してスキルと履歴ファイルに分けた
私の経験に基づく記録ですので、これを推奨するものでも、動作を保証するものでもありません。あくまでも参考情報としてご覧ください。
現状、サブエージェントを起動するだけで10万トークンかかっていることが分かりました(前回の記事はコチラ)。
原因は、このフォルダのCLAUDE.mdが7万字あることでした。
毎セッション読み込まれるので、放っておくとトークン使用量が上がる一方です。
ダイエットすることにしました。
何が入っていたか
CLAUDE.mdは、Claude Codeがセッションを始めるたびに読む、そのフォルダのルールブックです。
このブログ用のフォルダでは、3か月で約7万字(147KB)になっていました。
中身を種類で分けるとこうでした。
| 種類 | 字数 |
|---|---|
| 再開メモ(セッションの終わりに「現在地」を足し続けたもの) | 約2.9万 |
| 記事ごとの公開記録(ID・URL・直した点) | 約1.7万 |
| テーマの版ごとの変更履歴 | 約0.7万 |
| いつも要るルール(書かないこと・投稿の作法・RESTの癖) | 約0.8万 |
こうしてみると、毎セッション必要なのは最後の1割で、残りは履歴でした。
太った理由は単純で、セッションの終わりに「現在地」を追記するだけで古いものを消しておらず、
記事を公開するたびに公開記録を足していたからです。
頼んだこと
CLAUDE.md が7万字あって重いからダイエットして
案を作りました。残すのは冒頭のコンセプト・NGルール・投稿の作法・現在地の1節。再開メモの経緯と記事ごとの公開記録、テーマの版履歴は ideas/claude-md-history.md に原文のまま移します。元の行がすべてどちらかに入っていることを確認済みで、7.2万字→1.7万字です。
スキルにできるものはスキルにする、という方針も入れてほしい
投稿・公開の手順と REST の癖は blog-publish スキルに、広告枠の操作は blog-ads スキルに出しました。CLAUDE.md は1.2万字です。
Claude Codeがやったこと
- 残した: コンセプト・書かないこと・1記事1セッション・公開は確認後、のようないつも要るルールと、「現在地」の1節
- スキルに出した: 投稿から公開までの手順とRESTでハマった癖(blog-publish)、広告枠の操作(blog-ads)。スキルは呼ばれたときだけ読まれるので、毎セッションの読み込みから外れます
- 履歴ファイルに移した: 再開メモの経緯・記事ごとの公開記録・テーマの版履歴。原文のまま、元の行番号付きで
| 前 | 後 | |
|---|---|---|
| CLAUDE.md | 7.2万字(147KB) | 1.2万字(24KB) |
| スキル(新規2本) | なし | 0.9万字 |
| 履歴ファイル | なし | 6.9万字 |
前回と同じく、新しいセッションでHaikuのサブエージェントに同じ3問を答えさせてみたところ、
子の入力トークンは約10.5万から約5.9万に減りました。
太らせないために決めたこと
CLAUDE.mdの末尾に、自分用に5つ書いておきました。
- スキルにできるものはスキルにする(使う場面が決まっている手順は全部)
- 公開記録はCLAUDE.mdに書かず、公開済み記事のアーカイブ側に書く
- 「現在地」は追記ではなく上書き
- 経緯や調査メモは履歴ファイルへ
- 同じ決定を2か所に書かない
まとめ
消したものは1行もなく、置き場所を変えただけでサブエージェント1回のトークンが4割減りました。
とはいえ、5.9万トークンってまだ多いのでは?と思ったので、もう少し見直していきたいです。
続きで、サブエージェントにCLAUDE.mdを渡さない設定を試した話は コチラ。