CLAUDE.mdは、Claudeがプロジェクトをどう理解するかを決める1つのファイルです。適切に書かれていれば、修正が減り、コードの質が上がり、エージェントが自分の作業対象を正しく把握します。
このガイドでは、CLAUDE.mdファイルのすべてのセクションを解説します。技術スタックの宣言からエージェント固有のヒントまで、順を追って作成していきましょう。
CLAUDE.mdは、プロジェクトのルートに配置するMarkdownファイルです。Claude Codeがセッションを開始すると、最初にこのファイルを読み込みます。技術スタック、ファイル構成、チームの規約、すべてのエージェントに従わせたい指示など、ファイル内のすべてがClaudeのコンテキストになります。
ブリーフィング資料のようなものです。これがなければ、Claudeはプロジェクトの構成を推測するしかありません。良いCLAUDE.mdがあれば、Claudeは各ファイルの場所、従うべきパターン、避けるべきことをすでに理解しています。出力品質の差は大きいです。
“CLAUDE.mdに10分投資すれば、プロジェクトのパターンに合わないAI生成コードを修正する何時間もの作業を節約できます。”
数百のClaude Codeプロジェクトでの観察結果
CLAUDE.mdの構成と具体性が、Claudeのコードベースでのパフォーマンスに直接影響します。
適切に構成されたCLAUDE.mdは、この6つの領域をカバーします。それぞれがClaudeにすぐに活用できる具体的な情報を与えます。
フレームワーク、ライブラリ、そのバージョンを明示的に記載します。パッケージマネージャ、Nodeバージョン、ランタイム要件も含めます。Claudeはこれを使って推測なしに互換性のあるコードを生成します。
主要ディレクトリと各ディレクトリの内容を説明します。コンポーネント、ストア、サービス、APIルート、型定義。フォルダごとに1行の説明を付けた短いツリー図が効果的です。
命名パターン（ファイルはcamelCase、コンポーネントはPascalCase）、エラーハンドリングの方針、import順序、プロジェクト固有のルールを文書化します。これにより、Claudeの出力が既存コードと一貫性を保ちます。
dev、build、test、lintコマンドを含めます。Claudeが動作確認やスクリプト提案をする際に、プロジェクトが期待する正確なコマンドを使用します。
複数のエージェント（QA、フロントエンド、バックエンド、DevOps）を使用する場合、各ロールが何に集中すべきかを記述するセクションを追加します。AgentsRoomのマルチエージェント構成で特に有用です。
Claudeにやってはいけないことを伝えます。設定ファイルを変更しない、認証システムを変更しない、データベース層をリファクタリングしない。明示的な境界線が、エージェントによる意図しない変更を防ぎます。
一度にすべてを書く必要はありません。基本から始めて、Claudeが知るべき情報を発見するたびに拡張していきましょう。
package.jsonを開き、プロジェクトが使用するすべてのフレームワーク、ライブラリ、ツールをリストアップします。バージョンをメモし、ランタイム要件（Nodeバージョン、Pythonバージョン、データベース）を確認します。これが技術スタックセクションになります。
package.json + ランタイムバージョン + データベース
srcディレクトリのツリーを簡単に表示します。トップレベルのフォルダを特定し、それぞれに1行の説明を書きます。コンポーネント、ストア、サービス、型定義、APIルートの場所に注目します。
目的の注釈付きsrc/ツリー
既存のコードを見て、パターンをメモします。ファイルの命名方法、エラーの処理方法、importの構成方法、デフォルトエクスポートと名前付きエクスポートのどちらを使うか。これらを短いルールとして書き出します。
命名、import、エラーハンドリング、エクスポート
専門エージェントと作業する場合、各ロールのフォーカス領域を追加します。フロントエンドエージェントにはコンポーネントライブラリを、DevOpsエージェントにはデプロイパイプラインを、QAエージェントにはテストフレームワークを知らせましょう。
ロールごとのフォーカス領域 + 避けるべき領域
AgentsRoomはCLAUDE.mdを後付けではなく、中心的な概念として構築されています。
AgentsRoom内でシンタックスハイライトとライブ保存機能付きのCLAUDE.mdを直接編集できます。テキストエディタやIDEに切り替える必要はありません。
各エージェントがCLAUDE.mdをどう解釈しているかをリアルタイムで確認できます。ターミナル出力を見て、エージェントが規約に従い、避けるべき領域を守っているか確認しましょう。
AgentsRoomの各プロジェクトには独自のCLAUDE.mdがあります。プロジェクトを切り替えると、各エージェントがそのコードベース用の正しいコンテキストファイルを自動的に読み込みます。
AgentsRoomの14のエージェントロールはCLAUDE.mdのセクションと直接連動します。ロールごとにフォーカス領域と避けるべき領域を定義すれば、各エージェントが自分向けの指示だけを取得します。
AgentsRoomをダウンロードして、内蔵のCLAUDE.mdエディタでエージェントに必要なコンテキストを与えましょう。良い指示が、良いコードにつながります。
AgentsRoomをダウンロード永久無料 · 自分のAPI keyを使用