여러 세션과 에이전트에 일을 나누기

1. 여러 세션과 에이전트에 일을 나누기

신메뉴 페이지를 만들었다면 다음에는 문구와 화면을 각각 다듬고 싶을 수 있습니다. 한 대화에 모든 일을 섞어도 되지만, 작업이 커지면 스타일 담당과 내용 담당으로 나누고 한곳에서 진행을 모으는 방식이 편합니다. 이때 비슷해 보이는 두 가지가 있습니다. Desktop의 여러 세션을 묶어 관리하는 것과, 한 세션 안에서 서브에이전트에게 일을 맡기는 것입니다.

1.1 영상에서 본 하위 세션

2026년 10월에 공개된 사용 영상에서는 Code의 상위 세션 아래에 스타일과 콘텐츠용 세션을 두고, 상위 세션에서 하위 세션에 일을 보냅니다. 하위 항목을 열면 일반 세션처럼 대화가 이어집니다. 영상의 공개일은 한국 시간 10월 29일이며, 이것이 기능의 최초 출시일이라는 뜻은 아닙니다.

모모의 정원 페이지에도 같은 역할 분담을 적용해볼 수 있습니다.

신메뉴 소개 페이지를 다듬을 일을 역할별 세션으로 나누고 싶어.
스타일 담당은 글자와 간격, 휴대폰 배치만 점검하고,
내용 담당은 메뉴 설명과 영업 정보만 점검해줘.
각 세션의 대상 파일을 나누고 이 세션에서 진행 상황을 모아줘.
파일을 고치기 전에 역할과 범위를 먼저 정리해줘.

화면에 다른 작업을 시작하는 제안 카드가 나오면 Start로 새 세션을 시작하거나 Do it here로 현재 세션에서 진행할 수 있습니다. 시작 전에 환경·모델·권한·worktree 선택을 확인합니다. 실제 카드와 메뉴 구성은 앱 버전에 따라 다를 수 있습니다. 기능이 보이지 않을 때 임의의 활성화 스위치를 찾아 켤 필요는 없습니다.

공식 Desktop 문서는 다른 Code 세션이 한 일을 확인하고 메시지를 보내는 기능도 설명합니다. 예를 들어 "스타일 담당 세션의 진행 상황을 알려줘", "내용 담당에게 출시일이 바뀌었다고 전해줘"처럼 요청합니다. 이 경로가 다루는 대상은 Desktop이 실행하는 로컬·SSH·WSL 세션입니다. 터미널에서 따로 켠 CLI와 클라우드 세션까지 같은 목록에 모두 보인다고 가정하지 마세요.

1.2 서브에이전트는 한 세션 안에서 일을 나눕니다

서브에이전트는 메인 대화가 맡긴 일을 별도 컨텍스트에서 처리하고 결과를 돌려주는 작업자입니다. 조사 결과와 긴 실행 기록을 따로 다룰 때 도움이 됩니다. 이 서브에이전트가 또 다른 서브에이전트를 만드는 것이 에이전트 네스팅입니다.

2026년 7월 24일 UTC의 Claude Code v2.1.219 업데이트는 서브에이전트의 기본 중첩 깊이를 1에서 3으로 바꿨습니다. 현재 공식 문서는 메인 대화 아래 세 개 층까지를 기본값으로 설명합니다. 이를 네스팅 기능의 최초 도입일로 외울 필요는 없습니다. 실제 작업에서는 필요한 만큼만 나누면 됩니다.

구분	Desktop의 독립 하위 세션	한 세션 안의 서브에이전트
무엇을 나누나	별도로 이어갈 대화와 작업	현재 대화가 맡긴 작은 일
결과 모으기	세션 진행 확인과 메시지 전달	메인 대화에 결과 보고
더 깊이 나누기	화면·기능별 지원 확인	기본은 메인 아래 3개 층
개수	이 UI의 고정 최대 개수는 여기서 단정하지 않음	기본 동시 실행 20개, 깊이와 별도 한도

3개 층과 동시 20개는 서브에이전트의 한도입니다. Desktop의 독립 세션 개수에 같은 숫자를 붙이지 않습니다. 에이전트는 각자 사용량을 쓰므로 일을 많이 나눈다고 비용과 시간이 반드시 줄어들지는 않습니다.

1.3 직접 맡겨보기

처음에는 읽기만 하는 두 가지 점검을 나누어보세요.

신메뉴소개.html을 두 서브에이전트가 점검해줘.
한쪽은 메뉴 설명과 출시일을 확인하고,
다른 쪽은 휴대폰 배치와 링크를 확인해줘.
파일은 아직 고치지 말고, 각자 찾은 문제와 근거를 모아 보고해줘.
하위 점검이 더 필요하면 역할을 겹치지 않게 나눠줘.

Desktop에서는 해당 세션의 백그라운드 작업 패널에서 작업 내용을 확인할 수 있습니다. 공식 문서가 설명하는 터미널의 서브에이전트 패널에는 트리와 하위 항목 수 (+N)이 표시됩니다. 이 표기를 Desktop의 독립 하위 세션 화면과 똑같은 UI라고 생각하지는 마세요.

고급 설정이 필요할 때만 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH 값을 확인합니다. 공식 문서에서 1은 추가 중첩을 끄는 값이며 기본 깊이는 별도 토글 없이 적용됩니다. 에이전트가 Agent 도구를 쓸 수 없도록 제한되어 있다면 더 위임할 수 없습니다. 이 입문 실습을 위해 설정 파일을 바꾸거나 한도를 늘릴 필요는 없습니다.

같은 파일을 여러 작업자가 동시에 고치면 충돌할 수 있습니다. 수정할 파일을 나누거나, Git을 쓴다면 별도 worktree로 작업을 분리한 뒤 결과를 합칩니다. 먼저 문제를 읽고 보고하게 하면 이런 충돌을 줄이면서 역할 나누기를 익힐 수 있습니다.

마지막 수정 2026.10.31