Claude Code, 텔레메트리 꺼면 AGENTS.md 묵살
원제: Claude Code reads AGENTS.md only when telemetry is on [fixed]
왜 중요한가
텔레메트리 비활성화는 기업 보안 정책상 흔한 설정이며, 이 버그는 해당 환경의 모든 사용자에게 무음으로 영향을 미친다.
Anthropic의 Claude Code 2.1.277 버전이 추가한 AGENTS.md 지원 기능이, DISABLE_TELEMETRY=1 또는 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 환경변수 설정 시 파일을 읽지 않는 버그가 발견됐다. 원인은 원격 feature flag('tengu_agents_md_mod')로, 네트워크 접근이 불가할 때 기본값이 false로 설정돼 로컬 파일임에도 로드를 건너뛴다. 경고 메시지는 전혀 표시되지 않는다.
Claude Code 2.1.277이 AGENTS.md 지원을 공식 발표했지만, 해당 기능의 로더 플러그인 'agents-md'는 원격 feature flag에 묶여 있다. 소스 번들 분석 결과, 플러그인의 isOnByDefault 값은 false이며 isAvailable 함수는 원격 서버에서 'tengu_agents_md_mod' 플래그를 조회한다. 서버 응답이 없을 경우 폴백은 false, 즉 기능 비활성화다.
엔지니어 Przemek가 직접 측정한 결과는 명확하다. DISABLE_TELEMETRY=1 또는 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 중 하나라도 설정하면 AGENTS.md는 로드되지 않는다. 변수를 0으로 설정해도 차단이 유지된다. 프로젝트 .claude/settings.json의 env 블록에서 두 변수를 지워도 효과가 없다. 특정 저장소에서만 기능을 활성화하는 방법은 없다. AWS Bedrock, Google Vertex 등 서드파티 게이트웨이도 동일 문제를 겪는다.
더 큰 문제는 침묵이다. 파일이 스킵될 때 Claude Code는 어떤 경고도 출력하지 않는다. 모델은 프로젝트 지침 없이 응답하고, 사용자는 이를 알아챌 방법이 없다.
임시 해결책은 CLAUDE.md에 @path 임포트 문법을 활용하는 것이다. AGENTS.md와 같은 디렉터리에 @AGENTS.md 한 줄짜리 CLAUDE.md를 생성하면, 텔레메트리가 꺼진 상태에서도 파일이 정상 로드된다. 다만 이는 AGENTS.md 지원이 없애려던 바로 그 파일을 다시 추가하는 셈이다. GitHub Issue #95690에 관련 논의가 이어지고 있다.