코딩 에이전트가 공통으로 읽는 AGENTS.md 를 클로드 코드도 읽어 달라는 깃허브 이슈가 2025년 8월에 열려 반응 6,404개와 댓글 377개를 모았는데, 올해 8월 17일에 '완료' 상태로 닫혔어요. 정작 앤트로픽 공식 문서에는 '클로드 코드는 CLAUDE.md 를 읽고 AGENTS.md 는 읽지 않아요'가 그대로 남아 있고, 우회책으로 CLAUDE.md 안에서 @AGENTS.md 로 가져오거나 심볼릭 링크를 걸라고 안내해요. 그 뒤 쇼피파이 CEO 토비 뤼트케는 '클로드 코드가 마음을 바꿔 AGENTS.md 와 .agents/skills 를 읽을 때까지 사내에서 금지할까 생각 중'이라며, CLAUDE.md 만 고집하는 탓에 팀원마다 다른 도구를 쓰면 지시가 갈라진다고 적었어요.
용어 풀이
- AGENTS.md
- 여러 코딩 에이전트가 공통으로 읽도록 만든 프로젝트 지시 파일 규약
- CLAUDE.md
- 클로드 코드가 세션 시작 때 읽는 전용 지시 파일
- .agents/skills
- 도구에 매이지 않는 위치에 두는 에이전트용 절차 모음
- 심볼릭 링크
- 다른 파일을 가리키기만 하는 바로가기 파일
운영자 인사이트
클로드 코드가 직접 읽어 주기를 기다릴 이유는 없어요. AGENTS.md 를 원본으로 두고 CLAUDE.md 에는 @AGENTS.md 한 줄만 담아 두면, 도구를 섞어 쓰는 팀에서도 지시를 한 벌로 유지할 수 있어요. 이슈가 닫혔다고 규약이 바뀐 건 아니니 사내 표준을 정할 때는 이슈 상태가 아니라 공식 문서 문구를 근거로 잡는 게 안전해요.
여러 관점으로 보기
- 닫힌 뒤에도 그대로인 공식 문구 이슈가 닫힌 뒤에 열어 봐도 '클로드 코드는 CLAUDE.md 를 읽고 AGENTS.md 는 읽지 않아요'가 그대로 있고, @AGENTS.md 가져오기와 심볼릭 링크만 우회책으로 안내해요. Anthropic
- 같은 요청은 아직 열려 있어요 뤼트케가 집은 두 이름을 제목에 그대로 담은 후속 이슈가 반응 439개를 모은 채 아직 닫히지 않았어요. GitHub
- 불만이 나온 자리 쇼피파이가 공개한 에이전트 플러그인 저장소에는 클로드·코덱스·커서용 디렉터리가 나란히 있고 .agents 디렉터리도 함께 들어 있어요. GitHub
- AI 후퇴가 아니라는 배경 쇼피파이는 뤼트케가 'AI 사용은 기본 기대치'라는 사내 메모를 공개한 회사고, 개발자에게 코파일럿·커서·클로드 코드·윈드서프를 함께 깔아 줘요. First Round Review