Code의 하위 세션과 서브에이전트 네스팅
1. Code의 하위 세션과 서브에이전트 네스팅
Code에서 일을 나누는 방법에는 독립 세션과 서브에이전트가 있습니다. 세션은 별도의 대화와 작업 폴더를 가진 작업 공간입니다. 서브에이전트는 한 세션이 맡긴 작은 일을 별도 컨텍스트에서 처리하고 결과를 돌려주는 작업자입니다. 둘을 구분하면 영상의 하위 세션과 에이전트 네스팅을 이해하기 쉽습니다.
1.1 영상에서 본 독립 하위 세션
2026년 10월 29일 한국 시간에 공개된 참고 영상은 상위 세션 아래에 스타일·콘텐츠 담당 세션을 두고 진행을 모으는 모습을 보여줍니다. 이 날짜는 영상 공개일입니다. 기능의 최초 출시일을 뜻하지 않습니다.
실습하려면 Desktop의 Code를 열고 로컬 환경에서 빈 연습 폴더를 고릅니다. Code 이용 권한이 있는 계정으로 로그인해야 합니다. 다음 요청으로 작은 안내문부터 만들어보세요.
이 폴더에 모모의 정원 행사 안내문을 만들고 싶어.
먼저 행사안내.md에 다음 내용으로 초안을 만들어줘.
행사일 2026년 11월 20일, 참가비 무료, 신청 마감 11월 15일.
제목, 행사 설명 두 문장, 신청 안내로 구성해줘.
파일을 확인한 뒤 역할을 나누어 요청합니다.
이 안내문을 검토하는 일을 역할별 세션으로 나누고 싶어.
내용 담당은 날짜와 신청 조건을, 표현 담당은 문장의 길이와 이해하기 쉬운지 확인해줘.
파일은 아직 고치지 말고 각 세션의 점검 결과를 이 세션에서 모아줘.
새 작업 제안 카드가 제공되면 Start로 별도 세션을 시작하거나 Do it here로 현재 세션에서 진행할 수 있습니다. 시작할 환경·폴더·권한을 확인합니다. 다른 세션의 진행을 묻거나 “내용 담당 세션에 마감일은 유지하라고 전해줘”처럼 메시지 전달을 요청할 수 있습니다. 카드가 나오지 않으면 새 세션에서 같은 폴더와 점검 범위를 직접 정해 작업할 수도 있습니다.
공식 문서의 세션 간 작업 대상은 Desktop이 실행하는 로컬·SSH·WSL 세션입니다. 별도로 실행한 CLI나 클라우드 세션까지 모두 같은 목록에 나타난다고 가정하지 않습니다. 독립 하위 세션 UI의 고정 최대 깊이·개수는 여기서 단정하지 않습니다.
1.2 서브에이전트가 다시 위임하기
2026년 7월 24일 UTC, Claude Code v2.1.219 업데이트는 서브에이전트의 기본 중첩 깊이를 1에서 3으로 바꿨습니다. 현재 기본값은 메인 대화 아래 3개 층, 기본 동시 실행 수는 20개입니다. 동시 실행 수와 깊이는 별도 한도이며, Desktop 독립 세션의 한도를 뜻하지 않습니다.
앞에서 만든 안내문이 없어도 아래의 짧은 문구를 입력해 실습할 수 있습니다.
다음 행사 문구를 두 서브에이전트가 나누어 검토해줘.
"모모의 정원 신메뉴 행사: 11월 20일, 무료, 신청은 11월 15일까지."
한쪽은 날짜와 신청 조건이 명확한지 확인하고,
다른 쪽은 처음 읽는 사람이 이해하기 쉬운지 확인해줘.
필요한 세부 점검은 하위 에이전트에게 다시 맡겨도 돼.
문구는 아직 고치지 말고 각자의 근거와 최종 수정안을 모아줘.
Desktop에서는 세션의 백그라운드 작업 패널에서 진행을 확인합니다. 공식 문서에 나오는 터미널의 트리와 (+N) 표시는 터미널용 설명입니다. 독립 하위 세션 화면의 표기와 섞지 않습니다.
기본 중첩은 별도 활성화 토글 없이 적용됩니다. 고급 설정 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH의 1은 추가 중첩을 끄는 값입니다. Agent 도구 사용이 제한되면 하위 위임을 할 수 없습니다. 처음에는 설정을 바꾸지 않고 작은 점검부터 맡기면 됩니다. 각 작업자는 사용량을 쓰며, 같은 파일을 동시에 수정하면 충돌할 수 있으므로 수정할 파일이나 역할을 나누세요.
보충 실습: 여러 세션과 에이전트에 일을 나누기.
마지막 수정