CLAUDE.md とは？ AIへの「引き継ぎメモ」をわかりやすく解説

ひとことで言うと「AIへの引き継ぎメモ」

CLAUDE.md（クロード・エムディ）とは、AIコーディングツール「Claude Code」（クロード・コード）が毎回のセッション開始時に自動で読み込む設定ファイルのことです。

ここに「このプロジェクトのルール」「やってはいけないこと」「作業の進め方」を書いておくと、毎回同じことをAIに説明しなくても、最初からわかった状態で作業してもらえます。

料理で例えるなら、毎日シフトが変わるキッチンスタッフに向けて「うちの店のレシピと禁止事項を書いた引き継ぎノート」を渡すようなイメージです。そのノートさえあれば、新しいスタッフでも即日同じ水準の料理が作れます。

なぜ今注目されているのか

AIは「毎回記憶がリセットされる」問題がある

ChatGPTやClaudeなどの生成AI（=人工知能）は、会話のセッション（=一回の作業のまとまり）が終わると、その内容をほとんど覚えていません。次のセッションでは「はじめまして」の状態から始まります。

これはまるで、毎日記憶がリセットされるパート社員に同じ説明を繰り返すようなもの。慣れてきた頃に終わってしまい、また最初から説明…というストレスが生まれます。

Claude Codeが登場し、プロの現場に広まった

AnthropicはAIを使ったコーディングツール「Claude Code」を開発し、2025年に一般公開しました。このツールは、プログラムを書く作業を自動化・補助するものです。Claude Codeが広まるにつれ、「どうすればAIに毎回同じ説明をしなくて済むか」という課題が注目されるようになりました。

その解決策として登場したのが CLAUDE.md です。

「一度書けばずっと使える」が革新的

CLAUDE.mdをプロジェクトフォルダ（=作業用のフォルダ）に置くだけで、Claude Codeが自動的に読み込みます。つまり、プロジェクトのルールや注意点をこのファイルに書いておけば、何度も繰り返し説明する必要がなくなるのです。

何ができて、何ができないか

できること

CLAUDE.mdには、次のような内容を書いておくことができます。

CLAUDE.mdファイルはプロジェクト全体だけでなく、サブフォルダ（=フォルダの中のフォルダ）ごとにも置くことができます。フロントエンド（=画面の部分）専用のルール、バックエンド（=サーバー側の部分）専用のルールと、場所によって内容を変えられるのも特徴です。

さらに、ホームディレクトリ（=自分のパソコン全体で共通の設定場所）にCLAUDE.mdを置くと、すべてのプロジェクトに共通するルールを一度だけ書いておくこともできます。

できないこと・注意すべき限界

一方で、CLAUDE.mdは「強制的な設定」ではありません。Anthropicの公式ドキュメントには、「Claudeはこれらをコンテキスト（=会話の背景情報）として扱い、強制的な設定ではない」と明記されています。

つまり、書いたからといって100%従ってくれるとは限りません。とくに、内容が長くなればなるほどAIが指示を見落とす可能性が高まります。公式ドキュメントでは1ファイルあたり200行以内を目安として推奨しています。

「あれもこれも書き込もう」とすると、かえって精度が下がるというわけです。

はじめてみるには

ステップ1：Claude Codeをインストールする

CLAUDE.mdを活用するには、まず Claude Code が必要です。Claude Codeはターミナル（=文字を入力する画面）から使うツールで、MacOS・Linux・Windowsで動作します。

ステップ2：/init コマンドで自動生成してもらう

一番手軽な始め方は、Claude Codeの /init コマンドを使うことです。このコマンドを実行すると、Claudeがプロジェクトを分析して、ビルドコマンドやテスト手順、プロジェクトのルールを含むCLAUDE.mdを自動で作ってくれます。

すでにCLAUDE.mdが存在する場合は、上書きせずに「改善の提案」をしてくれるので安心です。

ステップ3：自分の言葉で育てていく

自動生成されたファイルはあくまで出発点です。実際に使いながら、「こういうことも伝えておけばよかった」という気づきをその都度追加していきましょう。

ちょうど、新入社員向けの引き継ぎマニュアルが、実際に使ってみてはじめて細かい注意点が見えてくるのと同じです。

置き場所による違い

注意したいこと

書きすぎはかえって逆効果

CLAUDE.mdは長いほど良いわけではありません。ファイルの内容はセッション開始のたびにトークン（=AIが処理する情報の単位）として消費されます。長くなるほどAIの処理に負荷がかかり、指示の守られ方が下がっていきます。

「大事なことだけ、短く、具体的に書く」ことが、CLAUDE.mdをうまく使うコツです。たとえば「きちんとコードを書いてください」という曖昧な指示より、「変更のたびに必ずテストを実行し、すべてのテストが通るまでタスク完了としない」のように、確認できるほど具体的に書くほうが効果的です。

機密情報の取り扱いに注意

CLAUDE.mdをチームで共有する場合は、個人情報や社外秘の情報を書き込まないよう注意が必要です。個人的なメモや機密情報は別ファイルに分けて管理することをおすすめします。

古い情報を放置しない

プロジェクトが変わっていくのに、CLAUDE.mdの内容が古いままだと、Claudeが間違った前提で作業を進めてしまう可能性があります。コードに大きな変更を加えたときは、CLAUDE.mdの内容も見直す習慣をつけましょう。

「これさえあれば安心」ではない

CLAUDE.mdはあくまでAIへのヒント集であり、AIの出力を完全に制御するものではありません。重要な変更をAIに任せるときは、必ず人間がレビュー（=確認）する仕組みを残しておきましょう。

まとめ

CLAUDE.mdは、AIコーディングツール「Claude Code」に「毎回覚えておいてほしいこと」を伝えるための設定ファイルです。一度書いておけば、セッションが変わっても同じルールで動いてくれます。

はじめは /init コマンドで自動生成し、使いながら少しずつ育てていくのがおすすめです。書きすぎず、具体的に、200行以内を目安に保つと効果的に機能します。

AIに毎回同じ説明をする手間を省いて、本当に大切な作業に集中できる環境を整えてみてください。