Claude Code는 텔레메트리가 켜져 있을 때만 AGENTS.md를 읽음

3 days ago 14

Claude Code 2.1.277에 추가된 AGENTS.md 지원은 원격 기능 플래그에 의존하며, 텔레메트리나 비필수 트래픽을 끄면 로컬 지침 파일을 경고 없이 건너뜀 내장 플러그인 agents-md 는 원격 플래그를 가져오지 못하면 기본값 false를 사용해 비활성화됨 DISABLE_TELEMETRY 와 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 중 하나만 설정해도 로딩이 차단됐으며, 값을 0으로 바꿔도 차단이 유지됨 CLAUDE.md에 @AGENTS.md 한 줄을 넣으면 원격 플래그와 무관하게 파일을 불러올 수 있고, 비필수 트래픽을 차단한 상태에서도 테스트를 통과함 파일을 불러오지 않았다는 경고가 없어 사용자가 모델의 지침 무시로 오해할 수 있음. 로컬 파일 읽기를 텔레메트리와 분리하고, 불러오지 못할 때는 이유를 표시해야 함 로컬 지침 로더를 막는 원격 플래그 Claude Code 2.1.277은 프로젝트에 CLAUDE.md가 없으면 대신 AGENTS.md를 읽는 기능을 추가했지만, 텔레메트리를 끈 환경에서는 파일이 로드되지 않음 원인과 재현 결과는 이슈 #95690과 추가 측정 결과에서 확인할 수 있음 2.1.280 번들에서 로더는 내장 플러그인 agents-md로 등록돼 있음 isOnByDefault 값은 false임 isAvailable은 원격 기능 플래그 tengu_agents_md_mod 를 조회하며, 조회 실패 시 대체 값도 false임 플래그를 가져올 수 없으면 플러그인을 사용할 수 없어 로컬 파일을 읽지 않음 작업 디렉터리의 Markdown 파일을 읽는 데 네트워크가 필요하지 않는데도 서버 측 스위치에 의존함 재현 방법과 환경 변수별 결과 빈 디렉터리에 확인용 단어가 담긴 AGENTS.md만 만들고, claude -p에 프로젝트 지침의 단어를 답하도록 요청함 파일 내용은 The canary word is PERIWINKLE.임 질문은 What is the canary word from the project instructions? Answer NONE if you have none. Do not read files.로, 별도 파일 읽기를 금지함 새 설정의 첫 세션은 플래그를 가져오고 두 번째 세션부터 사용하므로, 각 설정에서 두 세션씩 실행함 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 과 DISABLE_TELEMETRY=1 ...

Read Entire Article