OpneAI가 CLAUDE.md 파일 지원을 추가했습니다. 도 조만간...?
쉬운 설명
Claude Code는 개발자가 코드를 짤 때 옆에서 돕는 AI 도구인데요, 보통 프로젝트 폴더에 있는 'CLAUDE.md'라는 안내 파일을 읽고 그 규칙에 맞춰 일을 합니다. 그런데 요즘 여러 AI 도구가 함께 쓰는 'AGENTS.md'라는 공통 파일 형식이 주목받고 있거든요. 이번 업데이트 덕분에 Claude Code는 폴더에 CLAUDE.md가 없더라도 AGENTS.md를 대신 찾아서 읽을 수 있게 되었습니다. 쉽게 비유하자면, 우리 반 전용 안내문이 없을 때 학교 공통 생활 규칙을 대신 참고해서 행동하도록 똑똑해진 셈이죠.
요약
앤트로픽의 Claude Code 팀 소속 Thariq(@trq212)이 X(트위터)를 통해 밝힌 내용에 따르면, 버전 2.1.277부터 Claude Code에 AGENTS.md 지원 기능이 추가됩니다. 작업 폴더 안에 전용 설정 파일인 CLAUDE.md가 없으면, Claude가 자동으로 AGENTS.md 파일을 찾아 그 내용을 참고하는 방식입니다. 이 기능은 /config 명령어로 언제든 켜고 끌 수 있습니다.
AGENTS.md는 다양한 AI 코딩 도구들이 함께 채택하고 있는 프로젝트 안내 파일 형식인데요. 프로젝트의 기본 구조나 코딩 규칙, 빌드 방법 같은 핵심 정보를 정리해두는 용도로 쓰입니다. Claude Code가 이 형식을 지원하게 되면서, 파일 하나로 여러 AI 도구를 함께 다룰 수 있게 되어 실무자들의 번거로움이 크게 줄어들 것으로 보입니다.
활용 포인트
예를 들어 팀 안에서 Claude Code와 다른 AI 코딩 도구(Codex 계열 등)를 함께 쓰고 있다면, 지금까지는 CLAUDE.md와 AGENTS.md를 따로따로 만들어 중복해서 관리해야 했습니다. 하지만 이제는 프로젝트 루트 폴더에 AGENTS.md 파일 하나만 두면 Claude Code도 이를 문제없이 인식합니다. 새 프로젝트를 시작할 때 코딩 스타일이나 디렉터리 구조, 테스트 실행 방법 등을 AGENTS.md에 한 번만 정리해두면, 여러 AI 도구가 같은 지침을 공유하므로 설정이 서로 어긋날 일도 줄어들죠.
만약 팀에서 이미 CLAUDE.md를 활용해 세밀한 설정을 마쳐두었다면 그대로 쓰셔도 괜찮고, Claude Code에만 특별한 지침을 주고 싶을 때 CLAUDE.md를 따로 남겨두셔도 좋습니다. 혹시 자동 인식 기능이 의도치 않게 작동할까 염려되신다면 /config 명령어로 꺼둘 수도 있으니, 2.1.277 이상 버전으로 업데이트한 뒤 설정 화면을 한 번 둘러보시는 것을 추천합니다.
주의 사항
이 기능은 2026년 9월 18일 기준으로 공개된 버전 2.1.277부터 적용되는 내용입니다. 따라서 이후 버전 업데이트에 따라 세부적인 작동 방식이나 두 파일이 모두 있을 때의 우선순위 규칙 등이 달라질 수 있습니다. 또한 이번 소식은 앤트로픽의 공식 블로그나 공식 문서가 아니라 실무 담당자의 개인 X(트위터) 글을 통해 전해진 만큼, 정확한 세부 스펙은 Claude Code 공식 문서나 릴리스 노트를 통해 다시 한번 확인하시는 것이 안전합니다.
자체 검증
원문 게시물을 확인해보면 핵심 사실은 '버전 2.1.277부터 CLAUDE.md가 없는 폴더에서 AGENTS.md를 대신 인식한다', '이 기능은 /config 명령어로 켜고 끌 수 있다'는 점입니다. 본문에서는 이 내용을 왜곡 없이 정확하게 반영했으며, 원문에 나오지 않은 타 AI 도구와의 세부 연동 방식이나 우선순위 규칙 등은 섣부른 추측을 피해 일반적인 활용 시나리오 수준으로만 안내했습니다.
태그
#AI #ClaudeCode #AGENTSMD #개발도구 #AI에이전트 #코딩어시스턴트
원문
https://x.com/trq212/status/2101009392611278961