앤트로픽의 AI 코딩 에이전트 클로드 코드가 AGENTS.md 파일을 인식하는 기능을 추가했다. 버전 2.1.277부터 프로젝트 폴더 안에 기존 CLAUDE.md 파일이 없으면 클로드가 AGENTS.md 파일을 찾아 대신 사용한다. 이 소식은 사이먼 윌리슨(Simon Willison)이 9월 18일(현지시각) 자신의 블로그에 타릭 시히파르(Thariq Shihipar)의 발언을 인용해 전했다. 새 기능은 클로드 코드의 커스터마이징 체계인 “클로드 코드 모드(Claude Code mods)”를 기반으로 구현됐다.

핵심 변경: CLAUDE.md 없으면 AGENTS.md 자동 인식

타릭 시히파르는 “우리는 클로드 코드에 AGENTS.md 지원을 추가하고 있다”고 밝혔다. 그의 설명에 따르면 오늘부터 버전 2.1.277에서, 폴더 안에 CLAUDE.md가 없을 경우 클로드는 AGENTS.md를 확인하고 사용한다. 두 파일이 함께 있으면 CLAUDE.md가 우선하고, CLAUDE.md가 없을 때만 AGENTS.md가 대체 지침 파일로 작동하는 구조다.

이 방식은 기존에 AGENTS.md 형식으로 프로젝트 규칙을 정리해 둔 팀이라면 파일을 새로 만들거나 옮기지 않고도 클로드 코드에서 곧바로 활용할 수 있게 해준다. 프로젝트 지침 파일을 파일명별로 따로 관리해야 했던 번거로움을 줄여주는 변화다.

기반 기술: “클로드 코드 모드”란 무엇인가

AGENTS.md 지원은 클로드 코드 모드라는 새로운 커스터마이징 체계 위에서 동작한다. 타릭 시히파르는 이를 “클로드 코드 하네스(harness)를 커스터마이징하는 새로운 방법”이라고 설명했다. 하네스는 클로드 코드가 실제로 실행되는 뼈대 구조를 가리키며, 이 위에 다양한 기능을 모듈처럼 얹을 수 있게 한 것이 모드다.

이번 AGENTS.md 지원은 앤트로픽이 자체적으로 만들어 기본 내장한 “빌트인 모드(built-in mod)”다. 타릭 시히파르는 “이는 내장된 모드지만, 사용자가 원한다면 직접 프로젝트 지침의 커스텀 버전을 만들 수도 있다”고 덧붙였다. 그는 이 모드의 소스 코드도 함께 공개했다고 밝혔다.

확장 생태계 속에서 나온 변화

클로드 코드는 최근 몇 주간 플러그인과 모드 같은 확장 기능을 잇달아 선보이고 있다. 앞서 유니티 테크놀로지스는 클로드 코드용 공식 플러그인을 9월 초 29개 스킬과 함께 출시했고, 오픈AI의 코덱스용 플러그인도 9월 16일 31개 스킬로 뒤따라 나왔다. 두 사례 모두 각 도구가 클로드 코드의 확장 구조를 활용해 자체 기능을 심어 넣은 경우다.

AGENTS.md 지원 역시 같은 맥락에서 나온 변화다. 다만 특정 게임 엔진이나 특정 회사를 겨냥한 플러그인이 아니라, 클로드 코드 사용자 전체에게 적용되는 기본 동작 변경이라는 점에서 차이가 있다.

사용자가 직접 만드는 커스텀 모드도 가능

클로드 코드 모드 체계는 AGENTS.md 지원 하나로 끝나지 않는다. 타릭 시히파르에 따르면 사용자는 이 빌트인 모드처럼 자신만의 프로젝트 지침 커스텀 버전을 직접 만들 수 있다. 이를 위해 모드의 소스 코드도 공개된 상태다.

다만 구체적으로 어떤 커스텀 모드를 얼마나 자유롭게 만들 수 있는지에 대한 세부 가이드는 현재까지 공개된 내용에는 포함되지 않았다.