Claude Code の相棒、CLAUDE.md の書き方

前回までの記事（デスクトップアプリの入れ方 / Claude Code、まずはここから）で、Claude Code の基本に触れました。今回はもう一歩進んだ設定の話です。

CLAUDE.md って何？

Claude Code を起動すると、毎回 Claude は「このプロジェクトの前提」をゼロから把握しようとします。前回のセッションを覚えていてくれるわけではありません。

そこで活躍するのが CLAUDE.md というファイル。プロジェクトのルートに置いておくと、Claude が毎セッション最初に必ず読んでくれる「プロジェクト取扱説明書」になります。

前回の記事で「一言でいいから前提を伝えよう」と書きましたが、その一言を毎回打つのが面倒くさい。CLAUDE.md にまとめておけば、その手間がゼロになります。

私がいつも書いているのはこの5つです。

一文で OK。「Next.js のブログサイト」「Python の画像処理ツール」など。

主要なフレームワーク、言語、バージョンだけでも。

npm run dev、pytest、docker compose up など、ブラインドで叩く頻度が高いものを書いておくと、Claude が自分で正しいコマンドを選んでくれます。

.env、secrets/、本番設定ファイルなど。「読ませない」だけでなく「内容を出力させない」も明記しておくと安心です。

「コメントは日本語で書く」「関数名は動詞から始める」など、プロジェクト固有のクセを書いておくとコードの質が揃います。

短すぎても長すぎてもダメ。箇条書き中心で、ダラダラ書かないのがポイント。

私の感覚では 100〜300行程度がちょうど良いです。大きくなってきたら、詳細は別ファイル（docs/architecture.md など）に切り出して、CLAUDE.md からリンクを張る方が整理しやすくなります。

CLAUDE.md を置くだけで、Claude Code が「毎回ちゃんとプロジェクトを理解してくれる相棒」になります。

書き始めは面倒に感じるかもしれませんが、1 回書けば全セッションで効いてくる投資。最初に 15 分だけ使って整えておくと、後の作業の重さがだいぶ変わります。

次回は、セッション中に使える /clear /compact などのスラッシュコマンド活用術を紹介します。