Claude Code › 設定・拡張

CLAUDE.mdベストプラクティス|345行を169行に縮めた実録

CLAUDE.md は、短いほど守られます。

私は Claude Code を、記事づくりや情報整理など仕事の運用に使っています。 気づいた決まりを CLAUDE.md に足し続けた結果、一時は345行まで太りました。

書いたはずの決まりを守らないことが増えて、2回縮め、いまは172行です。

公式の説明と私の記録から、基本の書き方、そのまま使えるプロンプト、守られないときの直し方を順に紹介します。 公式の説明は、2026年9月29日に Claude Code のドキュメントで確かめた内容です。

結論:毎回守らせる決まりだけ書く

初心者

CLAUDE.md って、何を書けばいいんですか?

芝田

毎回守ってほしい決まりだけです。手順や経緯は、別のファイルに置きます。

先に結論を言います。

CLAUDE.md は、毎回の会話で必ず守らせたい決まりの一覧にします。 説明書や作業手順書にしないのがコツです。

私がたどり着いた型は、次の6つです。

  • 200行以下に収める
  • 消さずに、別のファイルへ移す
  • 「基本的に」をやめて、言い切る
  • 守られない決まりは、フックなどの仕組みで止める
  • Codex などと共用するなら、AGENTS.md を使う
  • 失敗が出たら直して、定期的に見直す

CLAUDE.md とは・置き場所

初心者

どこに置けばいいんですか?

CLAUDE.md は、Claude Code が会話を始めるたびに最初に読む指示書です。 チャットで伝えた指示は会話が終わると消えますが、CLAUDE.md に書いた決まりは次の会話でも読まれます。

CLAUDE.md の置き場所4種類と、読まれる順番の図

置き場所は4種類

種類 置き場所 使いどころ
組織 会社の管理者が配る場所 会社全体の決まり
自分用 ~/.claude/CLAUDE.md すべてのフォルダで守らせたい自分の好み
プロジェクト フォルダの CLAUDE.md(または .claude/CLAUDE.md) そのフォルダの作業の決まり。チームで共有する
個人のメモ フォルダの CLAUDE.local.md 共有したくない自分だけの設定

はじめは「自分用」と「プロジェクト」の2つで十分です。 私は、自分用に79行、仕事のフォルダ用に172行を置いています。

全部まとめて読まれる

複数の CLAUDE.md があるときは、上書きではなく全部がつなげて読まれます。 広い範囲のもの(自分用)が先、作業しているフォルダに近いものが後です。

そのため、2つのファイルに食い違う決まりがあると、Claude がどちらに従うかは分かりません。 同じことを2か所に書かないようにします。

基本の書き方(5項目)

形式の決まりはありません。 私は、次の5つの見出しで書いています。

目的

このフォルダで何を作るのか、誰に向けたものかを2〜3行で書きます。

例:「このフォルダは、会社のブログ記事を作る作業場。読み手は地元の中小企業の経営者」

作業の決まり

毎回守ってほしい書き方・進め方です。 検証できるくらい具体的に書くのが公式のおすすめです。

例:「きれいに書く」ではなく「返答と作るファイルは必ず日本語で書く」

保存先・ファイル名

作ったものをどこに、どんな名前で置くかです。 これが無いと、同じ種類のファイルが毎回違う場所に増えていきます。

例:「記事の下書きは drafts/ に置く。ファイル名は日付と題名にする」

やってはいけないこと

消してはいけないもの、勝手に送ってはいけないものです。 私の CLAUDE.md で、いちばん大事にしている項目です。

例:「元データは書き換えない」「メールの送信や公開はしない(下書きまで)」

終わりの確認

作業の最後に何を報告させるかです。

例:「変えたファイルの一覧と、確かめたことを報告する。確かめていないことは未確認と書く」

5項目をまとめた雛形です。 〇〇の部分を、自分の作業に合わせて書き換えてください。

# 目的
- このフォルダは、〇〇(例:会社のブログ記事と営業資料)を作る作業場
- 読み手は〇〇(例:地元の中小企業の経営者)

# 作業の決まり
- 返答と作るファイルは、必ず日本語で書く
- 大きな作業は、始める前にやることを3行で確認する
- 数字・料金・日付には、確かめた資料の名前と日付を添える

