Claude Code を使っていて、「毎回、同じ説明をしている」と感じたことはありませんか? このプロジェクトは何か、テストはどう動かすか、どのフォルダには触らないでほしいか。こうした説明を、毎回の会話でくり返すのは手間です。
Claude Code には、フォルダに置いた指示書(CLAUDE.md というファイル)を、作業の最初に読む仕組みがあります。この記事では、指示書に書いておきたい5つの項目と、書くときのコツを紹介します。
CLAUDE.md とは
CLAUDE.md は、プロジェクトのフォルダに置く、Claude Code 向けの説明書です。Claude Code は作業を始めるときにこのファイルを読み、書かれた決まりに沿って作業します。
自分のパソコンの設定フォルダに置いた CLAUDE.md は、すべてのプロジェクトで読まれます。チームで共有したい決まりはプロジェクトのフォルダに、自分だけの好みは自分の設定フォルダに、と分けて置けます。Claude Code の「/init」というコマンドで、ひな形を作ることもできます。
書いておきたい5つの項目
1. このプロジェクトは何か:目的と、使っている言語や仕組みを2〜3行で
2. よく使う操作:起動・テスト・ビルドのやり方
3. 書き方の決まり:名前の付け方、フォルダの分け方、コメントの書き方
4. やってはいけないこと:本番の環境に触らない、秘密情報のファイルを開かない、消してはいけないフォルダ
5. 「終わりました」の前に確かめること:テストを通す、画面で動きを確かめる、など
とくに5つ目が効きます。「作業が終わったら、テストを通してから報告すること」と書いておくだけで、動かないまま「できました」と言われることが減ります。
書くときの3つのコツ
・短く、具体的に書く:「きれいに書く」ではなく「1つの関数は50行まで」のように、守れたかどうかを判断できる書き方にします
・間違いが起きたら1行足す:同じ失敗を2回されたら、その場で決まりを1行足します。指示書は、使いながら育てるものです
・長くなったら分ける:フォルダごとに CLAUDE.md を置くと、そのフォルダで作業するときだけ読まれます。全部を1つのファイルに詰め込まないほうが、守られやすくなります
指示書だけでは止められないこと
CLAUDE.md は、あくまで「お願い」です。書いてあっても、状況によっては守られないことがあります。
フォルダごとの削除や、本番への書き込みのように、起きたら困る操作は、指示書だけに頼らず、操作そのものを止める設定(許可・確認・禁止の設定や、実行前に中身を確かめる仕組み)と組み合わせるのが安心です。前回の記事「Claude Codeを会社で使う前に決めておきたい5つのルール」で、その考え方を紹介しています。
作ってほしいときは
ココナラで、Claude Code の安全な初期設定を作るサービスを出品しています。御社のプロジェクトに合わせた指示書(CLAUDE.md)、危険な操作を止める設定、社員向けの手順書を一式でお渡しします。