Claude Code を同じプロジェクトで何度も使うなら、最初にやっておくと効くのが CLAUDE.md です。
これは、そのリポジトリで守ってほしい作法や前提をまとめておくためのメモで、ざっくり言えば「この案件ではこう動いてほしい」というプロジェクトメモリの役目を持たせられます。毎回「このフォルダは何のためのものか」「何を触ってよくて、何を触らないか」を説明し直す手間が減ります。
たとえば、コード修正だけでなく、文書整理、不要ファイルの洗い出し、案件ごとの資料作成のような作業でも、同じ説明を繰り返すのは地味に面倒です。
弁護士の案件フォルダなら「依頼者名の入ったファイル名は変えない」「提出版は final ディレクトリにまとめる」。
ディスク整理なら「Downloads 直下は消さず、重複候補だけ報告する」「写真の原本は触らない」。
こうした約束を先に置いておくと、Claude Code の返答の質が安定します。
CLAUDE.md は、作業するプロジェクトのルートに置くのが基本です。
Claude Code がそのプロジェクトの文脈を読むとき、まずここを見に行く運用がしやすくなります。細かな設定ファイルというより、「この案件のルールブック」です。
書き方は難しくありません。短い箇条書きで十分です。たとえば、Web アプリの保守ならこんな具合です。
# このリポジトリの作法
- 既存の設計を優先する。新しいライブラリは勝手に増やさない
- 変更は最小限にする。不要なリファクタリングはしない
- 破壊的な変更をする前に必ず確認する
- 返答は日本語で、要点を先に書く
- ファイル名やディレクトリ構成は既存ルールに合わせる
非エンジニア用途でも、考え方は同じです。
たとえば書面作成の案件なら、
- 依頼者名の表記は正式名称を使う
- 期限や日付は、元資料にない限り推測しない
- 参考資料の要約は作るが、原文の意味を変えない
- 先に結論、そのあと補足の順で書く
といった具合に、望むふるまいを書いておけば足ります。
CLAUDE.md に書くべきなのは、細かい作業指示より「迷わせたくない前提」です。
ここをはっきりさせると、毎回の説明がかなり短くなります。
向いているのは、たとえば次のような内容です。
逆に、1 回きりの細かい依頼は入れすぎないほうがいいです。
「今回だけ請求書を 3 通作る」「今日だけこの PDF を 1 枚に要約する」といった内容まで恒久ルールにすると、あとで邪魔になります。CLAUDE.md は固定ルール、個別依頼は会話、で分けたほうが楽です。
最初の一回は、Claude Code に CLAUDE.md のたたき台を作らせるのが手早いです。
既存の資料や README があれば、それも一緒に見せて、プロジェクトの作法を短く整理させます。
依頼文の例です。
このプロジェクトで今後 Claude Code に毎回伝えたい作法を CLAUDE.md にまとめてください。
内容は次を含めてください。
- 返答は日本語
- 変更は最小限
- 既存の構成や命名を尊重
- 迷ったら確認する
- このプロジェクトで触ってよい範囲と避ける範囲
長すぎないように、あとで人が更新しやすい形にしてください。
そのあと、できあがった CLAUDE.md をそのまま使うのではなく、少し手直しします。
ここで大事なのは、抽象的な言い回しを減らすことです。「丁寧に」「適切に」ではなく、「不明点は勝手に埋めず質問する」「ファイルは移動前に確認する」のように、行動に落ちる表現にすることです。
効くのは、短くて曖昧でない文です。
- 既存ファイルは削除しない
- 新しいフォルダは作る前に理由を述べる
- 出力先は `output/` に統一する
- 変更の前に影響範囲を一言で説明する
効きにくいのは、ふわっとした理想論です。
- なるべく良い感じにやる
- 場合に応じて柔軟に対応する
- ベストプラクティスで進める
この手の文は、読み手にはそれらしく見えても、実際の行動に落ちません。Claude Code にとっても判断材料が少ないままです。
「どう動いてほしいか」を、目で見て判断できる文にするのがコツです。
まず、CLAUDE.md は「自動で全部を片付ける魔法の設定」ではありません。
入れておけば毎回の説明をかなり減らせますが、個別の指示まで不要になるわけではないです。特に、今回だけの例外や、危険を伴う操作は、都度はっきり伝える必要があります。
それから、プロジェクトの実情と合わないルールを入れたまま放置しないこと。
たとえば、すでに src/ と docs/ が分かれているのに、「資料は全部ルート直下」と書いてしまうと、後から混乱します。運用が変わったら CLAUDE.md も更新します。ここをサボると、古い説明がずっと残ります。
もうひとつ、機密情報をそのまま書かないこと。
顧客名、認証情報、個人情報の扱いは、実務上ほんとうに必要な最小限に絞るべきです。ルールを明確にするのは大切ですが、書いてよい内容まで何でも書く必要はありません。
CLAUDE.md の本領は、2 回目、3 回目の作業で出ます。
最初は「毎回の説明を減らすためのメモ」ですが、続けて使ううちに「この案件では何が普通か」を固定できるので、会話の往復が減ります。ファイル整理のような単純作業でも、案件ごとの方針が残っているだけで安心感が違います。
実務では、最初に大きく作り込みすぎないほうがうまくいきます。
まずは 5 行から 10 行程度で始めて、実際に困った場面が出たときだけ追記する。これが一番長持ちします。
一度に完璧を狙うより、「この案件で一番よく忘れること」を先に書くほうが役に立ちます。
必要なら次の一歩として、プロジェクトの説明文そのものを短くする練習や、作業ごとに使う依頼文の型を固定するやり方に進むと、さらに会話が速くなります。