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가 자동으로 만들었습니다. 원문의 주장과 맥락은 원문에서 확인해 주세요. 저작권은 원저작자에게 있습니다.

AI 처리 방식을 확인하거나, 요약 오류와 출처 표기 문제, 삭제 요청을 문의 · 건의로 알려주세요.