참고팁Reddit
Claude Code(클로드 코드): AGENTS.md vs CLAUDE.md 우선순위 및 설정 주의사항
CLAUDE.local.md 파일 생성 시 AGENTS.md가 무시될 수 있음. 팀 단위 프로젝트 환경 설정 시 주의 필요.
요약
9월 18일 업데이트된 v2.1.277부터 Claude Code가 프로젝트 지침 파일로 AGENTS.md를 지원하며, 기존 Codex나 Cursor용으로 설정된 저장소에서도 별도의 CLAUDE.md 없이 사용 가능해졌다. Claude Code는 특정 우선순위에 따라 지침 파일을 읽는데, CLAUDE.md가 존재할 경우 AGENTS.md를 무시하는 등 파일 인식 규칙을 주의해야 한다. 특히 사용자가 개인 메모 용도로 추가하는 CLAUDE.local.md 파일이 CLAUDE.md로 인식되어 기존 AGENTS.md 설정을 무력화할 수 있다. 팀 프로젝트 저장소에서 AGENTS.md를 사용 중이라면 개인 설정 파일 생성 시 Claude Code가 AGENTS.md를 읽지 않게 될 수 있으므로 주의가 필요하다.
AI가 원문을 요약한 내용으로, 부정확할 수 있습니다.
원문 제목 Claude Code reads AGENTS.md now, but one personal file you might add for yourself quietly switches that off
원문 보기 ↗