# 保存先・ファイル名
- 記事の下書きは drafts/ に置く。ファイル名は「日付_題名.md」
- 画像は images/ に置く

# やってはいけないこと
- 元データ(raw/ の中)は書き換えない・消さない
- メールの送信・SNS への投稿・公開はしない(下書きまで)
- パスワードや API キーをファイルに書かない

# 終わりの確認
- 作業が終わったら、変えたファイルの一覧と、確かめたことを報告する
- 確かめていないことは「未確認」と書く

ファイルやフォルダを読めば分かること(フォルダの中身の説明など)は書きません。 Claude は読めば分かるので、行数だけが増えます。

Claude に書かせるプロンプト

初心者

自分で書くのは大変そうです…

芝田

下書きは Claude に書かせて、人は直すだけで大丈夫です。

私が CLAUDE.md を作り直したときのやり方をもとに、コピーして使える頼み方にしました。

新しく作る

まず Claude Code で /init を実行します。 公式の機能で、フォルダを読んで CLAUDE.md の出発点を作ってくれます。

そのあと、次のプロンプトで自分の作業に合わせて作り直させます。

このフォルダで私がしている作業を読み取って、CLAUDE.md の下書きを作ってください。

条件
- 見出しは「目的」「作業の決まり」「保存先・ファイル名」「やってはいけないこと」「終わりの確認」の5つにする
- 全体で200行以内。ファイルを読めば分かることは書かない
- 決まりは「必ず〜する」「〜しない」の言い切りで書く。「なるべく」「基本的に」は使わない
- 書く前に、あなたが判断できないこと(保存先・禁止したい操作など)を質問してください
- 保存する前に、全文を見せて私の確認を待ってください

長くなったのを縮める

200行を超えてきたら、次のプロンプトで縮めます。 私が縮めたときにうまくいったやり方と、気をつける点を入れてあります。

CLAUDE.md を200行以内に縮めてください。

条件
- 決まりは1つも消さない。手順・経緯・一覧などの詳しい説明は、docs/rules/ の下の別ファイルへそのまま移す
- CLAUDE.md には決まりの要点1行と、「〇〇の作業の前に docs/rules/〇〇.md を読む」という参照だけを残す
- 「必ず」「しない」「禁止」を含む文は、言い換えも短縮もしない
- 縮める前と後で「必ず」「しない」「禁止」の数を数えて、表で見せる
- ファイルを書き換える前に、変更の案を見せて私の確認を待つ

失敗を決まりに足す

同じ失敗が2回起きたら、決まりにするタイミングです。

今起きた失敗を、次から起こさないための決まりにしたいです。

- CLAUDE.md に足す決まりを、1〜2行の言い切りで3案出してください
- 今の CLAUDE.md に、似た決まりや食い違う決まりがないか探してください。あれば、足すのではなく、その決まりを直す案にしてください
- 特定の作業のときだけ要る決まりなら、CLAUDE.md ではなく別のファイルかスキルに書く案にしてください

ベストプラクティス3つ

CLAUDE.md に残すものと、別ファイルへ移すものの仕分けの図

200行以下に収める

公式の目安は、1つの CLAUDE.md につき200行以下です。 長いほど読み込む量が増え、決まりが守られにくくなると説明されています。

公式のベストプラクティスには、各行について「これを削除すると Claude が間違いを犯すか」と問い、間違えないなら削る、という考え方も書かれています。 私の CLAUDE.md は344行まで太り、2回縮めて169行にしました(経緯は最後の節で書きます)。

消さずに別ファイルへ移す

縮めるときは、決まりを消すのではなく、詳しい説明を別のファイルへ移します。 いまの私の CLAUDE.md の冒頭にも、「詳細は正本へ切り出し、ここには骨子だけを置く。」と書いてあります。

移す先は、必要なときに読ませるファイルやスキルです。 CLAUDE.md には「〇〇の作業の前に、このファイルを読む」とだけ残します。

フォルダごとの決まりを別のファイルに分ける rules の使い方は、こちらの記事にまとめています。

手順をスキルに移すときの作り方は、こちらの記事にまとめています。

