에이전트도 애플 MD, 안드로이드 MD로 나뉘어야 하나? 클로드는 자기만의 체계를 고집하네.

동찰 Beating AI 속보, Shopify CEO 토비 뤼트케가 회사에서 Claude Code를 비활성화하는 방안을 검토 중이다. Claude가 사용하기 불편해서가 아니라, Claude가 자체 CLAUDE.md를 고집하기 때문이다.

Shopify는 Claude Code, Codex 등 여러 에이전트를 동시에 사용한다. 다른 도구는 AGENTS.md를 공유할 수 있지만, Claude Code는 CLAUDE.md만 읽는다. 두 파일은 대규모 코드 저장소에서 계층적으로 재귀적으로 존재한다. 어느 한 레벨에서 동기화가 누락되면, 누군가는 잘못된 규칙을 받게 된다. Shopify는 이미 자동화 검사를 만들어 이를 보완하고 있지만, 토비는 이게 순전히 쓸데없는 짓이라고 생각한다.

그의 요구는 사실 간단하다: Claude Code도 AGENTS.md를 읽어서, 모두가 하나의 파일만 유지하면 된다는 것이다.

Claude Code 팀원 타리크는 AGENTS.md를 더 쉽게 사용할 수 있게 하겠다고 답했다. 하지만 말을 돌려서, Claude가 자체 프롬프트, Skills, CLAUDE.md가 필요한 이유를 설명하기 시작했다: 모델마다 다르기 때문에, 전용 최적화가 더 효과적이라는 것이다. 단기적인 해결책도 여전히 CLAUDE.md에서 AGENTS.md를 참조하는 방식이다.

이로써 토비의 문제는 해결되지 않았다. Claude를 위한 전용 최적화를 계속할 수는 있지만, 왜 프로젝트 규칙을 위해 Claude 전용 진입점을 또 유지해야 하는가?

Grok은 이전에 유출된 Claude Code 소스 코드를 검토한 결과, 더 직접적인 결론을 내렸다: CLAUDE.md 파일 이름은 로딩 로직에 하드코딩되어 있으며, 이를 AGENTS.md로 바꾸면 기존의 재귀적 발견, 로딩, 참조 메커니즘이 그대로 작동한다. 아키텍처 대규모 변경이 필요하지 않다.

솔직히 말해서, AGENTS.md를 사용할 수 없는 것이 아니라, Claude Code가 굳이 자체 CLAUDE.md를 하나 더 유지하려는 것이다.

댓글도 대체로 토비를 지지한다. DHH는 이 차이가 전혀 불필요하다고 말했고, Jesse Pollak은 짜증난다고 했으며, Chamath Palihapitiya는 두 시스템을 계속 유지하면 반드시 '분열'이 일어날 것이라고 생각한다. Kun Chen은 올바른 접근 방식은 기본적으로 AGENTS.md를 읽고, 정말 Claude 전용 최적화가 필요할 때 CLAUDE.md를 선택 사항으로 남겨두는 것이지, 그 반대가 되어서는 안 된다고 말했다.