Claude CodeのCLAUDE.mdを肥大化させない運用方法|200行目安と再発防止の書き方手順

Claude CodeのCLAUDE.mdを肥大化させない運用方法|200行目安と再発防止の書き方手順の要点を表すアイキャッチ
目次

この記事で分かること

この記事で分かることの図解
この記事で分かることの要点を図解しています。

Claude CodeのCLAUDE.mdが長くなりすぎて管理に困っている方向けに、行数の目安、書くべき内容と書かない内容の判断基準、再発防止の追記手順、肥大化したときの整理手順をまとめました。読み終えた時点で、今日から自分のCLAUDE.mdを整理できる状態を目指します。

CLAUDE.mdが肥大化すると何が起きるか

CLAUDE.mdが肥大化すると何が起きるかの図解
CLAUDE.mdが肥大化すると何が起きるかの要点を図解しています。

CLAUDE.mdは毎回の会話の開始時に自動で読み込まれる指示書です。memoryの公式ドキュメントでは、置き場所はプロジェクト直下の./CLAUDE.mdか./.claude/CLAUDE.md、全プロジェクト共通なら~/.claude/CLAUDE.mdとされ、1ファイル200行未満が目安と明記されています。ただし、200行を超えた瞬間にエラーが出たり読み込みが拒否されたりするという挙動は公式ドキュメントに明記されていません。超過した場合に起きるのは、関係のない指示まで毎回読み込まれて文脈を圧迫し、応答が遅くなったり無関係な制約が混ざったりする非効率であると理解しておくのが安全です。

コストを抑えるの公式ドキュメントでは、トークンは文脈の大きさに比例するため、特定の作業用の指示はCLAUDE.mdからスキルへ移すことが勧められています。スキルは呼ばれたときだけ読み込まれるため、普段は文脈を使いません。

書くべき内容と書かない内容の判断基準

書くべき内容と書かない内容の判断基準の図解
書くべき内容と書かない内容の判断基準の要点を図解しています。

判断に迷ったときは、次の基準で仕分けます。

  • 書く: 不可侵領域の指定(触ってはいけないファイルやフォルダ)、安全確認が必要な操作のルール、出力フォーマットの指定、禁止事項、完了条件
  • 書かない: ファイルツリー(Claude Code自身がコードベースを調べられるため不要)、頻繁に変わる詳細情報、外部スキルの全文

/initコマンドはコードベースを解析してCLAUDE.mdの下書きを作りますが、自動生成された内容にはコードを読めば分かる説明が混ざりがちです。/doctorコマンドは設定の点検を行い、CLAUDE.mdについてはコードから分かる内容を削る提案を出してくれるため、下書き後の整理に使えます。なお/doctorはあくまで設定の点検コマンドで、実行しても新しい会話は始まりません。点検結果を見てから、別途チャットでClaudeに編集を依頼する流れになります。

再現可能な手順:CLAUDE.mdを育てる3ステップ

再現可能な手順:CLAUDE.mdを育てる3ステップの図解
再現可能な手順:CLAUDE.mdを育てる3ステップの要点を図解しています。
  1. /initを実行してコードベースの下書きを作る
  2. 下書きからファイルツリーや冗長な説明を削り、ルールだけに絞り込む
  3. 同じ指摘が2回起きたら、そのルールをCLAUDE.mdに追記する

追記のタイミングは「2回目」が基準です。1回だけの失敗は作業中の指示で修正し、2回目が起きて初めて恒久ルールとして昇格させます。これにより、本当に繰り返すミスだけがファイルに残り、肥大化を防げます。

具体的な追記例は次のような書き方です。

## 禁止事項
- src/legacy/ 配下は読み取り専用。変更提案のみ行う
- テストを通さずにコミットしない

## 出力フォーマット
- 選択肢を提示するときは必ず3つまでにし、それぞれの長所と短所を1行で書く

Claude Codeへ渡す指示としては、次のように具体化して伝えると再現性が上がります。

CLAUDE.mdのルールに「選択肢は3つまで、長所短所を1行で」と追記してください。理由は、前回の提案が5つあって選びにくかったためです。

読み込み状況の確認方法

禁止事項の図解
禁止事項の要点を図解しています。

CLAUDE.mdが実際に読み込まれているかは/contextコマンドで確認できます。文脈の使用量が色付きのグリッドで表示され、CLAUDE.mdが読み込まれているかもここで分かります。意図した内容が反映されていないと感じたら、まず/contextを開いて確認する手順が確実です。

編集自体は/memoryコマンドで行えます。CLAUDE.mdを直接開いて編集するほか、自動メモリのオンオフもここで切り替えられます。自動メモリをオフにすると、作業中にClaudeが気づいた内容を自動でCLAUDE.mdへ書き足す動きが止まり、追記は自分の判断とタイミングだけに揃えられます。肥大化を自分でコントロールしたい場合は、オフにしたうえで本記事の「2回目で昇格」の基準を手動で適用する運用が向いています。

