【Claude Code AGENTS.md対応】ついにClaude Codeが業界標準に歩み寄り！仕組み・使い方・活用シーンを徹底解説

2026年9月19日、AnthropicがClaude Codeにおける「AGENTS.md」のネイティブサポートを発表しました！

これまで、Claude Codeだけが業界標準のAGENTS.mdを読み込めず、開発者はCLAUDE.mdとAGENTS.mdを二重管理する手間を強いられていました。Shopify CEOのTobi Lutke氏がXで「AGENTS.mdに対応しないならClaude Codeを社内で禁止する」と発言するなど、業界から強い要望が寄せられていた機能です。

この記事では、Claude CodeにおけるAGENTS.md対応の仕組みや使い方、活用シーンまでを徹底的に解説します。

【監修者】田村 洋樹

株式会社WEEL代表取締役 / 累計25社以上のAIアドバイザリーを担当 / 企業向けセミナー・大学講義でのべ10,000人超に登壇 / 日本HP・インテルなど、大手企業主催カンファレンスへの登壇実績多数。AI導入支援・生成AIを活用した業務改革のプロとして、アドバイザリー・PM・講演者など多面的な立場から企業を支援中。

Claude CodeのAGENTS.md対応とは？

Claude CodeのAGENTS.md対応は、複数のAIコーディングエージェント間でプロジェクト指示を共通化する「AGENTS.md」ファイルを、Claude Codeが直接読み込めるようにしたアップデートです。

AGENTS.mdとは、リポジトリのルートに配置するMarkdownファイルで、AIコーディングエージェントに対してビルドコマンドやテスト手順、コーディング規約、セキュリティ上の注意点などを伝えるためのオープンな標準フォーマットです。2025年にOpenAI Codexの開発とともに生まれ、その後Linux Foundation傘下のAgentic AI Foundation（AAIF）が標準化を推進しています。

しかし、AnthropicのClaude Codeだけは独自のCLAUDE.mdしか読み込まない仕様を貫いてきました。複数のAIツールを併用する開発チームにとって、これは大きな課題でした。CLAUDE.mdとAGENTS.mdにほぼ同じ内容を書き、片方を更新するたびにもう一方も手動で同期するという二重管理が必要だったためです。

この問題は、Claude CodeのGitHub Issue Tracker上でIssueとして報告され、さらに2026年8月にはShopify CEOのTobi Lutke氏が「Claude Codeを社内で禁止することも検討している」とXに投稿し、AnthropicのエンジニアリーダーであるThariq氏が「対応を進めている」と回答する事態にまで発展したという背景があります。

そして2026年9月19日、Claude Code バージョン2.1.277でついにAGENTS.mdのネイティブサポートが追加されました。デフォルト設定では、プロジェクト内にCLAUDE.mdが存在しない場合に自動的にAGENTS.mdがフォールバックとして読み込まれます。これによって、AGENTS.mdをSingle Source of Truth（唯一の信頼できる情報源）として管理することが現実的になりました。

Claude Code AGENTS.md対応の仕組み

AGENTS.md対応がどのような技術的アーキテクチャで実装されているのか、ここではその内部構造を解説します。

今回のAGENTS.md対応は、Claude Codeのエンジン本体を直接変更するのではなく、「mod」と呼ばれる新しい拡張レイヤーを通じて実装されました。modsとは、2026年9月にClaude Codeに導入された拡張機構で、TypeScriptの関数を使ってエンジンのイベントそのものをフックし、振る舞いを上書きできる仕組みです。従来のhooksがシェルコマンドでイベントの前後に反応するのに対し、modはイベントの中身を直接書き換えて次の処理へ流すことができます。

具体的には、agents-mdという名前の同梱modが、以下の4つのモードで動作します。

