Claude Code도 AGENTS.md를 읽는다

• 바뀐 점: Anthropic이 Claude Code 2.1.277에 AGENTS.md 지원을 추가했습니다. 한국 시간 9월 19일 공개된 버전부터 적용됩니다. [1]
• 어떤 파일인가: AI에게 프로젝트의 실행 방법과 코딩 규칙을 알려 주는 작업 안내서입니다. 예를 들어 “로그인 코드를 고치면 로그아웃도 확인한다” 같은 규칙을 적어 둡니다. [2]
• 편리해지는 점: Codex, Cursor, GitHub Copilot의 코딩 에이전트도 이 형식을 지원합니다. 도구를 바꿀 때마다 같은 규칙을 따로 적는 수고가 줄어듭니다. [2]
• 적용 조건: 프로젝트에 CLAUDE.md가 없으면 AGENTS.md를 대신 읽습니다. 기존 지침이 있다면 /config의 Project instructions에서 어떤 파일을 읽도록 설정됐는지 확인할 수 있습니다. [1]
• 지원 범위: 이 기능은 해당 버전에서 Bedrock, Vertex, Foundry를 통한 사용에는 아직 적용되지 않습니다. [1]

라떼군의 시선

• 여러 도구에 같은 규칙을 알려 줄 수 있어 실용적입니다. 규칙을 고칠 때 문서마다 찾아다니며 수정할 일도 줄어듭니다.
• 도구를 고를 때는 답변의 품질뿐 아니라 우리 프로젝트의 작업 방식을 얼마나 쉽게 이어받는지도 살펴볼 만합니다.

출처

1. Anthropic 공식 릴리스: v2.1.277, 2026년 9월 18일(UTC).
2. AGENTS.md 공식 안내.