AnthropicのAIエージェント「Claude Code」を使いこなす上で最重要となる設定ファイル「CLAUDE.md」の役割と活用法を解説する動画です。通常のWeb版チャットAIとは異なり、ターミナルで動くAIエージェントの真価を発揮させるには、適切な指示書を適切な場所に配置することが不可欠です。初心者から中級者向けに、具体的な書き方や管理のコツを網羅しています。

背景

Claude Codeは高度なAIエージェントですが、セッションごとに記憶をリセットして出社してくる「超天才だが物忘れの激しい新人」のような特性を持っています。そのため、作業のルールや前提条件を「引き継ぎメモ」として残しておく必要があります。前回の講座で解説された「フォルダ階層の設計」を土台とし、今回はその各階層にどのような指示（CLAUDE.md）を置くべきか、またAIの作業机であるコンテキストウィンドウを圧迫せずに効率よく指示を伝えるためのテクニックが解説されています。

この動画の要点

1. CLAUDE.mdはAIへの「引き継ぎメモ」であり、セッション開始時に必ず読み込まれる指示書です。管理ポリシー、ユーザー、プロジェクト、ローカルの4つの階層に設置でき、実行場所に物理的に近いファイルほど優先的に適用されます。これにより、プロジェクトごとの固有ルールや全案件共通の基本ルールを柔軟に使い分けることが可能になります。

2. 指示を「太らせない」ことが性能維持の秘訣です。公式の目安は1ファイル200行以内。内容が長すぎると重要な指示が埋もれて無視される原因になります。また、AIが自動で学習する「自動メモリ」とは異なり、CLAUDE.mdはユーザーが能動的に制御するルールとして機能するため、役割を明確に分担させることが重要です。

3. 「paths」設定を活用することで、特定のファイル形式（例：.pptxや.png）を操作する時だけ特定のルールを発動させる「条件付きロード」が可能です。これにより、不要な情報を常に読み込ませることなく、必要な時だけ指示を有効にでき、AIの処理能力（コンテキストウィンドウ）を節約しながら精度を高めることができます。

なぜ重要か

CLAUDE.mdの運用は、単なるプロンプトエンジニアリングを超えた「AIとの組織的な協業設計」と言えます。動画内で語られている「1回やらかすごとに1行足す」という育て方や、理由（Why）と制定日を記す管理手法は、AIを一時的なツールではなく、長期的なパートナーとして育成する視点を示唆しています。特に「paths」による情報の動的制御は、大規模なプロジェクトになればなるほど、AIの「注意力の散漫」を防ぐための必須テクニックとなるでしょう。また、/doctorコマンドなどの診断機能を活用し、定期的に指示書の健康状態をチェックする運用も実用的です。

こんな人におすすめ

Claude Codeを導入したものの、AIが同じ間違いを繰り返したり、指示通りに動かなかったりすることに悩んでいる開発者やビジネスパーソン。CLAUDE.mdの適切な配置と記述法を学ぶことで、AIエージェントの精度を劇的に向上させたい人に最適です。