Claude Code: CLAUDE.md 존재 시 AGENTS.md 무시
If your repo has both AGENTS.md and CLAUDE.md, Claude Code ignores AGENTS.md by default
·2026.11.04 11:11
핵심 내용
CLAUDE.md 존재 시 AGENTS.md가 무시되는 충돌이 확인됐다
자세히 보기
- 저장소에 AGENTS.md와 CLAUDE.md가 모두 존재할 경우 Claude Code는 기본적으로 CLAUDE.md만 로드하고 AGENTS.md를 완전히 무시함
- 두 파일을 모두 로드하려면 CLAUDE.md의 첫 줄에
u/AGENTS.md를 추가하거나 프로젝트 인스트럭션 설정을claude-md-and-agents-md로 변경해야 함 - Claude Code 2.1.312에서 서로 다른 무의미한 규칙을 가진 테스트 폴더로 검증하여 CLAUDE.md가 존재할 때 AGENTS.md 규칙이 누락됨을 확인함
- CLAUDE.local.md나 .claude/CLAUDE.md와 같은 추가 파일도 AGENTS.md를 가리지만, AGENTS.local.md와 AGENTS.override.md는 아예 읽지 않음
- AGENTS.md를 직접 읽으려면 버전 2.1.277 이상이 필요하며, Bedrock이나 텔레메트리 오프 모드와 같은 일부 세션은 버전 2.1.281이 요구됨
이 한국어 요약은 AI가 자동으로 만들었습니다. 원문의 주장과 맥락은 원문에서 확인해 주세요. 저작권은 원저작자에게 있습니다.