Claude Code: v2.1.277에서 원격 진단 정보 사용 여부에 따라 AGENTS.md 지원이 제한됨

Claude Code v2.1.277은 원격 진단 정보 사용이 비활성화된 경우 AGENTS.md 프로젝트 지침을 읽지 못하는 문제를 야기했습니다. 이는 원격 기능 플래그를 통해 기능이 제어되었고, 이 플래그는 네트워크 연결을 필요로 하여 DISABLE_TELEMETRY=1 또는 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 설정된 사용자에게 로컬 파일 읽기 기능이 실제로 비활성화되는 결과를 초래했습니다.

원격 기능 플래그가 로컬 파일 접근을 제어함

v2.1.277 버전에서 agents-md 플러그인은 isOnByDefault: false로 설정되었습니다. 플러그인의 가용성은 tengu_agents_md_mod라는 원격 기능 플래그에 따라 결정됩니다. Claude Code가 Anthropic 서버로부터 이 플래그를 가져올 수 없는 경우(즉, 원격 진단 정보 또는 비필수 트래픽이 비활성화된 경우), 플러그인은 사용 불가 상태가 되고 로컬 AGENTS.md 파일은 절대 읽히지 않습니다.

이 동작은 Bedrock 및 Vertex와 같은 제3자 게이트웨이 사용자에게 특히 큰 영향을 미쳤으며, 이러한 게이트웨이의 네트워크 정책은 이러한 플래그를 확인하는 데 필요한 트래픽을 차단하는 경우가 많아, 해당 사용자들에게는 기능이 완전히 사라지는 결과를 초래했습니다.

영향 및 침묵하는 실패

사용자들은 AGENTS.md에 포함된 프로젝트 지침 없이 모델이 응답하는 침묵하는 실패 현상을 경험했습니다. 경고 메시지나 오류 메시지 없이 발생했기 때문에 일부 사용자는 모델이 지침을 무시하는 것으로 오해했으며, 실제로 파일이 컨텍스트에 로드되지 않았음에도 불구하고 프롬프트 엔지니어링에 시간을 낭비할 수 있었습니다.

대안 및 구성 방법

v2.1.281에서 수정되기 전까지 사용자들은 프라이버시 설정을 유지하면서 프로젝트 지침을 사용하기 위해 여러 대안을 활용했습니다:

@path 임포트: @AGENTS.md를 포함하는 단일 줄의 CLAUDE.md 파일을 생성하면 기능 플래그에 의존하지 않고 지침을 로드할 수 있습니다.
세션 수준 오버라이드: 특정 세션에서 원격 진단 정보 환경 변수를 비우기 위해 --settings 플래그를 사용: claude --settings '{"env":{"DISABLE_TELEMETRY":"","CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":""}}'.
심볼릭 링크 생성: AGENTS.md를 CLAUDE.md로 심볼릭 링크 생성 (ln -s AGENTS.md CLAUDE.md).

개발자 반응 및 해결

Anthropic 엔지니어(@mpoteat)는 이 문제를 롤아웃 중 발생한 '사람의 실수'로 확인했습니다. 이는 롤아웃 중 문제가 발생했을 경우 원격으로 기능을 끌 수 있도록 하기 위한 킬스위치 구현과 관련된 문제였습니다. 이 문제는 v2.1.281에서 해결되었으며, 로컬 파일 읽기 기능에서 원격 진단 정보 사용 여부에 대한 의존성이 제거되었습니다.

"죄송합니다, 이건 롤아웃의 부산물이에요. 만약 문제가 생기면 원격으로 기능을 끌 수 있는 방법이 필요했고, 원격 진단 정보를 끄면 그런 플래그를 받을 수 없죠. 오늘 출시된 v2.1.281에서 이미 수정되었습니다."

커뮤니티의 통찰과 설계 비판

Hacker News에서의 기술 논의는 로컬 동작에 대한 기능 플래그 사용에 대한 여러 설계적 우려를 제기했습니다:

프라이버시-기능의 상충: 비판자들은 프라이버시 설정(원격 진단 정보 비활성화)이 관련 없는 로컬 기능을 침묵하게 만드는 것은 바람직하지 않다고 주장했습니다.
바이브 코딩(Vibe-coding): 일부 사용자는 이를 "바이브 코딩"이라고 묘사하며, AI가 생성한 패치가 전통적인 테스트를 우회하는 미묘하고 심각한 버그를 초래할 수 있다고 지적했습니다.
표준화: 커뮤니티는 Claude Code가 독자적인 CLAUDE.md 형식 대신 AGENTS.md 및 .agents/ 표준을 완전히 채택할 것을 지속적으로 요청하고 있습니다.
글로벌 구성: 사용자들은 프로젝트 간에 수동으로 복사하지 않고도 지속적으로 유지되는 전역 ~/.codex/AGENTS.md 또는 사용자 수준의 지침 파일에 대한 지원이 부족하다고 지적했습니다.