見出し画像

MDファイルって何？｜Claude Codeを別物に育てる地味で一番面白い仕組み

HITO｜AI活用ノート

はじめに

「Claude Codeに何度同じ指示を出しても、また同じところで間違える…」「せっかくClaude Codeを導入したのに、思ったように動いてくれない…」

そんな経験はありませんか？

ここまでのnoteで、私は何度も「MDファイル」「CLAUDE.md」という言葉を使ってきました。

「CLAUDE.mdで自分仕様に育っていく」
「自分のキャリアをMDファイルに保存しておく」

毎回、サラッと触れてきただけでした。

肝心の「MDファイルって結局なんなの？」という説明は、後回しにしてきました。

実は、Claude Codeを「自分の相棒」に育てる仕組みの正体が、この「MDファイル」です。

派手な機能ではありませんが、Claude Codeの「最重要概念」です。

MDファイルは、ただのテキストファイルです。

でも、MDファイルがあるかないかで、Claude Codeの動きはまったく別物になります。

MDファイルを押さえずに使うと、結局「AIで作業してみたけど、自分でやったほうが早かった」という状態に陥ります。

冒頭のセリフに心当たりがある方は、ぜひ最後までお読みください。

この記事でわかること

  • MDファイル（CLAUDE.md）が何なのか、ざっくりとした概念

  • なぜMDファイルがClaude Codeに効くのか（ChatGPT時代との違い）

  • 最初の一歩を何から始めればいいか

MDファイルって何？（できるだけ簡単に）

ひとことで言うと、Markdownという形式で書かれた、ただのテキストファイルです。

拡張子は「.md」。

中身は本当にただのテキストで、専用の難しいツールも必要ありません。

普通のメモ帳のような感覚で書けます。

ただ、Claude Codeにとっては、MDファイルはただのテキストではなく「マニュアル」として機能します。


イメージは新人スタッフに渡す業務マニュアル

ピンと来ない方は、新人スタッフが入社してきたときに渡す「業務マニュアル」をイメージしてください。

新人さんに毎回口頭で「メールはこの型で書いて」「報告書はこのフォーマットで」「お客様の名前はこの順で並べて」と説明するのは、本当に大変です。

最初にマニュアルを1冊渡しておけば、新人さんはマニュアルを見ながら、一定の品質で仕事を進められます。

MDファイルがClaude Codeに対して果たす役割は、これとまったく同じです。

「私はこういう文体で書く」
「ブログの装飾はこのルールで揃える」
「報告のフォーマットはこの順番で」

そういうルールをMDファイルに書いておけば、Claude Codeは毎回それを踏まえて作業してくれます。

おかげで、Claude Codeに毎回イチから細かい指示を出さなくても、出力の精度が一定に保たれます。


CLAUDE.md とその他のMDファイルの違い

MDファイルには、役割が違う2種類があります。

1. CLAUDE.md（特別な1ファイル）

  • Claude Codeがフォルダを開いた瞬間に、必ず最初に読み込む

  • いわば「総合案内」「目次」のような立ち位置

  • 「このフォルダは何の作業に使うか」「どんなルールで動いてほしいか」「どのMDファイルを参照すべきか」を書いておく

2. その他のMDファイル（任意の数）

  • CLAUDE.mdに「この場面ではこのファイルを見て」と書いておけば、Claude Codeが必要に応じて読みに行く

  • 「ライティングスタイル」「繰り返しがちなミス」「自分のキャリア」など、目的別に分けて書いておく

新人スタッフの例で言うと、CLAUDE.mdは「入社時に渡すオリエンテーション資料」、その他のMDファイルは「業務別の詳細マニュアル」です。

オリエンテーション資料に「経理処理は別冊の経理マニュアルを見てね」と書いておけば、新人さんは経理のタスクのときだけ、経理マニュアルを取り出して読みます。

Claude Codeも同じで、まずCLAUDE.mdを読み、その作業に必要な別のMDファイルだけを取り出して読みます。

このおかげで、1つのCLAUDE.mdにすべてを詰め込む必要がなくなります。

なぜMDファイルがClaude Codeに効くのか？

私が一番便利だと感じているのは、Claude Codeに「同じことを2度言わなくていい」ことです。


ChatGPT時代との違い

私はもともと、ChatGPTを使って副業のブログの文章を書いていました。

