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

팀을 켜면 생기는 함정

내가 팀을 만들라고 한 적이 없는데 팀이 생깁니다. 켜기 전에 읽으세요

내용

⚠️ 이 항목은 경고입니다.

📌 함정 — 시키지 않아도 팀이 생깁니다

팀 기능을 켜두면, 클로드가 이름을 붙인 서브에이전트가
전부 팀원으로 뜹니다. 클로드는 나중에 말을 걸려고
서브에이전트에 스스로 이름을 붙입니다.

그래서 "팀 만들어줘"라고 한 적이 없는데 팀이 생깁니다.
공식 문서도 이 점을 인정해 적어두었습니다 —
팀 작업이라고 생각한 적 없는 위임에서도 이 일이 생긴다고.

📌 왜 문제인가
팀원 하나하나가 별도의 클로드입니다.
각자 자기 맥락 창을 들고 토큰을 따로 씁니다.

평소 서브에이전트로 끝나던 일이 팀으로 커지면,
결과는 비슷한데 비용만 몇 배가 됩니다.
서브에이전트는 결과를 요약해 돌려주지만
팀원은 각자 자기 대화를 끝까지 들고 있기 때문입니다.

[ 되돌리는 법 ]
  "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "0" }

새 세션을 열 필요는 없습니다. 저장하면 바로 반영되고,
다음에 이름 붙는 서브에이전트부터 다시 서브에이전트로 돕니다.

⚠️ 다른 설정 파일이 켜두면 그쪽이 이깁니다
   내 사용자 설정에 0 을 넣어도, 프로젝트 설정·로컬 설정·
   회사 관리 설정 중 하나가 1 이면 그게 적용됩니다.
   회사에서 켜둔 것이면 관리자에게 말해야 합니다.

📌 켜기 전에 확인할 것 세 가지
① 이 작업이 진짜 여러 명이 동시에 할 만한 일인가
② 팀원들이 서로 다른 파일을 만지게 나눌 수 있는가
③ 토큰이 몇 배로 늘어도 괜찮은 작업인가

셋 중 하나라도 아니라면 서브에이전트로 충분합니다.

⚠️ 되돌릴 수 없는 것도 있습니다
   세션을 되살려도 팀원은 안 돌아옵니다.
   팀장이 없어진 팀원에게 말을 걸려 할 수 있습니다.
   그때는 새로 띄우라고 하세요.

⚠️ 팀장은 바꿀 수 없습니다
   처음 세션이 끝까지 팀장입니다. 팀원을 승격시킬 수 없고
   팀원이 자기 팀원을 또 만들 수도 없습니다.

궁금한 점: {{INPUT}}

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

근거

유형
설정 가이드 — 지정된 파일이나 설정에 적용합니다
사용 환경
Claude Code — settings.json 의 env 항목
사용 조건
회사 관리 설정이 켜두면 개인 설정으로 끌 수 없습니다
주의
켜두면 팀을 요청하지 않은 작업까지 팀으로 돌아 토큰이 늘어납니다.
공식 출처
https://code.claude.com/docs/en/agent-teams
확인일
2026-09-09 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기