CLAUDE.md とは
AI活用

CLAUDE.mdとは?役割と読み込みの仕組み、置き場所や作り方の基本

タグアイコン

公開 2026-10-27 更新 2026-11-03

Claude Codeを使うたびに、プロジェクトの説明や作業のルールを同じように伝え直していないでしょうか。CLAUDE.mdは、Claude Codeがセッションの開始時に毎回読み込む、指示を書いたファイルです。毎回伝えることを書いておけば、説明し直す手間が減ります。

この記事では、CLAUDE.mdの役割と読み込まれる仕組み、置き場所と作り方の基本、自動メモリやスキルとの違いを、公式ドキュメントをもとに解説します。

CLAUDE.mdとは?

CLAUDE.mdは、Claude Codeがセッションの開始時に毎回読み込む、指示を書いたテキストファイルです。作業の手順や守ってほしいルール、フォルダの構成などを書いておくと、Claudeはその内容を踏まえて作業します。

マークダウン形式のファイル

ファイル名の「.md」は、Markdown(マークダウン)という書式を表す拡張子です。中身は、見出しや箇条書きを記号で表したふつうのテキストなので、テキストエディタで作ったり直したりできます。ファイル名は、公式ドキュメントの表記どおり大文字で「CLAUDE.md」とします。

CLAUDE.mdがあると何が変わる?

Claude Codeのセッションは、毎回まっさらな状態で始まります。前のセッションで「原稿はこのフォルダに置く」「書き終えたらこの手順で確認する」と伝えていても、新しいセッションのClaudeはその会話を覚えていません。

一般的にこうした前提を作業のたびに伝え直すことが必要ですが、CLAUDE.mdに書いておけば、セッションの最初に読み込まれるので説明しなくてもその前提で作業を始めてもらえます。

CLAUDE.mdを作らなくても、Claude Codeは使えます。公式ドキュメントは、前のセッションと同じ説明をまた入力しているときを、CLAUDE.mdに書き足すタイミングの一つに挙げています。同じ説明を繰り返していると気づいたら、作ってみましょう。

CLAUDE.mdが読み込まれる仕組み

ファイルがいつ読まれるのかと、読まれた指示がどう扱われるのかを知っておくと、CLAUDE.mdに記載すべき内容も見えてくるでしょう。

Claude Codeを起動したフォルダと、その上の階層のフォルダにあるCLAUDE.mdは、起動したときに読み込まれます。下の階層のフォルダにあるCLAUDE.mdは、Claudeがそのフォルダのファイルを読んだり編集したりしたときに読み込まれます。

CLAUDE.mdが複数あっても、どれかが上書きされることはなく、すべてが読み込まれます。どのファイルが読み込まれたかは、Claude Codeで /context を実行し、「メモリファイル」の一覧で確認できます。

Claude Code メモリファイル

CLAUDE.mdは指示として読まれますが、設定のように強制されるものではありません。あいまいな指示や、ファイル同士で食い違う指示ほど守られにくくなります。ファイルを編集したあとに必ず整形をかける、のように毎回確実に実行させたい操作は、フックという仕組みで設定します。フックは決まったタイミングでコマンドを自動で実行するもので、Claudeの判断に左右されません。

長い作業の途中で会話を要約(/compact)しても、プロジェクトのフォルダ直下にあるCLAUDE.mdはファイルから読み直されます。一方、会話の中で伝えただけの指示は、要約のあとに残らないことがあります。毎回必要な指示は、会話で伝えるだけでなくCLAUDE.mdに書いておきましょう。

CLAUDE.mdの種類と置き場所

CLAUDE.mdは、置く場所によって効く範囲が変わります。自分のすべてのプロジェクト用、プロジェクト用、自分だけのプロジェクト用、組織用の4種類があります。

 

種類 置き場所 効く範囲 共有される相手
ユーザー ~/.claude/CLAUDE.md 自分のすべてのプロジェクト 自分だけ
プロジェクト プロジェクトのフォルダの CLAUDE.md または .claude/CLAUDE.md そのプロジェクト Gitなどのバージョン管理を通じてチームのメンバー
ローカル プロジェクトのフォルダの CLAUDE.local.md そのプロジェクト 自分だけ(.gitignore に追加する)
管理ポリシー OSごとに決まった場所(macOSは /Library/Application Support/ClaudeCode/CLAUDE.md) その端末のすべてのユーザー 組織のIT管理者が配布する

