Claude CodeのAGENTS.md対応｜CLAUDE.mdとの違いと移行5ステップ

2026-09-232026-09-26

「Claude CodeでもAGENTS.mdが使えるようになったって本当？」「CLAUDE.mdはもう消していいの？」「両方ある場合、どちらの指示が読まれるの？」

もしそう思っているなら、この記事は完全にあなたのためのものです。

筆者は40代の会社員（非エンジニア）。副業のYouTube、ブログ、音楽配信をAIに手伝ってもらうため、作業ルールをMarkdownファイルにまとめて運用しています。

2026年9月、Claude Codeの公式リリースノートにAGENTS.md対応が追加されました。ただし、「対応した＝今あるCLAUDE.mdをすぐ消してよい」ではありません。この記事では、公式情報で確認できた事実、筆者のMacで実測した状態、まだ試していない部分を分けて説明します。

この記事はこんな方向け

Claude CodeでCLAUDE.mdを使っている方
Codexなど複数のAIエージェントで同じ作業ルールを共有したい方
AGENTS.mdへ移行するべきか迷っている方
非エンジニアでも安全に動作確認できる手順を知りたい方

※ 本記事はChatGPTを用いて執筆しています。公式情報、筆者から提供された体験・記録、想定例を区別して記載します。

情報の確認日：2026年9月22日現在。 変わる可能性がある仕様は、Anthropicの公式リリース情報と公式解説、AGENTS.mdの公式サイトで確認しました。

🎙 この記事に登場するキャラ

社長 — 筆者本人（40代・副業YouTuber）
策 — Claude Code（参謀AI・冷静な軍師）
凛 — Claude.ai（秘書AI・ちょいドS姉御）

社長：「AGENTS.mdに対応したなら、CLAUDE.mdはもういらないのか？」

凛：「新機能を見た瞬間に正本を消そうとしない。まず今のバージョンと読み込み条件を確認しなさい。」

策：「結論は、すぐに削除せず、小さなテストで確認してから移行です。公式情報と実測を分けて見ていきます。」

📌 目次（クリックでジャンプ）

1. 【問題提起】AGENTS.md対応で何が分かりにくいのか
- 1-1. 3つの情報を混ぜると判断を誤る
- 1-2. 「対応」と「自分の環境で使える」は別
2. 【AI導入で変わった】1つの作業ルールを複数エージェントで共有しやすくなる
- 2-1. CLAUDE.mdは今もClaude Codeの正式な案内板
- 2-2. AGENTS.mdは共通部分の受け皿になり得る
3. 【具体例】今のプロジェクトで確認した3つの事実
4. 【じゃあどうやる？】CLAUDE.mdを消さずに確認する5ステップ
5. よくある質問（FAQ）
6. まとめ｜AGENTS.md対応は「すぐ移行」ではなく「共有しやすくなった」
- 次に読むべき記事

1. 【問題提起】AGENTS.md対応で何が分かりにくいのか

AGENTS.mdは、人間向けのREADMEに近い形で、AIエージェントへ作業ルールを伝えるためのファイルです。プロジェクトの概要、ビルド方法、テスト手順、コードの書き方、セキュリティ上の注意などをMarkdownで記録します。

AGENTS.md公式サイトでは、AGENTS.mdを「エージェント向けのREADME」と説明しています。ルートに置く方法に加え、大きなプロジェクトではフォルダごとに置き、最も近いファイルの指示を優先する設計が示されています。

一方、Claude Codeには以前からCLAUDE.mdがあります。こちらも、プロジェクトのルールをClaude Codeへ伝えるためのファイルです。役割が似ているため、「名前が違うだけなのか」「片方へ統一できるのか」が分かりにくいのです。

1-1. 3つの情報を混ぜると判断を誤る

今回のような新機能では、次の3つを分ける必要があります。

種類	この記事での扱い
公式事実	リリースノートや公式解説に書かれた内容
筆者の実測	筆者のMacで確認できたバージョンやファイル構成
推測・想定	公式文から考えられる運用方法。未検証と明記

検索結果には、AGENTS.mdへ未対応だった時期の記事も残っています。当時の記事が間違いなのではなく、Claude Code側の仕様が後から変わった可能性があります。日付とバージョンを見ずに結論だけ読むと、古い情報と新しい情報が衝突します。

1-2. 「対応」と「自分の環境で使える」は別

AnthropicのClaude Code公式リリースによると、2026年9月18日公開のバージョン2.1.277でAGENTS.md対応が追加されました。説明は「プロジェクトにCLAUDE.mdがない場合、代わりにAGENTS.mdを読む」という内容です。また、読み込むファイルはClaude Codeの/configにある「Project instructions」で変更できるとされています。

