CLAUDE.mdを作ろうとして、どのフォルダに置けばよいか迷っていないでしょうか。CLAUDE.mdの置き場所は4種類あり、場所によって効く範囲が変わります。迷ったらプロジェクトのフォルダ直下に置き、すべてのプロジェクトで使う指示は「~/.claude/CLAUDE.md」に書きましょう。
この記事では、置き場所ごとの違いと選び方、作り方、読み込まれる順番と確認方法を、公式ドキュメントをもとに解説します。
CLAUDE.mdの場所は4種類
CLAUDE.mdは、Claude Codeがセッションの開始時に読み込む、指示を書いたファイルです。
置ける場所は、ユーザー、プロジェクト、ローカル、管理ポリシーの4つで、場所ごとに効く範囲と共有される相手が違います。
| 種類 | 置き場所(macOS・Linux) | 置き場所(Windows) | 効く範囲 | 共有される相手 | Gitにコミット |
|---|---|---|---|---|---|
| ユーザー | ~/.claude/CLAUDE.md | %USERPROFILE%\.claude\CLAUDE.md | 自分のすべてのプロジェクト | 自分だけ | しない |
| プロジェクト | プロジェクトのフォルダの CLAUDE.md または .claude/CLAUDE.md | 同じ | そのプロジェクト | チームのメンバー | する |
| ローカル | プロジェクトのフォルダの CLAUDE.local.md | 同じ | そのプロジェクト | 自分だけ | しない(.gitignore に追加) |
| 管理ポリシー | macOS:/Library/Application Support/ClaudeCode/CLAUDE.md、Linux:/etc/claudecode/CLAUDE.md | C:\Program Files\ClaudeCode\CLAUDE.md | 組織のすべてのユーザー | 組織のIT管理者が配布する | ― |
「~」はホームフォルダ(macOSなら「/Users/ユーザー名」)を表します。ユーザーのCLAUDE.mdはホームフォルダの中にあるので、どのリポジトリにもコミットされません。
プロジェクトのCLAUDE.mdは、フォルダの直下の CLAUDE.md と、.claude フォルダの中の .claude/CLAUDE.md のどちらに置いても読み込まれます。
フォルダの直下にファイルを増やしたくなければ、「.claude」の中に置きましょう。管理ポリシーは、会社などの組織がすべての社員の端末に配るためのもので、個人が作るものではありません。
CLAUDE.mdの置き場所の選び方
迷ったら、Claude Codeで開くプロジェクトのフォルダ直下にCLAUDE.md を1つ置けば始められます。そのうえで、どのプロジェクトでも使う指示と、チームに共有したくない自分だけの指示が出てきたら、次のように分けます。
| こんなとき | 置き場所 |
|---|---|
| このプロジェクトの作業の手順やルールを書きたい | プロジェクト(CLAUDE.md) |
| どのプロジェクトでも守ってほしい自分の決まりを書きたい(返答の言語、作業の進め方など) | ユーザー(~/.claude/CLAUDE.md) |
| このプロジェクトで自分だけが使う設定を書きたい(自分用のテストの値など) | ローカル(CLAUDE.local.md) |
ここでいう「プロジェクトのフォルダ」は、Claude Codeを起動するフォルダのことです。ターミナルなら実行するフォルダ、Claudeデスクトップアプリの「Code」タブなら、セッションを始めるときに選ぶフォルダが当たります。
CLAUDE.mdは、プロジェクトごとに必ず作るものではありません。この媒体の記事制作では、資料は全部読む、推測で動かない、といったすべての作業に共通するルールを「~/.claude/CLAUDE.md」に置いています。
記事制作のプロジェクトのフォルダにはCLAUDE.mdを置いておらず、媒体の文章の規範や企画の手順は、スキルとしてプロジェクトの「.claude/skills/」に置いています。
一方、別のプロジェクト(あるコーポレートサイトの制作)では、そのサイトだけの決まりを、プロジェクト直下の CLAUDE.md に125行でまとめています。見出しの並びは次のとおりです。
Gitの運用やページの構成、デザインの原則は、そのサイトでしか使わない情報なので、プロジェクトのCLAUDE.mdに書いています。どこでも使うルールはユーザーのCLAUDE.mdに、そのプロジェクトだけの決まりはプロジェクトのCLAUDE.mdに、と分けると、同じことを何か所にも書かずに済みます。
置き場所ごとのCLAUDE.mdの作り方と開き方
プロジェクトのCLAUDE.mdは、Claudeに頼んで作ってもらえます。ユーザーとローカルのCLAUDE.mdは自分で作ります。どこにあるか分からないときは、ターミナルのClaude Codeなら /memory を実行すると、一覧から選んで開けます。
プロジェクトのCLAUDE.md
プロジェクトのCLAUDE.mdは、次の手順で作れます。
- プロジェクトのフォルダでClaude Codeを開く
- 毎回伝えている手順やルールを書き、「これをCLAUDE.mdに追加して」と頼む
- フォルダの直下にできた CLAUDE.md を開き、内容を確認する
自分でフォルダの直下に CLAUDE.md という名前のファイルを作ってもかまいません。ターミナルのClaude Codeでは、/init でフォルダの中を調べさせて下書きを作る方法もあります。下書きに何を書き足すかは「CLAUDE.mdとは?役割と読み込みの仕組み、置き場所や作り方の基本」で解説しています。
すべてのプロジェクト共通のCLAUDE.md(~/.claude)
すべてのプロジェクトで使うCLAUDE.mdは、ホームフォルダの中の .claude フォルダに作ります。Windowsでは 「%USERPROFILE%\.claude\CLAUDE.md」です。
.claude は名前がドット(.)で始まる隠しフォルダなので、Finderやエクスプローラーではそのままでは表示されないことがあります。macOSのFinderでは、ホームフォルダを開いて「Shift + Command + .(ピリオド)」を押すと表示されます。
見つけた CLAUDE.md は、テキストエディタで開いて編集が可能です。ターミナルのClaude Codeなら、フォルダを探さなくても /memory を実行すると、ユーザーのCLAUDE.mdを一覧から選べます。
まだファイルがなければ、選んだときに作成されてエディタで開きます。ユーザーのCLAUDE.mdはどのプロジェクトでも毎回読み込まれるので、どこでも必要なことだけを短く書きましょう。
自分だけのCLAUDE.local.md
チームに共有したくない自分だけの指示は、プロジェクトのフォルダ直下に CLAUDE.local.md を作って書きます。Gitを使っているプロジェクトなら、.gitignore に CLAUDE.local.md を追加して、コミットされないようにしましょう。Gitを使っていなければ、この作業は必要ありません。
CLAUDE.local.md は、同じフォルダの CLAUDE.md と一緒に、そのあとに読み込まれます。
複数のCLAUDE.mdが読み込まれる順番
CLAUDE.mdが複数あっても、どれかが上書きされることはなく、すべてが読み込まれます。読まれる順番は、効く範囲の広いものからです。
- 管理ポリシー
- ユーザー(~/.claude/CLAUDE.md)
- プロジェクト(CLAUDE.md)
- ローカル(CLAUDE.local.md)
フォルダが入れ子になっている場合は、上の階層から、Claude Codeを起動したフォルダの順に読まれます。たとえば次のような構成で、記事制作 のフォルダからClaude Codeを起動したとします。
起動したフォルダに近いCLAUDE.mdほど、あとに読まれます。同じフォルダの中では、CLAUDE.local.md が CLAUDE.md のあとです。
先ほどのコーポレートサイトのプロジェクトで作業すると、「~/.claude/CLAUDE.md」に書いた共通のルールのあとに、プロジェクトの CLAUDE.md が読まれ、両方が作業の前提になります。
読み込まれたCLAUDE.mdの指示どうしが食い違っていると、Claudeがどちらに従うかは保証されません。ユーザーのCLAUDE.mdとプロジェクトのCLAUDE.mdに、矛盾する指示を書かないようにしましょう。
サブフォルダに置いたCLAUDE.mdが読み込まれるタイミング
起動したフォルダより下のサブフォルダに置いたCLAUDE.mdは、起動したときではなく、Claudeがそのサブフォルダのファイルを読んだり編集したりしたときに読み込まれます。先ほどの例でいえば、原稿/CLAUDE.md は、Claudeが 原稿/ の中のファイルを扱うまでは読まれません。
フォルダごとに作業の決まりが違う場合は、この仕組みを使えます。たとえば、原稿/ には文章の決まりを、資料/ には資料の扱い方を、それぞれのフォルダのCLAUDE.mdに書いておくと、そのフォルダで作業するときだけ読み込まれます。
複数のチームが同じリポジトリを使っていて、他のチームのCLAUDE.mdを読ませたくない場合は、設定の claudeMdExcludes で特定のCLAUDE.mdを読み込みの対象から外しましょう。
CLAUDE.mdが読み込まれないときの確認ポイント
置いたはずのCLAUDE.mdが効いていないと感じたら、まずClaude Codeで /context を実行し、「Memory files」の一覧にそのCLAUDE.mdが出ているかを確認します。次の順で見直しましょう。
- /context の「Memory files」に、そのCLAUDE.mdが出ているかを見る
- Claude Codeを起動したフォルダが、CLAUDE.mdを置いたフォルダか、その下のフォルダかを確かめる(デスクトップアプリなら、選んだフォルダ)
- サブフォルダに置いたCLAUDE.mdなら、そのフォルダのファイルを扱わせてから確かめる(ターミナルでは、読み込まれると Loaded で始まる行が表示されます)
- ファイル名が CLAUDE.md になっているか、置き場所がフォルダの直下か .claude の中かを確かめる
ほかにも、読み込まれない理由がいくつかあります。ターミナルのClaude Codeで、–add-dir オプションを使って作業の対象に追加したフォルダにあるCLAUDE.mdは、既定では読み込まれません。
また、Claude Code以外のツール向けに AGENTS.md を置いている場合、同じフォルダかその上にCLAUDE.mdがあると、既定の設定のままではAGENTS.mdは読み込まれません。
先ほどのコーポレートサイトのプロジェクトにも、CLAUDE.md と並んで AGENTS.md が置いてあります。既定の設定のままなら、Claude Codeが読むのは CLAUDE.md だけです。
実際、このプロジェクトの AGENTS.md は更新されないまま、CLAUDE.md より古い内容が残っています。AGENTS.mdに書いた指示をClaude Codeにも読ませたいなら、CLAUDE.mdの中に @AGENTS.md と書いて取り込みます。
/context の一覧に出ているのに指示が守られない場合は、置き場所ではなく、書いた指示の内容に原因があります。指示をより具体的にするか、ほかのCLAUDE.mdと食い違っていないかを見直しましょう。
CLAUDE.mdの場所に関するよくある質問
CLAUDE.mdの置き場所について、よく出る疑問をまとめました。
Q1. ./CLAUDE.mdと./.claude/CLAUDE.mdはどちらがいい?
どちらもプロジェクトのCLAUDE.mdとして読み込まれます。フォルダの直下にファイルを増やしたくなければ、.claude の中に置きましょう。
Q2. CLAUDE.mdはGitにコミットする?
プロジェクトのCLAUDE.mdは、コミットしてチームと共有します。CLAUDE.local.md と ~/.claude/CLAUDE.md は自分だけのものなので、コミットしません。
Q3. 自動メモリはどこに保存される?
Claudeが作業の中で残す自動メモリは、CLAUDE.mdとは別に、~/.claude/projects/<プロジェクト>/memory/ に保存されます。ターミナルのClaude Codeでは、/memory から自動メモリのフォルダも開けます。
Q4. .claude/rules/はどこに置く?
指示を分けて置く .claude/rules/ は、プロジェクトのフォルダの .claude/rules/ か、すべてのプロジェクト用の ~/.claude/rules/ に置きます。
まとめ:CLAUDE.mdは迷ったらプロジェクトのフォルダ直下に置く
CLAUDE.mdの置き場所は、ユーザー、プロジェクト、ローカル、管理ポリシーの4種類です。
迷ったらプロジェクトのフォルダ直下に1つ置き、どのプロジェクトでも使う指示は ~/.claude/CLAUDE.md に、自分だけの指示は CLAUDE.local.md に分けましょう。複数あっても上書きされずにすべて読み込まれるので、指示どうしを矛盾させないことが大切です。
CLAUDE.mdを置いたら、Claude Codeで /context を実行して、読み込まれているかを確かめましょう。
この記事の監修者
小杉 啓太
監修株式会社みずかげ製作所 代表取締役
慶應義塾大学理工学部にてCNNによる画像分類を研究。エンジニアリング視点を持ったWebマーケターとして、SEO戦略立案から1,000本以上の記事校閲・編集まで幅広く経験。 ClaudeやCodexによる高度なWeb開発や、n8n・Google Workspace Studioを活用した最新の業務自動化ノウハウを武器に、IT・マーケティング分野の専門的で信頼性の高いコンテンツ監修を手掛ける。