라떼군 뉴스Claude Code도 AGENTS.md를 읽는다
발행 / 수정
Claude Code 2.1.277이 AGENTS.md를 읽으면서, AI에게 주는 프로젝트 규칙 파일 하나를 여러 코딩 도구가 함께 쓰기 쉬워졌습니다.
AI 코딩 도구마다 프로젝트 규칙을 읽는 파일이 달라서, 도구를 바꾸면 같은 규칙을 새 파일에 다시 옮겨 적어야 했습니다. 이 수고가 하나 줄었습니다. Anthropic이 한국 시간으로 9월 19일 공개한 Claude Code 2.1.277부터 AGENTS.md를 지원하기 때문입니다.
AGENTS.md는 AI 코딩 도구에 주는 작업 안내서입니다. 프로젝트를 실행하는 방법과 코드를 쓸 때 지킬 규칙을 적어 두는 파일로, "로그인 코드를 고치면 로그아웃도 확인한다" 같은 문장이 들어갑니다. Codex, Cursor, GitHub Copilot의 코딩 에이전트는 이미 이 형식을 씁니다. 이제 Claude Code까지 합류하면서, 규칙 파일 하나를 여러 도구가 함께 쓰기 쉬워졌습니다.
다만 Claude Code가 AGENTS.md를 읽는 데는 조건이 있습니다. 프로젝트에 CLAUDE.md가 없으면 AGENTS.md를 대신 읽습니다. 이미 지침 파일이 있다면 /config의 Project instructions에서 어떤 파일을 읽도록 설정됐는지 확인할 수 있습니다. 또 Bedrock, Vertex, Foundry 같은 클라우드 플랫폼을 거쳐 Claude Code를 쓴다면, 이 버전에서는 아직 적용되지 않습니다.
그렇다고 CLAUDE.md를 당장 지울 필요는 없습니다. 파일을 읽는 일과 그 지시를 같은 방식으로 따르는 일은 별개이기 때문입니다. 먼저 /config에서 실제로 읽는 파일을 확인하고, 이후 자주 하는 작업 하나를 맡겨 규칙이 제대로 적용되는지 살펴보는 편이 좋습니다.
도구를 쉽게 갈아타려면 문서 이름이 같은 것만으로는 부족합니다. 어떤 도구를 쓰든 문서에 적은 규칙을 같은 방식으로 따라야 합니다.
출처
- Anthropic 공식 릴리스: v2.1.277, 2026년 9월 18일(UTC).
- AGENTS.md 공식 안내.