AI 도서관 · Claude · 하네스 설정 · 에이전트끼리 소통

무엇을 쓸까 — 서브에이전트·팀·세션 메시지

넷이 비슷해 보이는데 성격이 다릅니다. 한 장 정리

내용

📌 네 가지가 있습니다

① 서브에이전트
   한 세션 안에서 도우미를 띄웁니다.
   결과만 돌려받습니다. 토큰이 제일 적게 듭니다.
   → 결과만 있으면 되는 일

② 에이전트 팀
   팀원끼리 직접 대화하고 할 일 목록을 나눠 집습니다.
   각자 별도의 클로드라 토큰이 제일 많이 듭니다.
   → 서로 의논하고 반박해야 하는 일

③ 세션 간 메시지
   내가 직접 띄운 세션끼리 소식을 주고받습니다.
   각 세션은 내가 따로 조종합니다.
   → 이미 터미널을 여러 개 띄워놓고 일하는 중일 때

④ 이어받기
   대화를 통째로 다른 곳에서 계속합니다.
   메시지가 아니라 맥락 전체가 넘어갑니다.
   → 옮기고 싶은 것에 가까울 때

[ 고르는 순서 ]
결과만 받으면 되나?              → ① 서브에이전트
서로 이야기해야 하나?            → ② 팀
이미 세션을 여러 개 띄워놨나?    → ③ 세션 간 메시지
대화를 통째로 옮기고 싶나?       → ④ 이어받기

📌 공식 문서가 권하는 순서
팀을 만들기 전에 가벼운 쪽이 되는지 먼저 보라고 합니다.
①로 되는 일이면 ①로 끝내는 것이 낫습니다.

📌 셋이 같은 도구를 씁니다
말을 거는 것은 전부 SendMessage 하나입니다.
상대를 찾는 것은 ListAgents 하나입니다.
그래서 이 둘을 막으면 셋이 한꺼번에 막힙니다.

  "permissions": { "deny": ["SendMessage", "ListAgents"] }

회사에서 통째로 끄고 싶을 때 쓰는 방법입니다.

📌 맥락은 자동으로 안 넘어갑니다
팀원은 프로젝트 지침 파일·커넥터·스킬은 알아서 읽지만,
팀장이 나와 나눈 대화는 모릅니다.
필요한 사정은 띄울 때 지시문에 적어 주어야 합니다.

⚠️ 팀은 세션당 하나뿐입니다
   여러 팀을 만들 수 없고, 팀을 세션끼리 나눠 쓸 수도 없습니다.
   구조를 미리 정하고 시작하세요.

궁금한 점: {{INPUT}}

{{INPUT}} 자리에 내 내용을 넣어 쓰는 프롬프트입니다. 아래 버튼으로 열면 넣는 칸이 나옵니다.

근거

유형
공식 기능·명령 — 해당 제품에서 실제로 동작합니다
사용 환경
Claude Code — 서브에이전트·팀·세션 메시지
주의
팀원은 팀장의 대화 내역을 물려받지 않습니다. 필요한 사정은 띄울 때 적어 주세요.
공식 출처
https://code.claude.com/docs/en/agent-teams
확인일
2026-09-09 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기