Claude CodeのCLAUDE.mdの書き方と実用例

こんにちは。AIあれこれ散歩道、運営者のもっちゃんです。

Claude Codeで毎回同じ注意を伝えているなら、CLAUDE.mdにプロジェクト固有の決まりを短く残す方法があります。たとえば、元ファイルの扱い、確認に使うコマンド、完成版の保存先をまとめると、次の作業でも前提を確認しやすくなります。

ただし、何でも覚えさせる長い日記にする必要はありません。この記事では、すぐ使える小さなサンプルと、読み込みの確認、古くなった指示の直し方を紹介します。例は編集部作成で、既存プロジェクトを変更する前に練習用フォルダで試せる内容です。

Claude CodeのCLAUDE.mdを作る

CLAUDE.mdは、作業の前提を文章で伝えるためのファイルです。最初から細かい設定をそろえるより、「このプロジェクトならではの決まり」を少数選んで書いてみましょう。

毎回必要な前提だけを残す

よい候補は、コードや資料を見ただけでは分からない決まりです。「公開用の資料なので顧客名は出さない」「旧フォルダは参照用として残す」など、作業の方向を変える情報を書きます。

逆に、その日だけの依頼、終わった作業の長い経緯、資料からすぐ読める内容を全部入れる必要はありません。長いほど頼もしく見えるかもしれませんが、今回と関係のない条件が混ざると、更新も確認も難しくなります。

繰り返し訂正していることを、一つずつ短く残す。たとえば毎回保存先を直しているなら、まず保存先だけを決めます。「丁寧に、正確に、最高品質で」と抽象的な言葉を重ねるより、結果を確かめられる決まりにしましょう。

Anthropicの公式資料でも、CLAUDE.mdは短く保ち、プロジェクト固有の確認方法や注意点を残す考え方が説明されています。（出典：Anthropic「Best practices for Claude Code」）

コピペで始める短い例

次の例は、説明資料を作るプロジェクト向けです。保存先の名前は例なので、自分のフォルダと一致させて使ってください。存在しないコマンドを追加して、実行できることにする必要はありません。

# プロジェクトの目的
初めて読む人向けの説明資料を作ります。

## 入力と保存先
- 元資料は sources/。原本は変更しません。
- 作業用は work/、完成版は output/ に保存します。

## 文章の決まり
- 最初に結論と、読者が次にする行動を書きます。
- 元資料にない数字・日付・実績は作りません。
- 不足情報は未確認として分けます。

## 確認
- 完成ファイルを開き、内容と文字化けを確認します。
- 最後に保存先、実施した確認、残る問題を報告します。

開発プロジェクトなら、文章の決まりの代わりに、実在するテストコマンドや変更してはいけない箇所を書けます。その場合も、READMEや設定ファイルと照合してください。インターネットで見つけたnpm testを、どのプロジェクトにもそのまま当てはめないようにします。

まずは人が見ても迷わない指示かを読み直します。「適切な場所へ」「必要に応じて確認」だけで終わる欄があれば、場所や確認する内容を具体化してください。

プロジェクトごとに置く

この仕事だけのルールなら、そのプロジェクトの入口にCLAUDE.mdを置くのが分かりやすい始め方です。別の仕事にも効く個人共通の設定と、特定フォルダのルールは分けて扱います。

sample-docs/
  CLAUDE.md
  sources/
  work/
  output/

同名のファイルがいくつもある場合は、どこが読まれているかを確認してください。画面に見える場所と、実際の作業フォルダが違う場合もあります。似た名前の古いコピーを更新しても、作業中の指示が変わるとは限りません。

Windowsでは、ファイル名がCLAUDE.md.txtになっていないかにも注意します。メモ帳などで保存した場合は、拡張子まで確認してください。文字コードはUTF-8を使い、開き直して日本語が崩れていないか確かめます。

自動メモリとの役割の違い

CLAUDE.mdは、人がプロジェクトの決まりとして書いて確認するファイルです。自動メモリは、Claude Codeが作業から残す情報を扱う別の仕組みです。前の会話を続けることも含め、すべてを一つの「記憶」と考えないほうが整理しやすくなります。

「覚えておいて」と頼んだ内容が、必ずCLAUDE.mdへ入るとは考えないでください。そのファイルに残したいなら、「CLAUDE.mdの追加候補として示して」と場所を指定できます。実際に保存した後は、ファイルを読んで確認します。

自動メモリも、すべての端末へ同じように共有されるとは限りません。利用環境が変わったときは、前の環境の記録が見えているかを確かめます。実際には読めていない資料を、覚えている前提で使わないことが大切です。