~ はホームフォルダ(macOSなら /Users/ユーザー名)を表します。はじめは、作業するプロジェクトのフォルダにCLAUDE.mdを1つ置けば始められます。どのプロジェクトでも守ってほしいことが出てきたら、~/.claude/CLAUDE.md に書きましょう。

CLAUDE.mdの作り方

CLAUDE.mdは、Claudeに頼んで作ってもらえます。手順は次のとおりです。

  1. 作業するプロジェクトのフォルダでClaude Codeを開く
  2. 毎回伝えている手順やルールを書き、「これをCLAUDE.mdに追加して」と頼む
  3. できたCLAUDE.mdを開いて内容を確認する

作業の途中で同じ説明をしそうになったときも、その場で「これをCLAUDE.mdに追加して」と頼めば書き足してもらえます。自分で調整したいときは、Visual Studio CodeやObsidianでファイルを開いて直接編集しましょう。なお、Claudeに「覚えておいて」と頼んだ内容は、CLAUDE.mdではなく自動メモリに保存されます。

コードのプロジェクトなら、「/init」というコマンドで、Claudeにフォルダの中を調べさせて下書きを作る方法もあります。ただし下書きはClaudeがフォルダから読み取れることが中心なので、残すのは自分しか知らないルールや作業の進め方にしましょう。

CLAUDE.mdに書く内容の基本

CLAUDE.mdには、すべての作業で毎回必要になる手順やルールを書きます。たとえば次のようなものです。

  • 開発プロジェクトの概要
  • 作業で使うコマンドや手順
  • 守ってほしいルールや約束ごと
  • フォルダの構成
  • 「必ず〜する」という決まりごと

公式ドキュメントは、書き足すタイミングとして、Claudeが同じ間違いを2回したときや、前のセッションと同じ説明をまた入力したときなどを挙げています。

反対に、何段階もある長い手順や、一部のファイルにしか関係しない指示は、CLAUDE.mdより別の仕組みに分けるほうが向いています。長すぎるとAIが読み飛ばしてしまうため、1ファイルあたり200行以下が公式の目標です。

ちなみにTOUHAの記事制作では、すべてのプロジェクトに共通する「~/.claude/CLAUDE.md」に、次のようなルールを書いています。

# 全プロジェクト共通ルール(一部を抜粋) ## 1. 指示に書かれた資料は全部読む URL・パス・ファイル名が指示にあれば、それは材料である。開いて読む。外部サイトでも同じ。 (略) ## 2. 分からないことは質問。勝手な憶測は厳禁 パス・設定値・仕様が分からないとき、推測で動かない。**聞く。** ユーザーが即答できることを、コマンドの試行錯誤で当てにいくのは常に間違い。 ## 3. 何に触るか/目的を宣言してから探索する 外部への通信も、作業ディレクトリの外を読むことも、普通の手段である。使ってよい。 ただし、ユーザーの画面からは何をしているか見えない。許可プロンプトも目的までは伝えない。 (略)

3つのルールは、どれもコードの書き方ではなく仕事の進め方を書いたものです。渡した資料を読まずに書き始めない、分からないことを推測で埋めない、何を調べるかを先に伝える、という約束を、どのプロジェクトのセッションでも最初に読ませています。プログラムを書かない業務でも、CLAUDE.mdにはこうした仕事の約束ごとを書けます。

CLAUDE.mdと自動メモリ・スキル・フックの違い

Claude Codeには、CLAUDE.mdのほかにも、Claudeに情報や手順を渡す仕組みがあります。違いは、誰が書くかと、いつ読み込まれるかです。

 

仕組み 誰が書くか いつ読み込まれるか 向いている内容
CLAUDE.md 自分 毎回、セッションの開始時 毎回守ってほしい手順やルール
自動メモリ Claude 毎回、セッションの開始時(索引の MEMORY.md の最初の200行または25KBまで) 作業の中で分かった好みや、直されたこと
ルール(.claude/rules/) 自分 毎回、または指定したファイルを扱うときだけ 一部のファイルにだけ関係する指示
スキル 自分(Claudeに作ってもらうこともできる) 呼び出したとき、またはClaudeが関係すると判断したとき 何段階もある手順
フック 自分 決まったタイミングで自動で実行 毎回確実に実行させたい操作

