CLAUDE.mdとは
CLAUDE.mdはClaude Codeに毎回自動で読み込まれる「指示書」です。一度書いておけば、セッションの度に同じ説明をしなくて済みます。この記事では置き場所・作り方・書くべき内容をサンプルつきで解説します。
置き場所の選び方
全プロジェクト共通~/claude/CLAUDE.md
どのプロジェクトでも常に読み込まれる。
「日本語で回答する」など全体に適用したいルールを書く。
プロジェクト専用~/claude/projects/CLAUDE.md
そのプロジェクトを開いたときだけ読み込まれる。技術スタックや固有のルールを書く。
複数のプロジェクトを管理している場合は、共通ルールはホームディレクトリ、プロジェクト固有のルールは各フォルダ、と分けて管理するのがおすすめです。
作り方
方法①：/init コマンドで自動生成
Claude Codeを起動した状態で /init と入力すると、プロジェクトの内容を自動で読み取り、CLAUDE.mdを生成してくれます。自動生成してから不要な部分を削除・修正するのが手軽です。
# Claude Codeのセッション内で入力 /init
💡 自動生成後は必ず内容を確認しましょう。不要な記述が含まれていることがあるので、短く・必要なことだけ書く、がベストです。
方法②：「CLAUDE.mdに書き込んで」と指示する
Claude Codeのチャット欄で「CLAUDE.mdに〇〇というルールを追加して」と日本語で指示するだけでも、ファイルを作成・編集してくれます。
方法③：手動でファイルを作成する
プロジェクトのルートフォルダに CLAUDE.md という名前でファイルを作り、テキストエディタで直接書き込む方法です。次のセクションのサンプルをそのままコピーして使えます
書くべき内容とサンプル
CLAUDE.mdに書く内容は大きく4つのカテゴリに分けると整理しやすいです。
① ユーザーの説明
自分がエンジニアか非エンジニアか、どのくらいの知識レベルかを書いておくと、回答の難易度などをClaude Codeが調整してくれます。
② コードに関するルール
「コメントは日本語で書く」「なるべくシンプルなコードにする」「既存のコードを許可なく変更しない」など、コーディングスタイルのルールを書きます。
③ エラー対応のルール
エラーが起きたときにどう対応して欲しいかを書きます。「原因を先に説明してから修正する」「一度に大量の変更をしない」などが効果的です。
④ プロジェクトの概要・やりたいこと
「業務の自動化ツールを作りたい」など、背景情報を書いておくと的外れな提案が減ります。
以下は非エンジニア向けのシンプルなサンプルです。そのままコピーして使えます。
# ユーザーについて
- 非エンジニアのため、専門用語は使わず平易な言葉で説明すること
- 回答は必ず日本語で行うこと
# 行動ルール（最重要）
- 明示的に指示されていないファイルは変更しないこと
- 変更を加える前に、何をするか必ず説明してから作業すること
- 不明な点があれば、作業を始める前に質問すること
- 一度に大量の変更をせず、小さな単位で確認しながら進めること
# コードのルール
- コメントは日本語で書くこと
- なるべくシンプルで読みやすいコードにすること
# エラー対応
- エラーが発生したら、まず原因を説明してから修正案を提示すること
- 複数の対処法がある場合はそれぞれのメリット・デメリットを説明すること
# プロジェクト概要
- 業務の自動化ツール作成
よくある質問（FAQ）
Q. CLAUDE.mdはどのくらいの長さが理想ですか？
公式では500行以内が推奨されています。実際には100〜200行程度に収めるのが精度・速度ともにバランスが良いとされています。「短いほど良い」を意識して、本当に必要なルールだけを書くようにしましょう。
Q. CLAUDE.mdを複数作ることはできますか？
できます。ホームディレクトリの共通ファイルとプロジェクト内の専用ファイルは同時に読み込まれます。共通ルールと個別ルールを分けて管理するのがおすすめです。
Q. 書いたルールが守られない場合はどうすればいいですか？
CLAUDE.mdの内容が多すぎると、重要な指示が無視されることがあります。まずファイルを見直して、不要な記述を削除してみてください。また、特に重要なルールは「最重要」などの言葉で強調すると効果的です。
Q. CLAUDE.mdはいつ更新すればいいですか？
プロジェクトの構成が変わったときや、Claude Codeに繰り返し同じ指示をしていると気づいたときが更新のサインです。「毎回これを説明しているな」と思ったらCLAUDE.mdに追記しましょう。
