CLAUDE.mdの書き方｜初心者向け設定とサンプル

Claude Codeを使い始めると、「毎回、使う技術やコードの書き方を説明している」と感じることがあります。そんなときに役立つのが`CLAUDE.md`です。ただし、ルールを長く書き足すほど便利になるわけではありません。ここでは、初めての小さな開発プロジェクトを例に、必要な情報だけを整理する方法を解説します。

CLAUDE.mdとは？設定ファイルとの違い

`CLAUDE.md`は、Claude Codeへ渡す継続的な作業指示をMarkdownで記録するファイルです。プロジェクトで使うコマンド、コーディングの方針、作業前の確認事項などを伝えられます。

ただし、`CLAUDE.md`の文章は強制力のあるセキュリティ設定ではありません。実行の許可・禁止を確実に制御したい場合は、Claude Codeの権限設定やフックなど、目的に応じた仕組みを使います。

置くもの	向いている内容	具体例
CLAUDE.md	毎回の作業に関わる指示	使用言語、テストコマンド、変更前の確認
settings.json	ツールの権限や動作設定	許可・確認・拒否ルールなど
Skills	必要なときだけ使う詳しい手順	リリース手順や定型レビュー

最初からすべての設定を理解する必要はありません。まずは「同じ説明を繰り返さずに済む情報」を選ぶのが出発点です。

保存場所と始め方を確認する

プロジェクト全体のルールは、作業フォルダーの直下に`CLAUDE.md`を作成する方法が基本です。`.claude/CLAUDE.md`もプロジェクト用の配置先です。個人の全プロジェクトに共通する指示には`~/.claude/CLAUDE.md`を使います。

VS Codeなどのエディターで、Claude Codeを使うプロジェクトを開く。
既存の`CLAUDE.md`がないか先に確認する。
まだファイルがなければ、プロジェクトのルートに`CLAUDE.md`を作る。
使う技術と作業時の注意事項を、短い文章で記入する。
Claude Codeの`/context`で読み込まれたメモリーファイルを確認する。

Claude Codeで`/init`を実行して初期案を作成する方法もあります。既存ファイルがある場合は、内容を確認してから必要な部分だけ調整してください。

まず記載したい5つの項目

プロジェクトの目的：何を作るリポジトリなのか。
技術スタック：使っている言語・フレームワーク。
実行・検証コマンド：開発サーバーやテストの起動方法。
変更方針：既存仕様を優先するか、最小限の差分を目指すか。
完了報告：変更したファイルと実行した検証をどう共有するか。

例として、JavaScriptで小規模なWebページを作るプロジェクトなら、次のように書けます。これは独自に作成した学習用サンプルです。実際のプロジェクトに合わせて編集してください。

# このプロジェクトのルール
- 小さなJavaScript製Webページを扱う。
- 変更前に関連ファイルを検索し、対象を特定する。
- 既存の表示や仕様を尊重し、差分を最小限にする。
- 修正後は利用できるテストと画面表示を確認する。
- 完了時は変更ファイル、確認結果、未確認項目を簡潔に報告する。

ここで大切なのは行数ではなく、必要な情報を具体的に伝えることです。たとえばテスト手順があるなら「テストする」よりも、実際のコマンドを記載するほうが役立ちます。

長いCLAUDE.mdを避けるための整理方法

`CLAUDE.md`はセッション開始時のコンテキストに読み込まれます。公式資料では、具体的で簡潔な説明を推奨し、1ファイル200行未満を目安にしています。ただし、これは成果を保証する魔法の上限ではありません。

残す情報	別に管理する情報
毎回使うテストコマンド	月に一度だけ行う公開手順
必須のコード規約	一般的な言語の基礎解説
重要なディレクトリの役割	不要になった過去の議論全文