Claude Codeの指示書(CLAUDE.md)の書き方|会社のルールを毎回説明しないための5項目

Claude Codeの指示書(CLAUDE.md)の書き方|会社のルールを毎回説明しないための5項目

記事
IT・テクノロジー
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)、危険な操作を止める設定、社員向けの手順書を一式でお渡しします。

サービス数100万件のスキルマーケット、あなたにぴったりのサービスを探す