ただ、正直に言うと、当時は使い物にならない場面が多かったです。

書いてもらった文章にはAI臭が残り、「この表現が変だから直して」と指摘して直してもらっても、別の箇所にまたAI臭が残る。

結局、修正作業のほうに時間がかかって、「自分でイチから書いたほうが早い」という状態でした。

今はまったく状況が違います。

MDファイルに、自分のライティングスタイル・思考の癖・パーソナリティをぜんぶ蓄積しているので、よっぽどじゃなければ変な文章が出てきません。

ワークフローも一緒にMDファイル化してあるので、Claude Codeに「ブログ書いて」と一言頼むだけで、ブログ制作が一気に進みます。


メモリじゃなく「ファイル」にする意味

ChatGPTにも「メモリ」という機能はあります。

ただ、メモリだけだと、AIが過去のやりとりを忘れたり、精度が落ちたりすることがあります。

一方、MDファイルに書き込んでおけば、Claude Codeは前回の指摘や決めごとを保持したまま、次の作業に進んでくれます。

毎回イチから作業する必要がなくなって、使えば使うほど、Claude Codeが「自分仕様の相棒」に育っていきます。

私がMDファイルを最初に作ったのは、実はClaude Codeを触る前でした。

普通のClaudeやChatGPTを使っているときに、「この情報をデータとしてちゃんと残しておきたいから、MDファイルにしておいて」と頼んだのが、最初のきっかけです。

そこからClaude Codeに移行したとき、ローカルのフォルダに置いたMDファイルを勝手に読みに行ってくれるとわかって、本当に便利だなと感じました。

プロジェクトにいちいちアップロードする手間もなくなりましたし、内容が古くなったらClaude Code自身がブラッシュアップしてくれます。

ClaudeやChatGPTのプロジェクト機能については、また別記事で解説します。


MDファイルなしでもClaude Codeは賢い

念のため正直に書いておくと、MDファイルがなくても、Claude Codeの文章生成力やリサーチ能力はかなり高いです。

普通にやりとりしていて「変な回答だな」と感じる場面も、ほぼありません。

ただ、MDファイルがあると、やりとりの裏でClaude Codeが先にコンテキスト（事前情報）を読みに行ってくれている感じがあります。

そこから、自分に最適化された回答を返してくれる。

「かゆいところに手が届いてくる」感覚、と言えばいちばん近いです。

「Claude Codeをちゃんと運用したい」と思ったら、MDファイルは避けて通れません。

私はどれくらいMDファイルを書いているか

正直なところ、自分のMDファイルの本数は、いちいち把握していません。

なので、Claude Codeにフォルダの中身を数えてもらいました。

結果は、CLAUDE.mdが「16個」、その他のMDファイルが「1,100本以上」（2026年8月時点）。

CLAUDE.mdが16個というのは、自分のフォルダの中を「ブログ」「日記」「家計」「キャリア」のような領域に分けていて、それぞれの領域ごとに「総合案内」のCLAUDE.mdを1個ずつ置いている状態です。

その下にぶら下がっているのが、領域ごとの個別マニュアルです。

1,100本すべてがマニュアルというわけではありません。

日記や記事の下書きも混ざった数字です。

たとえばブログの領域なら、「ライティングスタイル」「装飾ルール」「過去によく間違えたパターン集」「読者ペルソナ」のように、目的別に細かく分けて書いてあります。

最初からこんなに書こうと思っていたわけではありません。

「ブログ用のルールをまとめておこう」
「日記用は別にしたいな」
「転職活動の経歴も書いておくか」

そんな小さな積み上げで、気づいたらこの数になっていました。

書く内容によって、Claude Codeに読み込ませるCLAUDE.mdを切り替えます。

ブログを書くときはブログ領域のCLAUDE.mdとその関連MDファイル、日記を書くときは日記領域のCLAUDE.mdとその関連MDファイル、という使い分けです。

ただ、これは私が極端なだけです。

最初は1個のCLAUDE.mdから始めれば十分です。

最初の一歩｜MDファイルは「自分で書かなくていい」

ここが意外と知られていないのですが、MDファイルは自分でイチから書く必要はありません。

すべて、Claude Codeに任せれば作ってくれます。

たとえば、Claude Codeにこう聞くだけで十分です。

