참고팁Hacker News
Claude Code, 텔레메트리 끄면 AGENTS.md 무시하는 버그
설정 파일이 로드되지 않는 문제 확인. CLAUDE.md 내 @path 임포트로 해결 가능.
요약
Claude Code 2.1.277 버전부터 프로젝트 설정 파일로 AGENTS.md를 지원하기 시작했으나, 텔레메트리 기능이 꺼져 있으면 해당 파일이 정상적으로 로드되지 않는 문제가 발견되었습니다. 분석 결과, AGENTS.md 로더는 'tengu_agents_md_mod'라는 원격 기능 플래그에 의존하고 있어, 텔레메트리가 비활성화되면 플래그를 불러오지 못해 파일 읽기가 차단되는 것으로 확인되었습니다. 이 문제는 Bedrock 및 Vertex와 같은 서드파티 게이트웨이 환경에서도 동일하게 발생하며, 파일이 건너뛰어져도 사용자에게 별도의 경고 메시지가 표시되지 않습니다. 대안으로 CLAUDE.md 파일 내에 '@path'를 사용하여 AGENTS.md를 가져오도록 설정하면 텔레메트리 설정과 무관하게 파일을 정상적으로 불러올 수 있습니다.
AI가 원문을 요약한 내용으로, 부정확할 수 있습니다.
원문 제목 Claude Code reads AGENTS.md only when telemetry is on
원문 보기 ↗