쇼피파이 CEO “클로드 코드 전면 금지 검토”…AGENTS.md 미지원이 화근

쇼피파이 최고경영자(CEO) 토비 뤼트케(Tobi Lütke)가 앤트로픽의 AI 코딩 에이전트 클로드 코드(Claude Code)를 회사 전체에서 금지하는 방안을 검토하고 있다고 밝혔다. 뤼트케는 8월 25일(현지시각) X(옛 트위터)에 “클로드 코드가 AGENTS.md와 .agents/skills 등을 읽도록 방침을 바꾸기 전까지 쇼피파이에서 클로드 코드를 금지하는 걸 고민 중”이라고 적었다. 클로드 코드의 코딩 능력 자체가 문제가 아니라, AI 에이전트에게 프로젝트 지침을 전달하는 파일 형식을 두고 벌어진 다툼이라는 설명이다. 개발자 수천 명이 하나의 대형 저장소(모노레포)를 함께 쓰는 쇼피파이 같은 회사에서는 이런 형식 차이가 실제 업무 차질로 이어질 수 있다는 게 뤼트케의 지적이다. 개발자들이 거의 1년간 요청해온 기능이지만 앤트로픽은 최근까지도 관련 요청을 “계획 없음(not planned)”으로 닫아온 상태다.

마크다운 파일 하나가 부른 갈등

뤼트케는 후속 게시물에서 문제를 더 구체적으로 설명했다. “AGENTS.md와 클로드 파일은 디렉터리 트리를 따라 재귀적으로 적용된다”며 “개발자 수천 명이 참여하는 모노레포에서는 어느 디렉터리엔가 두 파일 중 하나가 빠지는 일이 실제로 벌어지고, 그 결과 일부 개발자는 일부가 잘려나간(lobotomy) 상태의 에이전트로 일하게 된다”고 썼다.

그는 “이 문제를 자동화로 해결하고는 있지만, 굳이 치르지 않아도 될 어리석은 복잡성 세금”이라고 덧붙였다. 서로 다른 팀원이 서로 다른 도구를 쓸 때 클로드 코드가 CLAUDE.md만 고집하면 이른바 “split brain(분리된 뇌)” 문제가 생긴다는 게 그의 요지다. 같은 코드베이스를 보고도 어떤 도구를 쓰느냐에 따라 에이전트가 서로 다른 지침을 따르게 된다는 뜻이다.

AGENTS.md와 CLAUDE.md, 왜 갈렸나

오픈AI(OpenAI)는 2025년 8월 코딩 에이전트에 프로젝트별 지침을 제공하기 위해 AGENTS.md 형식을 도입했다. 오픈AI에 따르면 같은 해 12월 기준 6만 개 이상의 오픈소스 프로젝트와 에이전트 프레임워크가 이 형식을 채택했고, 코덱스(Codex)·커서(Cursor)·제미나이 CLI(Gemini CLI)·깃허브 코파일럿(GitHub Copilot)·줄스(Jules)·VS코드(VS Code) 등이 이를 지원하고 있다. 오픈AI는 이후 이 형식의 관리권을 리눅스 재단(Linux Foundation) 산하 에이전틱 AI 파운데이션(Agentic AI Foundation)에 넘겼다.

반면 클로드 코드는 독자 형식인 CLAUDE.md를 사용한다. 저장소 안 여러 디렉터리에 흩어진 CLAUDE.md 파일을 재귀적으로 읽어들이는 방식은 AGENTS.md와 비슷하지만, AGENTS.md 파일 자체는 기본적으로 읽지 않는다. 앤트로픽은 CLAUDE.md 파일에서 AGENTS.md를 불러오거나 심볼릭 링크(symbolic link, 실제 파일을 가리키는 바로가기)를 쓰는 우회 방법을 안내하고 있지만, 대형 저장소에서는 이 지침들을 모든 위치에서 계속 동기화해야 하는 부담이 남는다. 2026년 진행된 한 조사는 깃허브(GitHub) 저장소 2,926개를 분석해 컨텍스트 파일(context file, AI에게 지침을 전달하는 파일)이 개발자들이 코딩 에이전트에 지침을 주는 가장 흔한 방식이 됐다는 결과를 내놨다. AGENTS.md는 이미 여러 도구에서 함께 쓰이고 있는 것으로 나타났다.

개발자들의 임시방편, “복잡성 세금”의 실체

호환성 문제에 부딪힌 개발자 커뮤니티는 저마다 해법을 만들어 대응했다. 가장 흔한 방식은 ln -s AGENTS.md CLAUDE.md 명령으로 심볼릭 링크를 만드는 것이다. 클로드 코드 자체의 파일 참조 기능을 활용해 CLAUDE.md 안에 @AGENTS.md를 적어 넣는 방법도 쓰인다. 이렇게 하면 팀이 이미 관리해온 공통 규칙을 클로드 코드가 불러오면서도, CLAUDE.md에는 클로드 전용 설정을 위한 공간을 남길 수 있다.

개발자 이언 넛톨(Ian Nuttall)은 맥(Mac) 환경에서 이 과정을 통째로 자동화하는 방법을 공개했다. 모든 AGENTS.md 파일을 재귀적으로 찾아 같은 위치에 CLAUDE.md 심볼릭 링크를 만들고, fswatch로 새 파일 생성을 계속 감시하고, launchd 에이전트로 시스템 시작 시 자동 실행되게 설정한 뒤, 생성된 CLAUDE.md 파일을 전역 깃(Git) 무시 목록에 추가해 실수로 커밋되지 않도록 하는 방식이다. 다른 도구들이 이미 기본으로 지원하는 형식을 클로드 코드에서 읽히게 하려고 조회 스크립트, 파일 감시, 자동 실행 설정, 깃 설정까지 갖춰야 하고 이 장치를 팀원 전체의 컴퓨터에서 똑같이 유지해야 한다. 뤼트케가 말한 “복잡성 세금”이 정확히 이런 모습이다.

거의 1년째 “계획 없음”…앤트로픽 대응은

개발자들은 거의 1년 동안 앤트로픽에 AGENTS.md 지원을 요청해 왔다. 2025년 8월 등록된 관련 기능 요청은 깃허브에서 5,000개에 육박하는 업보트를 받아 클로드 코드 커뮤니티에서 가장 많은 지지를 받은 요청 중 하나로 꼽힌다. 그럼에도 관련 이슈들은 하나씩 닫혀 왔고, AGENTS.md를 재귀적으로 찾아 적용하는 기능에 초점을 맞춘 최근 요청 역시 앤트로픽에 의해 “계획 없음”으로 처리됐다.

뤼트케의 게시물이 개발자 커뮤니티에서 폭넓게 반응을 얻으면서, 거의 1년간 이 문제에 침묵해온 앤트로픽도 결국 응답에 나선 것으로 전해졌다. 쇼피파이는 이미 자체 자동화로 이 문제를 해결하고 있다고 밝혔지만, 뤼트케는 저장소에 코딩 에이전트가 늘어날수록 도구 간 지침을 맞추는 일이 플랫폼 팀의 새로운 업무로 계속 쌓이고 있다는 점을 짚었다.