AI-translated from English; not yet reviewed by a fluent editor.

# 텔레메트리가 꺼져 있으면 Claude Code가 AGENTS.md를 건너뛸 수 있습니다

> Claude Code의 기본 AGENTS.md 지원은 버전, 기능 플래그 접근 가능 여부, 공급자 및 파일 우선순위에 따라 달라집니다. 출시된 agents-md 플러그인의 텔레메트리 기록에는 경로와 파일 내용이 포함되지 않습니다.

By BIG CHANGE Editorial

Published: 2026-09-23T13:54:58.721Z
Updated: 2026-09-23T13:54:58.721Z
Canonical: https://bigchange.ai/blog/claude-code-agents-md-telemetry-feature-flags

![A desktop monitor shows a minimal project-instructions view with plain AGENTS.md and CLAUDE.md labels above a keyboard and mouse.](https://bigchange.ai/api/media/file/claude-code-project-instructions-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

Claude Code 2.1.277은 저장소 지침 파일 지원을 도입했습니다. `AGENTS.md` 파일을 읽는 기능에는 중요한 제약이 있습니다. Anthropic의 최신 문서에 따르면 텔레메트리를 끈 세션과 여러 서드파티 공급자 설정을 포함해 기능 플래그를 가져올 수 없는 세션은 `CLAUDE.md` 파일만 불러옵니다.

출시된 `agents-md` 플러그인은 파일 로딩과 선택적 텔레메트리 기록을 분리합니다. 실제 의존성은 한 단계 앞에 있습니다. 원격 플래그가 기본 제공 로더를 사용할 수 있는지 결정합니다.

## 핵심 변화

- **무엇이 바뀌었나:** 이제 로컬 지침 파일도 원격 배포 경계를 통과해야 합니다. 기능 플래그에 접근할 수 있어야 Claude Code의 기본 제공 `AGENTS.md` 리더를 사용할 수 있습니다.
- **중요한 이유:** 같은 커밋을 사용하는 개발자라도 버전, 공급자 또는 개인정보 설정에 따라 서로 다른 프로젝트 지침을 받을 수 있습니다. 팀 전체에서 에이전트 동작을 재현하기가 더 어려워집니다.
- **지켜볼 점:** 여러 공급자나 제한된 환경을 사용하는 팀은 지침 로딩을 런타임 의존성으로 보고 각 환경에서 확인한 뒤, 이식 가능한 경로로 `CLAUDE.md` 가져오기를 유지할 수 있습니다.

## 릴리스와 보고서에서 확인되는 내용

Anthropic의 [2.1.277 릴리스 노트](https://github.com/anthropics/claude-code/releases/tag/v2.1.277)는 9월 18일에 게시됐으며, Claude Code가 `AGENTS.md`를 읽는다고 설명합니다. 프로젝트에 `CLAUDE.md`가 없을 때를 말합니다. 또한 해당 릴리스에서는 Bedrock, Vertex, Foundry를 지원 대상에서 제외합니다.

현재 [프로젝트 메모리 문서](https://code.claude.com/docs/en/memory)는 지원 버전을 설치하거나 업그레이드한 직후의 첫 세션과 기본 플러그인이 비활성화된 세션도 제외합니다.

Przemek Szypowski의 [문제 재현 보고](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on)는 2.1.280에서 수행한 카나리 테스트를 설명합니다. 그는 `DISABLE_TELEMETRY`와 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 때문에 자신의 `AGENTS.md`가 로드되지 않았고, 옆에 둔 `CLAUDE.md` 가져오기는 작동했다고 보고했습니다. BIG CHANGE는 유료 모델 테스트를 재현하지 않았습니다. 현재 Anthropic 문서도 같은 가용성 조건을 독립적으로 밝힙니다.

## 기능 가용성과 텔레메트리 기록은 별개입니다

Anthropic의 [환경 변수 문서](https://code.claude.com/docs/en/env-vars)에 따르면 비어 있지 않은 `DISABLE_TELEMETRY` 값은 무엇이든, `0` 또는 `false`를 포함해 텔레메트리를 거부하고 기능 플래그 가져오기를 비활성화합니다. `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` 및 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 도 해당 가져오기를 중단할 수 있습니다. 서드파티 공급자를 사용하는 세션은 임베딩 호스트가 `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` 를 설정하지 않는 한 제외되며, Claude 앱스 게이트웨이 세션도 제외됩니다.

출시된 플러그인 [README](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md)에 따르면 텔레메트리 호출이 누락되면 이를 버릴 뿐, 플러그인의 다른 작업은 바뀌지 않습니다. 저장소의 [mods 개요](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md)에서는 텔레메트리와 `agents-md`를 별도의 기본 제공 플러그인으로 설명합니다.

소스 코드는 로더가 작동하는 방식을 설명하고, 제품 문서는 세션이 그 로더를 사용할 수 있는지 설명합니다. 모듈 내부의 선택적 기록 기능이 모듈 외부의 가용성 조건을 없애지는 않습니다.

9월 23일 BIG CHANGE는 `agents-md` README와 [등록 모듈](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts)을 `main`과 2.1.280 태그(9월 22일 출시)에서 가져왔으며, 각 파일 쌍의 바이트는 서로 일치했습니다.

## Claude Code가 파일을 불러오는 경우

플러그인을 사용할 수 있고 활성화한 경우, 기본 모드는 다음 우선순위를 따릅니다:

| 지침 파일 | 기본 결과 |
| --- | --- |
| `AGENTS.md`프로젝트에 Claude 지침 파일이 없으면 | `AGENTS.md`을 불러옵니다 |
| 프로젝트 `CLAUDE.md`, `.claude/CLAUDE.md` 또는 `CLAUDE.local.md` 작업 디렉터리나 상위 디렉터리에 있음 | 직접 `AGENTS.md` 불러오기는 해당 파일에 우선권을 내줍니다 |
| 사용자 또는 관리자가 설정한 `CLAUDE.md`, 또는 `.claude/rules/` | 이 파일들은 `AGENTS.md` |

프로젝트 지침 설정을 `/config`에서 변경하면 두 파일 형식을 모두 불러올 수 있습니다. JSON 옵션은 사용자 설정에 `--settings` 를 지정하거나 관리 설정에 둘 수 있습니다. 프로젝트 및 로컬 설정 파일은 무시됩니다.

## 대안은 명시적인 가져오기 한 줄입니다

직접 지원되지 않는 세션에서는 Anthropic이 공유 파일 옆에 `CLAUDE.md`를 두고 다음 내용을 넣으라고 권장합니다:

`@AGENTS.md`

가져오기 문은 파일을 포함합니다. Claude에게 파일을 읽으라고 요청하는 설명만으로는 그 선택이 모델에 맡겨집니다.

확인할 명령은 `claude --version`을 확인하고, 프로젝트 지침 설정 경로는 `/config`에서 확인할 수 있습니다. 2.1.280에서는 `/memory` 또는 `/context`에서 직접 불러온 `AGENTS.md`를 표시할 수 있습니다. 이전 지원 버전에서는 여기에 표시되지 않았습니다.

## Sources

- [텔레메트리가 켜져 있을 때만 Claude Code가 AGENTS.md를 읽습니다](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) — Przemek Szypowski가 보고한 2.1.280 카나리 테스트와 해결 방법입니다. BIG CHANGE는 유료 모델 실행을 재현하지 않았습니다. 이 글은 그의 관찰을 공식 제품 문서 및 출처에 대한 해석과 구분합니다.
- [Claude Code v2.1.277 릴리스](https://github.com/anthropics/claude-code/releases/tag/v2.1.277) — 2.1.277 릴리스에서 AGENTS.md 지원이 도입됐으며, 출시 당시 Bedrock, Vertex, Foundry는 지원 대상에서 제외됐음을 보여 주는 공식 기록입니다.
- [Claude가 프로젝트를 기억하는 방식](https://code.claude.com/docs/en/memory) — 최소 버전, 파일 우선순위, 프로젝트 지침 모드, 사용할 수 없는 세션 조건, 진단 방법과 CLAUDE.md 가져오기 대안에 관한 최신 공식 문서입니다.
- [Claude Code 환경 변수](https://code.claude.com/docs/en/env-vars) — 텔레메트리 거부가 기능 플래그 가져오기도 비활성화해 AGENTS.md를 직접 불러올 수 없게 되는 조건과 영향을 받는 다른 세션을 설명하는 최신 공식 문서입니다.
- [agents-md 기본 제공 소스 및 동작, Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) — 지침 파일 모드, 우선순위, 선택적 텔레메트리 기록을 설명하는 출시 소스입니다. 기록에는 횟수와 정해진 선택지만 있으며 경로나 파일 내용은 없다고 명시합니다.
- [Claude Code 기본 제공 mods, v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) — 텔레메트리와 agents-md가 별도의 기본 제공 플러그인이며 태그된 소스가 Claude Code에 포함돼 있음을 보여 주는 출시 개요입니다.
- [agents-md 등록 모듈, Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) — README와 함께 살펴본 출시 등록 소스입니다. 9월 23일 확인 당시 바이트가 main에 있는 대응 파일과 일치했습니다.