클로드 코드, AGENTS.md 지원 추가 보도…최신 릴리스는 2.1.276

앤트로픽(Anthropic)의 코드 작성 도구 클로드 코드(Claude Code)가 프로젝트 지침 파일 AGENTS.md를 읽는 기능을 추가했다는 보도가 나왔다.

Crypto Briefing은 클로드 코드 버전 2.1.277이 프로젝트에 CLAUDE.md가 없을 때 AGENTS.md를 대체 파일로 읽도록 업데이트됐다고 보도했다. CLAUDE.md가 있으면 기존 파일을 우선 적용하며, 설정에 따라 두 파일을 함께 운용할 수 있다는 내용이다.

AGENTS.md는 코드 작성 에이전트에 프로젝트 구조, 실행 명령, 테스트 방법, 코딩 규칙 등을 전달하는 마크다운 파일이다. 사람이 읽는 README와 별도로 인공지능 에이전트가 작업에 필요한 개발 지침을 담는 형식이다.

AGENTS.md 공식 사이트는 이 형식이 6만개가 넘는 오픈소스 프로젝트에서 사용된다고 밝혔다. 오픈AI의 Codex, 구글의 Gemini CLI, 커서(Cursor), GitHub Copilot 등이 지원 대상으로 소개돼 있다.

오픈AI의 Codex는 이미 AGENTS.md를 프로젝트 지침 파일로 사용하고 있다. 오픈AI 문서도 저장소의 명명 규칙과 테스트 명령, 개발 환경 정보를 이 파일에 기록하도록 안내한다.

도구별 적용 방식은 같지 않다. Gemini CLI는 기본적으로 GEMINI.md를 사용하지만, 설정 파일에서 컨텍스트 파일 이름을 AGENTS.md로 바꿀 수 있다.

AGENTS.md가 주목받는 이유는 여러 코딩 에이전트에 동일한 프로젝트 규칙을 전달할 수 있기 때문이다. 개발팀은 하나의 파일에 빌드·테스트·보안 규칙을 정리해 도구별 설정 차이를 줄일 수 있다.

다만 파일 이름이 같다고 해서 각 도구의 동작까지 동일해지는 것은 아니다. 기본 파일의 우선순위와 설정 방식, 지원하는 명령 범위는 도구별 문서를 따로 확인해야 한다.

앤트로픽의 공개 GitHub 릴리스 페이지에서 현재 확인되는 최신 항목은 버전 2.1.276이다. 같은 페이지에서는 버전 2.1.277의 릴리스 기록이 확인되지 않았다.

따라서 이번 보도는 클로드 코드에 새 기능이 추가됐다는 내용과 공식 배포판의 버전 기록 사이에 차이가 남아 있는 상태다. 보도된 업데이트가 실제 배포판 전체에 적용됐는지는 추가 확인이 필요하다.

Crypto Briefing은 클라우드 환경인 Bedrock, Vertex, Foundry에서는 AGENTS.md 대체 지원이 아직 제공되지 않는다고 전했다. 클로드 코드를 모든 실행 환경에서 같은 방식으로 설정할 수 있다고 단정하기 어려운 이유다.

프로젝트 지침 파일은 AI 코딩 에이전트가 작업을 시작할 때 참고하는 공통 문서 역할을 한다. 파일에는 저장소 구조와 실행 명령, 테스트 방식, 코딩 규칙처럼 작업 재현에 필요한 정보를 담을 수 있다.

클로드 코드의 Bash 명령 실행을 운영체제 수준에서 격리하는 샌드박스 기능처럼 클로드 코드의 실행 환경과 권한 관리도 도구 활용 범위를 좌우하는 요소다. 지침 파일 지원 여부와 함께 실행 환경별 보안 경계도 점검해야 한다.

이번 사안의 핵심은 AGENTS.md 자체보다 도구 간 프로젝트 지침을 얼마나 일관되게 공유할 수 있느냐에 있다. 클로드 코드 버전 2.1.277의 공식 배포 여부와 환경별 지원 범위가 향후 확인 대상이다.