클로드 코드 하위 에이전트 재개 — 이력 그대로 이어짐·내가 멈춘 건 거부

검토를 맡겼던 하위 에이전트에게 「아까 그거 이어서 봐 줘」라고 하면 어떻게 될까요. 같은 이름을 불렀으니 이어질 것 같지만, 실제로는 완전히 새 인스턴스가 하나 더 뜹니다. 앞서 뭘 봤는지 모르는 채로요.

이어 가려면 재개를 시켜야 합니다. 그러면 대화 이력도, 도구 묶음도, 데워 둔 캐시까지 그대로 물려받습니다. 다만 재개가 아예 안 되는 경우가 따로 있습니다.

📌 30초 요약

• 부를 때마다 새로 뜹니다.
• 재개하면 전부 이어집니다.
• 일회성 둘은 재개 불가입니다.
• 내가 멈춘 건 거부됩니다.
• 이름이 겹치면 안 보냅니다.

1. 부를 때마다 새로 뜹니다

하위 에이전트는 호출할 때마다 새 인스턴스가 만들어집니다. 정의 파일이 같아도 앞선 실행과는 남남이죠. 그래서 이어 가고 싶으면 「그 검토를 이어서 해 줘」처럼 이어 가라고 말해야 합니다. 그러면 클로드가 새로 띄우는 대신 그 에이전트에게 메시지를 보내 깨웁니다.

재개하면	이렇게 이어집니다
대화 이력	도구 호출과 결과까지 전부
도구 묶음	처음 돌 때 그대로 유지
데워 둔 캐시	계속 읽어 갑니다
부하들이 낸 결과	그사이 도착한 것도 포함

둘째 줄과 셋째 줄이 실속입니다. 뒤에서 돌면 내장 도구가 줄어드는 성질이 재개에도 그대로 따라붙어, 처음 앞에서 돌았으면 그 도구 묶음을 유지합니다. 그리고 캐시를 물려받아 싸게 도는 방식과 같은 이득이 재개에도 있습니다 — 새로 띄우면 처음부터 다시 데워야 하죠.

차례 상한에 걸려 멈춘 경우에도 길이 있습니다. 그럴 때 결과가 「일부만」이라고 표시되고, 이어서 시킬 수 있다는 안내가 함께 붙습니다. 결과가 어중간하다 싶으면 이 표시부터 보세요.

깨어난 뒤에는 뒤에서 조용히 도는 방식으로 일합니다 — 새로 띄우는 절차 없이 그대로 이어지죠. ★그런데 이때 동시에 돌 수 있는 수를 세는 자리는 다시 세지 않습니다. 재개는 상한을 확인하지 않고 새 자리를 차지하기 때문에, 여럿을 한꺼번에 깨우면 돌고 있는 수가 정해진 선을 넘어설 수도 있습니다.

2. 재개가 안 되는 경우

전부 이어지는 건 아닙니다. 막히는 자리가 넷 있습니다.

이런 경우	어떻게 됩니다
일회성 내장 에이전트 둘	식별자를 안 돌려줌
내가 직접 멈춘 것	메시지가 거부됩니다
이름을 새 에이전트가 가져감	배달 대신 거부 후 안내
보관 기간이 지남	기록이 지워집니다(기본 30일)

첫째 줄은 미리 알아 두셔야 합니다. 탐색과 계획을 맡는 내장 에이전트 둘은 한 번 쓰고 끝나는 성격이라 식별자를 안 내놓습니다. 그래서 클로드도 이어 붙일 방법이 없죠. 이어서 파고들 일이라면 처음부터 범용 에이전트나 직접 만든 정의를 쓰셔야 합니다.

⚠️ 내가 멈춘 것과 스스로 끝난 것은 대우가 다릅니다

작업 목록에서 제가 직접 멈춘 하위 에이전트는 클로드가 메시지를 보내도 거부되고, 「취소됨」이라고 통보됩니다. 반면 클로드가 멈춘 것이나 스스로 끝난 것은 메시지 한 번으로 배경에서 조용히 다시 돕니다. 즉 「멈췄다」가 다 같은 뜻이 아닙니다 — 누가 멈췄느냐로 갈립니다. 다만 그 줄이 아직 화면에 남아 있다면 기록을 열고 직접 말을 붙여 되살릴 수 있고, 그러고 나면 클로드도 다시 깨울 수 있게 됩니다.

3. 엉뚱한 곳으로 안 가게 막는 장치

이름으로 부르는 방식에는 위험이 하나 있습니다 — 같은 이름을 나중에 뜬 에이전트가 가져갈 수 있거든요. 배경 에이전트를 다시 띄우면서 이름이 재사용되는 식이죠.