デフォルトのclaude-md-or-agents-mdモードでは、Claude Codeが作業ディレクトリからルートに向かってCLAUDE.md・.claude/CLAUDE.md・CLAUDE.local.mdを探索し、いずれも見つからなかった場合にのみAGENTS.mdを読み込みます。読み込まれたAGENTS.mdの内容は、Claude Codeのプロンプトコンテキストに対して「プロジェクト指示ファイル」として注入されるため、CLAUDE.mdとまったく同じ位置づけで扱われます。

Claude Code AGENTS.md対応の特徴

概要で触れた内容と重複しないよう、ここではより実践的な特徴に焦点を当てて解説します。

まず注目したいのは、ネストされたAGENTS.mdにも対応している点です。

ルートディレクトリにはプロジェクト全体のルールを、ios/やbackend/などのサブディレクトリにはそれぞれ固有のルールを配置できます。agents-md modは、Claude Codeがファイルを読み取る際に、そのディレクトリ階層に対応するAGENTS.mdを動的にコンテキストへ追加します。ただし、あるディレクトリにCLAUDE.mdが存在する場合は、そちらが優先される仕組みです。

次に、CLAUDE.mdとの併用が柔軟に設計されているのもポイントです。

デフォルトのclaude-md-or-agents-mdモードでは排他的な読み込みですが、/configからclaude-md-and-agents-mdモードに切り替えると、AGENTS.mdとCLAUDE.mdの両方をプロジェクト指示として同時に読み込めます。「AGENTS.mdに共通ルール、CLAUDE.mdにはClaude Code固有の指示」という役割分担が可能になるため、マルチツール環境でも最適化された指示を維持できます。

Claude Code AGENTS.md対応の安全性・制約

便利な新機能ですが、いくつか把握しておくべき制約があります。

まず、2026年9月時点でAmazon Bedrock・Google Cloud Vertex AI・Microsoft Foundry経由のClaude Codeでは、AGENTS.md対応は未提供です。クラウドプロバイダ経由でClaude Codeを運用しているチームは、引き続きCLAUDE.md前提の構成を維持する必要があります。

また、アップグレード直後の1回目のセッションではAGENTS.mdが読み込まれないという挙動が確認されています。2回目以降のセッションから正常に機能するため、「更新したのに効かない」と早合点しないよう注意が必要です。

加えて、CLAUDE.local.mdを配置するとAGENTS.mdが読み込まれなくなる点にも気をつけましょう。CLAUDE.local.mdは「CLAUDE.mdが存在する」と判定されるため、デフォルトモードではAGENTS.mdへのフォールバックが発生しません。両方読ませたい場合は、設定をclaude-md-and-agents-mdに変更してください。

Claude Code AGENTS.md対応の料金

AGENTS.md自体はオープンな標準フォーマットであり、ファイルの作成・配置・読み込みに追加料金は一切かかりません。ただし、AGENTS.mdを読み込むClaude Codeの利用には、以下の料金プランが関係します。

Claude Code AGENTS.md対応のライセンス

AGENTS.md標準と、Claude Code本体のそれぞれのライセンスについても整理しておきましょう。

AGENTS.md標準のリポジトリはMITライセンスで公開されており、自由に利用・改変・配布が可能です。一方、Claude Code本体およびagents-md modのソースコードはApache 2.0ライセンスで公開されています。

いずれもオープンソースライセンスであるため、自社プロジェクトでの利用やカスタマイズに制約はほぼありません。ただし、Apache 2.0ライセンスでは再配布時に著作権表示とライセンス文の添付が必須となるため、agents-md modを改変して社内ツールに組み込む場合はその点だけ注意してください。

Claude Code AGENTS.md対応の使い方

ここからは、実際にAGENTS.mdを活用するための具体的な手順を紹介します。

STEP

Claude Codeを最新バージョンに更新する

まずはClaude Codeをバージョン2.1.277以降に更新します。ターミナルで以下のコマンドを実行してください。

claude update

バージョンを確認するには、以下を実行します。

claude --version

2.1.277以降であれば、AGENTS.md対応が含まれています。

STEP

AGENTS.mdファイルを作成する

