Claude Code 2.1.277은 저장소 지침 파일 지원을 도입했습니다. AGENTS.md 파일을 읽는 기능에는 중요한 제약이 있습니다. Anthropic의 최신 문서에 따르면 텔레메트리를 끈 세션과 여러 서드파티 공급자 설정을 포함해 기능 플래그를 가져올 수 없는 세션은 CLAUDE.md 파일만 불러옵니다.
출시된 agents-md 플러그인은 파일 로딩과 선택적 텔레메트리 기록을 분리합니다. 실제 의존성은 한 단계 앞에 있습니다. 원격 플래그가 기본 제공 로더를 사용할 수 있는지 결정합니다.
핵심 변화
- 무엇이 바뀌었나: 이제 로컬 지침 파일도 원격 배포 경계를 통과해야 합니다. 기능 플래그에 접근할 수 있어야 Claude Code의 기본 제공
AGENTS.md리더를 사용할 수 있습니다. - 중요한 이유: 같은 커밋을 사용하는 개발자라도 버전, 공급자 또는 개인정보 설정에 따라 서로 다른 프로젝트 지침을 받을 수 있습니다. 팀 전체에서 에이전트 동작을 재현하기가 더 어려워집니다.
- 지켜볼 점: 여러 공급자나 제한된 환경을 사용하는 팀은 지침 로딩을 런타임 의존성으로 보고 각 환경에서 확인한 뒤, 이식 가능한 경로로
CLAUDE.md가져오기를 유지할 수 있습니다.
릴리스와 보고서에서 확인되는 내용
Anthropic의 2.1.277 릴리스 노트는 9월 18일에 게시됐으며, Claude Code가 AGENTS.md를 읽는다고 설명합니다. 프로젝트에 CLAUDE.md가 없을 때를 말합니다. 또한 해당 릴리스에서는 Bedrock, Vertex, Foundry를 지원 대상에서 제외합니다.
현재 프로젝트 메모리 문서는 지원 버전을 설치하거나 업그레이드한 직후의 첫 세션과 기본 플러그인이 비활성화된 세션도 제외합니다.
Przemek Szypowski의 문제 재현 보고는 2.1.280에서 수행한 카나리 테스트를 설명합니다. 그는 DISABLE_TELEMETRY와 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 때문에 자신의 AGENTS.md가 로드되지 않았고, 옆에 둔 CLAUDE.md 가져오기는 작동했다고 보고했습니다. BIG CHANGE는 유료 모델 테스트를 재현하지 않았습니다. 현재 Anthropic 문서도 같은 가용성 조건을 독립적으로 밝힙니다.
기능 가용성과 텔레메트리 기록은 별개입니다
Anthropic의 환경 변수 문서에 따르면 비어 있지 않은 DISABLE_TELEMETRY 값은 무엇이든, 0 또는 false를 포함해 텔레메트리를 거부하고 기능 플래그 가져오기를 비활성화합니다. DO_NOT_TRACK, DISABLE_GROWTHBOOK 및 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 도 해당 가져오기를 중단할 수 있습니다. 서드파티 공급자를 사용하는 세션은 임베딩 호스트가 CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST 를 설정하지 않는 한 제외되며, Claude 앱스 게이트웨이 세션도 제외됩니다.
출시된 플러그인 README에 따르면 텔레메트리 호출이 누락되면 이를 버릴 뿐, 플러그인의 다른 작업은 바뀌지 않습니다. 저장소의 mods 개요에서는 텔레메트리와 agents-md를 별도의 기본 제공 플러그인으로 설명합니다.
소스 코드는 로더가 작동하는 방식을 설명하고, 제품 문서는 세션이 그 로더를 사용할 수 있는지 설명합니다. 모듈 내부의 선택적 기록 기능이 모듈 외부의 가용성 조건을 없애지는 않습니다.
9월 23일 BIG CHANGE는 agents-md README와 등록 모듈을 main과 2.1.280 태그(9월 22일 출시)에서 가져왔으며, 각 파일 쌍의 바이트는 서로 일치했습니다.
Claude Code가 파일을 불러오는 경우
플러그인을 사용할 수 있고 활성화한 경우, 기본 모드는 다음 우선순위를 따릅니다:
지침 파일 | 기본 결과 |
|---|---|
| |
프로젝트 | 직접 |
사용자 또는 관리자가 설정한 | 이 파일들은 |
프로젝트 지침 설정을 /config에서 변경하면 두 파일 형식을 모두 불러올 수 있습니다. JSON 옵션은 사용자 설정에 --settings 를 지정하거나 관리 설정에 둘 수 있습니다. 프로젝트 및 로컬 설정 파일은 무시됩니다.
대안은 명시적인 가져오기 한 줄입니다
직접 지원되지 않는 세션에서는 Anthropic이 공유 파일 옆에 CLAUDE.md를 두고 다음 내용을 넣으라고 권장합니다:
@AGENTS.md
가져오기 문은 파일을 포함합니다. Claude에게 파일을 읽으라고 요청하는 설명만으로는 그 선택이 모델에 맡겨집니다.
확인할 명령은 claude --version을 확인하고, 프로젝트 지침 설정 경로는 /config에서 확인할 수 있습니다. 2.1.280에서는 /memory 또는 /context에서 직접 불러온 AGENTS.md를 표시할 수 있습니다. 이전 지원 버전에서는 여기에 표시되지 않았습니다.
