「Claude Codeで個人開発を始める」最初のCLAUDE.mdの書き方

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

CLAUDE.md は「毎回最初に渡す作業メモ」

Claude Code(ターミナルやエディタで動く、Anthropic のコーディング用 AI)は、会話が終わると前のやり取りを覚えていません。新しいセッションを開くたびに、「ビルドは npm run build で」「コミットは日本語で」と同じ説明を繰り返すことになります。

この繰り返しを減らすのが CLAUDE.md です。プロジェクトに置いた Markdown ファイルで、Claude はセッションの最初に必ずこれを読みます。

公式ドキュメントは、CLAUDE.md を「強制される設定ではなく、文脈(コンテキスト)」と説明しています。書いたことが機械的に守られる仕組みではありません。具体的で短い指示ほど、よく守られます。この性質を知っておくと、何を書くべきかが決めやすくなります。

📌 使える人
Claude Code を使うには、Claude の Pro・Max・Team・Enterprise のいずれかのプラン、または API 用の Console アカウントが必要です。無料プランには含まれていません(2026年11月時点、公式のセットアップページより)。

置き場所は4種類。個人開発ならまずプロジェクト直下

CLAUDE.md は置く場所によって、読まれる範囲が変わります。公式ドキュメントの整理はこうです。

種類置き場所対象
組織の方針OS ごとの決まった場所(Windows なら C:\Program Files\ClaudeCode\CLAUDE.md)組織の全員
ユーザー~/.claude/CLAUDE.md自分の、すべてのプロジェクト
プロジェクト./CLAUDE.md または ./.claude/CLAUDE.mdGit で共有する全員
ローカル./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 には推測できないからです。

  1. このプロジェクトは何か誰のための何で、どこに公開しているか。2〜3行で。
  2. やってほしくないこと「main に直接 push しない」「秘密の値をログに出さない」など。
  3. 自分の好みコミットメッセージの言語、説明の詳しさ、使ってほしいコマンド。

反対に、下書きのうち「当たり前のこと」「コードを見れば分かること」は消します。公式ドキュメントは CLAUDE.md 1ファイルあたり200行未満を目安にしていて、長いほど文脈を圧迫し、守られにくくなると書いています。

▶ Live Demo — CLAUDE.md の下書きを作る

      
    

書くこと、書かないこと

具体的に書く

公式ドキュメントが挙げている例が分かりやすいので、そのまま紹介します。「コードをきれいに整える」ではなく「インデントはスペース2つ」。「変更を確かめる」ではなく「コミットの前に npm test を実行する」。人に頼むときと同じで、解釈の余地がある指示ほど結果がぶれます。

❌ ぼんやりした指示
- きれいなコードを書く
- テストをしっかりする
- 安全に作業する
✅ 具体的な指示
- インデントはスペース2つ。セミコロンは付けない
- src/ を変えたら npm test を実行し、通ってからコミットする
- .env と dezign-mailer-config.php の中身は表示しない・Git に入れない

CLAUDE.md 以外に置いたほうがいいもの

なんでも CLAUDE.md に書くと、すぐ長くなります。公式ドキュメントは、内容によって置き場所を分けるよう勧めています。

内容置き場所理由
何手順もある作業skill必要なときだけ読み込まれる
一部のフォルダだけの決まり.claude/rules/ に paths 付きでそのフォルダのファイルを読んだときだけ読み込まれる
毎回必ず実行したい処理hookCLAUDE.md は「お願い」だが、hook は確実に実行される
長い資料別ファイルにして @docs/xxx.md で読み込むCLAUDE.md 本体を短く保てる

最後の @ での読み込みは便利ですが、読み込んだファイルもセッション開始時にまとめて読まれます。文脈の量が減るわけではない、という点は覚えておいてください。

⚠️ 「絶対に」は hook で
「コミット前に必ずリンターを通す」のように、1回でも抜けると困る処理を CLAUDE.md に書いても、守られない可能性は残ります。公式ドキュメントも、こうした処理は hook で自動実行するよう案内しています。

実例:このサイトの CLAUDE.md の骨組み

DE:ZIGN も、Claude Code(とクラウドの定期実行)で記事の取り込みやビルドをしています。リポジトリの CLAUDE.md は、次の見出しで組み立てています。

CLAUDE.md ├── 運営者について(返事は日本語・専門用語は言い換える) ├── プロジェクト概要(Astro → Cloudflare Workers) ├── 記事(ファイルの置き場所・取り込みのコマンド) ├── 自動執筆(毎日の手順 1〜7) ├── 画像の自動処理 ├── ビルドと確認 ├── 本番への反映(どの .bat を誰が実行するか) ├── 下書きの確認(プレビュー) ├── 秘密情報(Git に入れない・表示しない) └── Git

見出しは、「新しく手伝いに来た人に最初に渡す紙」として読めるかどうかを基準にしています。公式ドキュメントにも、新しいチームメンバーが同じ説明を必要とするなら 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回くらい読み返して矛盾と古い行を消す。

参考・出典

機能や対応プランは確認日の情報です。最新の情報は公式ドキュメントでご確認ください。