Claude Code使いこなし術「CLAUDE.md」毎回おなじ説明をやめる設定ファイル
かに🦀です！
Claude Code を使っていて、毎回おなじ説明を打ち込んでいませんか。僕はそうでした。「このプロジェクトは〇〇をすることが目的です」「コメントは日本語で書いて」。セッションを始めるたびに、同じことを書いていた。
その手間を1回で終わらせてくれるのが CLAUDE.md です。今回は、これが何なのか、どこに置いて何を書くのかを、最初の1枚が作れるところまで説明します。
Claude Code は毎回まっさらな状態で始まる
Claude Code は、セッションが変わると前回の会話を覚えていません。毎朝出社するたびに記憶がリセットされる新人、みたいなものです。
だから毎回「うちのプロジェクトはこうで」と説明することになる。その説明を紙に書いて机に貼っておくのが CLAUDE.md です。Claude Code はセッションを始めるとき、この紙を必ず読んでから作業に入ります。
どこに置く？ まずは2つだけ覚える
置き場所は何種類かありますが、まずは2つだけ覚えましょう。
ひとつはプロジェクトのフォルダ直下に置く CLAUDE.md。そのプロジェクト専用のルールを書く場所です。git で管理できるので、チームで作業するときも共有できます。
git は、ファイルの変更履歴を残しておく仕組みです。いつ・誰が・どこを直したかが全部残るので、壊れても前の状態に戻せます。
もうひとつが ~/.claude/CLAUDE.md。こちらは自分のパソコン全体で効く設定で、「返事は日本語で」のような、どのプロジェクトでも変わらない自分の好みを書きます。
両方あるときは両方読まれます。取り合いにはならないので、迷ったらプロジェクト側から作ればいい。
「~/.claude/CLAUDE.md」の先頭の ~ は、自分のユーザーフォルダを指す省略記号です。Mac なら「/Users/自分の名前」、Windows なら「C:\Users\自分の名前」のこと。長いので ~ の1文字で書く決まりになっています。そのまま ~ と打って大丈夫です。
何を書く？「Claudeが自分では気づけないこと」だけ
書く中身の基準はシンプルで、Claude が自力で推測できないことだけを書きます。
特別な書き方はありません。ただの箇条書きのメモで大丈夫です。
## このプロジェクトについて
- 家計簿アプリを作っています
- 使う人は僕ひとり
## お願い
- 返事は日本語で
- 変更したら動くか確かめてから報告して
- 分からないところは勝手に決めずに聞いてこれだけでもちゃんと効きます。プログラムを書く人なら、ここに「テストを動かすコマンド」や「大事なファイルの場所」を足すとさらに効きます。
コツは、あいまいな言葉を避けること。「ちゃんとやって」ではなく「変更したら動くか確かめて」。「勝手にしないで」ではなく「ファイルを消す前に確認して」。あとから自分で「守れたかどうか」を確かめられる形になっているかが分かれ目です。
書くタイミングの目安も公式ドキュメントに載っていて、これが分かりやすい。Claude が同じ間違いを2回したとき。同じ注意をまた打ち込んだとき。そのタイミングで足していくと、中身が自然と実用的になります。
書かないほうがいいこと
長い仕様書やAPIドキュメントを丸ごと貼るのはやめたほうがいいです。ファイルの場所を1行書いておけば、必要なときに読みに行ってくれます。
「品質を大事にする」「わかりやすいコードを書く」のような当たり前のことも要りません。効果がないうえに、大事な指示が埋もれます。
パスワードやAPIキーは絶対に書かない。.env という別ファイルに書くのが正解です。
.env は、パスワードやAPIキーだけを入れておく専用のファイルです。人に見せない情報をここにまとめておくと、うっかり公開してしまう事故を防げます。
長さは200行以下が目安。CLAUDE.md はセッションのたびに全文が読み込まれるので、長くするほど1つ1つの指示が効きにくくなります。書きすぎて逆に言うことを聞かなくなる現象は、僕も実際にやりました。この話は近いうちに1本にまとめて書きます。
ちゃんと読まれているか確かめる方法
書いたのに効いている気がしない、というときは /context と打ってみてください。
これが実際の画面です。「メモリファイル」の欄を開くと、いま読み込まれているファイルが並びます。
僕の場合は3つ。パソコン全体の設定（.claude/CLAUDE.md）と、いま作業しているプロジェクトの設定（Projects/.../CLAUDE.md）が、どちらもちゃんと読まれています。さっき「両方あるときは両方読まれる」と書いたのは、この状態のこと。
ここに出てこないなら、置き場所かファイル名を間違えている可能性が高い。効かない原因が「書き方」なのか「そもそも読まれていない」のかが、これで切り分けられます。
3つ目に並んでいる MEMORY.md は、僕が書いたファイルではありません。Claudeが自分で書きためていくメモです。CLAUDE.md とは別の仕組みなので、これは別の回でくわしく書きます。
まとめ
Claude Code はセッションごとに記憶がリセットされる。その前提を渡すのが CLAUDE.md
置き場所はまず2つ。プロジェクト直下と ~/.claude/CLAUDE.md
書くのは「Claudeが自力で推測できないこと」だけ。プロジェクトの前提、お願いごと、決まりごと
あいまいな言葉ではなく、確かめられる書き方にする
当たり前のこと・長い仕様書・パスワードは書かない
200行以下が目安。長いほど効きが悪くなる
/context の「メモリファイル」の欄で、読み込まれているか確認できる
まずは3行だけでいい。自分が今週いちばん多く打ち込んだ説明を、1行書き写すところから始めてみてください。
関連記事
それでは、かに🦀からは以上です。
