CLAUDE.md vs AGENTS.md: AI 에이전트 컨텍스트 파일, 무엇이 표준일까?
AI 코딩 에이전트에 프로젝트 규칙을 알려주는 컨텍스트 파일 CLAUDE.md와 AGENTS.md의 차이점을 분석하고, 실제 성능 테스트를 통해 어느 쪽이 더 효율적인지 알아본다.
diff --summary
- CLAUDE.md는 AI 코딩 에이전트에게 프로젝트 규칙을 알려주는 컨텍스트 파일이다.
- 한국에서는 CLAUDE.md가 사실상 표준으로 사용되지만, 글로벌 표준은 AGENTS.md다.
- AGENTS.md로 전환 시 성능 저하 및 비용 증가에 대한 우려가 있었으나, 210회 실측 결과 문제가 없었다.
- AGENTS.md는 표준화된 형식을 제공하여 더 넓은 에이전트 생태계와 호환성을 높인다.
- Claude Channel은 AI 세션을 PTY로 띄워 자동화 런타임으로 활용하는 새로운 가능성을 보여준다.
AI 코딩 에이전트를 쓸 때 프로젝트 규칙을 알려주는 파일, 어떤 이름을 쓰고 있나? 한국 개발자들 사이에서는 CLAUDE.md가 사실상 표준처럼 쓰이는 경향이 있다. 하지만 글로벌 표준은 AGENTS.md다. 과연 이 두 파일의 차이는 무엇이고, 표준을 따르는 것이 어떤 의미가 있을까?
CLAUDE.md vs AGENTS.md: 누가 진짜 표준일까?
우리 팀의 CLAUDE.md, AGENTS.md로 바꿔도 될까라는 글은 이 궁금증을 직접 파고들었다. AGENTS.md가 표준인 건 알겠는데, 막상 옮기면 느려지거나 비용이 더 들지는 않을까 하는 현실적인 의문이 있을 수 있다. 그래서 Haiku부터 Fable 5까지 5개 모델로 총 210회에 걸쳐 실측 테스트를 진행했다고 한다. 결과는 명확하다. 어떤 모델에서도 성능이 떨어지거나 비용이 늘지 않았다. 오히려 AGENTS.md가 표준이 된 흐름과 그 이점을 설명하며, 단 한 시간이면 끝나는 마이그레이션 5단계까지 제시한다. 이 글의 핵심은 AGENTS.md가 단지 이름만 다른 파일이 아니라, AI 에이전트 생태계 전반의 호환성과 효율성을 높이는 중요한 역할을 한다는 점이다.
Claude Channel: AI 세션을 자동화 런타임으로
한편, 클로드 채널, 이렇게까지 쓸 수 있다는 CLAUDE.md와는 또 다른 방식으로 AI 에이전트 활용의 깊이를 보여준다. 이 글은 Claude Channel이라는 리서치 프리뷰 기능을 활용해 AI 세션을 자동화 런타임으로 쓰는 방법을 다룬다. 기존 MCP(Managed Code Playground)가 필요할 때 AI를 당겨오는 풀(Pull) 구조였다면, 채널은 외부 이벤트를 클로드 세션에 밀어 넣는 푸시(Push) 구조다. 마치 살아있는 라이브 클로드 세션을 PTY(Pseudo-Terminal)로 띄워 자동화 컨트롤러와 코덱스(AI 모델)를 대화시키는 방식이다. 비록 정책 변경으로 하루 만에 철회된 기능이지만, 실무자가 AI 자동화를 어디까지 활용할 수 있는지 보여준 흥미로운 사례다.
$ sources
- [1] 우리 팀의 CLAUDE.md, AGENTS.md로 바꿔도 될까 yozm.wishket.com
- [2] 클로드 채널, 이렇게까지 쓸 수 있다 yozm.wishket.com