Claude Codeを始めた日に作るCLAUDE.md。1年で7,919行まで育てて分かった、最初に書くことと書かなくていいこと

Claude Code を使い始めたら、CLAUDE.md って何を書けばいいの？ と迷いませんか？

私も1年前、初日に187行書きました。でもその大半は、いま残っていません😅

この記事を読み終わったら、自分の CLAUDE.md を今日作って、使いながら育てていけるようにしてあります。そのまま貼れるひな形と、Claude Code に頼むプロンプトも置いておきます。

私について

Webアプリを一人で作って運営しています。個人開発を始めて1年ちょっとです。

◾️ 会員：15,000人以上（毎月3,000人ペースで増えています）
◾️ 有料会員：170人
◾️ 月間：約40万アクセス。流入のほとんどが検索です
◾️ 開発：すべて Claude Code
◾️ 本業もエンジニアで、これは本業のあとにやっています

作っているのは、パチンコ・スロットの店舗データを分析するサービスです。
スマホアプリは作っていません。SEO（検索から人を連れてくる設計）・Webアプリを得意としています。

CLAUDE.mdは、Claude Codeが毎回最初に読むメモ

CLAUDE.md は、プロジェクトのフォルダに置くメモです。Claude Code は作業を始めるたびに、まずこれを読みます。

つまり、毎回同じことを説明しなくて済むようになります。「返事は日本語で」「このデータは消さないで」みたいなことを、ここに書いておけばいいんです。

1年で、187行から7,919行になった

私のサービスの CLAUDE.md の行数です。

1,800行を超えたあたりで、うまく回らなくなりました。長すぎて、Claude Code が毎回全部を読むと、それだけで頭がいっぱいになります。3ヶ月前に書いたルールと今日書いたルールがぶつかっていても、自分でも気づけません。

それで、テーマごとに別のファイルに分けました。いまは本体が665行、分けたファイルが24個で、合わせて7,919行です。

最初は、短くていい

初日に書いた187行は、ほとんど残っていません。作る前に書いたルールは、作っているうちに合わなくなるからです。

最初に書くのは、この3つだけで大丈夫です。

◾️ 何を作っているか（1行）
◾️ 使っている技術
◾️ 絶対にやってほしくないこと（本番のデータを消す、など）

失敗したら、その日に1行足す

いちばん役に立っているのは、「過去にやらかしたことの表」です。

こういうのは、踏む前には書けません。だから、失敗したその日に1行足します。次の日には「なんでそうなったか」を忘れるので😓

書き方のコツは、「こうしろ」より「こう見えるけど、原因はこれ」と書くことです。

たとえば、リリースのたびにブランチが消えたことがありました。私は「操作ミスではなく、設定どおりの動き」と書きました。こう書いておくと、次に同じことが起きても、犯人探しで時間を使わなくて済みます。

変わる数字は書かない

これは、かっこ悪い話です。

CLAUDE.md に「月のアクセス数」を書いていました。8ヶ月後に見たら、実際は4.8倍に増えていました。

古い数字が残っていると、Claude Code はそれを「今の数字」として読みます。数字や進み具合は、書いた瞬間から古くなっていきます。

書くなら、数字そのものじゃなくて「どこを見れば分かるか」を書きましょう。

本当に止めたいことは、文章じゃなく設定で止める

1年やって、いちばんはっきりしたことです。文章で書いたルールは、ときどき破られます。

なので、本当に困ることは仕組みで止めています。たとえば「本番に直接反映する操作」は、Claude Code の設定（フック）で実行できないようにしました。

文章は「知っておいてほしいこと」、設定は「絶対にさせたくないこと」と分けて考えると楽です。

今日、そのまま貼れるひな形

ここまでの話を、ひな形にしました。プロジェクトのフォルダに `CLAUDE.md` という名前で置いて、（ ）の中を書き換えてください。

# CLAUDE.md

## このプロジェクト
- 作っているもの：（例：家計簿のWebアプリ）
- 使っている技術：（例：Next.js / Supabase / Vercel）

## 必ず守ること
- 返事は日本語で
- 本番のデータを消す・上書きする操作は、実行する前に必ず私に確認する
- .env などの秘密の情報はコミットしない

## 過去にやらかしたこと（失敗したら1行足す）
| 症状 | 本当の原因 | 次からどうするか |
|---|---|---|

## 数字は書かない
- アクセス数や会員数は、ここに書かずに（見る場所）で確認する

そして、何か失敗したら Claude Code にこう頼んでください。

いま起きた失敗を、CLAUDE.md の「過去にやらかしたこと」の表に1行で足してください。
「症状」「本当の原因」「次からどうするか」の3つで書いてください。
原因がはっきりしないときは、推測で書かずに「不明」と書いてください。

🔴 最後の1行は消さないでください。これが無いと、AIはそれっぽい原因を作って書いてしまいます。

まとめ

◾️ CLAUDE.md は、Claude Code が毎回最初に読むメモ
◾️ 私のは1年で187行から7,919行になった。1,800行を超えたところで分けた
◾️ 最初は「何を作るか・技術・やってほしくないこと」の3つだけでいい
◾️ 失敗したら、その日に1行足す。「こう見えるけど、原因はこれ」と書く
◾️ 変わる数字は書かない。本当に止めたいことは設定で止める

今日ひとつだけ覚えて帰るなら、これです。

CLAUDE.md は最初に書き切るものじゃなくて、失敗するたびに育てるものです。

---

AIを使った個人開発やSEO対策、会社まわりの相談を受けています。スポット相談（2,000円/1時間〜）。
今だけ、30分の無料相談にも乗っています。私が有名になる前だけの、とっておきですよ☺️
お問い合わせ: slotdata2020+work@gmail.com