앤스로픽(Anthropic)의 AI 코딩 도구인 클로드 코드(Claude Code) 사용자들이 AGENTS.md 파일 지원을 강력히 요청하고 있습니다. AGENTS.md는 코딩 에이전트가 코드베이스를 이해하는 데 사용하는 통합 마크다운(Markdown) 형식으로, 이미 2만 개 이상의 오픈소스 프로젝트에서 활용되며 코덱스(Codex), 앰프(Amp), 커서(Cursor) 등 다양한 AI 코딩 도구들이 채택하고 있습니다. 하지만 클로드 코드는 이 파일을 자동으로 인식하지 못해 사용자들이 CLAUDE.md라는 별도 파일을 만들어 지침을 복제하거나 우회적인 방법을 사용해야 하는 불편함을 겪고 있습니다.
현재 클로드 코드는 CLAUDE.md 파일을 우선적으로 로드하며, AGENTS.md 파일은 무시합니다. 이로 인해 여러 AI 코딩 도구를 사용하는 팀은 도구별로 지침 파일을 중복 관리해야 하고, AGENTS.md만 있는 저장소를 클로드 코드로 열면 컨텍스트(context)가 무시되는 문제가 발생합니다. 제안된 해결책은 클로드 코드 시작 시 CLAUDE.md를 먼저 검색하고, 없을 경우 AGENTS.md를 대체 파일로 로드하는 우선순위 기반 탐색 방식입니다. 이는 기존 프로젝트와의 하위 호환성을 유지하면서도 AGENTS.md의 공통 지침을 활용하자는 의도입니다. CLAUDE.md는 클로드 코드 고유 기능(예: 특정 서브에이전트 호출, 슬래시 명령)을 위한 파일로 유지하고, AGENTS.md는 도구에 종속되지 않는 공통 지침(예: 빌드/테스트 절차, 코드 스타일)을 제공하는 방식으로 역할을 분담하자는 것입니다.
하지만 앤스로픽은 이 기능 요청 이슈를 닫았으며, 명확한 종료 사유나 최종 답변을 제공하지 않았습니다. 이는 개발자 커뮤니티의 불만을 더욱 증폭시키고 있습니다. 특히 최근 앤스로픽이 자동 모드에서 전용 Read·Edit·Write 도구보다 Bash 도구를 우선 사용하도록 시스템 프롬프트를 변경하는 등 개발자 친화적이지 않은 정책을 '몰래' 적용했다는 비판이 쏟아지고 있습니다. 이러한 변경은 컨텍스트 토큰(context token)을 아끼려는 의도로 보이지만, 실제로는 사용성을 저하시키고 샌드박스(sandbox) 밖 파일 접근 오류를 유발하며, 실패한 도구 호출로 토큰 낭비를 초래한다는 지적입니다. 많은 개발자가 클로드 코드 사용을 중단하거나 다른 대안을 찾고 있으며, 앤스로픽이 개발자 커뮤니티의 신뢰를 잃고 있다는 우려가 커지고 있습니다.