CLAUDE.md ってなに? 初めての設定ファイル入門
「AI に覚えさせる」という発想を、3 種のテンプレで体験する記事。占い師サイト / ブログ / 家計簿、それぞれ違う CLAUDE.md を配布します。
結論(2 行で)
- CLAUDE.md は「この AI に、毎回説明しなくていい前提を教えておくメモ帳」 です。
- 長くなくていい。35 行くらいで、あなたの AI が別人のように賢くなります。
なぜ CLAUDE.md が必要なの?
Claude Code は、毎回まっさらな状態で話しかけられてきます。 私たちが「今日もよろしく」と話しかけるたびに、「はじめまして!あなたは誰ですか?」状態です。
CLAUDE.md は、その会話の最初にそっと差し出す「はじめましての自己紹介カード」。 「私はこういう人で、こういう仕事をしていて、こういうルールで動いてほしい」を書いておけば、 毎回の説明が不要になります。
書く内容(基本の 5 つ)
- このプロジェクトは何?(1 行)
- 使っている道具(言語・フレームワーク・ホスティング)
- やってほしいこと/やらないでほしいこと
- 書き方の好み(日本語で返してほしい、など)
- 信頼できる参考資料への道しるべ
「100 行より 35 行」ルール
長すぎる CLAUDE.md は、逆に読まれなくなります(人間と同じですね)。 nogataka さんの記事が詳しいですが、35 行くらいで、核心だけを書く のがちょうどいい。
配布:3 種のテンプレ
以下のリンクから、私の運用中テンプレをダウンロードできます(準備中🌸):
- 占い師サイト用
- ブログ運営用
- 家計簿・家事管理用
よくある質問
Q. どこに置けばいい?
A. プロジェクトのルート(一番上の階層)に CLAUDE.md として置きます。
Q. Git に含めて OK? A. はい。チーム全員でルールを共有するのが本来の使い方です。
この記事は、以下の方々の素晴らしい発信から学ばせていただきました。
- Boris Cherny 氏の知見を元に作成された、CLAUDE.md を理解する— uno_ha07(haru)
- CLAUDE.md を設計すると Claude Code の生産性が別物になる— nogataka
- 100 行の CLAUDE.md より 35 行が効く理由— nogataka
ターミナルを見ただけで閉じたくなっていたワーママが、Claude Code を自分の手足にするまでの最初の一歩。
「ChatGPT で十分じゃないの?」によく聞かれるので、両方を 3 ヶ月ずつ本気で使って出た答えをまとめました。結論は「役割がぜんぜん違う」でした。
「プログラマー向けの道具でしょ?」と思って半年スルーしていた私が、ある一言で考えを変えた話。ワーママの毎日が、Claude Code でどう変わったか。
速報じゃなくて「翻訳」します。難しいニュースを、ワーママの私がやさしく噛み砕いて、月曜朝にお届け。