AGENTS.md とは?複数のAIツールで使える共通の指示書
著者:高橋 輝(AITODAY プロダクトオーナー)
公開日:最終更新日:

この記事でわかること
- AGENTS.md は、複数のAIコーディングツールが共通で読む指示書
- Codex、Cursor、GitHub Copilot、Gemini CLI など25以上のツールが対応している
- Claude Code も、CLAUDE.md が無いプロジェクトでは AGENTS.md を読む
Codex、Cursor、GitHub Copilot など25以上のAIツールが読む AGENTS.md の役割と、CLAUDE.md との関係、迷わない置き方。
一言でいうと、AGENTS.md は、ツールごとにバラバラだったAIへの指示書を1つにまとめるための共通ファイルです。1つ書いておけば、Codex でも Cursor でも同じルールで動いてくれます。
AGENTS.md とは
もとは OpenAI の Codex 向けの決まりごとでしたが、今は Linux Foundation 傘下の Agentic AI Foundation が管理するオープンな形式になっています。6万以上のオープンソースのプロジェクトで使われています。
中身はただの Markdown で、必須の項目はありません。プロジェクトの一番上に置いておくと、対応しているツールが自動で見つけて読みます。
なぜ生まれたのか
2025年ごろまで、AIツールはそれぞれ自分専用の指示書を使っていました。
- Claude Code は CLAUDE.md
- Cursor は .cursorrules
- GitHub Copilot は copilot-instructions.md
- Gemini CLI は GEMINI.md
複数のツールを使う人は同じ内容を何個も書くことになり、少しずつ中身がずれていく問題がありました。それを1つにまとめるために出てきたのが AGENTS.md です。
対応しているツール
OpenAI Codex、Cursor、GitHub Copilot、Gemini CLI、Devin、Windsurf、Jules、VS Code、Zed、Aider など、25以上のツールが対応しています。
Claude Code も、v2.1.277 から AGENTS.md を読むようになりました。ただし読み方に条件があるので、次で説明します。
CLAUDE.md との関係
ここが一番迷うところです。Claude Code の場合、プロジェクトにあるファイルによって読むものが変わります。
| プロジェクトにあるもの | Claude Code が読むもの |
|---|---|
| AGENTS.md だけ | AGENTS.md |
| AGENTS.md と CLAUDE.md(または CLAUDE.local.md) | CLAUDE.md の方だけ |
| CLAUDE.md の中に「@AGENTS.md」と書いてある | 両方(AGENTS.md の中身が取り込まれる) |
両方読ませたい場合は、Claude Code の /config で「Project instructions」を両方読む設定に変えることもできます。
CLAUDE.md が無いプロジェクトで Claude Code を起動すると、AGENTS.md を読んだことが次の1行で表示されます。
no CLAUDE.md found; AGENTS.md loaded: /Users/you/project/AGENTS.md
ポイント複数のツールを使うなら、ルールの中身は AGENTS.md に書き、CLAUDE.md には「@AGENTS.md」の1行と Claude だけに伝えたいことを書く形が、いちばん中身がずれません。
そのまま使えるテンプレート
# このプロジェクトについて
(1〜2行で、何をするためのプロジェクトか)
# 開発の進め方
- 開発サーバー起動: npm run dev
- テスト: npm test
- 変更したら必ずテストを通してからコミットする
# コードのルール
- 新しいファイルは src/ の中に作る
- 関数名は英語、コメントは日本語
# やってはいけないこと
- 本番のデータベースに直接書き込まない
よくある勘違い
- 「Claude Code では使えない」:今は使えます。以前は読みませんでしたが、v2.1.277 以降は CLAUDE.md が無ければ AGENTS.md を読みます。
- 「AGENTS.md を置けば CLAUDE.md も読んでくれる」:逆です。Claude Code は CLAUDE.md(自分用の CLAUDE.local.md も含む)があるとそちらを優先し、AGENTS.md を読みません。両方読ませたいなら CLAUDE.md に「@AGENTS.md」と書きます。
まとめ
AGENTS.md は、複数のAIツールで共通に使える指示書です。Claude Code だけなら CLAUDE.md で十分ですが、Codex や Cursor も使うなら、中身を AGENTS.md に寄せておくと書き直しの手間がなくなります。
次に読む
よくある質問
Q. サブフォルダにも置けますか?
Q. AGENTS.md と README.md は何が違いますか?
Q. 決まった書き方はありますか?
Q. 古い Claude Code で AGENTS.md を読ませるには?
あなたの仕事に関係する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との関係、今日からできること。

