클로드 코드(Claude Code)가 Claude.md 파일이 없을 때 AGENTS.md를 읽도록 변경됐다. 클로드 코드 공식 변경 기록은 9월 19일 이 내용을 새 기능·개선 사항·버그 수정이 정리되는 릴리스 노트에 반영했다.
AGENTS.md를 대체 경로로 읽는 변경
이번 변경의 핵심은 클로드 코드가 프로젝트 지침 파일을 확인하는 과정에서 Claude.md가 존재하지 않을 경우 AGENTS.md를 읽는다는 점이다. 변경 기록 제목에도 ‘Claude.md가 없을 때 AGENTS.md를 읽는다’고 명시돼 있어, 두 파일을 같은 조건에서 모두 읽는다는 내용이 아니라 Claude.md 부재 시 AGENTS.md를 대체 경로로 활용하는 동작으로 설명된다.
원문에는 AGENTS.md의 적용 범위나 파일 내부에서 지원되는 지침 형식, 여러 디렉터리에 같은 파일이 있을 때의 처리 방식, 이번 변경이 적용된 정확한 버전은 적혀 있지 않다. 따라서 이번 발표만으로 특정 프로젝트 구조에서의 우선순위나 다른 설정 파일과의 관계까지 확인할 수는 없다. 확인 가능한 내용은 Claude.md가 없는 환경에서 AGENTS.md가 읽히도록 클로드 코드의 동작이 바뀌었다는 사실이다.
릴리스 노트와 설치 버전 확인 방법
클로드 코드의 릴리스 노트는 새 기능과 개선 사항, 버그 수정 내용을 버전별로 제공하는 문서다. 이번 AGENTS.md 관련 내용도 그 변경 기록에 포함됐다. 문서는 전체 변경 내역이 깃허브(GitHub)의 CHANGELOG.md에서 생성된다고 설명하며, 상세한 변경 이력의 원천이 해당 파일임을 함께 안내한다.
사용자는 터미널에서 `claude –version` 명령을 실행해 현재 설치된 클로드 코드의 버전을 확인할 수 있다. 다만 원문은 AGENTS.md를 읽는 기능이 어느 버전부터 제공되는지 별도로 밝히지 않았으므로, 명령 실행 결과만으로 이번 변경의 적용 여부를 판단하는 방법이나 최소 버전은 제시하지 않는다. 이번 기록은 기능 변경 사실과 버전 확인 명령을 안내하는 수준이다.
이번 변경은 Claude.md를 사용하지 않는 프로젝트에서도 AGENTS.md를 통해 클로드 코드에 지침을 전달할 수 있도록 읽기 경로를 넓힌 내용으로 정리된다. 가격, 출시 일정, 별도 설정 방법, 성능 변화에 관한 설명은 원문에 포함되지 않았다. 따라서 현재 확인되는 시장·정책 영향이나 경쟁 제품과의 비교보다, 파일명 조건에 따른 동작 변경 자체가 이번 릴리스 노트의 핵심이다.