CLAUDE.mdとは

Claude Codeがプロジェクトの規約・構成・注意点を把握するために自動で読み込む、リポジトリ直下に置くMarkdown形式の指示ファイル

ひとことで言うと

そのプロジェクト固有のルールや注意点をAIエージェントに伝えるためのメモ書きファイル。

概要

CLAUDE.mdは、AnthropicのClaude Codeがセッション開始時に自動的に読み込む、リポジトリ直下(または上位ディレクトリ、ユーザーのホーム配下)に置くMarkdown形式の指示ファイル。 ビルド・テストコマンド、コーディング規約、ディレクトリ構成、注意すべき既知の落とし穴など、そのプロジェクト固有の文脈をあらかじめ記述しておくことで、Claudeが毎回コードベースを探索し直さずに作業を始められるようにする。 プロジェクト全体で共有する内容はリポジトリにコミットし、個人設定は別ファイルに分けて管理する運用が一般的。

背景

コーディングエージェントは会話ごとにコードベースの前提知識を持たない状態から作業を始めるため、都度同じ説明を繰り返す非効率が生じていた。CLAUDE.mdは、その前提知識をファイルとして永続化し、セッションをまたいで再利用する目的で導入された。

歴史

2025年: AnthropicがClaude Codeの一部として、プロジェクト固有の指示を記述する「CLAUDE.md」規約を導入。

利点

• プロジェクト固有の規約や注意点を毎回説明し直す手間が省ける
• リポジトリにコミットすることでチーム全体がAIエージェントへの指示を共有できる

欠点

• 内容が古くなったり肥大化したりすると、かえって誤った前提をAIに与える
• Claude Code固有の仕組みであり、他ベンダーのツールとは形式が異なる(例: AGENTS.md)

比較

• AGENTS.md — AGENTS.mdが複数のAIコーディングツール間で共通利用できる形式を目指すのに対し、CLAUDE.mdはClaude Code専用の指示ファイル

関連用語

よくある質問

参考文献

• DocumentationHow Claude remembers your project - Claude Code Docs