なぜAIツールは .md ファイルばかりなのか
著者:高橋 輝(AITODAY プロダクトオーナー)
公開日:最終更新日:

この記事でわかること
- .md は人もAIも読めるただのテキストファイルで、記号だけで見出しや箇条書きをつける
- CLAUDE.md・AGENTS.md・SKILL.md など、AIツールの指示書はほぼ全部この形式
- CLAUDE.md は日本語の箇条書き10行から始められ、プログラミングの知識はいらない
Claude Code、Codex、Cursor が指示を受け取る .md(Markdown)とは何か。CLAUDE.md・AGENTS.md・SKILL.md の役割と、10行で書ける中身の例。
一言でいうと、.md は「人もAIも読める、いちばん軽いテキストファイル」です。Claude Code、Codex、Cursor など、いまのAIツールはほぼ全部この形式で指示を受け取ります。自分で書く必要があるのは、ツールに毎回同じことを説明したくなった時だけです。
.md とは
Markdown(マークダウン)形式のテキストファイルです。中身はただの文字で、見出しは「#」、箇条書きは「-」のように、記号だけで構造をつけます。メモ帳でも開けますし、GitHubやNotionに貼れば見出しや箇条書きがそのまま整って表示されます。

なぜAIツールは .md を使うのか
理由は3つです。
- AIが読みやすい。WordやPDFと違って飾りがないので、AIは文章と構造だけを受け取れます。学習データにもGitHubのREADMEなど大量の .md が含まれているので、AIにとって一番なじみのある形式です。
- 人も読める。設定ファイル(JSONやYAML)と違って、開けばそのまま日本語の文章として読めます。エンジニアでなくても直せます。
- 差分が追える。ただのテキストなので、Gitで「誰がいつどこを変えたか」が残ります。AIへの指示を社内で共有・更新するのに向いています。
AIツールで出てくる .md の仲間
| ファイル名 | 役割と、出てくるツール |
|---|---|
| CLAUDE.md | このプロジェクトでClaudeに毎回守らせたいルール(Claude Code、Cowork) |
| AGENTS.md | 1つ書けば複数ツールで使える共通の指示書。Claude Code も CLAUDE.md が無ければこれを読む(Codex、Cursor、GitHub Copilot など) |
| SKILL.md | 「この作業はこの手順でやる」という作業単位の指示書(Claude Code、Cursor、Codex など多数) |
| README.md | 人向けの説明書。AI向けではないが、AIも最初に読む(GitHub全般) |
| .cursorrules、.mdc | Cursor専用のルールファイル。中身はほぼ .md(Cursor) |
| llms.txt | 自分のサイトをAIに読ませるための案内ファイル。拡張子は違うが中身はMarkdown(Webサイト) |

CLAUDE.md は、よく使う置き場所が2つあります。プロジェクトのフォルダに置けばそのプロジェクトだけ、自分のホームフォルダの ~/.claude/ に置けばすべてのプロジェクトで読まれます(ほかに自分だけ用・会社用の置き場所もあります)。実際に読み込まれたファイルは、Claude Codeで /context と打つと確認できます。
実際の中身(CLAUDE.md の例)
# このプロジェクトについて
AIニュースを毎朝メールで配信するサービスのリポジトリ。
# ルール
- 回答は日本語で
- 本番DBには書き込まない
- 変更したらテストを実行してから報告する
# よく使うコマンド
- 開発サーバー起動: npm run dev
- テスト: npm test
これだけです。
ポイント10行程度から始めて、AIに同じ注意を2回したら1行足す、くらいで十分です。

よくある勘違い
- 「プログラミングの知識がないと書けない」:いりません。日本語の箇条書きで書けます。上の例にコードは1行もありません。
- 「長く書くほど賢くなる」:逆です。長いと読み飛ばされます。本当に毎回守ってほしいことだけに絞ってください。
まとめ
.md は「人もAIも読める、いちばん軽いテキストファイル」で、いまのAIツールはほぼ全部この形式で指示を受け取ります。まずは CLAUDE.md を10行ほど書いて、AIに同じ注意を2回したら1行足す、という使い方から始めてみてください。
次に読む
よくある質問
Q. .md ファイルはどのアプリで開けますか?
Q. CLAUDE.md と AGENTS.md は両方必要ですか?
Q. CLAUDE.md はどこに置けばいいですか?
Q. 英語で書かないといけませんか?
あなたの仕事に関係するAIニュースを、毎朝お届けします。
業界と使っているAIツールを選ぶと、仕事に関係するニュースが毎朝届きます。
登録無料・Googleアカウントなら30秒・いつでも解除できますAITodayについて →
関連記事
- 用語解説
Copilot Chat(Basic)とは?ExcelやWordからCopilotが消えた理由
ExcelやWordからCopilotが消えたときに出る「Copilot Chat(Basic)」の意味を、専門用語なしで解説。ライセンスなしで使える範囲、使い続ける方法と料金。
- 用語解説
AIエージェントとは?「答える」AIから「やっておいてくれる」AIへ
ニュースで毎日のように見る「AIエージェント」の意味を、専門用語なしで解説。チャットAIとの違い、何ができるか、仕事で使うときの注意。
- 用語解説
コンテキストエンジニアリングとは?プロンプトの「書き方」より「何を渡すか」
プロンプトエンジニアリングの次に注目されているコンテキストエンジニアリングの意味を、専門用語なしで解説。何が違うのか、CLAUDE.md・RAG・MCPとの関係、今日からできること。

