1. そもそもCLAUDE.mdとは

⚠️ 注記: 本記事はClaude Codeの2026年7月時点の公式ドキュメントに基づく解説です。Claude Codeは更新が速く、仕様が変わることがあります。実際の操作時は、必ず公式ドキュメント（code.claude.com/docs）で最新の仕様をご確認ください。

Claude Codeは、AnthropicのAI「Claude」がパソコンの中で実際に手を動かす「エージェント型」のツールです。ただ、AIとの会話（セッション）は基本的に一回ごとに区切られていて、前回話した内容を毎回覚えているわけではありません。だから放っておくと、「うちのプロジェクトではテストはこのコマンドで動かす」といった前提を、毎回説明し直すことになります。

そこで登場するのが「CLAUDE.md」です。これは、Claudeに常に知っておいてほしい前提やルールを書いておくメモ帳。Claude Codeは起動時にこのファイルを自動的に読み込み、その内容を頭に入れた状態で作業を始めます。つまり、一度書いておけば、毎回同じ説明を繰り返さなくて済むというわけです。

会社にたとえるなら、CLAUDE.mdは「新しく来た人にも必ず読んでもらう、部署のルールブック」のようなもの。これがあるかないかで、AIの"物わかりのよさ"が大きく変わります。

2. 置き場所には2種類ある

CLAUDE.mdは、置く場所によって「効く範囲」が変わります。大きく2種類あります。

• プロジェクトごと（./CLAUDE.md）：そのプロジェクトのフォルダに置く。そのプロジェクト固有のルールを書く場所。Gitで共有すれば、チーム全員に同じ前提が伝わります。
• 自分専用（~/.claude/CLAUDE.md）：自分のパソコンのユーザー設定に置く。どのプロジェクトでも効く、自分の好みや共通ルールを書く場所。

Claude Codeは、上位のフォルダから順にこれらを読み込み、両方の内容をあわせて頭に入れます。つまり「会社全体のルール（自分用）」と「このプロジェクトのルール（プロジェクト用）」を、重ねて適用できるイメージです。チームで統一したいことはプロジェクト用に、自分だけの癖はユーザー用に、と使い分けると整理しやすくなります。

3. 何を書くと効くのか

では、CLAUDE.mdには何を書けばよいのでしょうか。「毎回わかっておいてほしい前提」が基本です。具体的には、こんな内容が効きます。

• ビルドやテストの実行コマンド（例：「テストは npm test で回す」）
• コードの書き方のルール（例：「インデントは2スペース」「命名はこの規約で」）
• プロジェクトの構成や、よくつまずくポイント
• 使ってほしいライブラリ、避けてほしいやり方

逆に、書かないほうがよいものもあります。それは「細かすぎる多段手順」です。たとえば「リリースはこの10ステップで行う」といった長い手順書は、CLAUDE.mdに書くよりも、前回の記事で紹介した「スキル」にするほうが向いています。CLAUDE.mdはあくまで「常に頭に置いておく前提」を書く場所であって、手順書の保管庫ではありません。

4. 効く書き方のコツ

CLAUDE.mdは、ただ書けばいいわけではありません。書き方しだいで、効き目が変わります。コツは3つです。

① 短く、要点だけに

CLAUDE.mdは長くすればするほど良い、というものではありません。あれもこれもと盛り込むと、かえって大事な要点がぼやけ、AIも何を優先すべきか判断しづらくなります。目安は200行くらいまで。「本当に毎回必要な前提」だけに絞りましょう。

② 抽象的でなく、具体的に

「コード規約に従う」ではなく「インデントは2スペースを使う」。「わかりやすく書く」ではなく「関数名は動詞から始める」。このように、誰が読んでも同じ行動になるレベルまで具体的に書くのがコツです。抽象的な指示は、解釈の幅が広く、伝わりにくくなります。

③ /initで雛形を作り、育てていく

