Claude CodeとAGENTS.md標準：相互運用性の衝突

衝突：CLAUDE.md vs. AGENTS.md

Claude Codeは、プロジェクト固有のコンテキストとメモリをAIに提供するために、独自のCLAUDE.mdファイルを使用しています。しかし、すでに20,000以上のオープンソースプロジェクトで採用され、CursorやCodexなどのツールによってもサポートされているAGENTS.mdという成長中のオープン標準は、あらゆるコーディングAIに対して、エージェントに依存しない統一された指示ファイルを提供することを目指しています。

開発者たちは、Claude Codeに対して二重ファイル方式の採用を求めています。つまり、Claude固有の最適化（MCPサーバーの設定やサブエージェントの定義など）にはCLAUDE.mdを優先し、一般的なプロジェクトのガイドライン、ビルドコマンド、スタイルルールにはAGENTS.mdをフォールバックとして使用するという方法です。これにより、Claude Codeは、指示を手動で複製することなく、既存の数千ものリポジトリですぐに効果を発揮できるようになります。

現在の状況とコミュニティの反発

高い支持（GitHubのIssueで4,600件以上のリアクション）を集めているにもかかわらず、この機能リクエストは、コア製品へのネイティブな実装なしに「完了」としてクローズされました。これは、開発者コミュニティから大きな批判を巻き起こしています。ユーザーは、透明性の欠如、不適切な広報、そして「囲い込み（walled garden）」エコシステムへの動きであると指摘しています。

批判的な人々は、CLAUDE.mdファイルを要求することは、Anthropicにとっての「無料広告」の一種として機能し、指示の内容がオープン標準と同一であっても、すべてのリポジトリにClaude固有のファイルを表示させることを強制していると主張しています。一部のユーザーは、変更履歴やドキュメントなしにIssueが静かにクローズされたことは、プロフェッショナルな開発者を対象としたツールとしては受け入れがたいと述べて、強い不満を表明しています。

相互運用性のための技術的な回避策

AGENTS.mdのネイティブサポートは利用できないため、コミュニティは異なるAIツール間で「信頼できる唯一の情報源（single source of truth）」を維持するためのいくつかの回避策を開発しています。

1. インポート方式

Claude CodeのCLAUDE.mdは、他のファイルをインポートすることをサポートしています。開発者は、一般的な標準を取り込むために、次のような一行を含むCLAUDE.mdファイルを作成できます。

@AGENTS.md

2. シンボリックリンク

macOSやLinuxでは、ユーザーはシンボリックリンクを作成することで、Claude CodeがAGENTS.mdファイルをあたかもCLAUDE.mdであるかのように読み込むことができます。

ln -s AGENTS.md CLAUDE.md

3. セッションフックによる自動化

入れ子になったディレクトリ間でのよりスムーズな体験を実現するために、開発者は.claude/settings.jsonのフックを使用して、リポジトリ内で見つかったすべてのAGENTS.mdファイルを起動時にセッションコンテキストに自動的に注入することができます。

設定構成：

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup",
        "hooks": [
          {
            "type": "command",
            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/append_agentsmd_context.sh"
          }
        ]
      }
    ]
  }
}

シェルスクリプト (append_agentsmd_context.sh):

#!/bin/bash
echo "=== AGENTS.md Files Found ==="
find "$CLAUDE_PROJECT_DIR" -name "AGENTS.md" -type f | while read -r file; do
    echo "--- File: $file ---"
    cat "$file"
    echo ""
done

開発者の視点の統合

AGENTS.mdを巡る議論は、ツール固有の最適化とエコシステムの相互運用性の間の根本的な緊張関係を浮き彫りにしています。

"明らかな理由は、彼らがすべてのリポジトリにCLAUDE.mdファイルを持たせたいと考えているからでしょう... それは、現代における『Sent from my iPhone』のようなものです。"

ツール固有のファイルを使用することで、モデルの特定の癖に合わせて指示をより適切に調整できると主張する人もいますが、パワーユーザーの間では、大規模な組織や多くのオープンソースプロジェクトにおいて、ほぼ同一のファイルを複数維持するオーバーヘッドは、AIコーディングエージェントの導入を妨げる大きな摩擦点であるという意見が支配的です。

Sources

関連