참고팁Reddit
Claude Code(클로드 코드)의 AGENTS.md 인식 오류 해결법
CLAUDE.md가 있을 때 AGENTS.md가 무시되는 현상 해결. @import를 사용해 파일 내에서 명시적으로 호출하는 것이 핵심.
요약
최근 Claude Code 사용 환경에서 AGENTS.md와 CLAUDE.md 파일이 공존할 경우, Claude Code가 AGENTS.md를 무시하는 현상이 발견되었습니다. 공식 문서에 따르면 Claude Code는 작업 디렉터리 내에 CLAUDE.md, .claude/CLAUDE.md, 혹은 CLAUDE.local.md 파일이 존재하면 기본적으로 AGENTS.md를 읽지 않습니다. 이 문제를 해결하려면 CLAUDE.md 파일 첫 번째 줄에 '@AGENTS.md'를 입력하여 명시적으로 불러와야 합니다. 단순히 AGENTS.md를 읽어달라고 문장으로 적는 것은 자동 실행을 보장하지 않으므로 주의가 필요합니다. 설정 변경 후에는 /memory 명령어를 실행하여 변경 사항을 적용해야 합니다.
AI가 원문을 요약한 내용으로, 부정확할 수 있습니다.
원문 제목 If your repo has both AGENTS.md and CLAUDE.md, Claude Code may be ignoring AGENTS.md
원문 보기 ↗