Claude Code, 원격 플래그 켜야만 AGENTS.md 읽음
원제 Claude Code reads AGENTS.md only when telemetry is on
314 포인트댓글 149
Key Point
텔레메트리를 끈 사용자가 원격 플래그 때문에 로컬 파일 기능이 조용히 비활성화되는 설계 문제가 있으므로, Claude Code를 사용하는 개발자는 이 동작을 알고 있어야 한다.
핵심 요약
- Claude Code 2.1.277은 CLAUDE.md가 없을 때 AGENTS.md를 프로젝트 지시사항으로 읽도록 발표했다.
- 그러나 agents-md 플러그인은 기본값이 비활성화되어 있고, 원격 피처 플래그 tengu_agents_md_mod를 요청한다.
- 플래그를 가져올 수 없으면 로컬 파일을 네트워크 접속 없이 읽어야 함에도 서버 스위치를 기다린다.
- DISABLE_TELEMETRY=1 또는 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1이 설정되면 AGENTS.md가 로드되지 않으며, 0으로 설정해도 차단이 풀리지 않는다.
- 프로젝트 .claude/settings.json 설정도 효과가 없고, 세션 레벨 override만 두 번째 세션부터 작동한다.
- 파일이 스킵되어도 경고 메시지가 없어서 사용자는 모델이 지시사항을 무시하는 줄 알게 된다.
- Bedrock, Vertex, 서드파티 게이트웨이도 플래그가 true로 해석되지 않아 같은 문제가 발생한다.
- 임시 해결책은 AGENTS.md 옆에 '@AGENTS.md'만 담은 CLAUDE.md를 만드는 것이다.
- 저자는 로컬 파일 읽기가 텔레메트리 설정에 영향받으면 안 되며, 점진적 롤아웃이 필요하면 적어도 명시적 경고가 필요하다고 주장한다.
- 현재 플러그인은 프로젝트 디렉토리의 AGENTS.md만 찾고 사용자 레벨 파일을 지원하지 않으며, .agents/skills 디렉토리도 인식하지 않아 심링크로 우회해야 한다.