Claude Code · 2026년 7월 27일 ★★★★

Claude Code에 '서브에이전트 아껴 쓰라'는 지시가 실제로 심겨 있어요 — 다만 Opus 5 전용은 아니에요

Claude Code 시스템 프롬프트에 '몇 번의 도구 호출로 끝낼 일에는 서브에이전트를 띄우지 말라'는 문단이 실제로 들어 있는 게 확인됐어요. 다만 이 문단에 붙은 버전 표시는 v2.1.215로, Opus 5가 Claude Code에 추가된 v2.1.219보다 네 릴리스 앞서요. 특정 모델일 때만 붙는다는 조건도 확인되지 않아서, 'Opus 5를 겨냥해 서브에이전트를 막았다'는 화제의 제목과는 결이 달라요. 오히려 Opus 5가 들어온 v2.1.219에서는 서브에이전트가 다시 서브에이전트를 부를 수 있는 깊이가 1에서 3으로 되돌아왔어요.

용어 풀이
서브에이전트
본체 대신 곁가지 일을 맡아 따로 돌아가는 보조 실행 단위. 각자 별도 대화 공간을 쓴다
시스템 프롬프트
사용자 입력과 별개로 도구가 미리 넣어 두는 기본 지시문
운영자 인사이트

'막혔다'가 아니라 '기본값이 바뀌었다'로 읽는 게 맞아요. 그 문단은 금지가 아니라 비용 기준이라 크고 독립적인 작업은 그대로 위임되고, 실제로 발목을 잡는 건 깊이·동시 실행·세션 총량 같은 환경변수 상한이에요. 팀 자동화가 갑자기 느려졌다면 프롬프트를 의심하기 전에 그 값들부터 확인해 보세요.

여러 관점으로 보기
  • 실제 하드코딩된 문구 Claude Code 실행 파일에서 뽑아낸 원문이에요 — '몇 번의 도구 호출로 끝낼 일에 서브에이전트를 띄우지 말라', '직접 확인할 수 있는 일을 검토시키려고 띄우지 말라'고 적혀 있고 버전 표시는 v2.1.215예요. GitHub
  • 제한이 오히려 풀린 흐름 공식 변경 기록을 보면 v2.1.217에서 동시 실행 상한 20개와 중첩 금지가 들어왔다가, Opus 5가 추가된 v2.1.219에서 중첩 깊이가 1에서 3으로 되돌아왔어요. Claude Code Docs
  • 써 본 사람들의 반박 '금요일 첫 작업에서 Opus 5가 바로 서브에이전트 두 개를 띄웠다', '이틀 동안 중간·높은 노력 단계로 써 봤지만 피하는 낌새가 없었다'는 관찰이 올라왔어요. Hacker News
  • 모델 성향이 먼저였어요 공식 문서도 Opus 5가 이전 모델보다 위임을 더 자주 한다고 밝히고 있어서, 자제 문구는 막는 쪽보다 그 성향을 눌러 주는 쪽에 가까워요. Anthropic Claude Platform Docs

원본 보기 (hn:claude-code)