CLAUDE.mdの概念と使い方
下級プロジェクトの指示書「CLAUDE.md」の役割と、効果的な書き方を学びます。
座学
この講座で学べること
- ✓CLAUDE.mdがプロジェクトの指示書ファイルであり起動時に自動読み込みされることを理解する
- ✓書くべき4つの項目（概要・技術スタック・コーディングルール・注意事項）を把握する
- ✓プロジェクト単位とグローバル（~/.claude/CLAUDE.md）の2種類の使い分けを知る
- ✓100行以内に収めることが効果を維持するコツであることを理解する
CLAUDE.md は、Claude Code にプロジェクトのルールや背景知識を伝えるための「指示書ファイル」です。プロジェクトのルートフォルダに置くと、Claude Code が起動時に自動で読み込みます。 CLAUDE.md がない状態では、Claude Code は毎回「このプロジェクトはどんなプロジェクトですか？」という状況から始まります。CLAUDE.md を用意することで、毎回説明する手間がなくなり、プロジェクト固有のルールに沿った回答が得られるようになります。
CLAUDE.md に書くべき内容は大きく4つです。 ① プロジェクト概要 — 何を作っているか、誰のためか ② 技術スタック — 使っている言語・フレームワーク・ライブラリのバージョン ③ コーディングルール — 命名規則・コメントの言語・フォーマットのルール ④ 注意事項 — やってはいけないこと・セキュリティ上の制約など すべて書く必要はありません。Claudeに覚えておいてほしいことだけをシンプルに箇条書きで書けば十分です。
CLAUDE.md は階層構造にも対応しています。プロジェクトのルート以外にも、サブフォルダごとに CLAUDE.md を置くことができ、Claude Code はそのフォルダの CLAUDE.md を優先して参照します。 また、~/.claude/CLAUDE.md（グローバル設定）にすべてのプロジェクト共通のルールを書くこともできます。例えば「常に日本語でコメントを書く」などの個人的なルールはグローバル設定に書くと便利です。
実践手順
ステップ1：ターミナルを開いてプロジェクトフォルダへ移動する
お使いの OS タブを選んでターミナルを起動し、プロジェクトフォルダへ移動してください。
Windows（PowerShell）
1. PowerShell を起動する
スタートメニューで「powershell」と検索し、「Windows PowerShell」をクリックして起動してください。
2. プロジェクトフォルダへ移動する
以下のコマンドでプロジェクトフォルダへ移動してください。パスはご自身の環境に合わせて変更してください。
powershellcd C:\Users\your-username\your-project
ステップ2：CLAUDE.md ファイルを作成する
お使いの OS タブを選んで、プロジェクトフォルダに CLAUDE.md を新規作成してください。
Windows（PowerShell）
CLAUDE.md を新規作成する
PowerShell でプロジェクトフォルダに移動したあと、以下のコマンドで空の CLAUDE.md を作成してください。
New-Item -Name CLAUDE.md -ItemType FileVS Code で開く
code CLAUDE.mdVS Code がインストールされていない場合は、エクスプローラーから直接ファイルをダブルクリックしてメモ帳などで開いても構いません。
ステップ3：基本的な内容を書く
VS Code やテキストエディタで CLAUDE.md を開き、以下の内容を参考に自分のプロジェクトに合わせて書いてみてください。
# プロジェクト名
## 概要
このプロジェクトは〇〇のためのアプリです。
## 技術スタック
- フロントエンド：Next.js 15
- 言語：TypeScript
## コーディングルール
- コメントは日本語で書く
- 変数名・関数名は英語（キャメルケース）ステップ4：Claude Code を起動して読み込みを確認する
Claude Code を起動し、「現在のプロジェクトのルールを教えてください」と質問してみましょう。CLAUDE.md の内容を踏まえて回答が返ってくれば成功です。
claude確認チェック
講座を終える前に、以下の項目を確認しましょう。