CLAUDE.mdは、Claude Codeのプロジェクトルートに配置するMarkdownファイルで、そのプロジェクト固有のルール・コンテキストをClaude Codeに記憶させる仕組みです。コーディング規約、使用技術、ディレクトリ構造のルール、命名規則、テストの方針などを記述しておくと、Claude Codeはその情報を毎回のセッションで自動的に参照し、プロジェクトに一貫した品質のコードを生成します。いわば「新しいメンバーに渡すプロジェクトのオンボーディング資料」をClaude Code用に書いたものです。
CLAUDE.mdがないとどうなるか
CLAUDE.mdが存在しない場合、Claude Codeは汎用的なベストプラクティスに基づいてコードを生成します。たとえばTypeScriptプロジェクトであっても、Claude Codeは「セミコロンをつけるか」「シングルクォートかダブルクォートか」「インデントはスペース2つか4つか」を毎回独自に判断します。結果として既存コードとスタイルが統一されず、PR（プルリクエスト）ごとにフォーマットの修正が必要になります。チーム開発では特に深刻で、メンバーAがClaude Codeで書いたコードとメンバーBが書いたコードのスタイルが異なるという問題が頻発します。CLAUDE.mdはこの問題を根本的に解決します。
CLAUDE.mdに書くべき7つの項目
項目1は「プロジェクト概要」です。何をするアプリケーションか、誰が使うか、主要な機能は何かを2〜3行で記述します。Claude Codeがコードの目的を理解することで、変数名や関数名のセマンティクスが適切になります。
項目2は「技術スタック」です。フレームワーク（Next.js 15、React 19等）、言語（TypeScript）、データベース（PostgreSQL＋Prisma）、テストフレームワーク（Jest）、スタイリング（Tailwind CSS）など、使用している技術を列挙します。Claude Codeはこの情報をもとに適切なAPIやパターンを選択します。
項目3は「ディレクトリ構造」です。src/app/はルーティングとページコンポーネント、src/components/は再利用可能なUIコンポーネント、src/lib/はユーティリティ関数とAPI呼び出し、src/types/はTypeScriptの型定義——のように、各ディレクトリの役割を明記します。新しいファイルを作成する際にClaude Codeが正しい場所に配置してくれるようになります。
項目4は「コーディングルール」です。TypeScript strictモードを使用すること、anyは禁止であること、ESLint＋Prettierで整形すること、Reactはfunctional componentsのみ（classは使わない）、命名はキャメルケース（変数・関数）とパスカルケース（型・コンポーネント）——のように具体的なルールを記述します。
項目5は「テスト方針」です。テストフレームワーク（Jest＋Testing Library等）、テストファイルの配置場所（__tests__/ディレクトリまたは.test.tsサフィックス）、テストのカバレッジ目標（80%以上など）を記述します。
項目6は「Git運用ルール」です。ブランチの命名規則（feature/xxx、fix/xxx、chore/xxx）、コミットメッセージの形式（Conventional Commits等）、PRのレビュー基準を記述します。Claude Codeがbranch作成やcommitを行う際にこのルールに従います。
項目7は「禁止事項・注意事項」です。「.envファイルをcommitしない」「本番DBに直接接続しない」「ユーザーの個人情報をログに出力しない」など、絶対に守るべきルールを明記します。
AI活用・Web集客のプロに相談しませんか？
株式会社仁頼は、Claude・ChatGPT等の生成AI導入支援からSEO・GEO対策まで一貫対応。8年超の実務経験で「AIで何ができるか」から一緒に考えます。
CLAUDE.mdの具体的な記述例
実際のCLAUDE.mdは以下のような構成になります。冒頭にプロジェクト概要を2行で記述（例：「中小企業向けのSaaS型顧客管理システム。Next.js 15 + TypeScript + Prisma + PostgreSQL構成」）。次に技術スタックを箇条書きで列挙。ディレクトリ構造をツリー形式で記述。コーディングルールを箇条書きで記述。テスト方針を記述。Gitルールを記述。最後に禁止事項を記述。全体で100行から200行程度が適切です。500行を超えるとClaude Codeのコンテキストを圧迫するため、長くなりすぎる場合は要点を絞ってください。
CLAUDE.mdの置き場所と複数ファイルの使い分け
基本はプロジェクトルート（リポジトリのトップレベル）に1ファイル配置します。モノレポ構成の場合はルートに全体共通のCLAUDE.mdを、各パッケージのルートにパッケージ固有のCLAUDE.mdをそれぞれ配置すると、Claude Codeは両方を読み込んで統合的に参照します。ユーザーのホームディレクトリ（~/.claude/CLAUDE.md）に配置すると、すべてのプロジェクトに共通する個人設定（好みのコーディングスタイル等）を適用できます。優先順位はプロジェクトルート ＞ パッケージディレクトリ ＞ ホームディレクトリです。
CLAUDE.mdを最新に保つコツ
CLAUDE.mdは作成して終わりではなく、プロジェクトの進化に合わせて更新する必要があります。新しいライブラリを追加したとき、ディレクトリ構造を変更したとき、コーディング規約を改定したときにCLAUDE.mdも更新してください。更新を忘れると、Claude Codeが古い情報に基づいてコードを生成し、コードベースとの不整合が発生します。PRレビューのチェック項目に「CLAUDE.mdの更新が必要か」を含めておくのが効果的です。また、Claude Code自身に「このプロジェクトのCLAUDE.mdを最新の状態に更新して」と依頼することもできます。プロジェクトのファイル構造を走査して変更点を検出し、CLAUDE.mdに反映してくれます。
よくある質問
CLAUDE.mdを書かなくてもClaude Codeは使えますか
はい、なくても動作します。ただし出力品質と一貫性に大きな差が出ます。特にチーム開発ではCLAUDE.mdは必須と考えてください。Claude Codeの基本操作を一通り覚えたら、次のステップとしてCLAUDE.mdの作成に取り組むことを推奨します。
CLAUDE.mdの内容がClaude Codeのレスポンスに反映されないのですが
CLAUDE.mdが正しい場所（プロジェクトルート）に配置されているか確認してください。また、セッションの途中でCLAUDE.mdを変更した場合は、一度/clearで会話をリセットするか新しいセッションを開始すると反映されます。
機密情報をCLAUDE.mdに書いても大丈夫ですか
CLAUDE.mdはClaude Codeのコンテキストに読み込まれるため、APIキーやパスワードなどの機密情報は記述しないでください。環境変数の「変数名」は記載してOKですが、「値」は記載しないでください。
まとめ
CLAUDE.mdは「Claude Codeをチームの一員にするための仕様書」です。100行程度のMarkdownファイルを1つ配置するだけで、Claude Codeの出力品質が劇的に安定します。プロジェクトの技術スタック、ディレクトリ構造、コーディングルールを書くところから始めて、プロジェクトの成長に合わせて更新していってください。
