클로드 코드 서브에이전트를 CLAUDE.md 없이 띄우는 omitClaudeMd 설정법

클로드 코드(Claude Code)에서 직접 만든 서브에이전트는 메인 세션처럼 사용자·프로젝트·로컬 CLAUDE.md를 모두 읽고 시작한다. 위임 프롬프트만 있으면 되는 서브에이전트라면 정의에 omitClaudeMd: true를 넣어 이 파일들 없이 띄운다. 기본 제공 Explore·Plan 에이전트는 원래 이렇게 돈다.

.claude/agents/ 아래 에이전트 파일의 프런트매터에 한 줄을 더한다.

---
name: lean-scanner
description: 파일을 훑어 찾은 내용만 요약해 돌려준다
tools: Read, Grep, Glob
model: haiku
omitClaudeMd: true
---
위임받은 범위의 파일만 읽고, 찾은 내용을 파일 경로와 함께 짧게 보고한다.

--agents JSON으로 넘길 때도 필드 이름은 같다.

claude --agents '{"lean-scanner":{"description":"파일을 훑어 찾은 내용만 요약","prompt":"찾은 내용을 파일 경로와 함께 짧게 보고한다","tools":["Read","Grep","Glob"],"omitClaudeMd":true}}'

tools에 허용할 도구만 적으면 MCP 도구도 빠져서 더 가볍게 돈다. 관리 정책(managed policy) 파일은 그대로 읽힌다. 하위 폴더의 CLAUDE.md와 경로 지정 규칙(.claude/rules)도 서브에이전트가 그 폴더의 파일을 다룰 때는 읽힌다.

결과를 받는 메인 세션은 CLAUDE.md를 다 갖고 있으니 규칙 대부분은 서브에이전트까지 넘길 필요가 없다. 꼭 지켜야 할 규칙(예: vendor/ 폴더는 건드리지 않기)만 위임 프롬프트에 다시 적는다.

--agent로 메인 세션 에이전트로 띄울 때는 이 필드가 무시된다. 클로드 코드 v2.1.271 이상에서 쓸 수 있다.