CLAUDE.md に書かせるもの、書かせないもの

CLAUDE.md は、頼めば Claude Code が書いてくれます。ただ、何でも書かせればいいわけではありません。書かせるものと書かせないものの線引きをまとめました。

書かせるのは方針と決まったこと

CLAUDE.md に書かせるのは、その部門の方針と、部長との相談で決まったことです。部門の役割、目指すところ、守ってほしいルールなど。

公式のドキュメントでも、書くのは Claude Code が自分では推測できないこととされています。あなたの考えやあなたの部門だけの決まりは、書いておかないと伝わりません。

中身の見本はこちらの記事で紹介しています。

関連記事：CLAUDE.md とは何か、プロンプトとの違いを知る

プライベートなことは扱いの指示とセットで

私はプライベートなことも、社長室（自分のことを書いておくフォルダ）の CLAUDE.md に書かせています。

書かせないどころか、むしろ多く書いてあるほう。ふだんの相談でも、それを存分に使ってもらう形です。

そのかわり、ブログなど外に出る文章には漏れないように指示を出しています。私の決まりを短くまとめると、次のようなものです。

家族やお金などの個人的なことは、公開する文章に、本人に確認せずに書かない。

書かせるなら、扱い方の指示もいっしょに。自分のことを書く場所の作り方は、こちらの記事で解説しています。

関連記事：社長室を作って、AI にあなたのことを知ってもらう

外に漏れて困る情報は書かせない

一方で、外に漏れては困る情報はそもそも書かせません。AI に機密情報を読み込ませてはいけない、というのが私の考えです。

仕事で AI を使おうとして、勤め先の重要な情報を読み込ませ、問題になるケースが最近多いと聞きます。

CLAUDE.md に書いたことは、チャットを始めるたびに AI に読み込まれます。一度書けば、毎回 AI に渡すことになるわけです。次のようなものは、書かせないようにしましょう。

• パスワード、API キー（サービスを使うための鍵）などの認証情報
• 勤め先や取引先の機密情報

私のプロジェクトの CLAUDE.md にも、「パスワード・API キー・トークンなどの認証情報は、どのファイルにも書かない」という決まりを入れています。

手順と変わりやすいことは別のファイルに

CLAUDE.md は毎回読まれます。そのため、たまにしか使わない作業の手順は、別のファイルに分けるのが公式の考え方。必要なときだけ読まれる手順書の仕組みは、こちらの記事で解説しています。

関連記事：スキルとは何か、CLAUDE.md との違いを知る

よく変わる情報も、公式では CLAUDE.md に書かないもの。私は、まだ決まっていないことや途中のものも、別のファイルに分けています。

その分け方は、こちらの記事で解説しています。

関連記事：保留メモは溜めない、変わりやすいことは別のファイルに

見れば分かることは書かせない

Claude Code がフォルダの中を見れば分かることも、書かせる必要はありません。「丁寧に書く」のような、言わなくても守られる当たり前のことも同じです。

公式のドキュメントでは1行ごとに「この行を消したら、Claude Code は間違えるか」と問うことを勧めています。間違えないなら、その行は要らないということ。

公式では、CLAUDE.md は1つのファイルで 200 行未満が目安とされています。なくても困らない行を削っておけば、本当に必要なことが埋もれません。

書かせるものと書かせないもの

ここまでの線引きを表にまとめます。

CLAUDE.md が長くなってきたら、Claude Code に「CLAUDE.md に、書かなくていいことが入っていない？」と聞いてみてください。肥大化の防ぎ方はこちらの記事で解説しています。

関連記事：CLAUDE.md の肥大化・重複・漏れを防ぐ習慣