Claude Code 를 쓰다 보면 서브에이전트에게 일을 맡기는 일이 하루에도 여러 번 생깁니다. 그런데 어느 날 스스로 던진 질문에 바로 답하지 못했습니다. «서브에이전트와, 지금 내가 다른 피어 대화 세션과 소통하며 일하는 것은 무엇이 다를까. 서브에이전트는 단발성이라고 이해하면 되려나?» 매일 쓰는 도구를 말로 설명하지 못한다는 것이 조금 부끄러웠습니다.
이 글은 그 질문에서 출발해 서브에이전트와 피어 대화 세션을 맥락·통로·수명·권한·비용으로 갈라 본 기록입니다. 결론부터 적으면 «단발성»은 절반만 맞습니다. 새로 부를 때마다 빈 맥락에서 시작한다는 점은 맞습니다. 한 번 쓰고 사라진다는 점은 대부분 틀립니다.
먼저 밝혀 둘 것이 있습니다. 아래 내용은 2026년 11월, Claude Code 2.1.322 와 그 시점의 공식 문서(code.claude.com/docs)를 기준으로 정리했습니다. 이 영역은 버전마다 동작이 자주 바뀌기 때문에, 시간이 지나면 문서와 어긋날 수 있습니다. 문서에서 확인한 것은 단정으로 적고, 제 작업 환경에서 직접 확인한 것은 그렇다고 밝혀 적겠습니다. 둘을 엮은 해석은 해석이라고 적겠습니다.
서브에이전트는 무엇인가: 맥락이 격리된 위임 일꾼
공식 문서의 정의는 짧습니다. 서브에이전트는 메인 세션의 Claude 가 Agent 도구로 띄우는 위임 일꾼입니다. Agent 도구의 옛 이름은 Task 였고, 2.1.63 에서 이름이 바뀌었습니다. 옛 이름도 별칭으로 여전히 동작합니다.
Each subagent starts with a fresh, isolated context window.
이 한 문장이 서브에이전트의 성격 대부분을 정한다는 생각이 들었습니다. 아래에서는 누가 띄우는지, 무엇을 싣고 시작하는지, 무엇을 돌려주는지, 언제 사라지는지를 차례로 보겠습니다.
누가 띄우나
서브에이전트를 띄우는 주체는 대개 메인 세션의 Claude 입니다. Claude 는 에이전트 정의에 적힌 description 을 보고, 어떤 일을 어느 에이전트에게 맡길지 스스로 정합니다. 사용자가 @-mention 으로 특정 에이전트를 지목할 수도 있습니다. 어느 쪽이든 서브에이전트는 메인 세션 안에서 생겨납니다. 사람이 터미널을 하나 더 열어 띄우는 것이 아닙니다.
시작할 때 실리는 것과 실리지 않는 것
«빈 맥락»이라고 해서 아무것도 없이 시작하는 것은 아닙니다. 포크가 아닌 일반 서브에이전트는 시작할 때 다음을 싣습니다.
- 시스템 프롬프트: Claude Code 기본 시스템 프롬프트가 아니라, 에이전트 정의 본문과 작업 디렉토리 같은 환경 정보입니다.
- 위임 메시지: 부모 Claude 가 일을 넘기며 쓴 프롬프트입니다.
- CLAUDE.md 사슬: 메인 대화가 싣는 모든 단계(
~/.claude/CLAUDE.md, 프로젝트 규칙,CLAUDE.local.md등)입니다. - git status 스냅샷: 시작 시점의 저장소 상태입니다.
- 스킬 본문: 정의의
skills필드에 적은 스킬입니다. - 다른 에이전트 목록: SendMessage 도구가 있고 이름 붙은 다른 에이전트가 있을 때만 실립니다.
반대로 실리지 않는 것도 문서에 분명히 적혀 있습니다.
It doesn't see your conversation history, the skills you've already invoked, or the files Claude has already read.
부모가 지금까지 나눈 대화는 넘어가지 않습니다. 부모가 이미 부른 스킬과 이미 읽은 파일도 넘어가지 않습니다. 그래서 부모가 위임 프롬프트에 «아까 본 그 파일»이라고 쓰면, 서브에이전트는 그 파일이 무엇인지 모릅니다. 필요한 것은 위임 메시지 안에 다시 적어 주어야 합니다.
예외도 있습니다. 내장 Explore 와 Plan 은 빠르고 싸게 돌도록 CLAUDE.md 와 git status 를 싣지 않습니다. 직접 만든 에이전트도 정의에서 omitClaudeMd 를 켜면 CLAUDE.md 를 뺄 수 있습니다.
제 작업 환경(2.1.322)에서도 이 설명을 한 번 확인해 봤습니다. 내장 claude-code-guide 서브에이전트를 하나 띄운 뒤, 그 대화 기록 파일(~/.claude/projects/<프로젝트>/<세션 id>/subagents/agent-<id>.jsonl)을 열었습니다. 시작 지시문에 전역 CLAUDE.md 와 프로젝트 CLAUDE.md 가 실려 있었습니다. 문서의 "Other built-in ... subagents load both" 와 같았습니다.
다만 실린다는 것과 따른다는 것은 다른 문제였습니다. 예전 버전의 제 환경에서는 CLAUDE.md 사슬이 첫 사용자 메시지에 붙는 «참고 맥락»으로 들어왔고, 그 끝에 지금 하는 일과 밀접하게 관련되지 않으면 이 맥락에 응답하지 말라는 취지의 꼬리말이 붙어 있었습니다. 그때부터 반드시 해야 하는 행동은 CLAUDE.md 가 아니라 에이전트 정의 본문이나 위임 프롬프트에 적는 습관이 생겼습니다.
2.1.322 기록에서는 CLAUDE.md 사슬이 별도의 지시문(instructions) 첨부로 실려 있었고, 그 꼬리말은 찾지 못했습니다. 버전에 따라 들어오는 모양이 바뀐다는 뜻입니다. 그래도 그 에이전트만의 필수 행동은 정의와 위임 프롬프트에 두는 쪽을 유지하고 있습니다.
무엇을 돌려주고, 사람은 어떻게 보나
서브에이전트가 일하며 부른 도구와 읽은 파일은 서브에이전트의 맥락에만 남습니다. 부모에게 돌아가는 것은 마지막 요약, 곧 보고서 하나입니다.
the subagent does that work in its own context and returns only the summary.
사람은 보통 이 보고서를 부모를 통해 받습니다. 부모 Claude 가 완료 알림을 받고, 그 결과를 사람에게 전하는 구조입니다.
그렇다고 «사람은 서브에이전트를 직접 볼 수 없다»는 설명이 맞는 것은 아닙니다. 사용자는 /tasks 에서 서브에이전트를 골라 Enter 를 누르면 그 대화 기록을 열어 볼 수 있습니다. 목록에 남아 있는 동안에는 그 기록에 직접 입력해 대화를 이어 갈 수도 있습니다. 기본 통로는 부모를 거치지만, 들여다볼 창은 따로 있다고 이해하는 편이 정확합니다.
거꾸로 서브에이전트가 사람에게 먼저 말을 거는 통로는 좁습니다. 서브에이전트는 사용자에게 질문하는 도구인 AskUserQuestion 을 쓸 수 없습니다. 정의의 tools 에 적어 두어도 빠집니다. 다만 권한이 필요한 도구 호출은 메인 세션 화면에 권한 프롬프트로 올라옵니다. 그 프롬프트에는 어느 서브에이전트가 묻는지 이름이 붙습니다.
백그라운드가 기본이고, 중첩도 됩니다
설정을 따로 건드리지 않으면, 메인 대화가 띄운 서브에이전트는 백그라운드에서 시작합니다. 결과는 나중 턴에 완료 알림으로 부모에게 옵니다. 포그라운드로 띄운 서브에이전트는 끝날 때까지 메인 대화를 막습니다.
한때 «서브에이전트는 서브에이전트를 띄울 수 없다»는 설명이 돌았습니다. 2026년 11월 현재 문서는 반대로 적고 있습니다.
서브에이전트도 자기 서브에이전트를 띄울 수 있고, 기본 한도는 메인 대화 아래 3단계까지입니다. 이 한도는 환경 변수 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH 로 바꿉니다. 한도에 닿은 서브에이전트에게는 Agent 도구가 주어지지 않습니다. 문서는 여기서 포크를 예외로 둡니다.
도구·모델·권한은 대부분 물려받습니다
서브에이전트가 쓸 도구와 모델, 권한 모드는 정의 파일의 frontmatter 로 정합니다. tools 를 비워 두면 서브에이전트는 쓸 수 있는 도구를 모두 물려받습니다. permissionMode 를 비워 두면 메인 세션의 권한 모드를 물려받습니다. 메인이 bypassPermissions·acceptEdits·auto 중 하나로 돌고 있으면, 정의에 무엇을 적었든 서브에이전트도 메인과 같은 모드로 돕니다.
모델은 호출할 때 넘긴 값, 정의의 model, 환경 변수, 메인 모델 순서로 정해집니다. 어떤 일에 어느 모델을 붙일지는 서브에이전트 모델 티어링 글에 따로 적어 두었습니다.
«서브에이전트는 단발성인가?» 맞는 부분과 틀린 부분
이제 처음 질문으로 돌아가 보겠습니다. 제 답은 «부르는 방식은 단발이지만, 대화 자체는 단발이 아니다»입니다.
맞는 부분: 부를 때마다 새로 태어납니다
Agent 도구를 새로 부를 때마다 새 인스턴스가 생깁니다. 그 인스턴스는 빈 맥락에서 시작합니다. 문서는 이렇게 적습니다.
Each subagent invocation creates a new instance rather than continuing an earlier one.
같은 리뷰 에이전트를 두 번 새로 부르면, 두 번째 리뷰 에이전트는 첫 번째가 무엇을 봤는지 모릅니다. 내장 Explore 와 Plan 은 더 철저하게 일회성입니다. 이 둘은 agent ID 를 돌려주지 않기 때문에, 끝난 뒤 이어 부를 방법이 없습니다.
틀린 부분: 끝난 서브에이전트도 이어 부를 수 있습니다
general-purpose 나 직접 만든 일반 서브에이전트는 사정이 다릅니다. 부모 Claude 가 SendMessage 도구에 그 에이전트의 ID 나 이름을 넣어 메시지를 보내면, 그 에이전트는 이전 맥락을 그대로 가진 채 이어서 일합니다. 새 인스턴스를 만드는 것이 아니라 같은 대화를 다시 깨우는 것입니다.
제 환경에서 2.1.284 무렵 확인했을 때도 그랬습니다. 끝난 서브에이전트에게 SendMessage 를 보내자 "Resuming agent <id>" 라는 표시와 함께 기존 대화가 이어졌습니다. 아직 돌고 있는 서브에이전트에게 보낸 메시지는 그 에이전트의 다음 도구 호출 경계에서 배달됐습니다.
수명도 생각보다 깁니다. 서브에이전트의 대화 기록은 그 세션 안에서 유지됩니다. Claude Code 를 껐다 켜더라도 같은 세션을 resume 하면 그 서브에이전트를 다시 이어 부를 수 있습니다. 기록 파일은 cleanupPeriodDays(기본 30일)가 지나면 지워집니다.
그래서 어떻게 이해하면 좋을까
제가 내린 해석은 이렇습니다. 서브에이전트는 «단발 호출»이라기보다 «부모 세션에 딸린, 한 가지 일을 위한 대화»로 읽힙니다. 수명은 부모 세션에 묶여 있습니다. 그 대화에 말을 거는 쪽은 주로 사람이 아니라 부모입니다.
«단발성»이라는 말은 Agent 를 새로 부르는 방식에만 들어맞습니다. 돌이켜 보니 제 이해는 틀렸다기보다, 호출 방식 하나를 존재 방식 전체로 넓혀 읽은 것이었다는 생각이 들었습니다.
서브에이전트는 일을 마치면 스스로 멈출까
단발성 질문을 풀고 나니 바로 다음 질문이 따라왔습니다. 끝난 서브에이전트는 메인이 따로 종료시켜야 하는 걸까요. 답부터 적으면, 메인이 종료시킬 필요는 없습니다. 서브에이전트는 마지막 보고를 내면 그 실행이 끝납니다.
다만 «멈춘 것»은 «사라진 것»이 아닙니다. 끝난 경우, 아직 도는 경우, 도중에 멈춘 경우를 나눠 보겠습니다.
끝난 서브에이전트: 보고와 함께 멈춥니다
서브에이전트가 성공적으로 끝나면 화면의 서브에이전트 목록에서 그 줄이 바로 사라집니다. 하단에는 «/tasks to see subagents» 라는 안내가 30초 동안 뜹니다. 실패했거나 사용자가 멈춘 서브에이전트는 그 줄이 30초 동안 남습니다. 백그라운드 서브에이전트의 결과는 나중 턴에 완료 알림으로 부모 Claude 에게 옵니다. 목록에서 줄이 사라져도 /tasks 목록에는 끝난 서브에이전트가 남아 있습니다.
제 작업 환경에서도 이 글을 쓰며 띄운 문서 확인 에이전트로 확인해 봤습니다. 대화 기록 옆의 메타 파일(agent-<id>.meta.json)에 "finished": true 가 찍혀 있었습니다. 아무도 종료 명령을 보내지 않았습니다.
아직 도는 서브에이전트: 기다릴 것이 남아 있으면 끝나지 않습니다
보고를 낸 것처럼 보여도 아직 끝나지 않은 경우가 있습니다. 대화형 세션에서 자기 백그라운드 서브에이전트를 띄운 서브에이전트는, 그 결과를 받을 때까지 끝나지 않습니다. 또 서브에이전트가 걸어 둔 백그라운드 명령이 끝나면, Claude Code 가 그 서브에이전트에게 알림을 보냅니다.
이 두 번째 동작 때문에 제 환경(2.1.284 무렵)에서는 이런 일이 있었습니다. 백그라운드 명령만 걸어 둔 채 보고를 낸 서브에이전트가, 명령이 끝나자 다시 깨어나 결과를 한 번 더 냈습니다. 부모 쪽에는 같은 작업의 알림이 여러 번 왔습니다. 그래서 서브에이전트 안에서 긴 명령을 기다리게 할 때는 «명령이 다 끝난 뒤 보고하라»고 위임 프롬프트에 적는 편이 안전했습니다.
멈춘 서브에이전트: 누가 멈췄느냐에 따라 다릅니다
돌고 있는 서브에이전트는 멈출 수 있습니다. 사용자는 /tasks 에서 x 로 멈추고, SDK 에서는 stop_task 요청으로 멈춥니다. Claude 는 TaskStop 도구로 멈춥니다. 두 경우는 그 뒤가 다릅니다.
사용자가 직접 멈춘 것은 저절로 재개되지 않습니다. 그 뒤 Claude 가 메시지를 보내면 거절되고, Claude 에게는 취소된 에이전트라는 안내가 돌아갑니다. 다만 패널에 그 줄이 남아 있는 동안 사용자가 기록에 직접 입력하면 다시 살릴 수 있습니다. 그렇게 한 번 살린 뒤에는 Claude 의 메시지로도 다시 재개됩니다.
Claude 가 TaskStop 으로 멈춘 것은 사정이 다릅니다. 멈춘 실행이 끝나고 나면, 끝난 것과 똑같이 SendMessage 로 이어 부를 수 있습니다. 문서는 재개를 같은 ID 로 새 실행을 시작하는 것으로 설명합니다("Resuming starts a new run of the agent under the same ID"). 그래서 끝났던 에이전트가 작업 목록에서 다시 실행 중으로 보입니다.
정리하면 이어 부르기가 막히는 것은 사람이 멈춘 경우뿐이고, 그것도 사람이 다시 열어 줄 수 있습니다. 같은 «정지»라도 누가 멈췄느냐가 그다음을 정했습니다.
멈춘 뒤에 남는 것
끝났든 멈췄든 대화 기록 파일은 남습니다. 위치는 ~/.claude/projects/<프로젝트>/<세션 id>/subagents/agent-<agentId>.jsonl 이고, 옆에 meta.json 이 있습니다. 끝난 서브에이전트의 agent ID 는 부모 Claude 가 받습니다. 이 ID 나 이름으로 SendMessage 를 보내면, 새 Agent 호출 없이 백그라운드에서 이어서 돕니다.
Resumed subagents retain their full conversation history, including all previous tool calls, results, and reasoning.
이 기록은 세션 안에서 유지되고, 같은 세션을 resume 하면 재시작 뒤에도 이어 부를 수 있습니다. 기록은 cleanupPeriodDays(기본 30일)가 지나면 지워집니다.
여기서 하나 해석을 덧붙이면, 끝난 서브에이전트는 누군가 메시지를 보내기 전까지 모델을 부르지 않는 것으로 읽힙니다. 그렇다면 남아 있다는 사실만으로 토큰이 드는 것은 아닙니다. «멈춘 서브에이전트를 치워 줘야 하나?»는 비용 걱정이라기보다 목록 정리의 문제라고 정리할 수 있겠습니다.
다른 일을 이어 맡기면 맥락이 섞일까: 새로 띄우기와 이어 부르기
이어 부를 수 있다면 반대쪽 걱정도 생깁니다. A 일을 시킨 서브에이전트에게 성질이 다른 B 일을 또 시키면, 두 일의 맥락이 섞이지 않을까요.
섞임은 저절로 일어나지 않습니다. 새 Agent 호출은 언제나 빈 맥락에서 시작하기 때문입니다. 섞이는 것은 나 또는 부모 Claude 가 SendMessage 로 «이어 부르기»를 골랐을 때뿐입니다.
이어 부른 서브에이전트는 이전 도구 호출과 결과, 추론을 모두 가진 채 이어 갑니다. 그러니 B 를 이어 맡기면 A 의 맥락 위에서 B 를 하게 됩니다. Claude Code 가 섞임을 막아 주는 것이 아니라, 호출하는 쪽이 섞을지 말지를 고르는 구조입니다.
한 서브에이전트에 일을 계속 얹을 때의 비용도 있습니다. 서브에이전트도 자기 컨텍스트 창이 차면 자동 압축(auto-compaction)됩니다. 압축은 지난 대화를 요약으로 바꾸는 과정입니다. 그래서 일을 계속 얹다 보면 결국 원문이 아니라 요약을 들고 일하게 됩니다.
문서가 말하는 것과 말하지 않는 것
공식 문서의 모범 사례는 정의 단위로 이렇게 적습니다. "Design focused subagents: each subagent should excel at one specific task." 이어 부르기의 용도는 처음부터 다시 하는 대신 기존 작업을 이어 가는 것으로 설명합니다. 반대 방향의 선택지로는 포크가 있습니다. 포크는 입력 격리를 일부러 버린 서브에이전트이고, 문서는 다른 서브에이전트에게 배경을 너무 많이 설명해야 할 때 포크를 쓰라고 말합니다.
다만 «서로 다른 일을 한 서브에이전트에 섞지 말라»는 직접 경고는 문서에서 찾지 못했습니다. 그래서 아래 기준은 문서를 근거로 제가 세운 해석입니다.
제가 세운 기준
이어 불러도 된다고 본 경우는 같은 일의 연장입니다. A 의 결과물을 A 가 고치는 일이 대표적입니다. 초안을 쓴 글쓰기 에이전트에게 검토 의견을 반영시키거나, 구현을 마친 백엔드 구현 에이전트에게 리뷰 지적을 고치게 하는 식입니다. 왜 그렇게 썼는지에 대한 맥락이 그대로 쓸모 있기 때문입니다. B 가 A 에서 읽은 파일이나 내린 결정에 기대는 일도 이어 부르는 편이 낫다고 봤습니다.
새로 띄워야 한다고 본 경우는 셋입니다.
- B 가 A 와 무관한 일: A 의 맥락은 B 에게 소음입니다. 그 맥락은 호출마다 다시 읽히는 비용이고, 압축을 앞당깁니다.
- 독립된 판단이 필요한 일: 리뷰나 검증처럼 A 를 한 쪽의 시각에 물들지 않은 판단이 목적이면 반드시 새로 띄웁니다. 제 작업 환경에서도 리뷰 지적을 판정한 에이전트를 같은 라운드의 수정 담당으로 다시 쓰지 않는다는 규칙을 두고 있습니다. 판정과 수정을 한 맥락에 두면 독립성이 깨지기 때문입니다.
- 지시가 서로 배타적인 일: 이어 부르면 앞 지시가 그대로 남아 있습니다. 제 환경에서 굳이 이어 맡겨야 했을 때는 «앞 지시를 대체한다»고 분명히 적어야 했습니다.
한 줄로 줄이면 질문은 이것입니다. «B 를 하는 데 A 의 기억이 도움이 되는가, 방해가 되는가.» 도움이 되면 이어 부르고, 방해가 되거나 판단이 독립돼야 하면 새로 띄웁니다. 결국 맥락의 격리는 기본값으로 주어질 뿐이고, 그것을 지키거나 풀어 주는 것은 호출하는 쪽의 선택이라는 생각이 들었습니다.
피어 대화 세션은 무엇이 다른가: 위임이 아니라 협업
피어 대화 세션끼리 말을 주고받는 기능의 공식 이름은 cross-session messaging, 곧 세션 간 메시지입니다. macOS 와 Linux 에서는 2.1.224 이상이면 따로 켜지 않아도 동작합니다.
어떻게 닿나
대상은 내 다른 Claude Code 세션입니다. 같은 기기의 세션일 수도 있고, Remote Control 로 이어진 다른 기기나 클라우드의 세션일 수도 있습니다. Claude 는 ListAgents 로 대상을 찾고 SendMessage 로 보냅니다. 사람은 /list-agents(별칭 /peers)로 닿을 수 있는 세션을 봅니다. 이 목록에는 서브에이전트와 팀원, 다른 로컬 세션이 함께 나옵니다.
같은 기기 안에서는 세션별 소켓으로 직접 전달되고, Anthropic 서버를 거치지 않습니다. 다른 기기나 클라우드로 가는 메시지는 Anthropic 서버를 거칩니다.
넘어가는 것은 글자뿐입니다
A message is a piece of text one Claude writes to another, never the sender's conversation history or files.
보낸 쪽의 대화 기록이나 파일은 넘어가지 않습니다. 대화 전체를 옮기고 싶다면 메시지가 아니라 그 세션을 resume 해야 합니다. 이 점에서는 서브에이전트와 닮았습니다. 둘 다 상대의 맥락을 통째로 받지 않습니다. 다른 점은 받는 쪽이 이미 자기 맥락을 길게 가진 완전한 대화라는 것입니다.
받는 쪽은 메시지를 사용자 지시로 받지 않습니다
받는 세션은 그 메시지를 사람이 친 지시가 아니라 다른 세션이 보낸 것으로 받습니다.
a message from another session never counts as your consent
- 메시지로는 무엇도 승인할 수 없습니다. 사용자 동의로 치지 않습니다.
- 메시지가 설정이나 CLAUDE.md 를 바꾸지 않습니다.
- 메시지 안에 든
/compact같은 명령은 실행되지 않습니다. - 받는 세션의 권한 프롬프트는 그대로 뜹니다.
문서는 이를 "Permission boundaries stay per-session." 이라는 한 줄로 정리합니다. Claude 는 자기 세션에서 거절되거나 차단된 일을 다른 세션에 대신 시키지 않도록 지시받습니다. 메인의 권한 모드를 물려받는 서브에이전트와 가장 크게 갈리는 지점이 여기라는 생각이 들었습니다.
받을지 말지는 crossSessionInbound 설정으로 정합니다. 값은 accept, hold, refuse 셋입니다. 설정이 없으면 두 세션의 권한 모드 부류로 메시지마다 판정합니다. 부류는 권한 프롬프트를 건너뛰는 쪽과 묻는 쪽 둘입니다. 예를 들어 받는 세션이 권한을 묻는 쪽이면 메시지를 배달하되, 보낸 쪽이 건너뛰는 부류일 때만 승인을 기다립니다.
배달되는 방식
받는 세션이 일하는 중이면 도구 호출 사이에 메시지를 읽습니다. 쉬고 있으면 그 메시지로 새 턴이 시작됩니다. 배달된 메시지는 사용자가 친 프롬프트처럼 사용량에 잡힙니다.
위임과 협업은 다른 축에 있습니다
피어 세션은 사람이 직접 띄우고 직접 말을 거는 완전한 대화입니다. 자기 창과 자기 맥락, 자기 권한 모드를 가집니다. 공식 문서의 Run agents in parallel 페이지는 세션 간 메시지를 «에이전트를 돌리는 방식»으로 분류하지 않습니다. 내가 직접 돌리는 세션끼리 발견과 상태를 주고받게 하는 보조 도구로 분류합니다.
이 분류를 보고 나서야 둘이 다른 축에 있다는 것이 보였습니다. 서브에이전트는 위임입니다. 부모가 일을 떼어 넘기고, 과정은 넘겨받지 않고, 결과만 돌려받습니다. 프로그래밍으로 비유하면 인자를 넘기고 반환값만 받는 함수 호출에 가깝습니다.
피어 세션은 협업입니다. 각자 자기 맥락과 권한을 가진 채 일하고, 서로 알아야 할 것만 메시지로 주고받습니다. 이쪽은 대화 맥락을 공유하지 않고 메시지로만 통신하는 액터 모델에 가깝다고 봤습니다.
물론 비유일 뿐이고, 서브에이전트도 이어 부를 수 있으니 경계가 칼같지는 않습니다.
서브에이전트와 피어 세션 사이: 포크, 백그라운드 세션, 에이전트 팀, 워크플로
서브에이전트와 피어 세션 사이에는 두 성질을 섞은 방식들이 있습니다. 문서에 있는 것만 짧게 적겠습니다.
포크: 대화 전체를 물려받는 서브에이전트
포크는 빈 맥락이 아니라 지금까지의 대화 전체를 물려받는 서브에이전트입니다. 포크가 부른 도구 호출은 부모 대화에 들어오지 않고, 최종 결과만 돌아옵니다.
사용자가 직접 띄우려면 /subtask 를 씁니다. 부모와 프롬프트 캐시를 공유하므로, 같은 맥락이 필요한 일이라면 새 서브에이전트보다 쌉니다. 포크는 다시 포크를 띄울 수 없습니다. 맥락은 대화를 이어받는 쪽을 닮았고, 결과 통로는 서브에이전트처럼 요약 하나인 셈입니다.
이름 붙은 서브에이전트끼리의 메시지
이름이 붙은 서브에이전트는 SendMessage 로 서로 메시지를 보낼 수도 있습니다. 시작할 때 다른 에이전트의 이름 목록이 실리는 것도 이 때문입니다. 그래서 «서브에이전트는 부모에게만 보고한다»는 말은 기본 동작에 대한 설명으로 읽는 편이 맞습니다.
백그라운드 세션과 agent view
claude --bg 로 백그라운드 세션을 띄우고, claude agents 로 그 세션들을 한 화면에서 봅니다. 2026년 11월 기준으로 research preview 기능입니다. 각 백그라운드 세션은 터미널 없이 계속 도는 완전한 Claude Code 대화입니다.
결과는 사용자에게만 보고됩니다. 세션 간 메시지로 서로 주고받을 수는 있습니다. 백그라운드에서 돌지만 정체는 피어 세션 쪽이라고 정리할 수 있습니다.
에이전트 팀
에이전트 팀은 실험 기능이라 기본으로 꺼져 있고, CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 로 켭니다. 리더인 메인 세션이 팀원을 띄웁니다. 팀원은 각자 독립된 완전한 Claude Code 세션입니다.
팀원끼리 직접 메시지를 주고받고, 작업 목록을 공유합니다. 사용자는 리더를 거치지 않고 팀원에게 직접 말을 걸 수 있습니다. 리더의 대화 기록은 팀원에게 넘어가지 않습니다. 팀원은 자기 팀을 또 만들 수 없습니다.
문서는 서브에이전트를 "Focused tasks where only the result matters" 에, 팀을 "Complex work requiring discussion and collaboration" 에 맞는 것으로 나눕니다. 띄우는 방식은 서브에이전트를 닮았고, 팀원 하나하나의 성질은 피어 세션을 닮았다고 읽힙니다.
동적 워크플로
동적 워크플로(dynamic workflows)는 Claude 가 쓴 JavaScript 스크립트가 많은 서브에이전트를 한꺼번에 돌리고 결과를 서로 대조하는 방식입니다. 백그라운드에서 돌고, /workflows 로 봅니다. 문서의 표현을 빌리면 Claude 의 턴별 판단 대신 스크립트가 계획을 쥡니다.
문서가 제시하는 고르는 법
문서는 병렬 방식으로 서브에이전트, agent view, 에이전트 팀, 동적 워크플로, projects(claude.ai/code·데스크톱의 장기 대화) 다섯을 꼽고, 워크트리·세션 간 메시지·/batch 는 보조 도구로 따로 둡니다.
고르는 질문은 셋입니다. 첫째는 누가 조율하는가입니다. Claude 가 한 대화 안에서 맡기고 모으면 서브에이전트, 내가 독립 작업을 넘기고 나중에 보면 agent view, Claude 가 여러 일꾼을 계획·배정·감독하면 팀, 스크립트가 계획을 쥐면 워크플로입니다. 둘째는 일꾼끼리 말해야 하는가이고, 셋째는 같은 파일을 만지는가입니다. 셋째가 «그렇다»면 워크트리로 작업 공간을 가릅니다.
서브에이전트와 피어 세션, 비용의 모양이 다릅니다
서브에이전트를 쓰면 공짜로 맥락을 아끼는 것처럼 느껴지기 쉽지만, 그렇지 않습니다. 서브에이전트의 요청도 사용량에 잡힙니다. 서브에이전트와 워크플로가 띄운 에이전트는 메인 대화 위에 자기 요청을 따로 보냅니다. 장점은 장황한 출력이 서브에이전트 맥락에 남고, 메인에는 요약만 온다는 것입니다.
에이전트 팀은 단일 세션보다 «significantly more tokens» 를 쓴다고 문서에 적혀 있습니다. 쓰는 양은 팀원 수와 각자 도는 시간에 비례합니다. 세션 간 메시지가 쉬고 있는 세션에 도착하면 새 턴이 시작됩니다. 받는 쪽이 자기 맥락 전체를 다시 읽는 턴입니다.
이 사실들을 엮으면 비용의 모양이 다르다고 정리할 수 있습니다. 서브에이전트는 맡길 때마다 시스템 프롬프트와 CLAUDE.md 사슬, 위임 프롬프트라는 기반 맥락을 새로 싣습니다. 일종의 건당 고정비입니다. 피어 세션은 자기가 끌고 다니는 맥락을 메시지 한 통마다 다시 읽습니다. 맥락이 길어질수록 메시지당 비용이 커집니다.
이 차이를 실제로 잰 기록은 Claude Code 멀티 세션의 토큰 비용에 적어 두었습니다. 그 글의 결론은 «형태보다 수명»이었습니다. 무엇을 쓰느냐보다, 맥락을 얼마나 오래 끌고 가느냐가 비용을 정한다는 뜻입니다.
언제 무엇을 쓰나: 서브에이전트와 피어 세션 판단 기준
한 줄로 줄이면, 결과만 필요하면 서브에이전트에 맡기고 내가 계속 말을 걸며 판단해야 하면 피어 세션을 둡니다.
| 기준 | 서브에이전트 | 피어 대화 세션 |
|---|---|---|
| 누가 띄우나 | 부모 세션의 Claude(또는 내가 @-mention) | 내가 직접(터미널·--bg) |
| 시작 맥락 | 정의 본문 + 위임 프롬프트 + CLAUDE.md 사슬, 부모 대화는 없음 | 자기 대화 전체, 계속 쌓임 |
| 사람이 말을 거나 | 기본은 부모 경유, /tasks 로 열람·이어 입력 가능 |
직접 |
| 결과 통로 | 마지막 요약이 부모에게(완료 알림) | 메시지(글자)만, 사용자 지시가 아닌 다른 세션 요청으로 받음 |
| 수명 | 부모 세션에 묶임, 새로 부르면 빈 맥락, SendMessage 로 이어 부름 | 내가 닫을 때까지 |
| 같은 일꾼에게 다음 일을 시킬 때 | 이어 부르기(SendMessage)와 새로 띄우기 중 호출자가 고름 | 한 대화에 계속 쌓임, 비우려면 사람이 /clear 하거나 새 세션 |
| 권한 | 메인 모드를 물려받음, 사용자 질문 도구 없음 | 세션마다 따로 |
| 비용 모양 | 맡길 때마다 기반 맥락 고정비, 요약만 메인으로 | 쌓인 맥락 × 메시지 수 |
| 맞는 일 | 결과만 필요한 곁가지(검색·로그·리뷰) | 사람이 계속 대화하며 판단할 긴 줄기, 다른 작업 갈래 |
표를 다시 읽어 보면, 두 방식을 가르는 것은 성능이 아니라 «누가 그 대화에 말을 거는가»와 «맥락이 얼마나 오래 사는가»라는 생각이 들었습니다.
그래서 저는 이렇게 나눠 쓰고 있습니다. 결과만 필요하고 중간 과정을 다시 볼 일이 없으면 서브에이전트에 맡깁니다. 리뷰 에이전트에게 변경분을 보이고 보고서만 받거나, 백엔드 구현 에이전트에게 범위가 정해진 구현을 넘기는 식입니다.
내가 직접 계속 말을 걸며 방향을 바꿔야 하는 긴 줄기는 별도 세션으로 둡니다. 서로 다른 작업 갈래도 별도 세션으로 둡니다. 세션끼리는 알아야 할 것만 메시지로 주고받습니다.
마지막으로, 맥락을 오래 끌고 가는 것 자체가 비용입니다. 그래서 오래 사는 세션은 적게 두고, 이어 갈 맥락은 넘김 파일이나 이슈 같은 파일에 둡니다.
정리: 단발성이 아니라 «부모에 딸린 대화»
처음 질문에 다시 답해 보겠습니다. 서브에이전트는 단발성인가. 새로 부를 때마다 빈 맥락에서 태어난다는 점에서는 그렇습니다. 하지만 끝난 서브에이전트도 이어 부를 수 있고, 그 대화는 부모 세션과 함께 남습니다. 그래서 저는 서브에이전트를 «부모 세션에 딸린, 한 가지 일을 위한 대화»로 이해하기로 했습니다. 피어 세션은 «내가 직접 말을 거는 대등한 다른 대화»로 이해하기로 했습니다.
서브에이전트는 일을 마치면 메인이 종료시키지 않아도 저절로 멈추지만, 기록과 ID 를 남긴 채 멈춥니다. 그 대화를 이어 부를지 새로 띄울지는 호출하는 쪽이 고릅니다.
두 기능은 같은 SendMessage 도구를 쓰고, 둘 다 «다른 Claude 에게 일을 시키는 것»처럼 보입니다. 헷갈리기 쉬운 이유가 거기에 있다는 생각이 들었습니다. 하지만 맥락이 어디서 오고, 누가 말을 걸고, 권한이 어디에 묶이는지를 보면 둘은 꽤 다른 자리에 있었습니다. 다음에 무언가를 맡길 때는 «이건 위임인가, 협업인가»부터 먼저 물어보려고 합니다.