Home / Glossary / CLAUDE.md

Definition

CLAUDE.md

CLAUDE.mdはプロジェクトのルートに置くMarkdown設定ファイルで、Claude Codeに永続的なプロジェクト固有の指示を提供します。コーディング規約・アーキテクチャ・よく使うコマンド・ルールをエージェントに伝え、そのプロジェクトのすべてのセッションに適用される長期的なメモリとして機能します。

CLAUDE.mdの仕組み

Claude Codeがセッションを開始すると、プロジェクトのルート（および親ディレクトリやサブディレクトリ）にあるCLAUDE.mdファイルを自動的に読み込みます。その内容がエージェントのシステムコンテキストの一部となるため、毎回指示をリマインドしなくても指示に従います。これにより、エージェントがチームの規約に一貫して従うようになります。

CLAUDE.mdに含めるべき内容

  • +プロジェクトのアーキテクチャ概要と主要なファイルの場所
  • +コーディング規約（命名・フォーマット・使用すべきまたは避けるべきパターン）
  • +テスト・ビルド・デプロイのよく使うコマンド
  • +「新しい関数には必ずテストを書く」や「認証モジュールを直接変更しない」などのルール
  • +エージェントが認識しておくべき技術スタックの詳細
markdown
# CLAUDE.md

## プロジェクト
Next.js 14アプリ（App Router）、TypeScript、Tailwind CSS。

## コマンド
- `npm run dev` — 開発サーバーを起動
- `npm test` — Jestテストを実行
- `npm run lint` — ESLintチェック

## 規約
- デフォルトでサーバーコンポーネントを使用
- クライアントコンポーネントは`components/client/`に配置
- すべてのAPIルートはZodで入力をバリデーション
- 新しいユーティリティ関数にはテストを書く

## 禁止事項
- 明示的な承認なしに`lib/core/`内のファイルを変更しない
- TypeScriptで`any`型を使用しない
- 理由なく新しい依存関係を追加しない

CLAUDE.mdは簡潔に保ちましょう。エージェントはセッションごとに読み込むため、複数のタスクに関連する情報だけを含めてください。タスク固有の詳細はプロンプトに記述しましょう。

CLAUDE.mdはどこに置けばいいですか？+
プロジェクトのルートディレクトリに置いてください。Claude Codeはモジュール固有の指示用にサブディレクトリのCLAUDE.md、組織全体のルール用に親ディレクトリのCLAUDE.mdもサポートしています。適用されるすべてのファイルがマージされます。
CLAUDE.mdは他のAIツールでも使えますか？+
CLAUDE.mdはClaude Code専用です。ただし、他のツールでも同様のコンセプトが採用されています。Cursorは.cursorrulesを使い、他のエージェントもカスタム設定ファイルを読み込む場合があります。プロジェクトレベルのAI指示というコンセプトは一般的なパターンになりつつあります。
CLAUDE.mdはどのくらいの長さが適切ですか？+
500行以内に収めましょう。最も重要な規約とルールに絞ってください。エージェントは詳細は個々のファイルから読み込めます。CLAUDE.mdはタスク全体に共通する高レベルのコンテキストを提供するものです。

Related terms

エージェンティック・コーディングClaude Codeコード向けプロンプトエンジニアリング

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS