CLAUDE.mdとは？
CLAUDE.mdは、Claude Codeがプロジェクトのコンテキストを理解するための設定ファイルです。プロジェクトのルートに配置することで、Claudeはコードベースの構造、コーディング規約、ワークフローを事前に把握した状態で作業を開始できます。
なぜ必要か
Claude Codeは強力なAIエージェントですが、プロジェクト固有のルールや慣習までは知りません。CLAUDE.mdがあることで：
- コーディング規約の遵守 — チームのスタイルガイドに沿ったコードを生成します
- プロジェクト構造の理解 — ファイルの配置場所やディレクトリの役割を正しく把握します
- ワークフローの統合 — テストの実行方法、デプロイ手順、ブランチ戦略を理解します
- コンテキストの維持 — セッションをまたいでも一貫した行動を取ります
基本構造
最小限のCLAUDE.mdは以下のような構造です：
# プロジェクト名
## 概要
このプロジェクトの説明
## 技術スタック
- フロントエンド: React + TypeScript
- バックエンド: Node.js + Express
## コーディング規約
- 変数名はcamelCase
- コンポーネントはPascalCase
## ディレクトリ構造
- src/components/ — UIコンポーネント
- src/lib/ — ユーティリティ
配置場所
CLAUDE.mdは以下の3つの場所に配置できます：
- プロジェクトルート (
CLAUDE.md) — プロジェクト全体の設定 ~/.claude/CLAUDE.md— ユーザーのグローバル設定.claude/rules/— 特定の目的に絞ったルールファイル
次のステップ
まずはプロジェクトルートにCLAUDE.mdを作成し、最低限の情報を書いてみましょう。効果はすぐに体感できるはずです。