🚀 Claude CoWork 멀티 에이전트 완벽 가이드: 나만의 AI 개발 팀 만들기

최근 AI 코딩 도구의 트렌드는 단순히 코드를 한 줄 짜주는 것을 넘어, 스스로 계획을 세우고 실행하는 ‘에이전틱 워크플로우(Agentic Workflow)’로 진화하고 있습니다. 그 중심에 있는 Claude CoWork의 핵심 기능, 멀티 에이전트(Agent Teams) 구축 방법을 상세히 소개합니다.

이제 혼자 코딩하지 마세요. 여러 명의 Claude 에이전트에게 역할을 맡기고 협업하는 시대를 경험해 보세요!

다음 게시물도 한번 읽어보세요!

Contents

1. 멀티 에이전트(Agent Teams)란 무엇인가요?

기존의 AI 어시스턴트가 한 명의 비서였다면, 멀티 에이전트는 각기 다른 전문성을 가진 개발 팀과 같습니다. 사용자가 복잡한 요구사항을 던지면, 메인 에이전트가 이를 분석해 여러 개의 하위 작업으로 나누고, 각각의 서브 에이전트들에게 업무를 할당하여 병렬로 작업을 처리합니다.

2. 시작하기 전: 실험적 기능 활성화하기

현재 Claude CoWork의 멀티 에이전트 기능은 실험적(Experimental) 단계인 경우가 많습니다. 기능을 사용하려면 먼저 설정을 확인해야 합니다.

2026년 2월 출시된 Claude Opus 4.6과 Claude Code v2.1.32 이상 버전에서는 여러 에이전트를 동시에 가동하는 ‘Agent Teams’ 기능을 지원합니다.

설정 파일 수정: ~/.claude/settings.json 파일을 열어 에이전트 팀 기능을 활성화합니다.

JSON

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

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

3. 실제 멀티 에이전트 팀 구축 단계

Step 1: 자연어로 팀 구성 요청하기

따로 복잡한 코드를 짤 필요가 없습니다. Claude에게 대화하듯 팀 구성을 요청하세요.

Prompt 예시 1:

“새로운 사용자 로그인 기능을 구현해야 해. 3명의 에이전트 팀을 구성해줘. 에이전트 1은 DB 스키마를, 에이전트 2는 API 엔드포인트를, 에이전트 3은 프론트엔드 검증 로직을 담당하게 해줘.”

Prompt 예시 2:

“아래 매니페스트에 따라 3인 에이전트 팀을 구성해줘.
Agent 1 (Architect): src/core 구조 설계 및 전체 인터페이스(Interface) 정의 전담.
Agent 2 (Feature Dev): src/features 내 비즈니스 로직 구현. Agent 1의 인터페이스를 절대 수정하지 말 것.
Agent 3 (QA/Tester): 모든 PR에 대해 vitest 기반 테스트 코드 작성 및 검증.”

Step 2: 업무 할당과 자율적 실행

팀이 구성되면 Claude는 스스로 워크플로우를 설계합니다.

파일 분석: 각 에이전트가 프로젝트 구조를 파악합니다.
병렬 작업: 에이전트들이 각자의 영역(폴더)에서 동시에 코드를 작성합니다.
상호 소통: API 에이전트가 바뀐 사양을 프론트엔드 에이전트에게 공유하며 인터페이스를 맞춥니다.

Step 3: 실시간 모니터링 및 전환

에이전트들이 일하는 모습은 터미널에서 실시간으로 확인할 수 있습니다.

전환 키: Shift + Down 화살표를 누르면 현재 활발히 움직이는 에이전트 사이를 오가며 작업 내용을 볼 수 있습니다.
Tmux 활용: 더욱 전문적인 모니터링을 원한다면 claude --teammate-mode tmux 명령어를 사용해 화면을 분할하여 여러 에이전트의 터미널을 동시에 띄울 수 있습니다.

4. 멀티 에이전트 활용 꿀팁 💡

/plan 명령어를 먼저 쓰세요: 바로 코딩을 시작하게 하기보다, /plan을 통해 전체적인 협업 전략을 먼저 세우게 하면 충돌(Conflict)이 현저히 줄어듭니다.
/agents 명령어로 상태 확인: 현재 몇 명의 에이전트가 생성되어 어떤 상태인지 궁금할 땐 /agents를 입력해 보세요.
명확한 역할 부여: “에이전트 1은 보안 전문가로서 코드 리뷰를 담당해”와 같이 페르소나를 부여하면 더 꼼꼼한 결과를 얻을 수 있습니다.

5. 결론: AI 어시스턴트에서 AI 팀으로

Claude CoWork의 멀티 에이전트 기능은 단순한 편의 기능을 넘어, 혼자서는 며칠이 걸릴 대규모 리팩토링이나 기능 구현을 단 몇 분 만에 끝낼 수 있게 해줍니다.

이제 여러분의 프로젝트에 ‘Claude 개발 팀’을 초대해 보세요. 생산성의 차원이 달라질 것입니다!

참고: 이 가이드는 SWArchitect의 Claude CoWork 에이전틱 워크플로우 설계를 바탕으로 작성되었습니다.

sw architect