앤트로픽이 9월 18일 낸 클로드 코드 v2.1.277 릴리스 노트에 「CLAUDE.md 가 없는 프로젝트에서는 AGENTS.md 를 대신 읽는다」는 항목이 들어갔고, 공식 문서 메모리 페이지에도 AGENTS.md 절이 새로 생겼어요. 기본값은 대체 읽기라서 작업 폴더나 그 위에 CLAUDE.md·.claude/CLAUDE.md·CLAUDE.local.md 가 하나라도 있으면 AGENTS.md 는 읽히지 않고, 둘 다 읽게 하려면 /config 의 Project instructions 를 claude-md-and-agents-md 로 바꿔야 해요. 하위 폴더 AGENTS.md 는 CLAUDE.md 처럼 그 폴더 파일을 Read 도구로 열 때 붙지만 /memory·/context 목록에는 안 보이고, 베드록·버텍스·파운드리처럼 기능 플래그를 못 받는 세션·텔레메트리를 끈 세션·설치나 업그레이드 직후 첫 세션에서는 아직 안 읽히니 거기서는 종전대로 CLAUDE.md 에 @AGENTS.md 한 줄을 두는 방법을 써야 해요.
- AGENTS.md
- 코덱스·커서·코파일럿 등 여러 코딩 에이전트가 공통으로 읽는 저장소 지침 파일
- CLAUDE.local.md
- 커밋하지 않는 개인용 클로드 코드 지침 파일
- 기능 플래그
- 앤트로픽 서버에서 받아 오는 기능 켜기·끄기 값. 서드파티 제공자나 텔레메트리 차단 환경에서는 받지 못함
- 텔레메트리
- 사용 통계를 제공사 서버로 보내는 기능
코덱스·커서와 저장소를 같이 쓰느라 AGENTS.md 를 원본으로 두고 @AGENTS.md 한 줄짜리 CLAUDE.md 를 만들어 뒀다면 그대로 둬도 두 번 읽히지 않으니 급히 지울 이유는 없고, 오히려 팀원 한 명이 개인용 CLAUDE.local.md 를 두는 순간 그 사람만 AGENTS.md 를 못 읽게 되니 사내 기준은 「가져오기용 CLAUDE.md 유지」나 「전원 claude-md-and-agents-md」 중 하나로 정해 두는 게 안전해요.
- 릴리스 노트 「CLAUDE.md 가 없는 프로젝트에서는 AGENTS.md 를 대신 읽고, /config 의 Project instructions 에서 바꾼다, 베드록·버텍스·파운드리는 아직」이 첫 항목이에요. GitHub
- 공식 문서의 동작 규칙 작업 폴더나 그 위의 CLAUDE.md·.claude/CLAUDE.md·CLAUDE.local.md 는 AGENTS.md 를 막지만 ~/.claude/CLAUDE.md·관리형 CLAUDE.md·.claude/rules/ 는 막지 않고, AGENTS.local.md·.agents/ 아래는 읽지 않는다고 적혀 있어요. Claude Code Docs
- 구현 커밋 mods/agents-md 라는 내장 플러그인으로 들어왔고, 설정 키 instructionFiles 에 claude-md·claude-md-or-agents-md(기본)·claude-md-and-agents-md·managed-only 네 값이 있으며 프로젝트의 .claude/settings.json 에서는 이 옵션을 읽지 않아요. GitHub
- 해커뉴스 반응 「1년 반 동안 다들 불평한 끝에야 했다」는 반응이 많고, .agents/skills 폴더의 스킬은 여전히 읽지 않는다는 지적과 심볼릭 링크 우회는 하위 폴더까지 안 미쳤다는 경험담이 달렸어요. Hacker News
- 같은 날 바로 앞 릴리스 몇 시간 앞선 v2.1.276 은 ANTHROPIC_BASE_URL 로 프록시·게이트웨이를 쓸 때 모든 요청이 400 으로 실패하던 2.1.275 회귀 하나만 고쳤어요. GitHub