AI Dev Guide
Claude Code 設定

CLAUDE.md の書き方

プロジェクトのルールや慣習を AI に伝える設定ファイル CLAUDE.md の効果的な書き方を解説します

CLAUDE.md とは？

CLAUDE.md は、Claude Code がプロジェクトのコンテキストを理解するための設定ファイルです。プロジェクトのルート（または .claude/ 内）に置くと、会話開始時に自動的に読み込まれます。

これは AI への「申し送り事項」のようなものです。人間のチームメンバーに引き継ぎドキュメントを書くのと同じ感覚で書けます。

なぜ重要なのか

CLAUDE.md がないと、AI は毎回ゼロからプロジェクトを理解しようとします。結果:

  • 既存の規約と違うコードスタイルで書いてしまう
  • 不要な依存パッケージを追加してしまう
  • プロジェクト固有の制約を無視してしまう

CLAUDE.md があれば、これらを防げます。

基本構成

# プロジェクト名

## 技術スタック
- フレームワーク: React + Vite
- スタイル: Tailwind CSS
- 言語: TypeScript

## コーディング規約
- 関数コンポーネントのみ使用（クラスコンポーネント不可）
- CSS-in-JS は使わない
- ファイル名はケバブケース（例: user-profile.tsx）

## プロジェクト構造
src/
  components/  # 共通コンポーネント
  pages/       # ページコンポーネント
  hooks/       # カスタムフック
  utils/       # ユーティリティ関数

## やらないこと
- console.log を残さない
- any 型を使わない
- 不要なコメントを追加しない

効果的な CLAUDE.md のコツ

1. 「やること」より「やらないこと」を書く

AI は頼まれると何でもやろうとします。制限を明記する方が効果的です。

## 禁止事項
- テストファイルにモックを使わない（実 DB に接続する）
- エラーハンドリングを過剰に追加しない
- 頼まれていないリファクタをしない

2. 「なぜ」を添える

ルールだけでなく理由を書くと、AI がエッジケースでも適切に判断できます。

## ルール
- dayjs ではなく date-fns を使う（チームで統一済み、バンドルサイズ削減のため）

3. 配置場所を使い分ける

ファイル用途
~/.claude/CLAUDE.md個人設定（全プロジェクト共通）
プロジェクト/CLAUDE.mdプロジェクト固有のルール
プロジェクト/.claude/rules/*.md条件付きルール

4. 短く保つ

長すぎると AI が重要な部分を見落とします。A4 1枚程度が目安。本当に伝えたいことだけ書きましょう。

次のステップ