CLAUDE.md でカスタマイズ
CLAUDE.md は、プロジェクトのルールや設定を Claude Code に伝える特別なファイルです。セッション開始時に自動的に読み込まれ、Claude Code の振る舞いをカスタマイズできます。
CLAUDE.md とは
CLAUDE.md はマークダウン形式のテキストファイルで、プロジェクトのルートに配置します。Claude Code はセッション開始時にこのファイルを読み込み、そこに書かれたルールに従って動作します。
| 配置場所 | スコープ |
|---|---|
| プロジェクトルート | プロジェクト全体 |
| サブディレクトリ | そのディレクトリ以下 |
~/.claude/CLAUDE.md | 全プロジェクト共通(個人設定) |
後から読み込まれたものが優先されます。
プロジェクトルールの設定
CLAUDE.md に書くべき内容:
- プロジェクト概要: 使用技術スタック
- 開発コマンド:
npm run dev,npm test等 - コーディング規約: 命名規則、インデント等
- Git ルール: ブランチ名、コミット規約
- 禁止事項: 編集禁止ファイル、コミット禁止ファイル等
CLAUDE.md の記述例
markdown
# プロジェクト概要
社内タスク管理アプリ。React + TypeScript + Express + PostgreSQL。
## 開発コマンド
- `npm run dev` - 開発サーバー起動
- `npm test` - テスト実行
- `npm run build` - ビルド
## コーディング規約
- 変数名・関数名: camelCase / コンポーネント名: PascalCase
- インデント: スペース 2 つ
- TypeScript strict モード、any 型禁止
## Git ルール
- ブランチ名: feature/xxx, fix/xxx, chore/xxx
- コミット: Conventional Commits(feat:, fix:, docs: 等)
## 注意事項
- .env ファイルは絶対にコミットしない
- src/generated/ は自動生成のため編集禁止Claude に作ってもらう
自分で書かなくても、Claude Code にプロジェクトを分析して CLAUDE.md を作ってもらえます。
> このプロジェクトを分析して、適切な CLAUDE.md を作成してくださいベストプラクティス
- 簡潔に書く: 箇条書き中心で要点のみ
- 具体的に書く: 「きれいに」ではなく「camelCase を使って」
- 禁止事項を明記: 触ってほしくないファイルやルールを明確に
- 長すぎない: 数百行になると効果が薄れる
もっと詳しく知りたい方へ