Claude Code는 텔레메트리가 켜져 있을 때만 AGENTS.md를 읽습니다 [수정 완료]

(blog.szypowi.cz)

Hacker News2026년 9월 23일AI 코딩

Claude Code는 텔레메트리가 켜져 있을 때만 AGENTS.md를 읽습니다 [수정 완료]

Anthropic의 Claude Code가 텔레메트리(사용자 데이터 수집)를 비활성화할 경우 프로젝트 지침 파일인 AGENTS.md를 읽지 못하는 설계 결함이 발견되어, 보안과 프라이버시를 중시하는 개발자들의 혼란을 초래하고 있습니다.

이 글의 핵심 포인트

1Claude Code 2.1.277 버전부터 AGENTS.md 지원이 발표되었으나, 텔레메트리 비활성화 시 작동하지 않음
2문제의 원인은 원격 기능 플래그(tengu_agents_md_mod)가 네트워크 연결 없이는 false로 기본 설정되기 때문임
3CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 또는 DISABLE_TELEMETRY=1 설정 시 AGENTS.md 로드가 차단됨
4현재 해결책은 CLAUDE.md 파일 내에서 '@AGENTS.md'와 같이 경로를 직접 임포트하는 방식임
5이 문제는 Bedrock이나 Vertex AI와 같은 서드파티 게이트웨이를 사용하는 환경에서도 동일하게 발생함

이 글에 대한 공공지능 분석

왜 중요한가?

개발 도구의 핵심 기능이 사용자의 프라이버시 설정에 따라 예고 없이 작동하지 않는 것은 소프트웨어 신뢰의 문제입니다. 특히 보안이 중요한 기업 환경에서 설정 오류로 인해 AI가 잘못된 지침을 따르게 될 위험이 있습니다.

어떤 배경과 맥락이 있나?

Anthropic은 새로운 기능을 점진적으로 배포하기 위해 원격 기능 플래그(Feature Flag) 방식을 사용합니다. 하지만 이 방식이 로컬 파일 읽기라는 오프라인 기능까지 네트워크 상태에 종속되게 만들며 설계적 결함을 노출했습니다.

업계에 어떤 영향을 주나?

AI 에이전트 도구의 확산 과정에서 '투명성'과 '예측 가능성'이 핵심 경쟁력이 될 것입니다. 기능이 작동하지 않을 때 사용자에게 명확한 경고를 주지 않는 설계는 개발자 생태계의 이탈을 부를 수 있습니다.

한국 시장에 어떤 시사점이 있나?

보안과 데이터 주권을 중시하는 한국의 엔터프라이즈 및 금융권 개발 환경에서는 이러한 'Silent Failure'가 치명적일 수 있습니다. 글로벌 AI 도구 도입 시 설정값에 따른 기능 제약 사항을 면밀히 검토해야 합니다.

이 글에 대한 큐레이터 의견

이번 사례는 AI 도구의 '기능 배포 전략'과 '사용자 프라이버시' 사이의 충돌을 극명하게 보여줍니다. Anthropic 입장에서는 원격 플래그를 통해 안정적인 롤아웃을 시도하려 했겠지만, 로컬 자원(AGENTS.md)을 읽는 기능까지 네트워크 상태에 종속시킨 것은 명백한 설계 미스입니다. 이는 개발자에게 '설정의 불일치'라는 인지 부하를 강요하며, 결과적으로 AI 모델의 성능 저하로 오인하게 만드는 최악의 사용자 경험을 제공합니다.

물론, 신기능을 서버 측에서 제어하여 인프라 부하를 조절하고 버그 발생 시 즉각 차단하려는 트레이드오프는 이해할 수 있습니다. 하지만 로컬 파일 읽기 같은 오프라인 기능까지 차단하는 것은 과도한 통제입니다. 스타트업 창업자들은 이러한 'Silent Failure'가 제품의 신뢰도를 어떻게 깎아먹는지 주목해야 합니다. AI 에이전트 기반의 워크플로우를 구축할 때, 도구의 설정이 로컬 환경의 보안 정책과 충돌하지 않는지, 그리고 오류 발생 시 명확한 디버깅 정보를 제공하는지가 서비스 채택의 핵심 변수가 될 것입니다.

원문 보기 →