CLAUDE.mdとは何か：AIに自分のルールを教える仕組み

結論

CLAUDE.mdは、Claude Codeに自分のルールを教えるためのファイルです。一度作成すると、毎回同じ指示が適用されます。AIにどう振る舞ってほしいかを明確に伝えたいときは、このファイルを作成しましょう。使わないと、AIが予期せぬ行動を取る可能性があります。

CLAUDE.mdファイルの役割

CLAUDE.mdは、Claude Codeにプロジェクトごとの恒久的な指示を与えるためのファイルです。このファイルを用意すると、AIがそのプロジェクトに関連するタスクを行う際に、指定したルールやワークフローに従って動作します。

このファイルはテキスト形式で作成し、Markdownの構文を使って記述します。Claude Codeはこのファイルを読み込み、各セッションの開始時に適用されます。

CLAUDE.mdファイルの配置場所

CLAUDE.mdファイルは、いくつかの場所に配置できます。それぞれの配置場所によって、適用される範囲が異なります。

• ユーザーごとの指示：ホームディレクトリ内の~/.claude/CLAUDE.md
• プロジェクトごとの指示：プロジェクトフォルダ内に./CLAUDE.mdまたは./.claude/CLAUDE.md
• ローカルな指示：./CLAUDE.local.md

配置場所によって、Claude Codeが適用する範囲が決まります。設定したい指示のスコープをよく考えてファイルを配置してください。

CLAUDE.mdファイルを作成する手順

CLAUDE.mdファイルを作成するには、まずプロジェクトの構造に合わせた初期ファイルを生成します。Claude Codeに「/init」と入力すると、自動で初期ファイルが作成されます。

このファイルは簡潔に記述することが重要です。それぞれの行について、「これを削除したらClaude Codeが誤った行動を取るか？」という質問を投げかけてください。冗長なファイルは、AIが実際の指示を見落とす原因になります。

学習上の注意

CLAUDE.mdファイルは、AIに指示を与えるためのものです。しかし、このファイルだけでは十分ではありません。AIが正しい行動を取るよう、テストやビルド、スクリーンショットなどを用いて確認する必要があります。

また、Claude Codeは予期せぬエッジケースに対応できない場合があります。そのような場合は、必ず検証（テストやスクリーンショット）を行い、問題がないことを確認してください。