AI 요약
Claude Code 2.1.277 버전이 AGENTS.md 지원을 발표했지만, 텔레메트리를 비활성화한 환경에서는 AGENTS.md 파일이 전혀 로드되지 않는 버그가 확인됐다. 원인은 AGENTS.md 로더가 'tengu_agents_md_mod'라는 원격 기능 플래그에 의존하는 내장 플러그인으로 등록돼 있고, 기본값이 false이기 때문이다. 텔레메트리를 끄면 이 플래그를 가져올 수 없어 플러그인이 비활성화되고, 경고 메시지조차 표시되지 않는다. 저자는 CLAUDE.md에 @AGENTS.md 한 줄을 추가하는 우회 방법을 제시하며, 프라이버시 선택이 기능 손실로 이어지는 것은 부당하다고 지적했다.
핵심 포인트
- Claude Code 2.1.277에서 AGENTS.md 지원이 발표됐으나, 로더는 'tengu_agents_md_mod' 원격 플래그에 의존하며 기본값(isOnByDefault)이 false
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1또는DISABLE_TELEMETRY=1설정 시 AGENTS.md가 로드되지 않으며, 변수 값을 0으로 설정해도 차단이 유지됨- 프로젝트
.claude/settings.json의 env 블록으로는 해제 불가능하지만, 세션 레벨 오버라이드(claude --settings '{"env":{"DISABLE_TELEMETRY":"","CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":""}}')는 두 번째 세션부터 작동 - 우회 방법으로 AGENTS.md 옆에
@AGENTS.md를 담은 CLAUDE.md 한 줄을 추가하면 텔레메트리를 끈 상태에서도 로드 가능 - Bedrock, Vertex, 서드파티 게이트웨이에서도 플래그가 true로 해석되지 않아 동일한 문제 발생
향후 전망
- 원격 플래그 의존 구조가 개선되지 않으면 프라이버시를 중시하는 개발자들의 불만이 확대될 가능성이 있다.
- 로컬 파일 로딩에 네트워크 의존성을 제거하라는 요구가 이슈 트래커를 중심으로 이어질 전망이다.
출처:hackernews (szypowi.cz 블로그)