CLAUDE.mdの書き方——Claude Codeに「前提知識」を覚えさせるファイル

Claude Codeに同じ説明を、毎回の会話で繰り返していませんか。会社の基本情報、日々の業務の進め方、答えてほしい文章のトーン(ビジネス文書らしい言い回し・です・ます調など)——本来は一度伝えれば済むはずのことを、チャットを開くたびに書き直すのは地味に手間です。CLAUDE.mdは、この「毎回の説明」を過去にするためのファイルです。

CLAUDE.mdとは何か

CLAUDE.mdは、Claude Codeが作業フォルダに入るときに自動で読み込んでくれる、ルールや背景情報を書いたテキストファイルです。中身はただのMarkdownで、特別な文法もありません。

イメージとしては、GeminiのGemsやChatGPTのGPTsに設定する「システムプロンプト」と同じだと考えるとわかりやすいと思います。あらかじめ前提知識やふるまい方を書いておき、以降のやり取りではその前提を踏まえて応答してもらう、という発想は共通しています。

ただし、決定的に違う点が一つあります。GemsやGPTsのシステムプロンプトは「そのGem・そのGPT」というチャットの単位で発動しますが、CLAUDE.mdは「そのフォルダで作業するとき」に発動します。ChatGPTやGemini、Claude.aiのようなチャット型のAIには、そもそも「作業フォルダ」という概念がありません。会話が完結する場所は常にチャット画面の中であり、手元のファイルシステム上のどこかに存在しているわけではないからです。

一方、Claude Codeは、ターミナルから実行され、実際にPC上のフォルダに入り込んでファイルを読み書きするツールです。だからこそ「今どのフォルダで作業しているか」によって、読み込むべき前提知識を切り替えるという発想が成立します。CLAUDE.mdは、この「作業フォルダ」という概念があって初めて意味を持つ仕組みだと言えます。

実際のフォルダ構成——なぜ細かく分けているのか

では、実際に自分がこの仕組みをどう使っているか、フォルダ構成から見てみます。私は、生成AI研修・マーケティング・開発・バックオフィスといった業務に加えて、社内のClaude Codeスキルの作成・整備も担当しています。そこで、業務領域ごとにフォルダを作り、その中をさらに案件・仕事の内容ごとにサブフォルダで分類する、という構成にしています。

なぜそこまで細かく分類しているかというと、CLAUDE.mdがフォルダ単位で効く仕組みだからです。フォルダの階層ごとに置いておけば、そのフォルダ配下でだけ効かせたい前提知識やルールを重ねられるので、業務領域・案件でフォルダを細かく分けておくほど、この仕組みを的確に活かせるわけです。

実際のフォルダ構成は、こんなイメージです。

home/                             … ホームフォルダ
├─ .claude/
│   ├─ CLAUDE.md              … グローバル用(PC全体に効く)
│   └─ skills/                … 個人用スキル(SKILL.mdの置き場)
└─ 作業用フォルダ/                 … Claude Codeで作業する際の作業用のフォルダ
    ├─ CLAUDE.md              … 作業フォルダ全体に効くCLAUDE.md
    ├─ training/              … カテゴリ1(例：顧客向け研修・商談まわり)
    ├─ marketing/             … カテゴリ2(例：自社マーケティング施策)
    │   ├─ CLAUDE.md          … marketingカテゴリだけに効くCLAUDE.md
    │   └─ 94_開発事業マーケティング戦略/
    ├─ dev/                   … カテゴリ3(例：開発案件)
    └─ backoffice/            … カテゴリ4(例：経理・管理業務)
        ├─ CLAUDE.md          … backofficeカテゴリだけに効くCLAUDE.md
        └─ 11_請求書フォーマット整備/

ツリーを見ると、home/.claude・作業用フォルダ直下・marketing直下・backoffice直下、それぞれに CLAUDE.md が置かれているのがわかります。home/.claudeはPC全体、作業用フォルダ直下は作業フォルダ内で共通する前提、カテゴリ直下はそのカテゴリだけに効かせたい前提と、階層ごとに書き分けています。

ただし、この構造を毎回手作業で守るのは、地味に面倒です。案件がどのカテゴリに属するか考え、既存フォルダを見て次の番号を確認し、命名ルールに沿ってフォルダを掘る——これを手でやっていると、だんだん適当になっていきます。そこで、このフォルダ作成の一連の作業はスキル化しています(スキルの作り方自体はClaude Codeのスキルの作り方で紹介しました)。

中身は何が書いてあるのか——実例で見る

CLAUDE.mdは、この構造のどの階層にも置くことができ、実際の運用では大きく3つの階層で使い分けています。使い分けの軸はシンプルで、「作業場所によらない前提」か「作業場所による前提」かです。

1つ目は、先ほどのツリーで見た home/.claude/CLAUDE.md にあたる「グローバル用」です。ここには、自分が何者で、どんな役割で働いていて、どんな会社に所属していて、どんな口調で返してほしいかといった、作業場所によらない前提——どこで作業していても変わらないことだけを書いています。実際にはこんな内容です(記事用に簡略化しています)。

# Global CLAUDE.md

