CLAUDE.md 完全ガイド — AIにルールを教える技術

CLAUDE.md とは

CLAUDE.md は Claude Code がプロジェクトで作業するたびに 必ず読む 設定ファイルです。ここに書いたルールは、全ての会話セッションで有効になります。

つまり、一度設定すれば毎回指示しなくていい ルール集です。

CLAUDE.md の基本構造

# CLAUDE.md — [プロジェクト名]

## プロジェクト概要
（技術スタック、アーキテクチャの説明）

## 絶対禁止事項
（やってはいけないこと）

## コーディング規約
（命名規則、スタイル等）

## ファイル操作ルール
（編集してよいファイル/してはいけないファイル）

## 事前承認ワークフロー
（承認が必要な操作）

## テスト・品質基準
（ビルド・テストの条件）

効果的な記述の実例

技術スタックの明示

## 技術スタック
- Astro 5.x（SSG）
- TypeScript strict mode
- Tailwind CSS v4（CSS-first: @import "tailwindcss"）
- pnpm（npm/yarn は使わないこと）

技術スタックを書くと、AIが「この技術ではこの書き方をすべき」と自動的に判断できます。

禁止事項の具体化

## 絶対禁止事項
- `rm -rf` など再帰的削除コマンドの実行
- any 型の使用
- インラインスタイル（Tailwindクラスで代替）
- console.log を残してコミット
- .env ファイルのコミット
- node_modules の直接編集

曖昧な禁止より、具体的な禁止の方が効果的です。

ワークフローの定義

## 事前承認ワークフロー
以下を実行する前に、内容を日本語で説明して承認を得ること:
- 新規パッケージの追加（npm install 等）
- 設定ファイルの変更（tsconfig, vite.config 等）
- 外部APIの呼び出し
- 既存ファイルの削除

これにより、AIが勝手に大きな変更を加えることを防げます。

階層的な CLAUDE.md

プロジェクトルートだけでなく、サブディレクトリにも CLAUDE.md を置けます:

project/
├── CLAUDE.md          # プロジェクト全体のルール
├── src/
│   ├── CLAUDE.md      # src/ 以下のコーディング規約
│   └── components/
│       └── CLAUDE.md  # コンポーネント固有の規約

CLAUDE.md をメンテナンスする

更新のタイミング

• 新しいパターンを発見したとき
• AIが繰り返し同じミスをするとき（禁止事項に追加）
• 技術スタックが変わったとき

レビューの仕方

月に一度、CLAUDE.md を見直して:

1. 守られていないルールを強化
2. 不要になったルールを削除
3. 新しいプラクティスを追加

CLAUDE.md の限界

CLAUDE.md はすべての会話でリセットされません が、会話が長くなると初期の内容が薄れることがあります。重要なルールは会話の最初に再確認するか、プロンプトに含めることをおすすめします。

まとめ

CLAUDE.md は「AIとの作業契約書」です。最初に時間をかけて丁寧に書いておくと、プロジェクト全体を通じて一貫したコーディングが実現できます。

→ CLAUDE.md 自動生成プロンプトを使う