CLAUDE.mdとは？
読み方: クロード エムディー
定義
プロジェクトのルートに配置する設定ファイル。Claude Code にプロジェクト固有のルール・コーディング規約・アーキテクチャ情報を伝える。
詳しい解説
CLAUDE.md は Claude Code が会話開始時に自動で読み込むマークダウンファイルです。コーディング規約、使用フレームワーク、ディレクトリ構成、テストの実行方法などを記述しておくと、Claude Code がプロジェクトの文脈を理解した上でコードを生成します。プロジェクトルートの CLAUDE.md はチーム全員で共有でき、ホームディレクトリの ~/.claude/CLAUDE.md はユーザー個人の設定として使えます。CLAUDE.md の配置場所は 3 階層あり、優先度順に (1) プロジェクトルート（リポジトリ共有）、(2) ~/.claude/CLAUDE.md（ユーザー個人・全プロジェクト共通）、(3) ~/.claude/projects/パス/CLAUDE.md（ユーザー個人・プロジェクト固有）です。記述のベストプラクティスとして、プロジェクト概要・ディレクトリ構成・よく使うコマンド（ビルド、テスト、lint）・コーディング規約・禁止事項を含めるのが効果的です。例えば「生の <button> タグは使わず FormButton コンポーネントを使う」「コミットメッセージは Conventional Commits に従う」といった具体的なルールを書くと、Claude Code がそれに準拠したコードを生成します。/init コマンドで自動生成した後、チーム固有のルールを手動で追記するのが推奨ワークフローです。CLAUDE.md はバージョン管理に含めることで、新メンバーのオンボーディング資料としても機能します。
使用例
claude /init