巻き戻しとの違いに注意する

CLAUDE.mdを編集した結果が気に入らない場合、巻き戻し機能で戻せると思いがちですが、注意が必要です。Checkpointingの公式ドキュメントでは、入力欄が空の状態でEscキーを2回押すか/rewindを実行すると巻き戻しメニューが開き、「コードと会話」「会話のみ」「コードのみ」を選んで戻せるとされています。ただし、Bashコマンドで変更したファイルは巻き戻せないという制限が明記されています。CLAUDE.mdの編集をClaudeのEdit操作で行った場合は巻き戻しの対象になりますが、sedやmvなどBash経由でファイルを書き換えさせた場合は戻せないため、重要な編集前には編集方法を確認しておくと安全です。

失敗例と対策

失敗例 原因 対策
ルールを読んでくれない ファイルの配置場所が間違っている ./CLAUDE.mdか~/.claude/CLAUDE.mdの配置を見直し、/contextで読み込みを確認する
指示が長すぎて反応が遅い 1ファイルに全作業のルールを詰め込んでいる 作業固有の手順はスキルへ移し、CLAUDE.mdには共通ルールだけ残す
同じ修正を何度も指示している 曖昧な「いい感じに」で指示している 出力形式・禁止事項・完了条件を具体的な文で追記する
ファイルツリーを書いて更新を忘れる コードが変わるたびに手で直す必要がある ファイルツリーはそもそも書かず、Claude Code自身に調べさせる
Bash経由の編集を巻き戻せると思い込む Bashで変更したファイルは巻き戻し対象外という制限を知らない 重要な編集はClaudeのEdit操作で行い、Bashで直接書き換えさせない

初心者向けの最小構成

まず最初に置くCLAUDE.mdは、次の3項目だけで十分です。

# プロジェクトルール

## 不可侵領域
- node_modules/ と dist/ は変更しない

## 完了条件
- 変更後は必ずテストを実行し、結果を報告する

## 出力フォーマット
- 日本語で回答する

この最小構成から始め、同じ指摘が2回起きるたびに1項目ずつ増やしていく進め方が、肥大化を避けながらルールを育てる最も確実な方法です。

中上級者向けの応用:スキルとの役割分担

複数のプロジェクトやツールを横断して使う共通ルールは~/.claude/CLAUDE.mdに、プロジェクト固有のルールは./CLAUDE.mdに分けると管理しやすくなります。さらに、頻繁に使う定型作業の手順はスキルに切り出す設計が有効です。

スキルはSKILL.mdに手順を書いたもので、置き場所は~/.claude/skills/<名前>/SKILL.mdかプロジェクトの.claude/skills/<名前>/SKILL.mdです。関係する場面でClaude Codeが自動で使うか、/スキル名で直接呼び出せます。SKILL.mdの記述例は次の形です。

---
name: weekly-report
description: 週次レポートを指定フォーマットでまとめる手順
---

## 手順
1. 指定フォルダ内の今週分のメモを読み込む
2. 決定事項・課題・次のアクションの3項目に分類する
3. Markdown形式で出力し、ファイル名は日付入りにする

この形にしておけば、CLAUDE.mdには「週次レポートはweekly-reportスキルを使う」という一文だけ残し、詳細な手順はスキル側に任せられます。

下書き作成から再発時の追記までの流れは、次の順序で固定しておくと迷いません。

この図は、CLAUDE.mdを育てる作業の時系列の順序を軸に、下書き作成から追記までの流れを示します。具体的には「①/initでコードベースを解析し下書きを作る」→「②ファイルツリーや冗長説明を削ってルールだけに絞る」→「③/doctorでコードから分かる内容が残っていないか点検する」→「④同じ指摘が2回起きたら該当ルールだけをCLAUDE.mdへ追記する」という一直線の流れです。図の矢印の順番通りに手を動かせば、途中で迷わず運用を始められます。次に自分のプロジェクトで/initを実行するところから着手してください。

実践で分かったこと

運営者自身はClaude CodeをObsidianのVaultを作業対象にして運用しており、CLAUDE.mdはVaultの一番上に置く指示書として、毎回の作業で自動で読まれる前提で運用ルールを書いています。ここでは、その中から記事テーマに直結する2つの運用を具体的に書きます。

1つ目は、スキルの命名規則です。2026年9月時点で自作スキルは61本まで増えており、コンテンツ販売系と台本系で名前の付け方を分け、どの系統のスキルか名前だけで判別できるようにしています。これは、CLAUDE.mdに全スキルの説明を書き込むと行数がすぐ200行を超えてしまうため、CLAUDE.mdには命名規則だけを書き、個々の手順はスキル側に完全に任せる設計にしているためです。この運用により、CLAUDE.md自体が肥大化してどのルールが重要か分からなくなる事態を防げています。

