CLAUDE.md でプロジェクトの方針をAIに覚えさせる
この章でわかること: CLAUDE.md という1枚のファイルの役割と書き方。これは プロジェクトの「常識」をまとめておき、AIが毎回自動で読んでくれるメモです。 うまく使うと、「毎回おなじ前提を説明し直す」という地味に重い負担が消えます。
CLAUDE.md はプロジェクトの「常識」を書いた一枚
Section titled “CLAUDE.md はプロジェクトの「常識」を書いた一枚”新しくチームに入った人に、最初にプロジェクトの前提を一通り伝えますよね。 「うちはこういうトーンで書く」「この技術を使う」「ここには触らないで」——。 CLAUDE.md は、その申し送りメモをAI向けに1枚にしたものです。
ポイントは、AIがそのプロジェクトで作業を始めるとき、中身を毎回勝手に読み込むこと。 だからチャットのたびに前提を貼り直す必要がなく、セッションやページをまたいでも 一貫した出力が返ってきます。人に何度も同じ説明をせずに済むよう仕組み化する—— 極めてエンジニア的な発想を、ファイル1枚で実現しているわけです。
何を書くと良いか
Section titled “何を書くと良いか”最初から完璧を目指す必要はありません。次のようなことを、思いつく範囲で書きます。
- トーン・言い回し: 一人称、敬体/常体、避けたい表現など
- 使う技術・道具: 「このツールで作る」「この形式で出す」といった前提
- やってほしくないこと: 触ってほしくない箇所、避けたいやり方
- 素材やドキュメントの場所: 資料・画像・仕様書がどのフォルダにあるか
日本語の短い箇条書きで十分です。たとえば、営業資料サイトを作るプロジェクトなら こんな数行から始められます。
# このプロジェクトの方針
- 読み手は取引先の担当者。専門用語は避け、やさしい言葉で書く。- 文章のトーンは丁寧語(です・ます)で統一する。- 会社名は必ず「株式会社サンプル」と正式名称で書く(略称は使わない)。- 画像やロゴは `assets/` フォルダにあるものだけを使う。- 価格や日付など、資料にない数字は勝手に作らない。分からなければ確認する。Skills(技)との違い——こちらは「常設の前提」
Section titled “Skills(技)との違い——こちらは「常設の前提」”似た仕組みに Skills(スキル)があります。 違いはシンプルです。
- Skills = 呼び出して使う「技」。「今回はこの手順でやって」と、必要な場面で発動する
- CLAUDE.md = 常設の「前提」。呼び出さなくても、そのプロジェクトでは常に効いている
スキルが「必要なときに取り出す道具」なら、CLAUDE.md は「作業机に最初から貼ってある 注意書き」です。両方をあわせて使うと、普段の前提はCLAUDE.mdで固定しつつ、 特定の作業はスキルで呼び出す、という役割分担ができます。
非エンジニアでも書ける——まず数行から
Section titled “非エンジニアでも書ける——まず数行から”CLAUDE.md はプログラムではなく、ただの箇条書きメモです。書き方に厳密な決まりは なく、日本語の普通の文章で構いません。いきなり網羅しようとせず、 「これは毎回言っている気がする」という前提を1つ書くところから始めましょう。
育て方——詰まった原因を一行ずつ足していく
Section titled “育て方——詰まった原因を一行ずつ足していく”CLAUDE.md は書いて終わりではなく、使いながら育てるものです。コツは、 作業中に「あれ、思った通りに出なかった」と感じたら、その場で一行足すこと。
- 意図と違う出力が返ってきた → 「次はこうして」を一行追加する
- 同じ指示を毎回している自分に気づいた → その指示を前提として書いておく
- ミスの原因が分かった → 「◯◯は避ける」と書いて再発を防ぐ
こうして、詰まった原因や気づきを一行ずつ積んでいくと、CLAUDE.md は少しずつ そのプロジェクト専用の頼れる申し送りに育ちます。長い文章より、短い箇条書きを こまめに足すほうが、AIにも人にも読みやすく効きます。
VibeCoding で作業が長くなるほど、「毎回おなじ前提を説明し直す」コストは地味に 効いてきます。CLAUDE.md はそのコストを一度きりの記述に置き換え、セッションや ページをまたいでも一貫した品質を保つための、いちばん手軽な仕組み化です。
一度書けば毎回効く——この感覚は Skills の自作とも共通します。前提はCLAUDE.mdで 常設し、特定の進め方はスキルで呼び出す。両輪がそろうと、AIはぐっと 「自分のプロジェクトを分かっている相棒」に近づきます。実務での本格的な使い方は 提案書から動くPoCを作るへどうぞ。
参考リンク(情報ソース)
Section titled “参考リンク(情報ソース)”- Claude Code メモリ機能(CLAUDE.md)公式ドキュメント: https://docs.claude.com/en/docs/claude-code/memory
- Claude Code 公式ドキュメント: https://docs.claude.com/en/docs/claude-code/overview