Claude Code 最大の要望 AGENTS.md 対応——5,200 を超える reactions の痛みと今すぐできる回避策 Claude Code 最大の要望 AGENTS.md 対応——5,200 を超える reactions の痛みと今すぐできる回避策
- Claude Code のいちばん多い要望は、意外と知られていない GitHub の anthropics/claude-code の起票を、反応の数の多い順に並べてみてください。
- 先頭に来るのは、副の作業者の沈黙の停止でも、6月15日の課金
Claude Code の GitHub リポジトリ anthropics/claude-code で、reactions 数の多い順にイシューを並べると、最上位に来るのが「AGENTS.md のサポート」だ。5,200 を超える反応はコミュニティの切実さを物語っており、単なる機能リクエストというより、実務上のボトルネックとして認識されている。
AGENTS.md とは、OpenAI の Codex や Cursor などのエージェント型 AI ツールが参照するプロジェクト設定ファイルだ。リポジトリのルートや特定ディレクトリに置くことで、AIエージェントに対してコーディング規約・アーキテクチャ方針・禁止事項などを宣言的に伝えられる。Cursor が AGENTS.md を採用して以降、複数のツール間で「共通のコンテキストファイル」として使う開発ワークフローが広まった。しかし Claude Code はこれを標準ではサポートしておらず、ツールを切り替えるたびに設定を書き直す手間が生じていた。
この問題が特に痛いのは、エンタープライズや大規模チームで複数の AI コーディングツールを併用するケースだ。Cursor でプロトタイピングし、Claude Code でレビューや複雑なリファクタリングを行う、といった分業が現場では珍しくない。そのたびに CLAUDE.md と AGENTS.md を二重管理するコストは無視できない。
Claude Code のいちばん多い要望は、意外と知られていない GitHub の anthropics/claude-code の起票を、反応の数の多い順に並べてみてください。
現時点での回避策としては、いくつかのアプローチが紹介されている。最もシンプルなのは、AGENTS.md の内容を CLAUDE.md にそのまま転記または symlink で参照させる方法だ。CI/CD パイプラインで自動同期スクリプトを挟む手法も有効で、両ファイルの内容を単一ソースから生成することで整合性を保てる。また、Claude Code のカスタムスラッシュコマンドを活用して、セッション開始時に AGENTS.md を自動読み込みさせるワークアラウンドも報告されている。
背景として、AI コーディングツール間の「コンテキストファイル標準化」をめぐる動きは 2025 年後半から活発化している。GitHub Copilot が .github/copilot-instructions.md を採用し、JetBrains AI も独自形式を持つなど、各社がそれぞれの仕様を持ち寄っている状況だ。統一フォーマットへの圧力はコミュニティから高まっており、Anthropic が今後どのような形で対応するかは注目される。5,200 超の reactions はその圧力の数値的な表れと言えるだろう。公式の対応時期は明言されていないが、これほどの需要があれば優先度が上がる可能性は高いと見られる。
Browse the issues on Anthropic's anthropics/claude-code GitHub repository sorted by reactions, and one item sits firmly at the top: native support for AGENTS.md. With more than 5,200 reactions, it is less a feature request and more a signal of a real workflow bottleneck that developers are hitting every day.
AGENTS.md is a project-level configuration file popularized by tools like Cursor and OpenAI Codex. Placed at the root of a repository or in specific subdirectories, it lets developers declaratively communicate coding conventions, architectural constraints, and off-limits patterns to an AI coding agent. Once Cursor adopted the format, it became a de facto shared context layer for teams using multiple AI tools. Claude Code, however, does not natively read AGENTS.md — meaning developers who work across tools must either duplicate their configuration or manage two separate files that can drift out of sync.
The pain is sharpest for enterprise teams and larger engineering organizations that have settled into hybrid workflows. A common pattern is to use Cursor for rapid prototyping and ideation, then bring in Claude Code for deeper refactoring, architecture review, or tasks that benefit from its extended context window. Every time that switch happens, the lack of a shared configuration file creates friction. Maintaining both CLAUDE.md and AGENTS.md as separate sources of truth is the kind of invisible overhead that compounds quickly across a large codebase or team.
Several workarounds are in active use while an official solution remains pending. The simplest is to symlink AGENTS.md to CLAUDE.md, or to copy the content directly. Teams with mature CI/CD pipelines are generating both files from a single source template during build time, ensuring consistency without manual effort. A more Claude Code–specific approach involves custom slash commands that instruct the agent to load AGENTS.md at the start of every session — inelegant, but functional.
The broader context here is a quiet standards war playing out across the AI coding tool ecosystem. GitHub Copilot uses .github/copilot-instructions.md, JetBrains AI has its own format, and AGENTS.md has emerged as a grassroots standard without any single company fully owning it. The pressure for convergence is coming from developers themselves, who increasingly want to invest in a single configuration layer that works everywhere. Anthropic has not publicly committed to a timeline for AGENTS.md support, but a reaction count in the thousands is a hard signal to ignore. Whether this results in native AGENTS.md parsing, a superset format, or some interoperability layer remains to be seen — but the community has made its preference clear.
本ページの本文・要約は AI による自動生成です。正確性は元記事 (zenn.dev) をご確認ください。
