클로드 코드: 로컬 지침 파일 읽기가 원격 플래그에 의존하는 문제
Claude Code reads AGENTS.md only when telemetry is on [fixed]
Hacker NewsClaude Code의 프로젝트 지침 파일(`AGENTS.md`) 읽기 기능이 원격 서버 플래그에 의존하는 기술적 결함이 발견되었습니다.
- 사용자가 개인 정보 보호를 위해 텔레메트리를 비활성화할 경우, 로컬에 있는 핵심 지침 파일이 네트워크 상태 문제로 인해 모델에게 전달되지 않습니다.
- 로컬 디스크의 파일을 읽는 기능은 원격 서버 플래그나 네트워크 연결 여부와 무관하게 작동해야 사용자 신뢰를 유지할 수 있습니다.
- 현재 임시 해결책으로 `CLAUDE.md`에 `@AGENTS.md`를 포함하는 방법이 있으나, 매 프로젝트마다 파일을 추가해야 하는 번거로움이 따릅니다.
Claude Code는 프로젝트 내의 `AGENTS.md` 파일을 프로젝트 지침으로 읽을 수 있는 기능을 지원합니다. 그러나 이 기능은 내부적으로 `agents-md`라는 빌트인 플러그인을 사용하며, 해당 플러그인의 등록 과정이 원격 피처 플래그(`tengu_agents_md_mod`)의 가용성에 의존하는 구조적 결함이 발견되었습니다. 로컬 디스크에서 마크다운 파일을 읽는 행위 자체는 네트워크 연결을 필요로 하지 않음에도 불구하고, 이 기능은 서버 측 스위치(원격 플래그)를 기다려야만 작동합니다.
사용자가 개인 정보 보호 등의 이유로 텔레메트리 기능을 비활성화하거나(`DISABLE_TELEMETRY=1`), 필수적이지 않은 트래픽을 차단할 경우, `AGENTS.md` 파일은 모델에게 전달되지 않습니다. 이러한 환경에서는 기능이 사용 가능하다고 공지되어도 실제로는 작동하지 않으며, 특히 Bedrock이나 Vertex와 같은 게이트웨이를 사용하는 팀처럼 정책적으로 비필수 트래픽을 제한하는 사용자들에게 큰 문제가 됩니다.
현재로서는 임시 해결책으로 `CLAUDE.md` 파일 내에 `@AGENTS.md`를 포함시키는 방법이 있습니다. 이 방법을 사용하면 `CLAU_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`과 같은 환경 변수가 설정되어 있어도 지침 파일을 읽을 수 있습니다. 다만, 이는 프로젝트마다 추가적인 파일을 생성해야 하는 번거로움이 따릅니다.