AIToday
用語解説

なぜAIツールは .md ファイルばかりなのか

著者:(AITODAY プロダクトオーナー)

公開日:最終更新日:

なぜAIツールは .md ファイルばかりなのか

この記事でわかること

  • .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に貼れば見出しや箇条書きがそのまま整って表示されます。

左がGitHubのRaw表示(記号がそのまま見える素の状態)、右が通常表示(見出しや箇条書きが整った状態)

なぜAIツールは .md を使うのか

理由は3つです。

  1. AIが読みやすい。WordやPDFと違って飾りがないので、AIは文章と構造だけを受け取れます。学習データにもGitHubのREADMEなど大量の .md が含まれているので、AIにとって一番なじみのある形式です。
  2. 人も読める。設定ファイル(JSONやYAML)と違って、開けばそのまま日本語の文章として読めます。エンジニアでなくても直せます。
  3. 差分が追える。ただのテキストなので、Gitで「誰がいつどこを変えたか」が残ります。AIへの指示を社内で共有・更新するのに向いています。

AIツールで出てくる .md の仲間

ファイル名役割と、出てくるツール
CLAUDE.mdこのプロジェクトでClaudeに毎回守らせたいルール(Claude Code、Cowork)
AGENTS.md1つ書けば複数ツールで使える共通の指示書。Claude Code も CLAUDE.md が無ければこれを読む(Codex、Cursor、GitHub Copilot など)
SKILL.md「この作業はこの手順でやる」という作業単位の指示書(Claude Code、Cursor、Codex など多数)
README.md人向けの説明書。AI向けではないが、AIも最初に読む(GitHub全般)
.cursorrules、.mdcCursor専用のルールファイル。中身はほぼ .md(Cursor)
llms.txt自分のサイトをAIに読ませるための案内ファイル。拡張子は違うが中身はMarkdown(Webサイト)

Claude Codeで /memory と打つと、CLAUDE.mdの置き場所が一覧で出る

CLAUDE.md は、よく使う置き場所が2つあります。プロジェクトのフォルダに置けばそのプロジェクトだけ、自分のホームフォルダの ~/.claude/ に置けばすべてのプロジェクトで読まれます(ほかに自分だけ用・会社用の置き場所もあります)。実際に読み込まれたファイルは、Claude Codeで /context と打つと確認できます。

実際の中身(CLAUDE.md の例)

# このプロジェクトについて
AIニュースを毎朝メールで配信するサービスのリポジトリ。

# ルール
- 回答は日本語で
- 本番DBには書き込まない
- 変更したらテストを実行してから報告する

# よく使うコマンド
- 開発サーバー起動: npm run dev
- テスト: npm test

これだけです。

ポイント

10行程度から始めて、AIに同じ注意を2回したら1行足す、くらいで十分です。

上の10行をエディタで開いた画面

よくある勘違い

  • 「プログラミングの知識がないと書けない」:いりません。日本語の箇条書きで書けます。上の例にコードは1行もありません。
  • 「長く書くほど賢くなる」:逆です。長いと読み飛ばされます。本当に毎回守ってほしいことだけに絞ってください。

まとめ

.md は「人もAIも読める、いちばん軽いテキストファイル」で、いまのAIツールはほぼ全部この形式で指示を受け取ります。まずは CLAUDE.md を10行ほど書いて、AIに同じ注意を2回したら1行足す、という使い方から始めてみてください。

次に読む

よくある質問

Q. .md ファイルはどのアプリで開けますか?
A. メモ帳やテキストエディットなど、文字を開けるアプリならどれでも開けます。見出しや箇条書きが整った状態で見たい場合は、VS Code、GitHub、Notion が便利です。
Q. CLAUDE.md と AGENTS.md は両方必要ですか?
A. どちらか1つで足ります。Claude Code だけなら CLAUDE.md、Codex や Cursor も使うなら AGENTS.md にまとめるのがおすすめです。Claude Code も、CLAUDE.md(自分用の CLAUDE.local.md を含む)が無いプロジェクトでは AGENTS.md を読みます。
Q. CLAUDE.md はどこに置けばいいですか?
A. そのプロジェクトだけで使うなら、プロジェクトのフォルダの一番上に置きます。すべてのプロジェクトで使いたいルールは、ホームフォルダの ~/.claude/CLAUDE.md に書きます。
Q. 英語で書かないといけませんか?
A. 日本語で大丈夫です。AIは日本語の指示も問題なく読めます。

あなたの仕事に関係するAIニュースを、毎朝お届けします。

業界と使っているAIツールを選ぶと、仕事に関係するニュースが毎朝届きます。

登録無料・Googleアカウントなら30秒・いつでも解除できますAITodayについて →

関連記事