✓ 手順をスキルに移すときの作り方を見るClaudeスキルの作り方と使い方|コピペで使える雛形つき

1つ注意があります。

CLAUDE.md の中で @ファイル名 と書いて取り込んだファイルは、会話の始めに全部読み込まれます。 整理には役立ちますが、読み込む量は減りません(公式のメモリーのページに書かれています)。

「基本的に」をやめて言い切る

「基本的に」「なるべく」「できれば」は、例外を許す書き方です。 Claude はその例外を使うことがあります。

私は全プロジェクト共通の設定に「基本的に日本語で返答」と書いていました。

英語で返答されたときに原因を調べた記録には、「また「基本的に」という書き方には例外の余地がありました。」と残っています。

いまは「必ず日本語で返答する」に直しています。

守られないときの直し方

初心者

書いたのに、守ってくれません。

芝田

まず読み込まれているかを確かめて、それでもだめなら仕組みで止めます。

CLAUDE.md が守られないときに確かめる順番の図

読み込まれているか確かめる

最初に、その CLAUDE.md がそもそも読まれているかを確かめます。 会話の中で /context を実行すると、Memory files の欄に読み込まれたファイルが並びます。

/memory でも、どの CLAUDE.md があるかを確かめて開けます。

置き場所を間違えていると、どれだけ書いても読まれません。

必ず守らせたいことはフックで止める

公式の説明でも、CLAUDE.md は「強制的な設定ではありません」と書かれています。 毎回必ず守らせたいことは、フック(決まった場面で自動で動く仕組み)で止めます。

私の仕事のフォルダには、元データを入れる raw/ というフォルダがあります。 ここを書き換えない決まりは、CLAUDE.md に書くだけでなく、書き込みを止めるフックでも守らせています。

当時の記録には、「「raw/ は不変」という絶対原則を、AIの自制心ではなく仕組みで守る。」とあります。

ただし、フックも作っただけでは安心できません。 私のフックは、作った3日後に、実際の作業では一度も書き込みを止めていなかったと分かりました。

いまは、実際に止まるところを1回見てから「効いている」と判断しています。

フックの最初の1本の作り方と確かめ方は、別の記事にまとめています。

Codex と共用するなら AGENTS.md

Codex など、ほかの AI も同じフォルダで使うなら、AGENTS.md という共通の指示書があります。 Claude Code は、CLAUDE.md が無いフォルダでは AGENTS.md を読みます。

両方を使いたいときは、CLAUDE.md の先頭に @AGENTS.md と書いて取り込みます。

私は逆向きでつまずきました。

Codex は AGENTS.md を読むので、CLAUDE.md しか無い8フォルダでは何も読まれていなかったのです。 いまは共通の決まりを別のファイルにまとめ、CLAUDE.md と AGENTS.md の両方から参照しています。

Codex と Claude Code を両方使うときの分け方は、こちらの記事で紹介しています。

✓ Codex と両方使うときの分け方を見るCodex・Claude Code比較|4か月併用した使い分け

失敗が出たら直して見直す

公式は、CLAUDE.md に足すタイミングとして「Claude が同じ間違いを2回目に犯した場合」を挙げています。

私は、失敗が起きるたびに失敗の記録ファイルに書き、会話の始めに直近の記録を読ませています。 この仕組みを足したのは、「「書く」決まりはあっても「読む」決まりが無く、同じ日の失敗が次の作業で読まれていなかったためです。」

さらに、1週間の失敗と作業の記録から CLAUDE.md に足す候補を、毎週日曜に Claude に提案させる仕組みも置いています。 反映するのは、私が読んで承認したものだけです。

345行を169行に縮めた実録

3か月で138行から344行に

CLAUDE.md の行数の推移のグラフ。6月の138行から8月に344行まで増え、2回の圧縮で169行になった

6月16日に138行だった CLAUDE.md は、8月26日には344行になっていました。 git の履歴で数えると344行、当時の記録の数え方では345行です。

1回目は8月27日に、345行を250行にしました。 長い注意書きの詳しい説明を別のファイルへ移し、CLAUDE.md には要点と参照先だけを残しました。