2つ目は、再発した指摘だけをルール化する運用です。同じ修正を繰り返さないため、2回目の再発が起きた指摘だけをCLAUDE.mdや作業ルールへ昇格させ、曖昧な「いい感じに」ではなく出力形式・禁止事項・完了条件を具体化しています。1回限りのミスまで全部書き足すと行数がすぐ膨らむため、「2回目で昇格」という基準を自分の中に固定することで、本当に繰り返すパターンだけが蓄積され、ファイルが際限なく伸びる事態を防げています。

どちらの指摘がCLAUDE.mdへ向かい、どちらがスキルへ向かうのかは、次の切り口で分けて考えると判断しやすくなります。

この図は、同じ指摘が2回発生した場面を軸に、その指摘がCLAUDE.mdに書くべきルールか、スキルに切り出すべき手順かを分岐させる図です。分岐の基準は「全プロジェクト・全作業で毎回当てはまる共通ルールか」「特定の定型作業でだけ使う具体的な手順か」の2択で、前者ならCLAUDE.mdの該当セクションへ、後者ならSKILL.mdの新規作成か既存スキルへの追記へ進みます。自分が今直面している指摘がどちらに当てはまるかをこの基準で仕分けてから、追記先を決めてください。

一般的な手順と運営者の運用の比較

項目 一般的に説明される手順 運営者の運用 運用にしている理由
ルール追記のタイミング 気づいた指摘はすぐ書き足す 同じ指摘が2回起きてから追記する 1回限りのミスまで書くとすぐ200行を超えるため
定型作業の扱い CLAUDE.mdに手順をまとめて書く スキルに切り出し、CLAUDE.mdには呼び出し方だけ書く スキルは呼ばれたときだけ読み込まれ、文脈を圧迫しないため
スキルの命名 内容が分かれば自由に命名 事業系統ごとに命名規則を分ける(61本運用) どの系統のスキルか名前だけで判別でき、誤って別系統の手順を呼ばずに済むため

FAQ

Q. CLAUDE.mdは何行くらいに抑えるべきですか

memoryの公式ドキュメントでは、1ファイル200行未満が目安とされています。超えたからといって即座にエラーになるとは明記されていませんが、関係のない指示まで毎回読み込まれて文脈を圧迫する非効率が生まれます。超えそうな場合は、作業固有の手順をスキルへ移す方法が有効です。

Q. /initで作った下書きをそのまま使っても大丈夫ですか

自動生成された下書きにはファイルツリーなど不要な情報が含まれやすいため、/doctorコマンドで点検し、コードから分かる内容を削る提案を参考に整理してから使う方法を勧めます。/doctorは点検コマンドであり、実行しても会話自体は始まらない点も押さえておくと混乱しません。

Q. CLAUDE.mdが読み込まれているか確認する方法はありますか

/contextコマンドで文脈の使用量がグリッド表示され、CLAUDE.mdが読み込まれているかもそこで確認できます。

Q. 全プロジェクト共通のルールとプロジェクト固有のルールは分けられますか

分けられます。全プロジェクト共通のルールは~/.claude/CLAUDE.mdに、プロジェクト固有のルールは./CLAUDE.mdか./.claude/CLAUDE.mdに書く構成が可能です。

Q. CLAUDE.mdを編集した内容を元に戻せますか

ClaudeがEdit操作で編集した場合は/rewindやEscキー2回での巻き戻しメニューから戻せますが、Bashコマンドで変更したファイルは巻き戻しの対象外という制限があります。重要な編集前は、どちらの方法で変更させるかを意識しておくと安全です。

まとめ

CLAUDE.mdは200行未満を目安に、不可侵領域・安全確認ルール・出力フォーマット・禁止事項・完了条件といった繰り返し使う判断基準だけを残す運用が基本です。定型作業の手順はスキルへ切り出し、再発した指摘だけを2回目のタイミングで昇格させることで、肥大化を防ぎながら長く使える指示書に育てられます。/initでの下書き作成、/doctorでの点検、/contextでの読み込み確認という3つのコマンドを組み合わせ、Bash経由の変更は巻き戻せない制限も踏まえておけば、今日から自分の環境で整理を始められます。

CLAUDE.mdやスキルを使ったClaude Codeの運用をさらに体系立てて学びたい方には、公式LINEで「Claude Code×ひとり起業 10大キット」を無料で受け取れます。今回の整理手順と合わせて、次の自動化のヒントとして活用してください。

公式LINEで「Claude Code×ひとり起業 10大キット」を無料で受け取る

一次情報

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次