CLAUDE.md を細分化して軽量化と効率化を

CLAUDE.md に書き込みが増えてきたら、別のファイルに分けます。毎回読む量が減って軽くなり、要るものだけを読む効率のよい形に。
何を分けるのか。分けたファイルを、CLAUDE.md からどう紐づけるのか。私のやり方と、公式の仕組みをまとめました。
Claude Code が分けようと提案してくる
書き込みが増えると、Claude Code のほうから情報を分けることを提案してきます。私は、それを許可するだけ。
書き込ませ方は、こちらの記事で解説しています。
関連記事:フォルダを作ったら、まず CLAUDE.md を書かせる
分けるのは毎回読まなくていいもの
分けた先にあるのはたとえば次のようなファイルです。
- アイデア
- 保留メモ(決まっていないことや、途中のもの)
- 設定のメモ
- 過去の履歴
どれも毎回必ず読まなくてもいいもの。必要になったときだけ読めばいいものが、分けられているようです。
CLAUDE.md はチャットを始めるたびに読まれます。毎回は要らないものまで入れておくと、長くなるばかり。
長くなるほど、書いたことが漏れやすくなります。公式でも、CLAUDE.md は1つあたり200行未満が目安。分けどきを考えるときの、1つの基準になりそうです。
分けた先の場所は Claude Code まかせ
私は、分けた先の場所を指定していません。Claude Code が自分で分けて、自分で保存しています。
ときどき、どこにあるのか分からなくなることも。そんなときは「どこに格納してあるの?」と聞いています。
場所が確認できて、紐づけさえしっかりできていれば問題ない。私はそう考えています。
CLAUDE.md から場所を書いて紐づける
紐づけとは、CLAUDE.md から、分けた先のファイルをたどれるようにしておくことです。
一般的には、分けた先の場所を CLAUDE.md に書いておくとよいでしょう。場所が書いてあれば、必要になったときに Claude Code がそこを読みに行けます。

ただし、場所を書いただけのファイルを読むのは、Claude Code が開くと決めたときだけ。公式のドキュメントでも、そう説明されています。
私にも、自分で決めて場所を書かせている例が1つあります。社長室です。
ほかのフォルダの CLAUDE.md には「詳しくは社長室を見る」とだけ書かせています。自分のことの中身は社長室にだけ書き、ほかからは場所で指すわけです。
社長室の作り方はこちらの記事へ。
関連記事:社長室を作って、AI にあなたのことを知ってもらう
「@」で読み込む方法との違い
公式のドキュメントでは、別のファイルを読み込む方法も紹介されています。CLAUDE.md の中に、「@docs/rules.md」のように「@」とファイルの場所を書く方法です。
ただし「@」で読み込んだファイルは、チャットを始めたときに CLAUDE.md と一緒に読まれます。長いファイルを整理するのには役立ちますが、読む量は減らないのです。
毎回は要らないものなら、「@」を付けずに場所を書いておく形が合います。毎回必ず読ませたいものは、CLAUDE.md に残すか「@」で。
途中のものの分け方は別の記事で
アイデアや保留メモのような途中のものの分け方は、こちらの記事で解説しています。
関連記事:保留メモは溜めない、変わりやすいことは別のファイルに
どのフォルダでチャットを始めるか
案件が増えたら番号と対応表で管理