ただし、同じ説明には、記事確認時点でBedrock、Vertex、Foundryではまだ利用できないという注意もあります。利用経路やバージョンによって条件が違うため、ファイルを置くだけで必ず同じ動きになるとは断定できません。

社長：「公式が対応したなら、自分のMacでも今日から同じ動きになるんじゃないのか？」

凛：「更新されていなければ別。『最新版の仕様』と『手元の実行環境』は同じではないわ。」

策：「まずclaude --versionで現在地を測ります。対応条件を満たしてから、読み込みテストへ進む順番です。」

2. 【AI導入で変わった】1つの作業ルールを複数エージェントで共有しやすくなる

AGENTS.md対応の価値は、ファイル名が1つ増えたことではありません。複数のAIエージェントを使う現場で、共通ルールの置き場所をそろえやすくなることです。

筆者の作業フォルダには、記事確認時点でAGENTS.mdとCLAUDE.mdの両方が存在しています。これはローカルファイルを確認した実測です。しかし、筆者のClaude Codeはバージョン2.1.158でした。AGENTS.md対応が追加された2.1.277より前なので、新しい読み込み動作はまだ実機検証していません。

2-1. CLAUDE.mdは今もClaude Codeの正式な案内板

Anthropicの公式解説では、ルートのCLAUDE.mdはセッション開始時に読み込まれ、会話中も文脈として保持されると説明されています。長大な手順書ではなく、200行未満を目安に、全体像や参照先を示す索引として使う考え方です。

つまり、CLAUDE.mdは突然無効になったわけではありません。2.1.277の説明も「CLAUDE.mdがない場合にAGENTS.mdを読む」という条件です。両方あるプロジェクトで既定の読み込みがどうなるかは、文面上はCLAUDE.mdが残ると読むのが自然ですが、ここは公式文からの解釈です。自分の環境では/configの表示を確認してください。

2-2. AGENTS.mdは共通部分の受け皿になり得る

AGENTS.mdには、次のような複数エージェント共通のルールを置きやすいでしょう。

プロジェクトの目的とフォルダ構成
実行するテストと確認コマンド
秘密情報をソースへ書かないなどの安全ルール
既存ファイルを勝手に戻さない編集ルール
公開や削除の前に確認する承認ルール

一方、Claude Codeだけで使う機能や参照方法は、CLAUDE.mdに残すほうが混乱を減らせます。これは現時点のおすすめ運用であり、Anthropicが両ファイルの分割方法を指定しているわけではありません。

社長：「共通ルールをAGENTS.md、Claude専用をCLAUDE.mdに分ければ、二重管理が減りそうだな。」

凛：「ただし、同じ命令を両方に書いて内容がズレたら逆効果。正本がどちらかは明記して。」

策：「まずは共通ルールを移す候補だけ洗い出し、削除せず検証します。移行と整理を同じ日にやらないのが安全です。」

PR / アフィリエイトリンク

3. 【具体例】今のプロジェクトで確認した3つの事実

ここでは、公式情報と筆者環境の実測を混ぜずに並べます。

3-1. 公式事実：2.1.277でAGENTS.md対応が追加された

2026年9月22日に確認した公式リリース情報では、2.1.277に次の変更が記載されています。

CLAUDE.mdがないプロジェクトではAGENTS.mdを読む
/configの「Project instructions」で変更できる
Bedrock、Vertex、Foundryは記事確認時点で未対応

今後の更新で条件が変わる可能性があるため、実際に移行する日は公式リリース一覧を再確認してください。

3-2. 実測：筆者のClaude Codeは2.1.158だった

筆者のMacで次のコマンドを実行しました。

claude --version

結果は2.1.158 (Claude Code)でした。したがって、この記事では「筆者環境でもAGENTS.mdの自動読み込みを確認できた」とは書きません。公式情報は確認済み、手元の新機能は未検証です。

3-3. 実測：AGENTS.mdとCLAUDE.mdが両方ある

筆者のプロジェクトには両ファイルがあります。CLAUDE.mdは全体の索引、AGENTS.mdは複数のAIが共有するルールとして使っています。ただし、現在のClaude Codeがどちらを自動的に読んだかは、ファイルが存在するだけでは証明できません。

確認には、/configの「Project instructions」を見る方法と、安全な一時ルールを置いて応答を比べる方法を使います。後者は公開や削除を伴わない小さなテストにしてください。

