클로드 코드, 오픈AI 표준 'AGENTS.md' 지원: 설정 파일 이중 관리 끝

클로드 코드(Claude Code)와 오픈AI 툴을 함께 사용하는 개발자라면 프로젝트 루트 폴더에 CLAUDE.md와 AGENTS.md를 둘 다 두고, 싱크를 맞추기 위해 심볼릭 링크를 걸어본 경험이 있을 것입니다.

이러한 번거로움이 마침내 해소되었습니다. 앤트로픽은 금요일 배포된 클로드 코드 버전 2.1.277에서 오픈AI가 주도해 온 AGENTS.md 표준을 공식 지원하기 시작했습니다.

심볼릭 링크는 그만, CLAUDE.md 없으면 AGENTS.md 읽는다

AI 코딩 에이전트는 매 요청마다 이 마크다운 지침 문서를 읽어 코딩 컨벤션과 권장 도구, 행동 수칙 등을 파악합니다. 에이전트의 전체 컨텍스트를 형성하는 핵심 파일입니다.

클로드 코드 엔지니어 타릭 시히파르(Thariq Shihipar)가 소셜 미디어를 통해 밝힌 바에 따르면, 새 버전부터는 디렉터리에 CLAUDE.md가 없으면 클로드가 자동으로 AGENTS.md를 찾아 사용합니다. 이 동작은 /config 명령어로 켜고 끌 수 있습니다.

소식이 전해지자 오픈AI 핵심 제품 총괄 티보 소티오(Thibault Sottiaux)는 환영한다는 반응을 남겼고, 시히파르가 악수 이모지로 답하며 양사 간의 보기 드문 훈훈한 장면을 연출하기도 했습니다.

왜 중요한가

개발자 입장에서 당장 체감되는 가치는 관리 포인트의 단일화입니다. 여러 AI 도구를 오가며 작업하더라도 동일한 프로젝트 지침을 이중으로 관리할 필요가 없어졌습니다. 이미 AGENTS.md를 갖춘 프로젝트라면 별도 세팅 없이 클로드 코드를 바로 투입할 수 있습니다.

에이전트 표준화 흐름에서도 상징적인 진전입니다. 오픈AI는 지난해 리눅스 재단 산하 Agentic AI Foundation에 AGENTS.md를 기증했으며, 2025년 12월 기준 이미 6만 개 이상의 오픈소스 프로젝트가 이 표준을 채택했습니다.

앤트로픽의 이번 결정은 매우 실용적이고 영리해 보입니다. 클로드 코드가 높은 인기를 얻고 있는 상황에서 독자 규격을 고집할 수도 있었지만, 개발자들에게 피로감을 주는 파일 분절화를 과감히 버렸습니다. 오픈AI 진영에 머물던 개발자들의 유입 장벽을 스스로 낮춘 셈입니다.