Skip to content

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 を使って」
  • 禁止事項を明記: 触ってほしくないファイルやルールを明確に
  • 長すぎない: 数百行になると効果が薄れる

最終更新:

Anthropic公式ドキュメントを基に作成