CLAUDE.mdの書き方、制作会社の作業ルールをAIに渡す──置き場所4つ、書く項目と書かない項目、200行を目安にする理由、そのまま使える骨子
この記事は、Claude Codeに社内の作業ルールを渡す CLAUDE.md の書き方を扱います。
毎回、同じ注意をチャットに打っている
「ビルドは npm run build で。テーマのファイルは直接いじらないで。コメントは日本語で」
Claude Codeを使うたびに、同じ注意を打ち込んでいる人がいます。
注意を忘れた日に限って、AIは社内のやり方と違う書き方をします。
人ごとに注意の中身が違えば、同じリポジトリでも仕上がりがそろいません。
その注意を、一度だけ書いて全員で使い回すのが CLAUDE.md です。
CLAUDE.mdとは、毎回説明し直していることを、プロジェクトの事実と決まりとして書き残し、Claude Codeが作業の始めに読む指示書である
黒字化の外科医です。CLAUDE.md を、制作会社の作業ルールの渡し方として解剖します。
書き方を決めるべき理由は、三つあります。
第一に、書いた内容は、毎回の作業の文脈に入るから。
公式ドキュメントでは、CLAUDE.md はセッションの始めに読み込まれると説明されています。長く書くほど、毎回の作業で読む量が増えます。
第二に、具体的でないと、守られにくいから。
公式は「きれいに書く」ではなく「2スペースで字下げ」、「テストする」ではなく「コミット前に npm test を実行」のように、確かめられる書き方を勧めています。
第三に、CLAUDE.md は、強制ではないから。
公式は、CLAUDE.md を「強制される設定」ではなく文脈として扱うと明記し、必ず止めたい操作は hooks で止めるよう案内しています。
CLAUDE.mdの置き場所、公式で確認できたこと
2026年10月27日に、公式ドキュメント（code.claude.com/docs の How Claude remembers your project、Manage costs effectively）で確認した内容です。
置き場所 効く範囲
組織の管理用（WindowsはC:\Program Files\ClaudeCode\CLAUDE.md など） 組織の全員
~/.claude/CLAUDE.md 自分の全プロジェクト
./CLAUDE.md または ./.claude/CLAUDE.md プロジェクト（コミットしてチームで共有）
./CLAUDE.local.md 自分の、そのプロジェクトだけ（.gitignore に入れる）
その他
・/init で、コードベースを調べて最初の CLAUDE.md を作れる（既にあれば改善案を出す）
・@パス で別のファイルを読み込める（例：@README）。読み込んだ分も毎回の文脈に入る
・.claude/rules/ にテーマ別のファイルを置ける。paths を書くと、該当ファイルを扱うときだけ読まれる
・1ファイル200行未満を目安にするよう案内されている
・読み込まれたかは /context の Memory files で確かめる書く項目、書かない項目
公式は、書き足すきっかけとして「同じ間違いが2回起きた」「レビューで指摘された」「前回と同じ注意を打った」「新人にも同じ説明が要る」を挙げています。
制作会社に当てはめると、次のように分けられます。
【書く】毎回の作業で必要な事実と決まり
・ビルド、テスト、lint のコマンド
・フォルダの構成と、触ってよい場所・触らない場所
・書き方の決まり（命名、字下げ、コメントの言語）
・使ってよいライブラリと、追加するときの手順
・完了の条件（テストが通る、差分を説明する）
【書かない、または移す】
・一部のフォルダだけの決まり → .claude/rules/ に paths つきで
・手順の長い作業（リリース、移行）→ Skills に
・必ず止めたい操作 → 設定の deny や hooks に
・パスワード、APIキー、お客様の個人情報 → どこにも書かない今すぐ試せる：今の注意から CLAUDE.md の下書きを作るプロンプト
私はWeb制作会社のエンジニアです。Claude Codeの CLAUDE.md の下書きを作ってください。
（顧客名や秘密情報は入力しません）
【材料】
・この1か月、AIに繰り返し伝えた注意：〔箇条書き〕
・レビューで指摘されたこと：〔箇条書き〕
・ビルド・テスト・lint のコマンド：〔記載〕
・触ってはいけないフォルダやファイル：〔記載〕
1. 材料を「毎回必要な決まり」「一部のフォルダだけの決まり」「長い手順」「必ず止めたいこと」に分ける。
2. 「毎回必要な決まり」だけで、200行未満の CLAUDE.md を書く。確かめられる書き方にする。
3. 残りを、.claude/rules・Skills・設定のどこに移すべきか示す。CLAUDE.md工場：制作会社の骨子と効果の計算
骨子（WordPressのテーマ開発の例）
# プロジェクトの概要
・〔案件の種類〕のWordPressテーマ。本番環境には触れない
# コマンド
・ビルド：npm run build
・lint：npm run lint（変更のあとは必ず実行する）
# フォルダ
・自作テーマ：wp-content/themes/〔テーマ名〕/ だけを編集する
・プラグインとWordPress本体のファイルは編集しない
# 書き方
・PHPのコメントは日本語。関数名の接頭辞は〔社名略称〕_
・新しいライブラリは追加しない。必要なら理由を書いて相談する
# 完了の条件
・lint が通る
・変更したファイルと理由を、箇条書きで報告する計算例：同じ注意を打つ時間（数字はすべて例）
1回の注意：5分 × 1日3回 × 月20日 ＝ 300分 ＝ 5時間／人
4人のチーム：5時間 × 4人 ＝ 20時間／月
目標の時間単価 7,645円（例）：20時間 × 7,645円 ＝ 152,900円／月注意を打つ時間そのものより、注意を忘れた日の手戻りのほうが大きいことも多いはずです。両方を1か月記録すると、CLAUDE.md を整える時間の価値が見えます。
構造的なリスク
逆説を指摘しておきます。
丁寧に書くほど CLAUDE.md は長くなり、長くなるほど守られにくくなります。公式も、長いファイルは文脈を使い、守られる度合いが下がると説明しています。
また、矛盾する決まりがあると、どちらかが選ばれてしまいます。
だから、月に1回、古い決まりと矛盾を消す時間を取り、200行を超えたら rules や Skills に移します。
よくあるQ&A
Q. CLAUDE.md に「本番に触れない」と書けば十分か？
十分ではありません。必ず止めたい操作は、設定と hooks で止めます。
Q. 個人の好みは、どこに書くか？
自分の全プロジェクトなら ~/.claude/CLAUDE.md、そのプロジェクトだけなら CLAUDE.local.md です。チームの CLAUDE.md には書きません。
Q. お客様のリポジトリに、CLAUDE.md をコミットしてよいか？
納品物に含めるかは、お客様と決めます。社内の事情を書いた内容は、納品前に見直してください。
最後に
CLAUDE.md は、毎回説明し直していることを、短く、確かめられる形で書き残す場所です。
200行を目安に事実と決まりだけを書き、止めたいことは設定と hooks に移した会社だけが、誰が使っても同じ仕上がりのAI作業を回せるのです。
制作会社向けの CLAUDE.md の雛形と、設定・hooks をまとめた一式は、導入設定キットに置きました。
▶ Claude Code導入設定キット、制作会社がそのまま置くファイル一式──チーム共有・個人・組織のsettings.json、CLAUDE.mdの雛形、hooksの守りの設定、席の割当表と運用表
これまでの記事は、メンバーシップ「黒字化オペ室」でまとめて読めます。月額1,980円、記事2本分の金額です。詳しくはプロフィールから。
#Web制作会社 #ClaudeCode #CLAUDEmd #AIコーディング #社内ルール #標準化 #制作会社経営 #中小企業 #AI駆動開発 #生成AI
