FETCH DIFF

←  다이제스트

Digest /

CLAUDE.md vs AGENTS.md: AI 에이전트 컨텍스트 파일, 무엇이 표준일까?

AI 코딩 에이전트에 프로젝트 규칙을 알려주는 컨텍스트 파일 CLAUDE.md와 AGENTS.md의 차이점을 분석하고, 실제 성능 테스트를 통해 어느 쪽이 더 효율적인지 알아본다.

AI 개발자 도구 출처 2 KST 10:05

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. [1] 우리 팀의 CLAUDE.md, AGENTS.md로 바꿔도 될까
  2. [2] 클로드 채널, 이렇게까지 쓸 수 있다