理由は「司令塔は毎回の会話に丸ごと読み込まれるため、太るほど毎回のコストが増える。」です。

2回目は9月20日です。

記録には「司令塔の CLAUDE.md を 252行(約25KB)から 169行(約15KB)に縮めました。」とあります。 このときは、公式の200行という目安を先に確かめてから縮めました。

禁止の文は縮めない

2回目の圧縮では、縮めすぎた1行がありました。 「ある種類の成果物を、この仕事のフォルダに置かない」という禁止の決まりを、「その成果物は別の場所にある」という説明文に縮めてしまったのです。

失敗の記録には、「禁止が単なる状況説明に変わり、ルールとしての強さが落ちた。」と書いています。 それ以来、縮めるときは「必ず」「しない」「禁止」を含む文には手を付けず、縮める前と後でその数を数えています。

上の「長くなったのを縮める」プロンプトに、禁止の文を残す条件を入れたのは、このためです。

縮めても直らなかったこと

英語で返答される問題は、169行にした後も起きました。 記録を見返すと、長い英語のエラーや作業ログを読んだ直後に、返答が英語に引きずられていました。

CLAUDE.md の長さだけが原因ではなかったのです。

そこで、先に書いた「失敗の記録を会話の始めに読ませる」仕組みを足しました。 それでも9月28日にも起きていて、ゼロにはなっていません。

CLAUDE.md を直すだけで、すべてが守られるようにはなりません。 それでも、短くして言い切りにしたことで、どの決まりが守られていないかは見つけやすくなったと感じています。

よくある質問

CLAUDE.md は日本語で書いてもいい?

日本語で書いて問題ありません。

私の CLAUDE.md は、コマンド名とファイル名以外はすべて日本語で書いています。 2026年9月29日に確かめた公式のメモリーのページにも、書く言語の決まりはありませんでした。

CLAUDE.md と AGENTS.md の違いは?

CLAUDE.md は Claude Code 用、AGENTS.md は Codex などほかの AI とも共有する指示書です。 Claude Code は、CLAUDE.md が無いときに AGENTS.md を読みます。

両方を使うなら、CLAUDE.md の先頭に @AGENTS.md と書いて取り込みます(Claude Code v2.1.277 以降)。

CLAUDE.md とスキルはどう使い分ける?

毎回守らせる決まりは CLAUDE.md、特定の作業のときだけ要る手順はスキルです。 公式でも、何段階もある手順や一部の作業だけに関わる内容は、スキルなどに移すよう書かれています。

スキルは必要なときだけ読み込まれるので、毎回の会話が重くなりません。

テンプレートをそのまま使ってもいい?

出発点としては使って大丈夫です。

ただ、テンプレートの決まりが自分のフォルダで本当に要るかは、1行ずつ確かめてください。 「この行を消したら Claude が間違えるか」で考え、間違えない行は消します。

まとめ

  • CLAUDE.md は、毎回守らせる決まりだけを書く。公式の目安は200行以下
  • 長くなったら、消さずに別のファイルへ移す。「必ず」「しない」「禁止」の文は縮めない
  • 「基本的に」はやめて言い切る。それでも守られない決まりは、フックで止めるか、失敗の記録を読ませる
  • 一度では完成しない。失敗が出るたびに直し、定期的に見直す

まずは上の雛形を置いて、同じ失敗が2回起きたら決まりを1行足すところから始めてください。

参考資料・出典

2026年9月29日に確認しました。

企業・事業者のかたへ

自社の業務に AI エージェントを取り入れたい企業・事業者のかた向けに、無料の AI 業務診断を行っています。

無料のAI業務診断を申し込む

個人で学びたいかたへ

Claude Code を自分の仕事で使えるようになるまで、1対1で伴走します。

個別伴走の申込ページへ

この記事を書いた人

芝田拓望のイラスト芝田拓望DevAIse 代表

DevAIse(ディバイズ)代表。毎日5〜15時間、Claude Code と Codex を使い、記事づくり・情報の整理・毎朝のまとめを AI の仕組みにしています。コードを書かずに作ってきたやり方を、1対1の個別伴走でもお伝えしています。

著者ページへ

関連記事

URL をコピーしました