Claude Codeがプロジェクト指示用のAGENTS.mdフォールバックを追加

Claude CodeがCLAUDE.mdが存在しない場合にAGENTS.mdを読み込むように — 長年待ち望まれていた標準準拠の変更

Claude Code 2.1.277（2026年9月18日リリース）では、シンプルながら影響の大きい機能が追加されました。プロジェクトディレクトリに CLAUDE.md ファイルが含まれていない場合、CLIは自動的に AGENTS.md を読み込んで指示セットとして使用するようになります。この変更は /config 内の Project instructions で設定可能ですが、Bedrock、Vertex、またはFoundryのデプロイメントではまだ利用できません。

なぜこれが重要なのか

標準準拠の構成 – AGENTS.md は、エージェント、スキル、プロジェクトレベルのプロンプトを記述するための事実上のコミュニティ標準です。これを標準でサポートすることで、Claude Codeはユーザーに重複ファイルやシンボリックリンクの維持を強いていた独自の仕様を排除します。
摩擦の軽減 – 開発者は、後方互換性のために維持していた CLAUDE.md → AGENTS.md のシンボリックリンクを削除できるようになりました。すでに AGENTS.md（または新しい .agents/ レイアウト）を使用しているプロジェクトは、追加の手順なしで動作します。
対応力のシグナル – このアップデートは、より広範なAIツール標準との整合性を求めるコミュニティからのフィードバックに応えたものです。これは、Anthropicが独自のファイル命名規則を押し付けるのではなく、開発者の声に耳を傾けていることを示しています。

チェンジログの内容

AGENTS.mdのサポートを追加：CLAUDE.mdがないプロジェクトでは、Claude Codeは代わりにAGENTS.mdを読み込みます。変更は /config の「Project instructions」で行えます（Bedrock、Vertex、Foundryではまだ利用不可）

この機能は純粋な読み取り専用のフォールバックであり、Claude Codeが .agents/skills やその他のカスタムディレクトリ配下のスキルを検出する方法を変更するものではありません。単に CLAUDE.md が存在しない場合に、システムプロンプトのソースを切り替えるだけです。

Hacker Newsでのコミュニティの反応

コメンテーター	感情	主なポイント
@askonomm	ポジティブ	「ユーザーに独自のワークフローを強制するのではなく、ようやく標準に準拠したことをしてくれた。」
@neverrroot	ポジティブ	「ありがとう、正しい判断だ。」
@bcorigliano	ポジティブ	「ついに！！業界全体の標準が必要だ。」
@stillpointlab	観察的	Claude Fableがすでに `AGENTS.md` とそれへのシンボリックリンクを作成していることに言及し、自動プロジェクトスキャフォールディングがこの変更のきっかけになった可能性を示唆。
@TomGarden	中立/混合	動きは評価するが「絶対的な最低限の対応」とし、既存のシンボリックリンクを削除した。
@mococa	批判的	この変更は開発者への真の配慮ではなく、コミュニティの怒りに対する単なる反応に過ぎないと主張。
@mitchitized	批判的	新しいロジックが `CLAUDE.md` よりも `settings.json` を優先するようになり、ユーザーが提供した指示を上書きする可能性があると主張。
@aroman	実用的	「ようやく、AGENTS.mdをGEMINI.mdやCLAUDE.mdに再帰的にシンボリックリンクしていた `sync-agent-docs.sh` を削除できる…」
@bluestein	ユーモア	「AGENTS.mdは新しいautoexec.batだ。」
@chr15m	ポジティブ	「これはAppleがUSB-Cに切り替えたときのように、当たり前で賢明な対応だ。」
@perganomoly	ネガティブ	「これほど基本的な機能を追加するのにこれほど時間がかかったのは恥ずべきことだ。」

全体として、コミュニティはこの変更を画期的なイノベーションというよりは、必要な修正と見なしています。多くのユーザーはシンボリックリンクが不要になったことに安堵していますが、一部のユーザーは依然としてAnthropicの動機に対して懐疑的です。

新しいフォールバックの使用方法

AGENTS.md がプロジェクトルートにあることを確認します（またはClaude Codeがプロジェクト指示をスキャンするサブディレクトリに配置します）。
以前 AGENTS.md へのポインタとして使用していた CLAUDE.md ファイルやシンボリックリンクを削除します。
検索場所をカスタマイズする必要がある場合は、/config ファイルの Project instructions セクションを編集します：
```
{
  "projectInstructions": {
    "fallbackFile": "AGENTS.md"
  }
}
```
claude --version を実行して、バージョンが 2.1.277 以降であることを確認します。

変更されないことは？

スキルの読み込み – Claude Codeは依然として .agents/skills ディレクトリからスキルを自動的に読み込みません。これは引き続き別の機能リクエストとして残ります。
Bedrock/Vertex/Foundry – このフォールバックは現在これらのプラットフォームでは利用できません。引き続き CLAUDE.md が必要です。
既存のプロジェクト – 両方のファイルがすでに含まれているプロジェクトでは、CLAUDE.md を削除しない限り、引き続き CLAUDE.md が優先されます。

結論

Claude Codeが AGENTS.md をフォールバック指示ファイルとして追加したことで、長年の摩擦点が解消され、ツールがコミュニティの慣習と一致し、開発者のフィードバックに基づいて適応するAnthropicの姿勢が示されました。この変更は控えめなものですが、ユーザビリティと標準準拠における明確な勝利です。