클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

에이전트 팀 (Agent Teams)

여러 개의 Claude Code 세션을 리드 + 팀원 구조로 묶어 같은 저장소에서 병렬 작업하게 만드는 협업 가이드.

자동화·워크플로고급★ 2,767⑂ 269AI 점수 8/10마지막 업데이트: 2026. 8. 3.

무엇을 해주나

실험 기능인 에이전트 팀 모드를 실무에서 쓰는 방법을 정리한 스킬입니다.

  • 첫 세션이 팀 리드, 이후 세션이 팀원으로 합류하는 구조와 활성화 방법(CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1)
  • 공유 작업 목록, 메일박스 메시징, 파일 락 클레임으로 충돌 없이 동시 편집
  • 팀 규모 선택 기준(2명 / 3~5명 / 5명 초과는 비추천), 팀원당 5~6개 작업이라는 작업 단위 기준
  • 좋은 작업 분해 vs 나쁜 작업 분해 예시, 의존성 선언, 계획 승인 절차
  • Shift+Tab 위임 모드, Shift+Down 팀원 순회, tmux/iTerm2 분할 화면 팁
  • TeammateIdle / TaskCreated / TaskCompleted 훅 활용
  • 팀 vs 서브에이전트 vs 워크트리 vs /batch 선택표와 안티패턴 목록

이런 분께 추천

  • 여러 터미널에서 Claude Code를 동시에 돌려보고 싶은 중·고급 사용자
  • API·UI·테스트처럼 레이어가 나뉜 기능을 한 번에 밀어붙이고 싶은 팀
  • 서브에이전트만으로는 컨텍스트가 부족해 병렬화가 잘 안 되던 개발자

활용 예시

  1. 레이트 리미팅 기능: 미들웨어 / Redis 설정 / 테스트 / API 문서 4개 작업으로 쪼개 팀원 2명에게 배분하고, 미들웨어 완료 시 나머지 작업이 자동 해제되도록 의존성 설정.
  2. 2인 팀 리뷰 루프: 한 세션은 구현, 다른 세션은 리뷰 전담으로 두고 리드가 계획 승인만 담당.
  3. 선택 판단: "경쟁하는 두 가지 구현안을 비교"는 팀이 아니라 워크트리, "20개 이상 파일 일괄 수정"은 /batch로 라우팅.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 rohitg00/pro-workflow 의 skills/agent-teams 폴더를 내 ~/.claude/skills/agent-teams/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/rohitg00/pro-workflow.git && mkdir -p ~/.claude/skills && cp -r pro-workflow/skills/agent-teams ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 저장소를 내려받습니다: git clone https://github.com/rohitg00/pro-workflow.git
  2. 스킬 폴더가 없다면 만듭니다: mkdir -p ~/.claude/skills
  3. 스킬을 복사합니다: cp -r pro-workflow/skills/agent-teams ~/.claude/skills/
  4. 실험 기능을 켠 뒤 Claude Code를 실행합니다: export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 → claude
  5. 같은 저장소에서 터미널(또는 tmux 창)을 추가로 열어 claude를 다시 실행하면 팀원으로 합류합니다.
  6. 리드 세션에서 "agent-teams 스킬대로 작업을 4개로 쪼개 배분해줘"처럼 요청해 동작을 확인합니다.

※ 실험 플래그가 없는 버전에서는 팀 기능이 동작하지 않으니 Claude Code를 최신으로 업데이트하세요.

GitHub에서 원본 보기 ↗