見つけた記事にはClaude CodeはAGENTS.mdをサポートしていないと書かれていますが、記事が間違っているのですか？
必ずしも間違っているわけではなく、2026年9月18日のv2.1.277リリースより前に書かれた可能性が高い。それ以前は、Claude Codeは確かにCLAUDE.mdしか読まず、「AGENTS.mdのサポートなし」は当時としては正確な記述であり、インポートやsymlinkが唯一の回避策だった。この種の情報を検証する際は、記事やドキュメントの公開日を確認することが、内容をそのまま信じることよりも重要だ——この機能の境界線はちょうど1ヶ月以内に収まっており、新旧の情報が同時に流通しているため、古いバージョンの情報に行き着きやすい。
チームでAGENTS.mdに切り替えたいのですが、誰かがすでにCLAUDE.local.mdを作成していないか確信が持てません。最も早く確認する方法は？
最も直接的な方法は、各チームメンバーに自分のローカルのリポジトリルートでCLAUDE.local.mdというファイルがあるかどうかを確認してもらうことだ——このファイルは慣例的にバージョン管理の対象外なので、リポジトリ自体を見ても分からず、各人が自分のマシンで確認する必要がある。誰も作成していないことが確認できれば、AGENTS.mdのみへの切り替えはスムーズに進むはずだ。すでに誰かが作成している場合、その人に個人設定ファイルを削除してもらうよりも、claude-md-and-agents-mdモードに切り替えて両方のファイルを同時に読み込ませる方が、どちらがスキップされるかを気にしなくて済む、より現実的な方法だ。
公式ドキュメントが示す4つのモード（claude-md-or-agents-md、claude-md-and-agents-md、claude-md、managed-only）を、一般的なチームはどう選べばよいですか？
チームにクロスツールで共有する指示ファイルの必要がないなら、デフォルトのclaude-md-or-agents-mdを維持するか、明示的にclaude-mdに設定するかで実質的な差はほとんどない。どちらにせよAGENTS.md自体が存在しないからだ。チームが実際にクロスツールで共有するAGENTS.mdを維持していて、2つのファイルの内容が矛盾したり漏れたりすることを心配しているなら、claude-md-and-agents-mdモードは両方を重複除去しながら同時に読み込む、より保守的な選択だ。代償として両方のファイル分のトークンを消費する。managed-onlyは集中管理が必要で、個々の開発者のローカル設定やAGENTS.mdの介入を望まない組織向けであり、通常、小規模チームでは必要にならない。
技術的な背景はなく、チームのコンテンツガイドライン文書の管理だけを担当しています。これは私に実際どんな影響がありますか？
チームがAIツールに見せるガイドライン文書（CLAUDE.mdと呼ぶかAGENTS.mdと呼ぶかに関わらず）の維持を担当しているなら、最も実際的な影響はこうだ：まずチームが現在実際にどのファイル、どのモードを使っているのかを正確に把握すること。「どうせ指示ファイルなんだから、どちらでもいい」と思い込まないこと。チームが複数のAIコーディングツールを使っているなら、AGENTS.md形式に統一してClaude Codeにネイティブに読み込ませることで、2つの重複文書を維持する手間を省ける。ただし、その前提として、チームの誰かが個人設定ファイルのせいで静かにその共有ガイドラインを迂回していないかを確認する必要がある。そうでなければ、あなたがAGENTS.mdを更新しても、誰かが古いバージョンのまま作業し続け、お互いそれに気づかないことになる。
最近「Claude CodeはAGENTS.mdを読むのか」を調べたことがあるなら、矛盾する2つの答えに出会ったかもしれない。一つは「いいえ、Claude CodeはCLAUDE.mdしか読まない。AGENTS.mdは@AGENTS.mdのインポートかsymlinkを使わない限り機能しない」というもの。もう一つは「サポートされている。フォルダにCLAUDE.mdがなければ、Claude Codeは自動的にAGENTS.mdを読む」というものだ。この2つの答えはどちらも、ある時点では正しかった——ただ異なる時期を指しているだけだ。Claude Codeはv2.1.277（2026年9月18日リリース）より前は確かにCLAUDE.mdしか読まず、インポートやsymlinkが当時AGENTS.mdを機能させる唯一の方法だった。v2.1.277以降、公式ドキュメントは「フォルダにCLAUDE.mdがなければ、ClaudeはAGENTS.mdを確認して使用する」と明確に記載している。これはネイティブサポートであり、もはや回避策は不要だ。
The Registerの報道によると、AGENTS.mdはもともとOpenAI陣営が推進していたクロスツールのプロジェクト指示ファイル仕様で、単一のプロジェクト説明ファイルを複数のAIコーディングツールで共有し、各ツールがフォーマットの異なるほぼ重複した内容の設定ファイルを個別に維持する必要をなくすことを目的としていた。Anthropicがv2.1.277でこの仕様をサポートすると決めたことは、実質的に「各チームのリポジトリにCLAUDE.md、AGENTS.md、.cursorrulesなど、ほぼ同一内容の指示ファイルが複数積み重なっている」という実際に存在する保守負担を認めたことになる。
公式のデフォルト動作はclaude-md-or-agents-mdモードだ：現在のディレクトリまたはその上位のディレクトリにCLAUDE.md、.claude/CLAUDE.md、またはCLAUDE.local.mdのいずれかが存在する限り、Claude Codeはそれらのみを読み込み、AGENTS.mdを完全にスキップする。AGENTS.mdがフォールバックとして読み込まれるのは、ディレクトリツリー全体にCLAUDE.mdのいずれのバリアントも存在しない場合のみだ。この動作は設定で変更できる——claude-md-and-agents-mdは両方のファイルを同時に読み込む（CLAUDE.mdが優先され、重複は除去される）、claude-mdはAGENTS.mdを完全に無視する、managed-onlyは組織が管理するCLAUDE.mdのみに限定する。
これは複数の技術記事が特に強調している点だ：CLAUDE.local.md（開発者個人用で、バージョン管理されない設定ファイル）は、「CLAUDE.mdが存在するか」をClaude Codeが判断する際、チーム共有のCLAUDE.mdと完全に同じ扱いを受ける。つまり、チームのリポジトリに元々AGENTS.mdしか置いていなかった場合（クロスツール共有フォーマットを意図的に選んだ場合）でも、ある開発者が自分の個人的な設定を保存するためにCLAUDE.local.mdを作成すると、デフォルトモードでは、その開発者のClaude Codeは静かにチーム共有のAGENTS.mdの読み込みを停止し、自分のローカルファイルだけを見るようになる——CLAUDE.local.mdを作成していない他の同僚は影響を受けず、通常どおりAGENTS.mdを読み込み続ける。この「同じリポジトリなのに、開発者によって異なる指示が読み込まれる」という状況は、表面上は全員が同じリポジトリで作業しているように見えるため、特に調査に時間がかかる。
チームが他のツールと共有するAGENTS.mdを既に維持していて、2つの重複ファイルを維持せずにClaude Codeにその内容を読ませたい場合、コミュニティが整理した運用ガイドには、v2.1.277以前の時代から有効な2つの方法が挙げられている：CLAUDE.mdファイルの先頭に@AGENTS.mdというインポート行を1行追加する方法で、Claude Codeはセッション起動時にインポートされた内容を読み込み、その後CLAUDE.md内のClaude専用の追加指示を読み続ける。もう一つは、CLAUDE.mdからAGENTS.mdへ直接symlinkを作成する方法だ。Windowsではsymlinkの作成に管理者権限または開発者モードが必要なため、クロスプラットフォームのチームでは@AGENTS.mdインポート方式の方が実用的だ。また、既にAGENTS.mdがあるリポジトリで/initを実行すると、その内容を読み込んで自動生成されるCLAUDE.mdに統合する、一度限りの統合オプションも提供される。
この機能はまだBedrock、Vertex、Foundryなどのプラットフォームには拡張されていない。feature-flagの権限がない、またはtelemetryを無効化しているセッションもAGENTS.mdを読み込めない。新規インストールしたClaude Codeでは、最初のセッションが完了するまでこの機能は有効にならない。手順通りに設定したのに機能しない場合、これらのプラットフォームや設定の制限が最初に確認すべき点だ。
チームがClaude Codeのみを使用し、クロスツールで共有する指示ファイルの必要がないなら、デフォルトモードを維持し、CLAUDE.mdのみを使い続けるのが最も簡単な選択であり、追加の作業は不要だ。チームが複数のAIコーディングツールを使用し、クロスツールで共有する単一の指示ファイルを維持したいなら、ネイティブサポートが加わったAGENTS.mdは確かに重複保守の負担を取り除いてくれる——しかし、チームの中に既にCLAUDE.local.mdを作成した人がいないか必ず確認すること。そうでなければ、その人のClaude Codeは静かにチーム共有のAGENTS.mdではなく自分のローカルファイルに戻ってしまい、同じリポジトリなのに人によって異なる指示が読み込まれるというズレが生まれてしまう。