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

에이전트끼리 말을 걸게 하기 (팀)

시켜서 결과만 받는 게 아니라, 서로 의논하고 반박하게 만드는 구성

내용

📌 지금까지 쓰던 것과 무엇이 다른가

서브에이전트
  내가 시킨다 → 각자 한다 → 나에게 결과를 준다
  서로 이야기하지 않습니다. 전부 나를 거칩니다.

에이전트 팀
  팀원끼리 직접 메시지를 주고받습니다
  공유 할 일 목록에서 각자 일을 집어 갑니다
  나는 팀장 세션 하나만 붙잡고 있으면 됩니다

📌 어디에 쓰나 (공식 문서가 꼽는 것)
• 조사·검토 — 서로 다른 각도로 파고든 뒤 결과를 맞부딪칩니다
• 새 기능 — 각자 다른 파일을 맡아 안 겹치게
• 원인 찾기 — 가설을 나눠 잡고 서로 반증합니다
• 층을 가로지르는 변경 — 화면·서버·테스트를 각각

[ 켜는 법 ]
기본은 꺼져 있습니다. 설정 파일에 넣으세요.

  "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" }

[ 시키는 법 — 그냥 말로 ]
  "TODO 주석을 훑는 도구를 설계하려고 해.
   팀원 셋을 띄워서 각각 다른 각도로 봐줘 —
   하나는 사용성, 하나는 구조, 하나는 반대 입장."

📌 제일 효과가 큰 쓰임새 — 서로 반증시키기
원인을 모를 때 한 명은 그럴듯한 설명 하나를 찾고 멈춥니다.
먼저 살펴본 가설 쪽으로 계속 기울기 때문입니다.

여러 명이 서로 틀렸다고 공격하게 시키면,
살아남은 가설이 진짜 원인일 가능성이 훨씬 큽니다.

  "사용자가 한 번 대화하면 앱이 꺼진다고 해.
   팀원 다섯을 띄워서 각자 다른 가설을 조사하게 해줘.
   서로 대화하면서 상대 가설을 반증하게 해 — 과학 토론처럼."

[ 팀원을 직접 보고 지시하기 ]
입력창 아래 목록에서 위아래 화살표로 고르고 Enter.
그 팀원의 화면이 열리고 거기서 바로 말을 걸 수 있습니다.

⚠️ 토큰이 훨씬 많이 듭니다. 팀원 수에 비례해 늘어납니다.
   일상적인 작업이면 세션 하나가 낫습니다.

⚠️ 3~5명으로 시작하세요. 공식 권장입니다.
   더 붙인다고 비례해서 빨라지지 않습니다.

⚠️ 두 팀원이 같은 파일을 고치면 덮어씁니다.
   파일을 나눠서 맡기세요.

궁금한 점: {{INPUT}}

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

근거

유형
공식 기능·명령 — 해당 제품에서 실제로 동작합니다
사용 환경
Claude Code 대화형 세션 전용 — -p 로 돌리면 팀원이 생기지 않습니다
사용 조건
실험 기능이라 기본으로 꺼져 있습니다. 설정으로 직접 켜야 합니다
주의
토큰이 팀원 수만큼 늘어납니다. 순차 작업이나 같은 파일을 만지는 일에는 오히려 손해입니다.
공식 출처
https://code.claude.com/docs/en/agent-teams
확인일
2026-09-09 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기