Claude Code built-in subagents: Explore와 Plan을 팀 규칙에 맞게 통제하는 법 | DAKER 커뮤니티
Claude Code built-in subagents는 코드 탐색과 계획을 빠르게 분리하지만, 팀 규칙이 반드시 전달되는 실행 단위는 아닙니다. Built-in subagents란 Claude Code가 기본으로 등록해 자동 위임에 쓰는 보조 에이전트입니다. 오늘은 2026년 7월 13일 KST 기준 공식 문서에서 확인한 Explore, Plan, Agent tool 제한 흐름을 팀 운영 관점으로 정리합니다.
문제 상황: 왜 서브에이전트가 팀 규칙과 다르게 움직일까?
당신이 대규모 저장소를 열면 Claude Code는 탐색과 계획을 별도 에이전트에 맡겨 주 대화의 문맥을 아낄 수 있습니다. 문제는 모든 보조 에이전트가 같은 기억과 같은 상태를 그대로 받는다고 생각할 때 생깁니다. 공식 문서 기준으로 Explore와 Plan은 빠른 탐색을 위해 일부 프로젝트 기억과 git 상태를 건너뛰는 예외가 있습니다.
핵심 개념: built-in subagents는 언제 통제해야 할까?
한 줄 요약: 빠른 탐색이 목적이면 기본 동작을 두고, 팀 규칙 준수나 권한 제한이 더 중요하면 차단 범위를 명시해야 합니다. 서브에이전트는 편의 기능이 아니라 실행 주체입니다. 따라서 누가 읽을 수 있고, 누가 쓸 수 있고, 어떤 규칙을 받는지 확인해야 합니다.
단계별 사용법: 팀에서 통제 기준을 어떻게 정할까?
- 먼저 자동 위임을 허용할 작업과 직접 대화에서 처리할 작업을 나눕니다.
- 파일 탐색만 필요한 작업은 Explore에 맡겨도 되는지 확인합니다.
- 계획 수립 중 팀 규칙이 반드시 필요하면 Plan 결과를 그대로 실행하지 말고 주 대화에서 한 번 검토합니다.
- 특정 기본 에이전트가 문제라면 permission deny 또는 전용 환경 변수로 제한합니다.
- 전체 위임을 막아야 하는 보안 구간에서는 Agent tool 자체를 거부하는 정책을 검토합니다.
짧은 예시: 보안 리뷰에서 Explore를 어떻게 다룰까?
보안 리뷰처럼 팀 정책과 금지 경로가 중요한 작업에서는 Explore가 반환한 파일 목록을 최종 판단으로 보지 않습니다. 주 대화에서 위험 명령 차단 hooks 글과 CLAUDE MD와 auto memory 글의 기준을 다시 대조한 뒤 수정 작업으로 넘어가는 편이 안전합니다.
팀 적용 체크리스트: 오늘 무엇을 문서화할까?
- Explore에 맡겨도 되는 읽기 전용 작업을 한 줄로 적습니다.
- Plan 결과를 실행 전에 검토해야 하는 조건을 정합니다.
- Agent tool을 허용할 저장소와 차단할 저장소를 나눕니다.
- 서브에이전트가 팀 규칙을 못 받을 수 있는 예외를 온보딩 문서에 남깁니다.
- 병렬 작업에는 subagent depth 운영 글과 worktree 안전 경계 글를 함께 연결합니다.
공식 출처 기준으로 무엇을 조심해야 할까?
작성 기준일은 2026년 7월 13일 KST입니다. 공식 문서는 기본 에이전트, 사용자 정의 에이전트, Agent SDK 실행의 제한 방법을 구분합니다. 공개 본문에는 외부 공식 링크를 넣지 않았고, 기능 사실은 private verification에서만 확인했습니다.
자주 묻는 질문
Explore와 Plan을 항상 꺼야 하나요?
아닙니다. 빠른 탐색과 계획에는 유용합니다. 다만 팀 규칙이나 보안 경계가 핵심인 작업에서는 결과를 주 대화에서 다시 검토해야 합니다.
Agent tool을 막으면 어떤 일이 생기나요?
Claude가 서브에이전트로 작업을 위임하지 못합니다. 자동 병렬화보다 단일 대화의 통제가 더 중요한 저장소에서 선택할 수 있습니다.
사용자 정의 에이전트가 기본 에이전트보다 항상 안전한가요?
아닙니다. 도구, 권한, 기억, 훅 범위를 잘못 주면 더 위험할 수 있습니다. 이름과 목적, 허용 도구를 작게 시작하는 편이 좋습니다.
오늘 바로 점검할 항목은 무엇인가요?
팀 저장소에서 자동 위임을 허용할 작업 세 가지와 차단할 작업 세 가지를 먼저 적어 보세요.
오늘은 서브에이전트를 더 많이 쓰기보다, 어떤 작업에서 자동 위임을 신뢰할지 먼저 정해 보세요.