그래서 2.1.199판부터 그 이름이 아직 같은 에이전트를 가리키는지 확인합니다. 다른 쪽이 가져갔으면 엉뚱한 데 배달하는 대신 거부하고, 지금 그 이름이 누구인지 알려 줍니다. 앞서 띄운 쪽을 확실히 부르려면 이름 대신 식별자를 쓰면 됩니다. 이 검사는 지금 대화 안에서만 유효하고 대화를 비우면 초기화됩니다.

기록이 어디 남는지도 알아 두면 좋습니다. 하위 에이전트의 기록은 본 대화와 별도 파일이라, 본 대화가 압축돼도 영향을 안 받습니다. 세션을 다시 열어도 같은 세션이면 이어 붙일 수 있고요. 다만 앞서 본 대로 보관 기간이 지나면 정리됩니다.

이어 붙일수록 이력이 쌓인다는 점도 함께 보셔야 합니다. 하위 에이전트의 맥락 창 크기는 부모가 아니라 자기 모델을 따릅니다. 값싼 모델에 맡겨 뒀다면 그 모델의 작은 창을 쓰는 셈이라, 재개를 거듭하면 먼저 가득 찹니다. 다행히 하위 에이전트도 본 대화와 같은 방식으로 알아서 줄입니다 — 언제 줄일지 정하는 설정도 똑같이 적용되고요. 그래도 한참 이어 갈 일이라면 창이 넉넉한 모델로 맡기는 편이 낫습니다.

4. 에이전트가 보낸 말의 한계

하위 에이전트끼리도 메시지를 주고받을 수 있습니다. 2.1.198판부터는 자기를 띄운 쪽이 보낸 말을 평범한 작업 지시로 받아들여, 일하는 중간에 방향을 틀기도 합니다. 편리한 만큼 선이 필요하겠죠.

그래서 누가 보냈든 뚫리지 않는 선이 둘 있습니다. 첫째, 어떤 에이전트의 메시지도 승인 창에 대한 제 승인이 될 수 없습니다. 둘째, 에이전트의 말로는 권한 설정도, 지침 파일도, 구성도 바꾸지 못합니다. 승인은 권한 체계나 제 답변으로만 이뤄집니다.

보고가 어디로 가는지도 갈립니다. 하위 에이전트가 다른 에이전트를 깨운 경우, 깨어난 쪽은 저에게가 아니라 자기를 깨운 그 에이전트에게 결과를 돌려줍니다. 깨운 쪽은 그 결과를 받을 때까지 자기 일을 안 끝내고 기다리고요. 그래서 여러 겹으로 얽히면 제 화면에는 맨 위 하나의 요약만 올라옵니다 — 중간에서 무슨 말이 오갔는지 보려면 그 에이전트의 기록을 직접 열어 보셔야 합니다.

이 설계가 중요한 이유는 기억을 켜면 도구가 늘어나는 것처럼 에이전트 사이에서 권한이 번지는 경로를 막아 두기 때문입니다. 여럿이 서로 말을 걸수록 「누가 허락했나」가 흐려지기 쉬운데, 그 지점을 못 박아 둔 셈이죠.

자주 묻는 질문 (FAQ)

Q. 같은 이름을 부르면 이어지지 않나요

안 이어집니다. 호출할 때마다 새 인스턴스가 뜹니다. 「그 작업을 이어서」처럼 이어 가라고 말해야 앞선 이력을 들고 다시 돕니다.

Q. 탐색 에이전트를 이어서 쓰고 싶습니다

그 둘은 한 번 쓰고 끝나는 성격이라 식별자를 안 돌려줍니다. 이어 갈 계획이라면 처음부터 범용 에이전트나 직접 만든 정의로 시작하세요.

Q. 멈춘 에이전트를 되살릴 수 있나요

누가 멈췄느냐에 달렸습니다. 클로드가 멈췄거나 스스로 끝났으면 메시지로 다시 돕니다. 제가 직접 멈춘 건 거부되지만, 줄이 남아 있을 때 기록을 열고 직접 말을 붙이면 살아납니다.

Q. 본 대화가 압축되면 기록도 날아가나요

아닙니다. 하위 에이전트 기록은 별도 파일로 보관돼 본 대화의 압축과 무관합니다. 다만 보관 기간(기본 30일)이 지나면 정리됩니다.

정리하면

• 이어 가라고 말해야 합니다.
• 도구와 캐시까지 따라옵니다.
• 일회성 둘은 못 이어 씁니다.
• 누가 멈췄는지가 갈림길입니다.
• 승인은 사람 몫으로 남습니다.

※ 공개된 하위 에이전트 문서의 「재개」 절을 읽고 정리했습니다. 도구 이름과 설정 항목은 우리말로 풀어 적었으니 실제 표기는 원문에서 확인하세요.

※ 판올림에 따라 검사 방식과 보관 기간 기본값이 달라집니다. 2026년 9월 기준이며 이후 바뀔 수 있습니다.