ゼロから書く必要はありません。/initというコマンドを使うと、プロジェクトの中身を見て、CLAUDE.mdの雛形を自動で作ってくれます。まずはこれで土台を作り、あとは実際に使いながら「これは毎回言っているな」という指示を追記して育てていきます。会話の途中で#から書き始めると、その場でCLAUDE.mdにメモを追記できる仕組みもあります。「気づいたらすぐ足す」を繰り返すことで、自社仕様のルールブックが育っていきます。

なお、Claude Code自身が「これは覚えておくと便利」と判断した情報を、自動で記憶していく仕組み（オートメモリ）もあります。人が書くCLAUDE.mdと、AIが貯める記憶。この両輪で、使うほどに賢くなっていきます。

5. ひとつ注意：CLAUDE.mdは「命令」ではなく「前提」

覚えておきたい大事な点があります。CLAUDE.mdは、「絶対に100%守られる命令」ではなく、「常に伝えている前提」だということです。書いておけばAIは従いやすくなりますが、必ずそのとおりに動くと保証されているわけではありません。

だからこそ、大事なルールほど、簡潔に、目立つように書くことが効きます。長い文章の中に埋もれさせず、要点を箇条書きで整理する。優先度の高いことは先頭に置く。こうした工夫で、守られやすさが上がります。CLAUDE.mdは「一度書いて終わり」ではなく、「効き目を見ながら磨いていくもの」と考えるとよいでしょう。

6. でも、CLAUDE.mdを書けるだけでは成果は出ない

CLAUDE.mdは、AIを自社の前提に合わせて動かすための、地味ですが強力な道具です。しかし最後に大事なことをお伝えします。CLAUDE.mdを書けること自体は、成果のゴールではないということです。

「前提を書く箱」は用意できても、自社の業務にとって、何をルール化し、どう組み込めば本当に成果につながるのか——ここが難所です。多くの企業では、「機能はわかったが、自社のどの業務を、どうAIに任せれば効くのかがわからない」「個人が便利に使うだけで、チームや会社の仕組みとして定着しない」という壁にぶつかります。

AIツールが各社横並びに近づいた今、差がつくのは「CLAUDE.mdのような機能があるか」ではなく、それを自社の業務フローや判断基準に合わせて設計し、現場で使われ続ける形にする実装力です。ここは、機能を知っているだけでは越えられません。

自社の業務のどこをAIに任せ、どんな前提とルールを与え、現場で回り続ける形にまで作り切るか。そこを、ツールの機能習得だけで終わらせず、現場に入り込んで実装まで伴走してくれる相手と進めることが、AIを本当の成果に変える近道になります。私たちの「Protostar AI Works」は、まさにこの実装と定着を現場で伴走する支援です。「触れる」から「成果が出る」へ、ご一緒します。

まとめ

CLAUDE.mdは、AIに毎回わかっておいてほしい前提・ルールを覚えさせるメモ帳でした。

• 置き場所：プロジェクト用（./CLAUDE.md・Gitで共有）と、自分用（~/.claude/CLAUDE.md）
• 書く内容：ビルド/テストのコマンド、コード規約、構成、つまずき所。細かい多段手順はスキルへ
• 書き方のコツ：短く（目安200行）、具体的に、/initで雛形を作って育てる
• CLAUDE.mdは「命令」ではなく「前提」。大事なことほど簡潔に、目立たせる

まずは/initで雛形を作り、「毎回説明していること」を1つ書き足すところから始めてみてください。そのうえで、AIを自社の成果に変える「実装」まで見据えることが大切です。

📚 「今さら聞けないClaude Code」シリーズ（全3回）
① 権限モード編：どこまで自動で動かすか
② スキル編：よく使う手順を"技"にして自動化する
③ CLAUDE.md編（本記事）

⚠️ 本記事のClaude Codeの仕様は執筆時点（2026年7月）の公式ドキュメントに基づきます。更新が速いため、最新情報は公式ドキュメント（code.claude.com/docs）でご確認ください。