プロジェクトのルートディレクトリにAGENTS.mdファイルを作成します。中身はプレーンなMarkdownで、プロジェクト固有のルールや手順を記載します。

touch AGENTS.md

以下は最小構成の一例です。

# AGENTS.md

## Project overview
- TypeScript + Next.js 14
- パッケージマネージャ: pnpm

## Build & test commands
pnpm install
pnpm dev        # 開発サーバー起動
pnpm test       # テスト実行
pnpm lint       # Lint実行

## Code style
- Formatter: Prettier
- Linter: ESLint + @typescript-eslint
- 変数名はcamelCase、コンポーネントはPascalCase

## Testing
- テストフレームワーク: Vitest
- 新機能には必ずユニットテストを追加する

## Security
- 環境変数はハードコードしない
- ユーザー入力は必ずバリデーションする

ポイントは、AIエージェントがコードベースから自動で推測できない情報に絞ることです。ビルドコマンドの正確なフラグ、言語デフォルトと異なるコーディング規約、セキュリティ上の注意点などが該当します。

STEP

既存のCLAUDE.mdからの移行

すでにCLAUDE.mdを運用しているプロジェクトでは、AGENTS.mdへの移行も選択肢に入ります。デフォルト設定のclaude-md-or-agents-mdモードでは、CLAUDE.mdを削除またはリネームすればAGENTS.mdが自動的に読み込まれるようになります。

もっとも安全な移行方法は以下の手順です。

# 1. CLAUDE.mdの内容をAGENTS.mdへコピー
cp CLAUDE.md AGENTS.md

# 2. Claude Code固有の指示を除去し、ツール共通の指示に整理
# 3. CLAUDE.mdを削除（またはバックアップ）
mv CLAUDE.md CLAUDE.md.bak

Claude Code固有の指示が残っている場合は、CLAUDE.mdを残したうえで設定をclaude-md-and-agents-mdに変更し、両方読み込ませる方法もあります。

STEP

読み込みモードを変更する

デフォルトのフォールバック動作を変更したい場合は、Claude Codeのセッション内で/configコマンドを実行し、「Project instructions」の項目から読み込みモードを選択します。

/config

設定ファイルを直接編集する場合は、プロジェクトの.claude/settings.jsonに以下を追記します。

{
  "pluginConfigs": {
    "agents-md@builtin": {
      "options": {
        "instructionFiles": "claude-md-and-agents-md"
      }
    }
  }
}

これで、CLAUDE.mdとAGENTS.mdの両方がプロジェクト指示として読み込まれるようになります。

【業界別】Claude Code AGENTS.md対応の活用シーン

AGENTS.mdの統一対応により、さまざまな業界でマルチエージェント開発が加速します。ここからは業界ごとの活用例を紹介します。

ソフトウェア開発（マルチツール環境）

最も恩恵を受けるのは、複数のAIコーディングツールを併用している開発チームです。例えば、フロントエンドチームがCursorを使い、バックエンドチームがClaude Codeを使い、コードレビューにGitHub Copilotを使うようなケースでは、AGENTS.mdを1ファイル管理するだけで全ツールの挙動を統一できます。これまで必要だったCLAUDE.mdと.cursorrules、copilot-instructions.mdの三重管理から解放されます。

生成AIを搭載したSaaSについて、詳しく知りたい方は以下の記事も参考にしてみてください。

WEEL

生成AI・LLMを搭載したSaaSとは？メリットやおすすめツール10選を紹介 | WEEL WEELメディア事業部AIライターの2scです。 みなさん、生成AIが使えるSaaSをご存知ですか？ ChatGPTの登場以降、評価額10億ドル超えの生成AI系SaaSスタートアップが世界中で…

SIer・受託開発

受託開発では、プロジェクトごとにコーディング規約やテスト基準が異なります。AGENTS.mdにプロジェクト固有のルールを集約しておけば、どのAIツールを使う開発者でも同じ基準で作業できるため、品質のばらつきを抑えられます。新しいメンバーがチームに加わった際にも、AGENTS.mdを読むだけでプロジェクトの作法を把握できる点も実用的です。

