핵심 요약
- 클로드 코드가 지원하기 시작한 'AGENTS.md' 파일 로딩 기능이 서버 피처 플래그에 의존하고 있어, 텔레메트리를 비활성화하면 동작하지 않는 사실이 확인되었습니다.
- 로컬 파일을 읽는 작업임에도 원격 통신이 차단되면 아무런 경고나 알림 없이 조용히 파일 로드를 건너뛰는 구조입니다.
- 보안상 통신을 차단한 기업 환경 등에서 지침이 무시되는 피해가 발생하고 있으며, 현재는 CLAUDE.md 내 간접 임포트로 우회해야 합니다.
요약 앤트로픽의 개발 도구인 '클로드 코드(Claude Code)'가 최근 업데이트에서 프로젝트 지침용 표준 파일인 'AGENTS.md' 지원 기능을 추가했으나, 원격 텔레메트리(원격 측정 및 비필수 통신)가 켜져 있어야만 해당 파일을 정상적으로 읽어 들이는 것으로 밝혀졌습니다.
보안이나 프라이버시를 이유로 텔레메트리를 꺼둔 한 개발자가 자신의 저장소에서 AGENTS.md가 전혀 인식되지 않는 현상을 겪고 번들 코드를 직접 뜯어보며 문제를 확인했습니다. 분석 결과, AGENTS.md를 로드하는 내장 플러그인(agents-md)의 기본 활성화 상태는 'false'로 설정되어 있었으며, 외부 서버에서 'tengu_agents_md_mod'라는 피처 플래그를 받아와야만 켜지는 구조였습니다. 즉, 로컬 디렉터리에 있는 마크다운 파일을 읽는 작업임에도 불구하고 네트워크를 통해 원격 플래그를 가져오지 못하면 기능 자체가 완전히 차단되는 것입니다.
테스트 결과 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 또는 DISABLE_TELEMETRY 환경 변수를 설정해 통신을 제한할 경우 파일이 절대 로드되지 않았습니다. 심지어 0으로 설정해도 차단이 풀리지 않았으며, 개별 저장소 설정 파일(.claude/settings.json)을 통한 해제도 먹히지 않았습니다. 게다가 이러한 차단 과정에서 어떤 경고 메시지도 출력되지 않아, 사용자는 지침 파일이 무시된 채 모델이 답변하는 이유를 전혀 알 수 없게 됩니다. 이는 자체 게이트웨이나 AWS Bedrock, GCP Vertex AI 등을 통해 비필수 통신을 차단하고 클로드 코드를 사용하는 기업 환경에서도 똑같이 발생하는 문제입니다.
작성자는 원격 서버와 통신해야 하는 기능도 아닌 로컬 파일 읽기에 텔레메트리를 필수 조건으로 걸어둔 점과, 설정으로 인해 기능이 누락되었음에도 아무런 안내조차 띄우지 않는 침묵 방식을 강하게 비판했습니다. 현재로서는 CLAUDE.md 파일 안에 '@AGENTS.md'라는 한 줄 임포트 문구를 직접 넣어 우회하는 방법이 유일한 대안으로 제시되고 있습니다.
Sponsored · 광고