読み込みを確かめる

Claude Codeでは、/memoryで指示ファイルやメモリの場所を確認できます。画面で参照先を見て、意図したプロジェクトのCLAUDE.mdが対象か確かめてください。操作画面の構成は、利用する版や環境で変わる場合があります。

/memory

続いて、文章でも認識を確認できます。以下のように、今回は編集せず、参照した場所と決まりだけを示すように頼んでみてください。

この作業に適用する指示ファイルの場所を示してください。
保存先、原本の扱い、完成の確認方法を整理してください。
まだファイルは変更しないでください。
読めなかった指示があれば未確認として分けてください。

公式のメモリ資料には、CLAUDE.mdと自動メモリ、/memoryの役割が説明されています。確認画面に名前があることと、ファイルの内容が正しく、実行結果へ反映されたことは別に確認してください。（出典：Anthropic「How Claude remembers your project」）

Claude CodeのCLAUDE.mdを直す

運用では、追加することだけでなく、古い指示や重複を減らすことも大切です。守られなかった理由を決めつけず、場所・矛盾・実行条件の順に点検しましょう。

依頼文は今回の作業に絞る

基本の決まりを残したら、チャットでは今回作るものを具体的に伝えます。CLAUDE.mdを読めば何を頼まれたかまで分かる、という形にしなくて大丈夫です。材料と完成物を一つずつ指定してみてください。

sources/ の説明メモから、初めて読む人向けの案内を作成。
出力は1ページ分の文章と、確認が必要な項目の一覧です。
保存先と原本の扱いはCLAUDE.mdに従ってください。
今回は画像作成、メール送信、Web公開は含めません。
読み取れない資料があれば、その部分を推測せず知らせてください。

例の「今回は含めない範囲」は、実際に混同が起きそうなものだけ残せば十分です。毎回何十項目も禁止を並べる必要はありません。完成物を受け取ったら、指定した保存先と、本文の根拠を確認します。

計画を見てから変更したい場合は、Claude CodeのPlan Modeで計画を確認する方法も使えます。指示書を作る工程と、その回の実装計画を作る工程を分けると整理しやすくなります。

守られないときの確認順

最初に、作業先と指示ファイルのパスを確認します。次に、同じ内容に異なる決まりがないか見ます。たとえば「完成版はoutput」と「すべてworkへ保存」が混ざっていたら、人が読んでも迷います。

実行できない確認方法が書かれていないかも点検してください。テストの実行に別のサービスが必要だったり、ファイルを見る権限がなかったりすれば、指示を強めるだけでは解決しません。実施できたことと、できなかった理由を分けて受け取ります。

指示と実際の結果に差がありました。
参照したファイル、適用された決まり、矛盾する指示、
実行できなかった条件を確認してください。
原因が分からない場合は推測と明記してください。
同じルールを重複追加する前に、修正案だけ示してください。

「絶対」を増やすより、実行できる指示へ直す。曖昧な保存先、存在しないコマンド、条件がぶつかる指示を直すほうが、何を守るか明確になります。

長い手順は別資料へ分ける

毎回必要な概要と、特定の作業だけで使う詳しい手順を分けます。たとえば公開時だけの長い手順があるなら、普段の誤字修正でも全文を読む形にせず、公開工程で参照する資料へまとめる方法があります。

ただし、別ファイルへ移してリンクを貼れば、必ず読まれるわけではありません。「どの作業のときに参照するか」を入口へ書いてください。原本を複数作って内容が食い違わないよう、一つの資料を更新する形にします。

ほかのAIツールでも同じ情報を使う場合は、対応する指示ファイルや読み込み方式を公式資料で確認します。名前だけを変えれば、優先順位や探索範囲まで同じになるとは限りません。

指示書で権限は制御できない

CLAUDE.mdは意図や規則を伝えるためのファイルです。「変更しない」と書くことと、権限設定で変更操作を制限することは違います。原本、認証情報、本番データを扱うなら、実際の権限と保存方法も確認します。

パスワードやAPIキーを指示書に保存する必要はありません。Gitで共有するプロジェクトなら、CLAUDE.mdも共有される可能性を考えてください。個人情報や秘密を、AIのための説明として書き込まないようにします。

Claude CodeのCLAUDE.mdまとめ

まず、繰り返し伝えている決まりを三つ選んでください。目的、保存先、完成の確認を短いCLAUDE.mdにまとめ、/memoryと参照パスで対象を確認します。その後に小さな依頼を一つ行い、実際の完成ファイルまで見れば、次に直す点も分かります。