Claude Codeに毎回同じプロジェクト説明やコーディング規約を伝えるのが面倒なら、プロジェクト直下の CLAUDE.md にまとめる方法があります。Claude Codeはセッション開始時にこのファイルを読み込むため、構成や実行コマンド、守ってほしい制約を会話ごとに貼り直さずに済みます。
最初は /init で下書きを作り、正しいコマンドと本当に必要なルールだけを残すのが出発点です。この記事では、置き場所、書く内容、短く保つコツ、更新と確認の手順を順番にまとめます。
この記事が向いている人・向いていない人
- 向いている人：Claude Codeを同じリポジトリで繰り返し使い、毎回の説明や同じ間違いを減らしたい人。
- 向いていない人：1回だけ質問したい人や、プロジェクト固有のルールをまだ決めていない人。まずは通常のプロンプトで作業内容を伝えれば十分です。
CLAUDE.mdはプロジェクトへの引き継ぎメモ
CLAUDE.md はMarkdown形式の指示ファイルです。Claude Codeがフォルダを開いてセッションを始めるときに読み込み、プロジェクトの進め方や注意事項を参照します。コードそのものや設定を自動で変更する機能ではなく、Claude Codeに渡す前提情報を整理するためのファイルです。
全プロジェクトに共通する好み、プロジェクト全体の決まり、特定フォルダだけの決まりを分けられます。プロジェクトルートなら ./CLAUDE.md または ./.claude/CLAUDE.md に置けます。プロジェクトを他の人と共有する場合は、チームに必要なファイルをリポジトリへ含めるかを決めてからコミットしてください。
まずは /init で下書きを作る
- ターミナルで対象プロジェクトのルートへ移動します。
- Claude Codeを起動し、
/initを実行します。 - 作成された
CLAUDE.mdを開き、検出された説明やコマンドが正しいか確認します。 - 誤りや不要な記述を直し、チームで共有する内容ならバージョン管理に加えます。
/init は既存ファイルや構成をもとに初稿を作るための機能です。出力内容の正確さを保証するものではありません。実際に存在しないテストコマンドや古い設定が含まれていないか、手元のプロジェクトと照らし合わせます。
CLAUDE.mdに書く内容は5つに絞る
| 項目 | 書く例 | 確認すること |
|---|---|---|
| 実行コマンド | 開発サーバー、ビルド、テスト、lintの起動方法 | 今の設定で実行できるか |
| プロジェクトの概要 | 主要フォルダと役割、構成要素の関係 | ファイル構成と一致するか |
| 実装上の規約 | 命名、エラー処理、配置場所など | チームが実際に守っているか |
| 変えてはいけない条件 | 生成物を直接編集しない、本番データへ書き込まない | 範囲が具体的で誤解しにくいか |
| 既知の注意点 | ローカル環境だけに必要な手順、よくある落とし穴 | 古くなっていないか |
設定ファイルの丸写し、長い変更履歴、コードを読めば分かる説明は、常に読み込む指示としては優先度が低めです。詳細な説明が必要なら、本文に全部詰め込まず別ファイルに分け、必要なときに参照する形を検討します。
短い記述例から始める
# Project
- TypeScript のWebアプリ。画面は src/pages、API処理は src/server に置く。
# Commands
- 開発: npm run dev
- テスト: npm run test
- lint: npm run lint
# Rules
- 既存の公開APIの引数と戻り値を、依頼なしに変更しない。
- 変更した処理に関係するテストを実行する。
- src/generated/ は直接編集しない。
# Done
- 変更内容と実行した確認を最後に短く報告する。これは説明用の例です。実際のコマンドやフォルダ名は、プロジェクトに合わせて置き換えてください。「必要に応じてテストする」のような曖昧な希望より、「変更した処理に関係するテストを実行する」のように、どの場面で何をするかを明記すると確認しやすくなります。
置き場所は全体・プロジェクト・フォルダ単位で使い分ける
~/.claude/CLAUDE.md：すべてのプロジェクトに共通する個人設定。プロジェクトのルート/CLAUDE.md：そのリポジトリの構成、コマンド、チーム規約。サブフォルダ/CLAUDE.md：特定の領域にだけ必要な決まり。対象フォルダをClaude Codeが読むときに参照されます。
まずはプロジェクトルートの1ファイルで始め、実際に別の規約が必要になってから分割すると管理しやすくなります。公開リポジトリへ個人的な指示を混ぜたくない場合は、共有用ファイルと個人用のローカル設定を区別してください。
すでに AGENTS.md を使っている場合は、Claude Codeの対応バージョンやプロジェクト指示の設定も確認してください。現行ドキュメントでは、条件によって AGENTS.md を読み込めます。両形式を併用するなら、どのファイルが読み込まれる設定かを /memory や /context で確認します。
同じ失敗が起きたときに1行ずつ直す
Claude Codeが同じプロジェクト上で同じ間違いを繰り返したら、その原因がプロジェクト固有の決まりにあるかを確かめ、再発防止に必要なルールを追加します。1回の失敗だけで指示を増やすと、例外や一時的な依頼まで恒久ルールにしてしまうことがあります。
規約やテスト手順が変わったときも、該当箇所を更新します。古いコマンドを残すと、Claude Codeが誤った確認を実行する原因になります。定期的に読み返して、使われていない指示を削ることも大切です。
効いているかは /memory と小さな依頼で確かめる
/memoryを実行して、Claude Codeが参照しているメモリファイルを確認します。- 追加したルールが実際のパスにあり、意図した内容になっているか読みます。
- 既存ファイルを変更しない調査依頼など、小さな作業で規約やコマンドの認識を確認します。
- 結果が違ったら、ファイルを読む位置や指示の具体性、競合する記述を見直します。
ファイルに書いた自然文は、権限設定や保護機能そのものではありません。危険な操作を確実に禁止したいときは、指示文だけに頼らず、Claude Codeの権限設定やチームの実行環境も合わせて確認します。権限の設定方法はClaude Codeの許可確認を調整する記事で扱っています。
CLAUDE.mdでよくある失敗
何でも詰め込んで長くなる
セッションごとに読み込む前提情報が増えると、重要な決まりが埋もれやすくなります。まずは作業に直接必要なルールだけ残し、コードベースを読めば分かる事項や履歴は外します。
実在しないコマンドを載せる
/init の提案をそのまま採用せず、package.jsonやREADME、実際の環境で確認します。ビルド・テストのスクリプト名が違うと、確認作業自体が止まります。
お願い文だけで操作を制限する
「本番環境を変更しない」と書くことは有用ですが、ファイル中の文章はアクセス制御の代わりになりません。強制したい操作制限は権限機能で設定し、指示ファイルは前提や手順を伝える目的で使い分けます。
よくある質問
CLAUDE.mdはどのくらいの長さがよい？
Anthropicは、CLAUDE.mdをおおむね200行未満に保つことを目安として案内しています。最初から行数の目標に合わせるより、必要な決まりだけ残し、定期的に不要な記述を削ってください。
ファイルを編集したらすぐ反映される？
通常は次のセッションから反映されます。作業中に変更を反映したい場合は、Claude Codeの現行ドキュメントにあるメモリ再読込手順を確認してください。
CLAUDE.mdに書けば、必ず守られる？
必ずとは限りません。ルールを具体的に書き、/memory で読み込み状態を確認し、重要な禁止事項は権限設定や実行環境でも制御してください。
まとめ：まず /init の草案を点検して短く保つ
Claude Codeの説明を毎回繰り返しているなら、プロジェクトルートで /init を実行し、コマンド、構成、規約、制約、既知の注意点に絞って CLAUDE.md を整えます。生成内容は必ず実際のプロジェクトに照らして修正し、同じ失敗が続いたときに必要な1行を加えましょう。
Claude Code自体をこれから導入する人はWindowsでのインストール方法を、依頼の組み立てに迷う人はAIコーディング指示文のテンプレートを先に確認できます。独学の全体像や講座選びはAIコーディングの学習手順とバイテックGEEKの料金・相談前の確認事項にまとめています。コードや作業画面を含めた環境から整える場合は、AI作業用デスク環境の作り方も参考になります。