CLAUDE.mdと自動メモリはどちらも毎回読み込まれますが、CLAUDE.mdは自分で書く指示、自動メモリはClaudeが作業の中で残すメモです。毎回の約束ごとを自分で決めておきたいならCLAUDE.md、細かな好みや直された点はClaudeに任せて自動メモリ、と分けられます。

この媒体の記事制作では、仕事の進め方の約束(資料は全部読む、推測で動かない)をCLAUDE.mdに、文章の規範(ですます調にする、箇条書きを使う条件など)と記事の企画の手順をスキルに、作業の中で直されたことを自動メモリに置いています。自動メモリの索引には、たとえば次のような行があります(一部を抜粋)。

– 文体(記事はですます調)・箇条書きの条件・NG表現は、メモリではなく `.claude/skills/japanese-tech-writing/SKILL.md` に移動済み。ライティングの規範はスキルを参照し、追記もスキル側に行う

– [校正は原文を触らず校正版に書く](kousei-target-file.md) — 既存原稿の校正は`レビュー/<元ファイル名>_校正版.md`を作ってそこに。原文を上書きすると差分運用が壊れる

1行目は、文章のルールを自動メモリからスキルへ移したことの記録です。毎回すべてを読ませる必要がない長い規範は、使うときに読み込まれるスキルにまとめています。スキルの作り方は「Claudeのスキルとは?作り方やskill-creatorで実際に作ってみた結果」で解説しています。

CLAUDE.mdに関するよくある質問

CLAUDE.mdを使い始めるときによく出る疑問をまとめました。

Q1. CLAUDE.mdは無料で使える?

CLAUDE.mdを読み込むClaude Codeは、Pro・Max・Team・Enterpriseのプランで使えます。CLAUDE.md自体はテキストファイルなので、作るのに費用はかかりません。

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

公式ドキュメントに、CLAUDE.mdを書く言語の指定はありません。日本語で書いてかまいません。

Q3. CLAUDE.mdとREADME.mdの違いは?

README.mdは人が読むための説明で、CLAUDE.mdはClaudeに毎回読ませる指示です。README.mdの内容もClaudeに読ませたいときは、CLAUDE.mdに @README.md のように書くと、そのファイルを取り込めます。取り込んだファイルも毎回読み込まれます。

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

AGENTS.mdは、Claude Code以外のコーディングツールでも使われる、指示を書くためのファイルです。Claude Codeは、CLAUDE.mdがない場合にAGENTS.mdを読み込みます。

Q5. CLAUDE.mdはGitにコミットする?

プロジェクトのCLAUDE.mdはチームのメンバーと共有するものなので、コミットします。自分だけの設定は CLAUDE.local.md に書き、.gitignore に追加してコミットしないようにします。

まとめ:CLAUDE.mdはClaude Codeに毎回の前提を伝えるファイル

CLAUDE.mdは、Claude Codeがセッションの開始時に毎回読み込む指示のファイルです。毎回説明し直すことになる手順やルールを書いておくと、その前提で作業を始めてもらえます。ただし必ず守られるものではないので、確実に実行させたい操作はフックに、ときどき使う長い手順はスキルに分けましょう。

まずは作業しているフォルダでClaude Codeを開き、毎回伝えているルールを1つ「これをCLAUDE.mdに追加して」と頼んでみましょう。

この記事の監修者

小杉 啓太

小杉 啓太

監修

株式会社みずかげ製作所 代表取締役

慶應義塾大学理工学部にてCNNによる画像分類を研究。エンジニアリング視点を持ったWebマーケターとして、SEO戦略立案から1,000本以上の記事校閲・編集まで幅広く経験。 ClaudeやCodexによる高度なWeb開発や、n8n・Google Workspace Studioを活用した最新の業務自動化ノウハウを武器に、IT・マーケティング分野の専門的で信頼性の高いコンテンツ監修を手掛ける。

専門領域 JDLA G検定 2020 #3

関連記事