CLAUDE.mdは、Claude Codeにプロジェクトの概要、開発ルール、テスト手順、注意点を継続的に伝えるためのMarkdown形式の指示ファイルです。
Claude Codeのセッション開始時に読み込ませる前提情報として使われ、毎回チャットで同じ説明を繰り返す手間を減らせます。
まず押さえたいポイント
- Claude Code向けのプロジェクト指示ファイル
- Markdownで書くため、人間にもAIにも読みやすい
- ビルド、テスト、設計方針、禁止事項を書くと効果が出やすい
- 長すぎる指示や古い手順は、かえってAIの判断をぶれさせる
どんな場面で使うか
Claude Codeにコード修正、調査、テスト追加、リファクタリングを依頼するとき、プロジェクト固有の情報がないとAIは毎回探索から始めます。
CLAUDE.mdに、プロジェクト構成、よく使うコマンド、既存の実装方針、レビュー前の確認手順を書いておくと、AIが作業の前提をつかみやすくなります。
たとえば、Laravelプロジェクトなら、php artisan test の実行条件、Seederの使い方、BladeやControllerの既存パターン、触ってはいけない本番設定などを書くと実用的です。
よくある誤解
CLAUDE.mdは、Claude Codeを完全に制御する設定ファイルではありません。
あくまでコンテキストとして渡される指示なので、重要な作業ではチャットでも「CLAUDE.mdを読んでから進めて」と明示した方が安全です。
また、CLAUDE.mdに秘密情報を書いてはいけません。
APIキー、パスワード、クライアントの機密情報、本番DBの接続情報は含めず、必要なら環境変数名や確認手順に留めます。
実務で見るポイント
CLAUDE.mdは、一度作って終わりではなく、AIが同じ失敗をしたときに育てるファイルです。
ただし、何でも追記すると長くなりすぎるため、毎回必要なルール、検証可能なコマンド、重要な禁止事項に絞る方が安定します。
AGENTS.mdやCopilot instructionsとの違いは、AIコーディングで使うmdファイルとは？AGENTS.md・CLAUDE.md・指示書の役割を整理 で整理しています。