9월 14일 나온 v2.1.271 은 에이전트 프론트매터와 --agents JSON 에 omitClaudeMd 필드를 넣어, 사용자 정의·플러그인 서브에이전트가 ~/.claude/CLAUDE.md·프로젝트 CLAUDE.md·CLAUDE.local.md 를 빼고 돌 수 있게 했고, 공식 서브에이전트 문서는 조직 관리 정책(managed policy) CLAUDE.md 는 그대로 들어가지만 관리 설정(managed settings)에서 정의한 서브에이전트는 그것도 읽지 않으며 --agent 나 agent 설정으로 메인 세션 에이전트로 돌 때는 이 필드가 무시된다고 적어 뒀어요. 이 기능은 5월 30일 깃허브 이슈 #63855 가 '약 600KB 규칙이 리뷰용 서브에이전트 컨텍스트를 채워 자동 압축이 세 번 연속 실패한다'며 요청했다가 '계획 없음'으로 닫혔던 것과 같은 내용이에요. 같은 판에는 Bash 권한 검사에서 셸 변수 선언 플래그로 실행 명령을 다르게 보이게 하거나 패턴·옵션 값 속 와일드카드가 펼치는 파일이 검사를 빠져나가던 구멍, /resume·/teleport 가 이전 대화의 파일 읽기 기록을 물려받아 읽은 적 없는 파일을 고칠 수 있던 문제, 압축 뒤 아직 도는 개발 서버를 한 번 더 띄우던 문제 수정도 들어 있어요.
- 프론트매터(frontmatter)
- 마크다운 파일 맨 위에 --- 로 감싸 적는 설정 머리말
- JSON
- 키와 값을 중괄호로 묶어 적는 데이터 표기 형식
- Bash
- 터미널에서 명령을 실행하는 셸. 클로드 코드에서는 셸 명령을 실행하는 도구 이름이기도 하다
- /resume·/teleport
- 이전 대화를 이어 여는 클로드 코드 명령. /teleport 는 다른 곳에서 돌던 세션을 가져온다
체크리스트가 자기 프롬프트 안에 다 있는 리뷰·검사용 서브에이전트라면 omitClaudeMd 로 컨텍스트를 아낄 수 있지만, 조직 정책 CLAUDE.md 는 못 빼고 --agent 로 메인 세션에 올리면 무시된다는 점을 전제로 설계하세요. allow 규칙에 기대어 사람 없이 돌리는 파이프라인은 Bash 권한 검사 수정 때문에도 이 판으로 올릴 이유가 있어요.
- 릴리스 노트 원문 v2.1.271 은 "Added omitClaudeMd to agent frontmatter and --agents JSON, letting custom and plugin subagents run without user, project and local CLAUDE.md files; managed policy files still load" 를 비롯해 100줄 넘는 변경 항목을 실었어요. GitHub
- 이 기능을 요청했던 이슈 5월 30일 열린 이슈 #63855 는 대형 모노레포의 약 600KB 규칙이 읽기 전용 리뷰 서브에이전트에 통째로 들어가 자동 압축이 반복 실패한다며 Explore·Plan 과 같은 제외 옵션을 요청했고, '계획 없음'으로 닫혀 있어요. GitHub
- 공식 문서가 정한 예외 서브에이전트 문서의 프론트매터 표는 omitClaudeMd 를 true 로 두면 관리 정책 파일은 계속 읽되 관리 설정에서 정의한 서브에이전트는 예외이고, --agent 나 agent 설정으로 메인 세션 에이전트로 돌 때는 무시되며 v2.1.271 이상이 필요하다고 적어 뒀어요. Anthropic