Claude Code, 텔레메트리 끈 사용자의 AGENTS.md 로딩 막다
원제 Claude Code reads AGENTS.md only when telemetry is on
314 포인트댓글 149
Key Point
로컬 파일 읽기가 프라이버시 설정에 숨겨진 네트워크 의존성으로 인해 무음으로 차단되는 것이 문제다. 특히 텔레메트리를 의도적으로 끈 사용자와 보안 정책이 있는 팀이 기능을 사용할 수 없으면서도 아무 알림도 받지 않는다.
핵심 요약
- Claude Code 2.1.277은 프로젝트에 CLAUDE.md가 없을 때 대체용으로 AGENTS.md를 읽도록 설계됐지만, 실제로는 원격 피처 플래그에 의존한다.
- 텔레메트리를 비활성화하거나 DISABLE_TELEMETRY, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 환경변수를 설정하면 AGENTS.md 로딩이 차단되는데, 프로젝트 .claude/settings.json에서 이를 해제할 수 없다.
- 로컬 파일 읽기는 네트워크가 필요 없지만, 원격 플래그를 못 받으면 아무 경고도 없이 파일을 건너뛴다.
- Bedrock, Vertex, 서드파티 게이트웨이 사용자도 플래그를 받을 수 없어 같은 문제를 겪는다.
- 현재 해결책은 CLAUDE.md 파일에 '@AGENTS.md' 한 줄을 추가하는 것이지만, 이는 AGENTS.md 도입으로 해결하려던 추가 파일 문제를 다시 만든다.