지난해 8월에 올라와 댓글 354개가 쌓인 'AGENTS.md를 지원해 달라'는 요청 이슈를, 앤트로픽의 클로드 코드 책임자가 8월 17일 '완료'로 닫았어요. 닫으면서 남긴 답은 기능을 넣었다는 게 아니라 "클로드 코드는 CLAUDE.md를 읽으니, `@AGENTS.md` 한 줄만 담은 CLAUDE.md를 만들거나 CLAUDE.md를 AGENTS.md로 이어 두라"는 안내였어요 — 그러면 세션을 시작할 때 AGENTS.md를 그대로 불러와요. 공식 문서도 "클로드 코드는 CLAUDE.md를 읽지 AGENTS.md를 읽지 않는다"고 똑같이 적고 있고, 버전별 변경 목록에 관련 항목이 없다는 지적이 이슈에 이어지고 있어요.
용어 풀이
- AGENTS.md
- 여러 코딩 에이전트가 함께 읽도록 만든 프로젝트 지침 파일 규격. 코덱스·커서 등이 쓴다.
- CLAUDE.md
- 클로드 코드가 세션을 시작할 때 읽는 프로젝트 지침 파일.
운영자 인사이트
코덱스·커서와 저장소를 같이 쓴다면 AGENTS.md를 원본으로 두고 CLAUDE.md엔 `@AGENTS.md` 한 줄만 넣는 게 지금으로선 가장 깔끔해요 — 윈도우에서는 파일을 이어 두는 데 관리자 권한이나 개발자 모드가 필요하니 한 줄 가져오기 쪽을 쓰세요.
여러 관점으로 보기
- 공식 문서가 적은 그대로 클로드 코드는 CLAUDE.md를 읽지 AGENTS.md를 읽지 않는다고 못 박고, 이미 AGENTS.md를 쓰는 저장소라면 그것을 끌어오는 CLAUDE.md를 만들라고 안내해요. Claude Docs
- 한 번에 옮겨 오는 다른 길 `/import` 명령을 쓰면 AGENTS.md 같은 지침 파일을 CLAUDE.md로 한 번 복사해 주고, MCP 서버·명령·서브에이전트·스킬도 함께 옮겨 와요. v2.1.213 이상이 필요해요. Claude Docs