社長：「ファイルがあるんだから、読んでいると思っていたぞ。」

凛：「置いたことと読まれたことは別。自動化で一番危ない思い込みね。」

策：「画面の設定と、壊れていたら差が出るテストの二経路で確認します。空の結果を成功扱いしないことも重要です。」

4. 【じゃあどうやる？】CLAUDE.mdを消さずに確認する5ステップ

おすすめは、現行ファイルを残したまま、読み込み先を確認することです。いきなり名前を変えたり、CLAUDE.mdを削除したりする必要はありません。

Step 1. 現在のバージョンを確認する

ターミナルで次を実行します。

claude --version

2.1.277より前なら、この記事で紹介したAGENTS.md対応の条件を満たしていません。更新する場合は、利用中の導入方法に合う公式手順を確認してください。インストール方法が違えば、更新方法も同じとは限りません。

Step 2. 2つのファイルを消さずに役割をメモする

現在のAGENTS.mdとCLAUDE.mdについて、次の3分類を作ります。

分類	例
共通ルール	テスト、命名、安全、公開前の承認
Claude専用	Claude Code固有の機能や参照先
重複・矛盾	両方にあり、内容が違う指示

この段階では編集せず、重複と矛盾を見つけるだけで構いません。プロジェクトのルールを整理する考え方は、Claude Codeメモリ棚卸し術でも詳しく紹介しています。

Step 3. `/config`でProject instructionsを確認する

Claude Codeで/configを開き、「Project instructions」に何が指定されているか確認します。2.1.277の公式説明では、ここで読み込むファイルを変更できます。

表示がCLAUDE.mdなら、AGENTS.mdが同じフォルダにあっても、まずCLAUDE.mdを正本として扱うのが安全です。表示がAGENTS.mdなら、そのファイルに必要な共通ルールが揃っているか確認します。

Step 4. 壊れていたら差が出る小さなテストをする

想定例として、作業に影響しない一時的な確認文を対象ファイルへ追加します。

確認テスト中は、最初の返答に「指示ファイル確認済み」と書く。

新しいセッションを開き、指示どおりの返答になるか確かめます。確認できたら一時文だけを元に戻します。本番ファイルを上書きする前にはバックアップを取り、公開中の処理がない時間に行ってください。

Step 5. 共通ルールだけを段階的に寄せる

テストが通ったら、共通ルールをAGENTS.mdへ寄せます。CLAUDE.mdはすぐ削除せず、Claude固有の案内とAGENTS.mdへの参照を残します。

大事なのは、同じルールを2か所で長期間更新しないことです。正本と参照先を決め、1項目ずつ移します。AIの記憶とファイルの役割を整理したい方は、Claude Codeのメモリとドキュメントを3分類した方法も参考になります。

社長：「消す前に、バージョン、設定、実際の返答まで見る。これなら非エンジニアでも確認できるな。」

凛：「そう。新機能の移行で必要なのは勢いではなく、戻せる順番よ。」

策：「旧ファイルを残しておけば、想定と違ってもすぐ戻せます。確認が終わるまで削除しないのが最短です。」

5. よくある質問（FAQ）

Q1. CLAUDE.mdは今すぐAGENTS.mdへ改名すべきですか？

いいえ。 2026年9月22日現在の公式説明は「CLAUDE.mdがない場合にAGENTS.mdを読む」です。まずバージョンと/configを確認し、読み込みテストを通してから判断してください。

Q2. AGENTS.mdとCLAUDE.mdを両方置いても大丈夫ですか？

ファイルを両方置くこと自体はできます。ただし、同じルールが食い違うと判断が不安定になります。共通ルールとClaude専用ルールを分け、どちらが正本かを書いておくのがおすすめです。

Q3. AGENTS.mdはどこに置けばいいですか？

AGENTS.md公式サイトでは、プロジェクトのルートに置く基本形と、フォルダごとに追加する方法が案内されています。複数ある場合は、編集対象に最も近いAGENTS.mdの指示が優先される設計です。

Q4. 古い解説記事と内容が違うのはなぜですか？

Claude CodeのAGENTS.md対応は2026年9月18日の2.1.277で追加されたため、それ以前の記事は未対応だった当時の説明である可能性があります。公開日だけでなく、対象バージョンと公式リリースを確認してください。

Q5. 読み込みテストで反応が変わらない場合は？

バージョン、/configの指定、ファイル名、配置場所、新しいセッションで試したかを順に確認します。それでも分からない場合は、既存のCLAUDE.md運用へ戻し、原因を1つずつ分けてください。