「Claude Codeで個人開発を始める」最初のCLAUDE.mdの書き方
Claude Code は、セッションを始めるたびに CLAUDE.md というファイルを読みます。ここに何を書くかで、毎回の説明の手間も、作業のぶれも変わります。最初の1枚の作り方と、育て方をまとめました。

CLAUDE.md は「毎回最初に渡す作業メモ」
Claude Code(ターミナルやエディタで動く、Anthropic のコーディング用 AI)は、会話が終わると前のやり取りを覚えていません。新しいセッションを開くたびに、「ビルドは npm run build で」「コミットは日本語で」と同じ説明を繰り返すことになります。
この繰り返しを減らすのが CLAUDE.md です。プロジェクトに置いた Markdown ファイルで、Claude はセッションの最初に必ずこれを読みます。
公式ドキュメントは、CLAUDE.md を「強制される設定ではなく、文脈(コンテキスト)」と説明しています。書いたことが機械的に守られる仕組みではありません。具体的で短い指示ほど、よく守られます。この性質を知っておくと、何を書くべきかが決めやすくなります。
置き場所は4種類。個人開発ならまずプロジェクト直下
CLAUDE.md は置く場所によって、読まれる範囲が変わります。公式ドキュメントの整理はこうです。
| 種類 | 置き場所 | 対象 |
|---|---|---|
| 組織の方針 | OS ごとの決まった場所(Windows なら C:\Program Files\ClaudeCode\CLAUDE.md) | 組織の全員 |
| ユーザー | ~/.claude/CLAUDE.md | 自分の、すべてのプロジェクト |
| プロジェクト | ./CLAUDE.md または ./.claude/CLAUDE.md | Git で共有する全員 |
| ローカル | ./CLAUDE.local.md(.gitignore に入れる) | 自分だけ、このプロジェクトだけ |
出典:Claude Code ドキュメント「Memory」(2026年11月14日に確認)
Claude は作業しているフォルダから上の階層へさかのぼって CLAUDE.md を探し、見つかったものを全部つなげて読みます。作業フォルダに近いファイルほど後に読まれます。
ひとりで作っているなら、最初はプロジェクト直下の CLAUDE.md だけで十分です。「返事は日本語で」のように、どのプロジェクトでも共通の好みが出てきたら、ユーザー用の ~/.claude/CLAUDE.md に移します。
最初の1枚は /init で作って、削る
白紙から書く必要はありません。Claude Code で /init と打つと、Claude がコードを調べて、ビルドやテストのコマンド、見つけた決まりごとを書いた CLAUDE.md の下書きを作ります。すでに CLAUDE.md があるときは、上書きせずに改善案を出します。
下書きができたら、次の3つを自分で足します。コードを読んでも分からないことは、Claude には推測できないからです。
- このプロジェクトは何か誰のための何で、どこに公開しているか。2〜3行で。
- やってほしくないこと「main に直接 push しない」「秘密の値をログに出さない」など。
- 自分の好みコミットメッセージの言語、説明の詳しさ、使ってほしいコマンド。
反対に、下書きのうち「当たり前のこと」「コードを見れば分かること」は消します。公式ドキュメントは CLAUDE.md 1ファイルあたり200行未満を目安にしていて、長いほど文脈を圧迫し、守られにくくなると書いています。
書くこと、書かないこと
具体的に書く
公式ドキュメントが挙げている例が分かりやすいので、そのまま紹介します。「コードをきれいに整える」ではなく「インデントはスペース2つ」。「変更を確かめる」ではなく「コミットの前に npm test を実行する」。人に頼むときと同じで、解釈の余地がある指示ほど結果がぶれます。
- きれいなコードを書く
- テストをしっかりする
- 安全に作業する
- インデントはスペース2つ。セミコロンは付けない
- src/ を変えたら npm test を実行し、通ってからコミットする
- .env と dezign-mailer-config.php の中身は表示しない・Git に入れない
CLAUDE.md 以外に置いたほうがいいもの
なんでも CLAUDE.md に書くと、すぐ長くなります。公式ドキュメントは、内容によって置き場所を分けるよう勧めています。
| 内容 | 置き場所 | 理由 |
|---|---|---|
| 何手順もある作業 | skill | 必要なときだけ読み込まれる |
| 一部のフォルダだけの決まり | .claude/rules/ に paths 付きで | そのフォルダのファイルを読んだときだけ読み込まれる |
| 毎回必ず実行したい処理 | hook | CLAUDE.md は「お願い」だが、hook は確実に実行される |
| 長い資料 | 別ファイルにして @docs/xxx.md で読み込む | CLAUDE.md 本体を短く保てる |
最後の @ での読み込みは便利ですが、読み込んだファイルもセッション開始時にまとめて読まれます。文脈の量が減るわけではない、という点は覚えておいてください。
実例:このサイトの CLAUDE.md の骨組み
DE:ZIGN も、Claude Code(とクラウドの定期実行)で記事の取り込みやビルドをしています。リポジトリの CLAUDE.md は、次の見出しで組み立てています。
見出しは、「新しく手伝いに来た人に最初に渡す紙」として読めるかどうかを基準にしています。公式ドキュメントにも、新しいチームメンバーが同じ説明を必要とするなら CLAUDE.md に書く、という目安があります。
記事の書き方のように長いものは、CLAUDE.md には置き場所だけを書き、中身は docs/writing-guide.md に分けています。
書きっぱなしにせず、間違えたら足す
CLAUDE.md は一度で完成させるものではありません。公式ドキュメントが追記のタイミングとして挙げているのは、Claude が同じ間違いを繰り返したとき、コードレビューで「これは知っておいてほしかった」と思ったときです。
追記は自分で書かなくても、「今のことを CLAUDE.md に追加して」と頼めば Claude が書き足します。/memory と打つと、いま読み込まれている CLAUDE.md の一覧が出て、そこから開いて直すこともできます。
もうひとつ忘れがちなのが掃除です。矛盾した指示が2つあると、どちらに従うかは決まっていません。月に1回くらい読み返して、古くなった行や重複を消してください。
CLAUDE.md が育つと、セッションの最初の数分でしていた説明がなくなります。個人開発では、この数分の積み重ねが案外大きいです。
まとめ
- CLAUDE.md は Claude Code が毎回最初に読む作業メモで、強制される設定ではなく文脈として扱われる。
- 個人開発なら、まずプロジェクト直下の CLAUDE.md だけで十分。共通の好みはユーザー用の ~/.claude/CLAUDE.md へ。
- 最初の1枚は /init で下書きを作り、プロジェクトの説明・やってほしくないこと・自分の好みを足す。
- 指示は「インデントはスペース2つ」のように具体的に書き、1ファイル200行未満を目安に短く保つ。
- 長い手順は skill、一部のフォルダだけの決まりは .claude/rules/、必ず実行したい処理は hook に分ける。
- 同じ間違いが起きたら追記し、月に1回くらい読み返して矛盾と古い行を消す。
参考・出典
- Claude Code ドキュメント:How Claude remembers your project(CLAUDE.md) 2026年11月14日確認
- Claude Code ドキュメント:セットアップ(動作環境・利用できるプラン) 2026年11月14日確認
機能や対応プランは確認日の情報です。最新の情報は公式ドキュメントでご確認ください。