Claude Codeを使いこなす上で不可欠な設定ファイル「CLAUDE.md」について、AI専門家のチャエン氏が解説します。このファイルを設定しないと、通常のWeb版AIチャットと変わらない性能しか発揮できません。AIを「毎朝記憶を失う優秀な社員」に例え、その能力を最大限に引き出すための「引き継ぎメモ」としての役割と具体的な運用方法を学びます。

背景

Claude Codeを利用する際、多くのユーザーが直面するのが「指示の定着」という課題です。AIモデル（Opus 3.5やSonnet 3.5など）はIQ 140を超える天才的な能力を持ちながらも、記憶の保持力が極めて低いという特性があります。そのため、プロジェクト固有のルールや過去の修正内容を記憶させ続ける仕組みが必要です。この課題を解決し、Web版のChatGPTやGeminiといった汎用ツールとの差別化を図る鍵となるのが、プロジェクトディレクトリに配置する「CLAUDE.md」という指示書ファイルです。

この動画の要点

1. CLAUDE.mdは「引き継ぎメモ」：AIは毎朝記憶を失って出社してくる優秀な社員のような存在です。能力は最高ですが、前日に教えたことを覚えていません。そのため、机の上に「引き継ぎメモ」としてCLAUDE.mdを置いておくことで、セッション開始時に必ず指示を読み込ませ、一貫した動作を保証する役割を果たします。

2. 追記のタイミングは「2回目のミス」：1回目の間違いは事故として処理しますが、同じ間違いを2回繰り返された時がCLAUDE.mdに書き足す合図です。AIがルールを学習できていない証拠なので、そのタイミングで明文化します。これにより、場当たり的な修正ではなく、恒久的な指示としてAIの挙動を改善していくことが可能です。

3. 公式の目安は1ファイル200行以内：指示書を長くしすぎないことが重要です。公式の推奨は1ファイル200行以内で、これを超えるとAIの遵守率が下がってしまいます。また、「日本語で出力」と「英語で出力」のような矛盾する指示を混ぜないことも、AIを混乱させず正確に動作させるための鉄則として挙げられています。

なぜ重要か

CLAUDE.mdの運用は、単なる設定作業ではなく「AIとの協業プロトコル」の構築と言えます。動画内で語られている「AIは記憶を失う」という前提に立つことで、ユーザー側が何をすべきかが明確になります。特に「2回目のミスで追記する」という具体的な運用ルールは、開発効率を落とさずに指示書を洗練させるための非常に実践的なアドバイスです。また、`/context`コマンドで現状を把握し、AI自身に「MDファイルを作りたい」と相談しながら進める手法は、初心者にとってもハードルを下げつつ、AIの真価を引き出す最短ルートを示しています。この「指示書で決まる」という視点は、今後のAIツール活用全般において重要な示唆を含んでいます。

こんな人におすすめ

Claude Codeを導入したものの、期待通りの挙動にならず悩んでいる開発者や、AIへの指示出しを効率化したい人。CLAUDE.mdの具体的な役割や運用のタイミングを知りたい初心者に最適です。