普段〇〇という仕事をしていて、Claude Codeを有効活用したい。
おすすめのMDファイルを私に合わせて3つ作ってください。

必要に応じて、わからないことは私に質問しながら進めてください。

これでClaude Codeが「じゃあ、まずはこんなMDファイルから作りましょう」と提案してくれます。

私自身、最初の頃は「全部自分で書かないとダメだ」と思い込んでいて、ハードルが高そうに感じていました。

でも実際には、Claude Codeに丸投げで作ってもらって、気になる部分だけあとから手直しすればいい、というのが正解でした。


何から始めるか：目的別の例

私の場合は、ブログを書きたかったので、まず自分のブログ記事をClaude Codeに読み込ませて「ライティングスタイルを学んでMDファイル化して」と頼みました。

ブログをやっていない方でも、目的に合わせて、こんな入り口があります。

  • 転職活動中の方：履歴書・職務経歴書・求人票を読み込ませて、「自分のキャリア・経歴を整理してMDファイル化して」

  • Claude Codeを人生の相棒のように育てたい方：自分の価値観・普段考えていること・仕事の内容・人間関係を音声入力で大量に流し込んで「これを整理してMDファイル化して」

  • とにかく1行から試したい方：「私の書く文章の文末はです・ますで統一してください」と1行書いて、CLAUDE.mdとしてフォルダに置く

特に最後の方法は、本当に1分でできます。

それだけでも、その後のClaude Codeの出力の語尾がちゃんと揃います。

書きながら「あ、こういうことも書いておきたい」と気づいたら、追記していけば自然に育っていきます。

私がしばらく気づかなかったこと｜「装飾もMDファイル化できる」

最後に、私自身が振り返って「もっと早くMDファイル化しておけばよかった」と感じた話を1つだけ。

最初の頃、私はMDファイルで管理できるのは「文章のルール」だけだと思い込んでいました。

ブログ記事の「飾りつけ」や「囲み枠」のデザインは、HTMLやCSSが絡みます。

だからMDファイル化できないものだと思っていました。

でも、よくよく考えたら、ブログの装飾もただのコードです。

HTMLとCSSというプログラムでできているので、そのコードをClaude Codeに読み取らせれば、装飾ルールもMDファイル化できます。

そのことに気づかせてくれたのは、AI活用のコミュニティで知り合った方の発言でした。

そこからは、装飾ルールもMDファイルに集約して、Claude Codeに「この記事も同じデザインで装飾して」と一言指示するだけで、ブログ作業がかなり短縮できるようになりました。

ちなみに、そのコミュニティ（あとがき）の主催者の「ひつじさん」の書籍もClaude Codeを勉強する上で、とても参考になります👇

話を戻しますが、「これはMDファイル化できないだろう」と思っているものは、たいていMDファイル化できます。

迷ったら、とりあえずClaude Codeに「これってMDファイル化できる？」と聞いてみてください。

まとめ｜MDファイルは Claude Code を使う上で避けて通れない

  • MDファイルは、Claude Codeに渡す「マニュアル」のようなもの

  • CLAUDE.mdは総合案内、その他のMDファイルは業務別の詳細マニュアル

  • 一度書いておけば、Claude Codeに同じ指示を何度も出さなくていい

  • ChatGPTのメモリと違って、精度が落ちずに前回の指摘を保持してくれる

  • 自分でイチから書く必要はない。Claude Codeに「おすすめのMDファイルある？」と聞けば作ってくれる

  • 文章だけでなく、装飾や仕事の手順も、コードがあるものはほぼ全部MDファイル化できる

MDファイルは派手な仕組みではありません。

でも、Claude CodeやCodexのようなAIエージェントを使う上で、MDファイルは避けて通れない「超基本概念」です。

ここを押さえないと、いつまでも「AIで書いたけど、自分で書いたほうが早かった」状態から抜け出せません。

私のフォルダにある1,100本も、最初は「です・ます」の1行から始まりました。

私が実際に使っているMDファイルは、こちらで15個ぜんぶ公開しています。

Claude Codeが初めての方は、始め方をこちらにまとめています。

HITO｜現役人事×AI実運用

元採用担当。人事・事務の実務にAIエージェントを持ち込む実験を発信しています。

インスタ・Threadsでも情報発信中👇

いいなと思ったら応援しよう！