핵심 내용
GeekNews 최신 글 페이지에서 가장 주목도가 높은 AI 개발 항목 가운데 하나는 Claude Code의 AGENTS.md 지원이다. Anthropic의 공식 claude-code changelog를 확인하면 버전 2.1.277부터 프로젝트에 CLAUDE.md가 없을 경우 AGENTS.md를 대신 읽는다. /config의 Project instructions에서 동작을 변경할 수 있으며, 출시 시점에는 Bedrock·Vertex·Foundry 경로에서는 아직 이 fallback이 제공되지 않는다고 명시돼 있다.
바로 다음 버전인 2.1.278에서는 Claude API·Enterprise 사용자와 Bedrock·Vertex·Foundry·gateway 환경의 Auto Mode가 기본적으로 server-side classifier를 사용하도록 변경됐다. Anthropic은 이 server-side classifier 자체의 overhead에는 별도 비용을 청구하지 않는다고 설명하며 /status에 해당 세션이 server-side classifier를 사용하는지 보여주는 항목도 추가했다.
배경
AGENTS.md는 Codex를 비롯한 여러 coding agent가 repository-level instruction을 저장하는 공통 파일명으로 사용해왔다. Claude Code는 기존에 CLAUDE.md를 중심으로 동작해 여러 coding agent를 함께 사용하는 팀은 동일한 빌드 명령, 테스트 규칙, 금지 디렉터리 같은 내용을 여러 파일에 중복 작성하는 경우가 많았다. 이번 변경은 CLAUDE.md가 없는 프로젝트에서 최소한의 호환 계층을 제공한다.
중요한 제한은 이것이 기본적으로 merge가 아니라 fallback이라는 점이다. 기존 CLAUDE.md가 있는 저장소라면 AGENTS.md가 자동으로 함께 적용된다고 가정하면 안 된다. 또한 cloud provider별 지원시점이 다르기 때문에 로컬/API Claude Code와 Bedrock·Vertex·Foundry에서 동일하게 동작한다고 단정해서도 안 된다.
산업·시장에 미치는 영향
coding agent 시장이 여러 공급자를 병렬로 사용하는 방향으로 가면서 모델 자체보다 repository instruction, tool policy, MCP, test harness 같은 agent interoperability layer의 중요성이 커지고 있다. AGENTS.md 같은 공통 규칙파일이 널리 지원되면 팀이 Claude Code·Codex·기타 Agent를 바꿔가며 사용하기 쉬워지고, 공급자 lock-in도 일부 줄어든다.
실무에서 바로 활용할 수 있는 시사점
여러 coding agent를 쓰는 repository라면 공통 규칙은 AGENTS.md에 모으고 공급자별 차이가 꼭 필요한 부분만 별도 파일로 분리하는 방식을 검토할 만하다. 다만 Claude Code에서는 기존 CLAUDE.md와의 우선순위를 실제 /config에서 확인하고 CI에서도 각 Agent가 동일한 test/build rule을 읽는지 검증하는 편이 안전하다. Auto Mode를 사용하는 팀은 2.1.278 이후 classifier overhead와 fallback billing이 어떻게 표시되는지도 /status와 비용 로그에서 확인할 가치가 있다.