この記事の要点
- CLAUDE.mdは、Claude Codeが作業のたびに自動で読み込む指示書です。
- プロジェクトの前提、よくある間違い、書き方やコードのルールを書いておくと、毎回の説明が省けます。
- 詰め込みすぎず、本当に毎回守ってほしいことだけに絞るのがコツです。
どうも岩崎です。
Claude Codeに作業を頼むとき、「このプロジェクトはこういうルールで」「これはやらないで」と、毎回同じ説明を繰り返していませんか。地味に手間ですし、伝え忘れて同じミスをされることもあります。
今日はその手間を減らしてくれるCLAUDE.mdの書き方についてです。
CLAUDE.mdとは何か
CLAUDE.mdは、Claude Codeが作業を始めるたびに自動で読み込むファイルです。プロジェクトのルートに置いておくと、毎回のやり取りの前提として扱われます。前回の記事で触れた通り、サブエージェントへの振り分け自体は各部下のdescriptionが主役ですが、CLAUDE.mdはそれとは別に、プロジェクト全体で共通して守ってほしいルールを伝える場所として役立ちます。より詳しい仕様はAnthropic公式ドキュメントにもまとめられています。
何を書いておくと便利か
書いておくと便利なのは、まずプロジェクトの概要です。何のためのプロジェクトで、誰に向けたものなのかを書いておくと、毎回一から説明しなくて済みます。次に、よくある間違いや注意点です。過去にやってしまったミスや、これはやってほしくないという行動を書いておくと、同じ失敗を繰り返さずに済みます。さらに、好みのスタイルやトーンです。文章の書き方の癖や、コードの書き方の好みなど、毎回口で説明していたことを先に書いておくイメージです。
詰め込みすぎないことが大事
CLAUDE.mdを書き始めると、あれもこれも伝えたくなるんですが、長くなりすぎると逆効果です。情報が多すぎると、本当に守ってほしいルールの優先順位が薄まってしまいます。だから、本当に毎回守ってほしいことだけに絞ることが大事です。それと、曖昧な精神論よりも、具体的な行動レベルで書いた方が伝わりやすいです。「丁寧に書く」ではなく「見出しは使わない」「一文を短くしすぎない」というように、そのまま実行できる形で書くのがコツです。
実際にやってみて
私のブログ執筆用のプロジェクトでも、CLAUDE.mdに文章のトーンや出力形式についての前提をいくつか書いています。これを書いてからは、毎回同じ説明を繰り返さずに済むようになり、作業を頼むたびに一から前提を伝えていた頃と比べて、かなり時短になっています。
Claude Codeを使っていて、毎回同じ説明を繰り返している自覚があるなら、その内容をCLAUDE.mdに書き出してみてください。
それでは！
よくある質問
-
CLAUDE.mdはどれくらいの長さが適切ですか？
-
決まった長さはありませんが、読み返して「これは本当に毎回必要か」と聞かれて即答できる項目だけに絞るのがおすすめです。そのため、迷ったら削る方向で調整してみてください。
-
CLAUDE.mdは自分で書かないといけませんか？
-
Claude Codeに「これまでのやり取りの中で繰り返し伝えていたルールをCLAUDE.mdにまとめて」と頼めば、たたき台を作ってもらえます。そこから自分で調整していく形で十分です。
-
CLAUDE.mdはプロジェクトごとに用意する必要がありますか？
-
プロジェクト直下のCLAUDE.mdとは別に、ホームディレクトリに置くと全プロジェクト共通のルールとして読み込まれます。プロジェクト固有のルールと共通のルールを分けておくと管理しやすくなります。
P.S.
普段は写真の撮り方について書いているブログですが、CLAUDE.mdを育てる作業は、レンズや設定を自分の撮り方に合わせて少しずつ調整していく感覚に似ています。一枚の写真を仕上げるように、道具との付き合い方も時間をかけて整えていければと思っています。