生成AIによるシステム開発について、詳しく知りたい方は以下の記事も参考にしてみてください。

WEEL

生成AIによるシステム開発とは？弊社事例・開発の流れを解説 | WEEL 生成AIを活用したシステム開発のメリット・方法について解説します。生成AIを社内システムと連携させると生産性が高い運用が可能です。ただ、生成AIの利用には注意点も存在…

オープンソースプロジェクト

コントリビューターが世界中から参加するオープンソースプロジェクトでは、各自が使うツールもさまざまです。AGENTS.mdを1つ配置するだけで、Claude Code・Codex・Cursor・Aiderなどツールを問わずプロジェクトのルールが伝わるため、PRの品質向上やレビュー負荷の軽減に直結します。

【課題別】Claude Code AGENTS.md対応が解決できること

続いて、AGENTS.md対応によって解決できる具体的な課題を整理しておきましょう。

CLAUDE.mdとAGENTS.mdの二重管理からの解放

これまでClaude Codeユーザーは、AGENTS.mdとCLAUDE.mdにほぼ同じ内容を書く必要がありました。片方を更新するともう一方が古くなる「スプリットブレイン問題」が生じ、ツールごとに異なるルールでコードが生成される原因になっていました。

AGENTS.mdをSingle Source of Truthにできるようになったことで、この問題は根本的に解消されます。

ツール乗り換え時のコスト削減

AIコーディングツールの進化は早く、チーム内で使うツールが変わることは珍しくありません。

AGENTS.mdに指示を集約しておけば、ツールを切り替えても指示ファイルの再作成は不要です。CursorからClaude Code、あるいはその逆への移行もスムーズに行えます。

新メンバーのオンボーディング高速化

プロジェクトのルールやコマンドが1つのMarkdownファイルに凝縮されているため、人間の新メンバーにとってもAGENTS.mdはプロジェクトの全体像を把握するための有用なドキュメントとして機能します。AIだけでなく人間にも読みやすいフォーマットである点が、READMEとの違いです。

Claude Code AGENTS.md対応を使ってみた

実際にAGENTS.md対応を検証してみましょう。

AGENTS.mdだけを配置してClaude Codeが指示を読み込むか検証

新規プロジェクトにAGENTS.mdのみを配置して、Claude Codeが正しく読み込むかどうかを確認しました。

AGENTS.mdに「すべての回答の冒頭にテストを付けてください」という合言葉的な指示を仕込み、Claude Codeを起動してみます。

# AGENTS.md
## Rules
- すべての回答の冒頭に「テスト」を付けること
- コメントは日本語で書くこと

以下の画像の通り、1回目のセッションでは指示が反映されませんでした。

これは公式ドキュメントにも記載されている「初回セッションでは読み込まれない」仕様です。

セッションを終了し、再度Claude Codeを起動して質問を投げると、回答の冒頭に「テスト」が付与されていることを確認できました。

Claude Codeのご相談はWEELへ！

Claude Code 2.1.277でのAGENTS.md対応は、AIコーディングツールの相互運用性における大きな一歩です。業界標準のフォーマットをAnthropicがついに受け入れたことで、開発チームは指示ファイルの二重管理から解放され、AGENTS.mdを唯一の真実として運用する選択肢を手に入れました。

弊社では、AI導入を検討中の企業向けに、業務効率化や新しい価値創出を支援する情報提供・導入支援を行っています。最新のAIを活用し、効率的な業務改善や高度な分析が可能です。

大規模言語モデル（LLM）比較レポート

「生成AIを社内で活用したい」「生成AIの事業をやっていきたい」という方に向けて、生成AI社内セミナー・勉強会をさせていただいております。

セミナー内容や料金については、ご相談ください。

また、大規模言語モデル（LLM）を対象に、言語理解能力、生成能力、応答速度の各側面について比較・検証した資料も配布しております。この機会にぜひご活用ください。

無料で相談する

資料をダウンロードする

よくある質問