Claude Code は AGENTS.md のサポートを追加しました

CLAUDE.md が存在しない場合、Claude Code は AGENTS.md を読み込みます

結論: 2026年9月18日リリース以降、プロジェクトに CLAUDE.md が存在しない場合、Claude Code は AGENTS.md ファイルをフォールバックとして読み込みます。この変更により、必須手順が削除され、ユーザーは指示ファイルをプロバイダに依存せずに保持できるようになり、コミュニティが期待する標準的なエージェント定義フォーマットに準拠するようになりました。


変更の意義

  • 運用の簡素化 – 以前は、すべての Claude Code プロジェクトにリポジトリルートに CLAUDE.md が必要でした。AGENTS.md を好むユーザー(または他のハーネスから移行したユーザー)は、シンボリックリンクを作成するか、ファイルを複製する必要がありました。新しいフォールバックにより、その追加のメンテナンスが不要になります。
  • 新たな規範への整合 – クラウド、Codex、Gemini、その他のAIコードアシスタントで通用する中立的な AGENTS.md 名の導入を求める開発者が複数います。AGENTS.md を標準でサポートすることで、Anthropic はコミュニティの基準に応える姿勢を示しています。
  • プロジェクト構造の洗練 – エージェントの指示を1つのソースとして保持でき、シンボリックリンクや重複ファイルでリポジトリが散らばることなくなります。

リリースノートの内容

2026年9月18日 – AGENTS.md のサポートを追加:CLAUDE.md が存在しないプロジェクトでは、Claude Code は AGENTS.md を読み込みます。/config の「プロジェクトの指示」で変更可能です(現時点では Bedrock、Vertex、Foundry には未対応)。

この変更は CLI および VS Code 拡張機能に限定されており、Bedrock、Vertex、Foundry 上のクラウドホスト型 Claude Code セッションは、今後のアップデートで機能が追加されます。


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

コメント投稿者 感情 主なポイント
@askonomm 正の評価 「ついに、ユーザーを独自のワークフローに強制するのではなく、標準準拠の行動を取っている。」
@stillpointlab 観察的 Claude Fable が自動的に AGENTS.md とそのシンボリックリンクを作成していることから、すでに中立的なファイルの必要性を推測していたと指摘。
@neverrroot 正の評価 「ありがとう、正しいことをしたね。」
@bcorigliano 正の評価 業界全体の標準化への動きを称賛。
@TomGarden 混合 変更を評価するが、以前の要件は「絶対に最低限」だったと指摘。
@mococa 批判的 この変更は遅すぎると主張し、標準はもっと早く採用されるべきだったと指摘。
@clutter55561 警告的 Claude Code が .agents/skills 内のスキルを検出しないことをユーザーに思い出させる。
@aroman 実用的 「ついに、sync-agent-docs.sh を削除できる。これは AGENTS.md を GEMINI.md と CLAUDE.md に再帰的にシンボリックリンクするスクリプトだった…」
@jtbaker ユーモラス Shopify のCEOが、AGENTS.md を尊重しない限り Claude Code を禁止する可能性があると報じたニュース記事を共有。
@mitchitized 疑念的 この変更がコミュニティの圧力への反応に過ぎず、本心からの配慮ではないと主張。
@perganomoly 残念 「このような基本的な機能を追加するのにこれほど時間がかかったのは、恥ずべきことだ。」
@albatross79 皮肉的 Claude Code を「重い」と呼び、AGENTS.md の指示を完全に尊重する日が来るとは疑っている。

全体として、感情は圧倒的に肯定的であり、多くのコメント投稿者が簡素化を歓迎し、より広範な相互運用性への一歩だと捉えています。


新しい動作の使い方

  1. プロジェクトのルート(または作業中の任意のサブディレクトリ)に AGENTS.md を作成します。CLAUDE.md で使用していたのと同じ構文で指示を含めてください。
  2. CLAUDE.md ファイルを削除するか、存在しない状態にしてください。Claude Code は自動的に AGENTS.md を検出し読み込みます。
  3. 必要に応じてフォールバックパスを設定します。/config パネルの「プロジェクトの指示」から設定可能です。この設定は現在、CLI および VS Code UI でのみ利用可能で、Bedrock/Vertex/Foundry のデプロイでは未対応です。
  4. 確認のために claude --version を実行し、セッションを開始します。起動ログに「Reading project instructions from AGENTS.md」と表示されれば成功です。

変更しない点

  • スキルの読み込み – Claude Code は still .agents/skills ディレクトリからスキルを自動的に読み込みません。ユーザーはスキルを明示的に登録するか、既存の skills/ メカニズムに依存し続ける必要があります。
  • クラウドホスト型セッション – フォールバックは Bedrock、Vertex、Foundry ではまだ有効になっていません。これらのプラットフォームは後続のパッチで更新されます。
  • レガシー動作 – CLAUDE.md と AGENTS.md の両方が存在する場合、CLAUDE.md が優先され、既存のプロジェクトの後方互換性が維持されます。

既存プロジェクト向けクイックチェックリスト

  • CLAUDE.md → AGENTS.md を指すすべてのシンボリックリンクを削除。
  • AGENTS.md が、必要なエージェント指示の完全なセットを含んでいるか確認。
  • 新しい Claude Code セッションをテストし、ファイルが正しく読み込まれることを確認。
  • 内部ドキュメントを更新し、AGENTS.md を標準の指示ファイルとして参照するように変更。

結論

Claude Code が AGENTS.md のフォールバックを追加したことは、わずかではあるが、開発体験の質を高める有意義な改善です。不要なファイルを削除し、複数のAIコードアシスタントで通用する命名規則を尊重し、Anthropic が開発者からのフィードバックに耳を傾ける姿勢を示しています。この変更はすでに CLI および VS Code 拡張機能で利用可能であり、コミュニティの反応から、AI支援開発エコシステムにおけるより広範な標準化への一歩として歓迎されると見られます。

Sources

関連

  • Dispatch
  • Dispatch
  • Dispatch
  • プロジェクト
  • プロジェクト