## ユーザー
- 下岡稔(Minoru Shimooka)／株式会社パンハウス CFO(財務・経理統括)

## 会社(株式会社パンハウス)
- 東京大学松尾研究室発のAIスタートアップ
- 事業：①生成AI研修 ②AIソリューション開発 ③AIプロダクト
- 会社/事業の詳しい情報が必要な場合は `info-company` のスキルを使う

## コミュニケーション
- 日本語でやり取り
- フレンドリーに(堅苦しい敬語は不要)

## 機密情報の扱い
- APIキー・パスワード・顧客の個人情報は出力・ログ・コミットに含めない

2つ目は、先ほどのツリーで見た「作業用フォルダ」直下のCLAUDE.md、作業フォルダ全体用です。ここには反対に、作業場所による前提——home/作業用フォルダ/という場所で作業するときだけ意味を持つ、フォルダの全体構造や案件フォルダの共通ルールを書いています。実際にはこんな内容です。

# 作業用フォルダ CLAUDE.md

## 作業フォルダ
- 基本の作業フォルダは `home/作業用フォルダ/`

## プロジェクト構造
`home/作業用フォルダ/{カテゴリ}/{NN}_案件名/`
- training … 生成AI研修事業の顧客向け実務
- marketing … 自社の事業・サービス戦略、マーケティング全般
- dev … コード/Bot開発・API連携
- backoffice … 経理・財務・社内文書
- 番号は全カテゴリ横断で一意の通し番号

3つ目は、業務カテゴリごとの「カテゴリ用」です。同じ「作業場所による前提」でも、こちらはさらに一段階狭い場所——特定の業務カテゴリのフォルダだけに効く前提です。たとえば自社のマーケティング業務を扱うフォルダの直下には、実際にこんな内容を書いています(登場する人名・数値は説明用に置き換えています)。

# marketing CLAUDE.md

## このカテゴリの役割
- 自社の事業・サービス戦略、マーケティング全般を扱う
- 主な内容：戦略策定／競合分析・市場リサーチ／ブランディング／LP・広告／オウンドメディア／会社資料

## 前提・視点
- アウトプットの主語は常に「自社」
- 事業内容・サービス詳細は、社内の情報参照用スキルを必ず確認してから書く

## よく使うデータ・参照
- マーケ全体の情報は GitHub `panhouse/marketing-management` に集約されている(単一の正・private)
- 過去の戦略・分析レポートは、このカテゴリ内の既存案件フォルダを参照

## GitHub `panhouse/marketing-management`(マーケ情報の単一の正)
- `README.md` … 全体像ハブ(チャネルサマリ・リード→受注フロー・体制)
- `channels/` … チャネル別詳細
- `foundation/` … 横断基盤
- `tasks/tasks.json` … マーケタスク台帳(Claude Code経由でのみ運用)
- 前提知識：主力チャネルは展示会、リファラルが最大の伸びしろ(受注率35%・未起動)。マーケは田中→鈴木へ段階移譲中

## 成果物のルール
- レポート＝Markdown、定量分析＝表計算ソフト、共有・提案用＝スライドを基本とする

「アウトプットの主語は自社」「参照すべき一次情報はどこか」「成果物はどのフォーマットで、どこに置くか」——こうした、コードや資料そのものには書かれていない「判断の前提」をまとめておくことで、案件ごとに毎回説明し直す手間がなくなります。

同じ「カテゴリ用」でも、扱う業務が変われば書く内容もまったく違います。たとえば経理・財務まわりを扱うbackofficeカテゴリには、実際にこんな内容を書いています。

# backoffice CLAUDE.md

## このカテゴリの役割
- 経理・財務・社内文書まわりの業務を扱う
- 主な内容：請求書処理／経費精算／契約書管理／助成金の要件確認／社内規程整備

## 前提・視点
- 数字の正確性を最優先する。曖昧な処理は必ず確認してから進める
- 会計データの参照は、社内の会計連携用スキル経由に限定する(直接編集しない)

## よく使うデータ・参照
- 会計データは会計クラウドサービスのAPI経由で参照する(読み取り専用)

## 成果物のルール
- 金額・口座・インボイス番号を含む内容を含む際は、必ずユーザーに確認させる

マーケティングでは「主語は自社」「GitHubの単一の正」が前提として重要だったのに対し、経理・財務では「数字の正確性」「ユーザーへの確認」が前提として重要になる——同じ枠組みでも、業務ごとにまったく違う前提が浮かび上がってくるのがわかると思います。

階層的に読み込まれる仕組み

CLAUDE.mdが強力なのは、これが1つだけでなく、階層的に重なって読み込まれる点です。Claude Codeは作業を始めるとき、次の順番でCLAUDE.mdを探し、見つかったものをすべて合わせて前提知識にします。

グローバル(home/.claude/CLAUDE.md)——PC全体、どの作業でも共通の前提
上位フォルダ(例：home/作業用フォルダ/CLAUDE.md)——作業領域全体で共通のルール
業務カテゴリ・案件のフォルダ(例：marketing/CLAUDE.md)——その単位だけに効かせたい前提

