AIToday
用語解説

AGENTS.md とは?複数のAIツールで使える共通の指示書

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

公開日:最終更新日:

AGENTS.md とは?複数のAIツールで使える共通の指示書

この記事でわかること

  • 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. サブフォルダにも置けますか?
A. 置けます。多くのツールは、作業しているファイルにいちばん近い AGENTS.md を優先して読みます。フロントエンドとバックエンドでルールを分けたいときに使えます。
Q. AGENTS.md と README.md は何が違いますか?
A. README.md は人が読むための説明書で、AGENTS.md はAIが読むための指示書です。README に書くと人には細かすぎる内容(テストの流し方や細かいルール)を AGENTS.md に分けます。
Q. 決まった書き方はありますか?
A. ありません。必須の項目もなく、ふつうの Markdown で自由に書けます。
Q. 古い Claude Code で AGENTS.md を読ませるには?
A. CLAUDE.md を作って、1行目に「@AGENTS.md」と書きます。これで AGENTS.md の中身が取り込まれます。

出典:AGENTS.md 公式サイト

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

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

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

関連記事