メインコンテンツへスキップ
見出し画像

CLAUDE.mdの書き方|コピペで使えるテンプレートと実例・置き場所・ベストプラクティス

    「CLAUDE.md って何を書けばいいの?」「どこに置くの?」「テンプレートや例が欲しい」。この記事は、そんな方に向けた CLAUDE.md の書き方ガイドです。

    CLAUDE.md とは何か、置き場所(プロジェクト直下・ホーム・サブフォルダ)、/init での下書き、書くことと書かないこと、コピペできるテンプレート、実例、AGENTS.md との併用のしかたまでを解説します。

    私は Claude Code と Codex を毎日使い、教材の出品や SNS 運用、画像づくりまでを自動化しています。その土台が CLAUDE.md です。実際の運用から簡略化した例も載せます。全文無料です。機能や場所は、2026年10月に公式ドキュメントで確認したものだけを書いています。

    この記事で分かること

    • CLAUDE.md とは何か、なぜ効くのか

    • CLAUDE.md の置き場所と、読み込まれる順番

    • /init で下書きを作る方法

    • 書くべきこと、書かない方がよいこと

    • 短く保つなど、ベストプラクティス

    • コピペで使えるテンプレートと実例

    • AGENTS.md との併用(CLAUDE.md に @AGENTS.md と書く方法)

    • CLAUDE.md の育て方

    CLAUDE.mdとは

    CLAUDE.md は、Claude Code が毎回の会話の最初に読む指示書です。ふつうの Markdown(文章ファイル)で、名前は CLAUDE.md にします。

    公式の説明では、Claude Code の会話は毎回、新しい状態から始まります。前の会話の内容は引き継がれません。そこで、毎回読ませたいことを CLAUDE.md に書いておきます。ビルドやテストのコマンド、守るルール、フォルダの役割などです。

    新人に渡す引き継ぎメモを想像してください。毎朝同じ説明をしなくても、メモを読んだ新人が最初から動けます。CLAUDE.md はそのメモです。

    大事な注意点が1つあります。公式は、CLAUDE.md を「強制力のある設定ではなく、読ませるコンテキスト」として扱っています。守る確率は、書き方で変わります。どうしても毎回必ず実行させたいことは、CLAUDE.md ではなく「フック」(決まったタイミングで自動実行するしくみ)で行うのが公式の考え方です。

    CLAUDE.mdの置き場所

    主な置き場所

    公式の一覧から、個人で使う場所を挙げます。

    • プロジェクトの指示:./CLAUDE.md または ./.claude/CLAUDE.md。そのプロジェクトで作業する全員に向けたルールです。Git で共有できます

    • ユーザーの指示:~/.claude/CLAUDE.md。自分のすべてのプロジェクトに効く個人の好みです。たとえば「応答は日本語」など

    • ローカルの指示:./CLAUDE.local.md。そのプロジェクトでの個人用の設定です。Git に入れないよう、.gitignore に追加します

    • 組織の指示:IT 管理者が配る全社共通のものです。個人は気にしなくて構いません

    ~ はホームフォルダのことです。Windows では C:\Users\あなたの名前 になります。

    どう読み込まれるか

    • 作業を始めたフォルダと、その上のフォルダにある CLAUDE.md は、起動時にすべて読み込まれます。上書きではなく、順につながります。たとえば foo/bar/ で起動すると、foo/CLAUDE.md のあとに foo/bar/CLAUDE.md が読まれ、いる場所に近い指示が最後に来ます

    • サブフォルダの CLAUDE.md は、起動時ではなく、Claude がそのフォルダのファイルを読んだり編集したりしたときに読み込まれます

    つまり、全体のルールは上のフォルダに、プロジェクト固有のルールはそのプロジェクトのフォルダに置けます。同じ内容が食い違うと、どちらに従うか不確実になるので、食い違いは作らないでください。

    読み込まれたかの確認

    Claude Code の中で /context を打つと、読み込まれた指示書の一覧(Memory files)が見られます。そこに無いファイルは、Claude には見えていません。/memory では、CLAUDE.md を開いて編集できます。

    @ で別のファイルを読み込む

    CLAUDE.md の中に @docs/git-instructions.md のように書くと、そのファイルが一緒に読み込まれます。相対パスは、そのファイルのある場所が基準です。読み込んだファイルがさらに別のファイルを読み込む連鎖は、最大4段までです。

    プロジェクトの概要は @README を、使えるコマンドは @package.json を見る。

    注意が2つあります。読み込んだファイルも起動時に全部読まれるので、長さの節約にはなりません(整理には役立ちます)。また、バッククォートで囲んだ @README は、読み込まれず文字のままです。

    /initで下書きを作る

    最初の1枚は、/init に作らせるのが早いです。Claude Code の中で /init と打つと、フォルダを調べて、見つけたビルドコマンドやテストの手順、規約を入れた CLAUDE.md の下書きを作ります。すでに CLAUDE.md がある場合は、上書きせず改善案を出します。

    下書きは、そのまま使わず、削ってください。フォルダを見れば分かることが並びがちだからです。次の章の基準で、残す行と削る行に分けます。

    下書きを削るときは、そのまま Claude Code に手伝わせられます。

    CLAUDE.md の下書きを読んでください。次の基準で、残す行と削る行に分けて、理由を一言ずつ付けてください。まだファイルは書き換えないでください。
    1. 毎回の作業で要るか
    2. 書かないと推測で間違えるか
    3. 守れたかを確かめられるか
    フォルダを見れば分かる内容は、削る候補にしてください。

    返ってきた分け方を読み、自分で判断してから、書き換えを頼みます。

    CLAUDE.mdに書くこと・書かないこと

    公式のベストプラクティスにある基準を、私の言葉で整理します。判断の問いは1つです。「この行を消したら、Claude Code は間違えるか?」。間違えないなら、その行は要りません。

    書くこと

    • Claude Code が推測できないコマンド(例:python tools/build.py で PDF を作る)

    • 既定と違う決まり(日付の書き方、ファイル名の形式、単位)

    • テストの手順と、「できた」と言う条件

    • 作業のエチケット(ブランチの名前、報告の形)

    • このプロジェクト固有の判断(「同じ機能を二重に作らない」)

    • 触ってはいけないもの、止まる線(元データは変えない、など)

    • 環境のくせ(必要な環境変数の名前。値は書かない)

    書かないこと

    • コードを読めば分かること(ファイルごとの説明、ディレクトリの全一覧)

    • 一般的な作法(「きれいなコードを書く」)

    • 長い解説や API の詳しい資料(必要ならリンクにする)

    • 頻繁に変わる情報

    • パスワード、API キーなどの秘密(絶対に書かない。別の保管場所に置く)

    特定のファイルだけに関わるルールや、複数手順の作業は、CLAUDE.md ではなく、.claude/rules/(ファイルの種類ごとのルール)やスキル(手順書)に分けるのが公式のすすめです。

    画像

    CLAUDE.mdのベストプラクティス

    1. 短くする。公式の目安は、1ファイル200行以下です。長いほど読み取りの負担が増え、守られにくくなります

    2. 具体的に書く。「きれいに整形する」より「インデントは2スペース」。「テストする」より「コミット前に npm test を実行する」。確かめられる書き方にします

    3. 見出しと箇条書きで整理する。密な文章より、守られやすくなります

    4. 矛盾させない。ファイル同士や上下のフォルダで食い違う指示は、どちらかが任意に選ばれます

    5. 強調は絞る。無視される1行だけに「重要」と足します。あちこちに付けると、どれも目立たなくなります

    6. 禁止は代わりの形と一緒に。「〜するな」だけでなく「その代わり〜する」を添えます

    7. 守られないルールは、フックに変える。毎回必ず実行したいことは、フックの方が確実です

    8. 定期的に削る。Claude Code が指示なしで正しくやることは、消します。/doctor prompt-audit で、古い指示や食い違いの点検もできます(Claude Code v2.1.283 以降)

    コピペで使えるテンプレート

    小さなプロジェクト向けの型です。自分の名前、コマンド、数字に書き換えて使います。30行前後に収めるのが目安です。

    # CLAUDE.md - (プロジェクト名)
    
    ## 目的
    (何のフォルダか。1〜2文)
    
    ## フォルダ
    - data/     元データ(変えない)
    - output/   出力。YYYY-MM-DD_名前.md
    - tools/    スクリプト
    
    ## コマンド
    - 作成: python tools/build.py <名前>
    - テスト: python -m pytest
    
    ## 決まり
    - 日付は 2026-10-14 の形で書く
    - 金額は税込の整数(円)。カンマなし
    - 作業のあと、必ずテストを実行して、結果を見てから「できた」と言う
    
    ## 止まる線
    - data/ の中は、変えない・消さない
    - 同名のファイルがあれば、上書きせず止まって聞く
    - パスワードや確認コードの入力はしない。「要確認: 〜」と書いて止まる
    
    ## 報告の形
    1. 作ったファイル
    2. 確認した結果
    3. 聞きたいこと(なければ「なし」)

    使ったら、新しい会話で次のように聞いて、読まれているかを確かめます。

    このフォルダで守る決まりを、5項目の箇条書きでまとめてください。ファイルは変えないでください。

    大事なルールが返ってこなければ、そのルールは埋もれているか、あいまいです。順番を前に出すか、確かめられる言い方に直します。

    実例:複数のプロジェクトを持つ総合フォルダ

    私は、すべての仕事を1つの総合フォルダ(HQ)にまとめています。その中に、教材づくり、SNS 運用、ネットショップ、画像づくりなどのプロジェクトのフォルダがあります。構成はこうです。

    • 総合フォルダの直下に、全体の CLAUDE.md

    • 各プロジェクトのフォルダにも、その仕事用の CLAUDE.md と、Codex 用の AGENTS.md

    • 「各プロジェクトの中に CLAUDE.md があれば、そのフォルダ内の作業ではそちらを優先する」と、全体の側に書く

    全体の CLAUDE.md を簡略化すると、次のようになります。

    # CLAUDE.md - 総合フォルダ
    
    応答は日本語。各プロジェクトの中に CLAUDE.md があれば、
    そのフォルダ内の作業ではそちらが優先。
    
    ## 使い方の前提
    - 私はコマンドを打たない。「〇〇を作って」と言葉で頼む。
      Claude Code が判断して実行し、結果(作った場所・次にやること)を報告する
    - 足りない情報(名前・数)だけを短く聞く。決められるものは決めて進める
    
    ## 構成
    - 10_sns/   発信の運用
    - 20_ec/    ネットショップ
    - 60_sites/ 教材・学習サイト
    - 80_assets/ 2つ以上のプロジェクトで使う素材
    - 99_archive/ 止めたもの
    
    ## 担当表(同じ機能を二重に作らない)
    - 発信の運用は 10_sns、物販は 20_ec、教材は 60_sites
    - 新しい道具を作る前に、既にあるか台帳と各 CLAUDE.md を見る
    - 重複を見つけても勝手に消さない。どちらを残すか聞く
    
    ## 秘密情報
    API キーは設定用の .env だけ。コードや CLAUDE.md には書かない

    特徴は3つです。担当表で、仕事ごとの置き場所を決めて重複を防ぐこと。止まる線(秘密は .env だけ、重複は勝手に消さない)を明記すること。そして、経緯や理由は別の決定ログに任せ、CLAUDE.md には「何を・どこで」だけを書くことです。

    プロジェクト側は、目的、フォルダ、コマンド(道具ごとに1〜2行)、決まり、「毎回の最初に決定ログを読む」の5つ程度です。この型で、毎回の説明がほぼ要らなくなりました。

    AGENTS.mdとの併用

    Codex や他の AI ツールは、AGENTS.md という名前の指示書を使います。両方のツールを使う人は、同じ内容を2か所に書きたくありません。公式のドキュメントでは、次のように説明されています。

    • 新しい版(v2.1.277 以降)の Claude Code は、AGENTS.md をプロジェクトの指示として読めます。ただし既定では、CLAUDE.md が無いときだけです。両方あるときは、CLAUDE.md だけが読まれます

    • そこで、CLAUDE.md の先頭に @AGENTS.md と1行書いて、AGENTS.md を読み込ませる方法が公式に紹介されています。Claude 専用の指示は、その下に足します

    @AGENTS.md
    
    ## Claude Code
    `src/billing/` の変更は、先に計画を立ててから進める。

    こうすれば、共通のルールは AGENTS.md の1か所だけで管理できます。なお、AGENTS.md へのシンボリックリンクでも代用できますが、Windows では管理者権限が要ったり、Git で普通のファイルになったりします。Windows を使う人は、@AGENTS.md の方が確実です。

    読み込まれたかの確認は、/context か /memory で行います。

    CLAUDE.mdの育て方

    最初から完璧を目指さず、育てます。公式が挙げる「足すタイミング」が使えます。

    • Claude Code が同じ間違いを2回したとき

    • 前回と同じ説明を、また書いたとき

    • レビューで「これは知っておいてほしかった」と気づいたとき

    足すときは、行を増やす前に、削る行も探します。週に1回、/context で読み込まれた量を見て、使っていないルールを消す習慣がおすすめです。

    つまずきやすい点

    • 書いたのに守られない:長すぎる、あいまい、他の指示と矛盾、のどれかが多いです。/context で読み込まれているかを確認し、短く、具体的に直します

    • 書き換えが反映されない:新しい会話を始めて確かめるのが確実です。会話の途中の編集がいつ反映されるかは、版で変わることがあります

    • サブフォルダのルールが効かない:サブフォルダの CLAUDE.md は、そこのファイルを読むまで読み込まれません

    • 会話が長くなると忘れる:プロジェクト直下の CLAUDE.md は、/compact のあとも読み直されます。会話だけで伝えたルールは消えるので、大事なものは CLAUDE.md に書きます

    まとめ

    • CLAUDE.md は、毎回の会話の最初に読まれる指示書。強制ではなく、読ませる文脈

    • 置き場所は、./CLAUDE.md(プロジェクト)、~/.claude/CLAUDE.md(個人)、./CLAUDE.local.md(個人用・Git に入れない)。サブフォルダのものは、必要になったときに読まれる

    • 最初は /init で下書き。そこから削る

    • 書くのは、推測できないコマンドと、既定と違う決まり、止まる線。書かないのは、コードを読めば分かること

    • 200行以下、具体的に、矛盾なく。守られない大事なことは、フックへ

    • AGENTS.md との併用は、CLAUDE.md の先頭に @AGENTS.md


    次に読む

    このアカウントをフォローすると、Claude Code や Codex の新しい手順の記事が届きます。ぜひフォローしてください。

    まさのAI実務ラボ|Codex・Claude Code では、有料記事が読み放題になります。指示書の育て方や自動化の手順を、まとめて読みたい方はご覧ください。

    あなたへのおすすめ