具体的には、どのディレクトリでClaude Codeを起動するかによって、起動時に読み込まれるCLAUDE.mdが変わります。また、起動後に下位フォルダのファイルを扱うと、そのフォルダのCLAUDE.mdが追加で読み込まれることがあります。たとえば home/作業用フォルダ/ でClaude Codeを起動した場合、起動時に読み込まれるのはグローバルと作業領域全体の2つだけです。marketing/CLAUDE.mdは、この時点ではまだ読み込まれません。ただし、その後Claude Codeがmarketing/内のファイルを扱うと、marketing/CLAUDE.mdもオンデマンドで読み込まれます。一方、home/作業用フォルダ/marketing/ でClaude Codeを起動した場合は、起動した時点でグローバル・作業領域全体に加えて marketing/CLAUDE.md も——起動ディレクトリそのものにあたるため——読み込まれ、3つすべてが起動時から前提として効くようになります。

さらに、同じ「3つとも読み込まれる」場合でも、marketingで作業するときとbackofficeで作業するときを比べてみると、この重なり方がよくわかります。marketingカテゴリの案件フォルダで作業を頼むと、Claude Codeはhome/.claude/CLAUDE.md(グローバル)→home/作業用フォルダ/CLAUDE.md(作業領域全体)→marketing/CLAUDE.md(カテゴリ)の3つをすべて読み込みます。その結果、「アウトプットの主語は自社」「マーケ情報はGitHubの単一の正を見る」といった、マーケティング特有の前提を踏まえたうえで動いてくれます。

一方、backofficeカテゴリの案件フォルダで起動するときも、読み込まれる階層の数は変わりません。ユーザー共通用(グローバル)と作業フォルダ全体用の2つは同じですが、3つ目に読み込まれるカテゴリ用の指示が異なります。marketingの案件フォルダで起動すればmarketing/CLAUDE.mdが、backofficeの案件フォルダで起動すればbackoffice/CLAUDE.mdが追加されます。すると今度は、「数字の正確性を最優先する」「金額や口座を含む内容は必ずユーザーに確認させる」といった、経理・財務ならではの前提が加わります。

marketingで作業するときとbackofficeで作業するときのCLAUDE.md階層の比較図

つまり、グローバルと作業領域全体の2つは、どのカテゴリで作業していても共通の土台として効き続け、そこにどのカテゴリのCLAUDE.mdが追加で重なるかだけが、作業場所によって変わる——これが「階層的に読み込まれる」ということの実際の姿です。上書きや差し替えが起きているわけではなく、見つかったCLAUDE.mdが上位から下位の順に連結されて、前提として積み上がっていくイメージです。フォルダを細かく分けておくほど、案件固有の背景情報まで、この重なりの中に追加できるということでもあります。

書くときのコツ

CLAUDE.mdを書くときに意識しておきたいポイントは次の5つです。

作業する際の前提を書く——AIは頭はすごくいいものの、仕事の進め方や社内の事情といったコンテキストを持たない新人のようなものです。当たり前だと思っていることほど、実はAIには伝わっていません。知っておいてほしい前提を、まずはここに書きましょう。
よくAIに書き込むことをCLAUDE.mdに書き込もう——毎回のやり取りで同じ指示をAIに書き込んでいるな、と気づいたものがあれば、それはCLAUDE.mdに移す候補です。
階層間で矛盾させない——共通の事項は上位のCLAUDE.mdに、カテゴリ・案件固有の事項は下位のCLAUDE.mdに書きます。同じテーマについて、異なる階層に反対の指示を書かないようにしましょう。
機密情報は書かない——CLAUDE.mdは他の人と共有したり、バックアップされたりすることが多いファイルです。パスワードや口座情報など、外部に出せない情報は書かないようにします。
定期的に見直す——状況が変われば内容も古くなります。たまにClaude Codeに「CLAUDE.mdに書くべきことを、過去のセッションから考えてみて」と聞いてみたり、実際に自分の目でときおりCLAUDE.mdを確認してみたりして、定期的に見直すのがおすすめです。
長すぎないようにする——CLAUDE.mdは起動時に必ず読み込まれるので、その分コンテキストを消費します。長すぎる情報をそのまま書き込んでしまうと、それだけコンテキストを食ってしまうので、大きな情報を入れたいときは、たとえばinfo-companyのようにスキル化してしまうのも手です。

ただし一点、注意しておきたいことがあります。CLAUDE.mdはClaude Codeのふるまいを導くための指示であり、技術的な強制機能ではありません。機密ファイルへのアクセス禁止や特定のコマンドの実行禁止など、確実に制御したい事項については、権限設定やHooksなど、CLAUDE.mdとは別の仕組みと組み合わせる必要があります。

まとめ

CLAUDE.mdは、一度書いておけば、そのフォルダで作業するたびに自動で効き続ける「前提知識」のファイルです。GemsやGPTsのシステムプロンプトと似た発想でありながら、Claude Codeならではの「作業フォルダ」という概念があるからこそ、フォルダ単位・階層単位で使い分けられる点が最大の特徴です。まずは今のプロジェクトフォルダの直下に、いつも説明し直している内容を1つ書き出してみることから始めてみてください。