Claude Code 상세 사용법 43: 병렬 에이전트 표면 고르기 | DAKER 커뮤니티

Claude Code 상세 사용법 43: 병렬 에이전트 표면 고르기

Claude Code에서 “여러 에이전트로 돌려줘”는 하나의 기능명이 아닙니다. 공식 문서 기준으로 선택지는 subagents, agent view, agent teams, dynamic workflows, worktrees가 나뉩니다. 잘 고르면 AI 코딩 속도가 빨라지고, 잘못 고르면 토큰만 쓰고 같은 파일 충돌을 만듭니다.

한눈에 고르는 기준

공식 docs는 병렬 작업이 토큰 사용량을 곱한다고 경고합니다. 그래서 첫 질문은 “병렬이면 빠른가?”가 아니라 “각 작업자가 독립적으로 진전할 수 있는가?”입니다.

Subagents: 현재 대화의 보조 전문가

Subagent는 별도 컨텍스트에서 탐색, 리뷰, 요약 같은 보조 작업을 처리하고 결과만 돌려줍니다. 검색 로그가 긴 작업, 반복되는 코드 리뷰 역할, 읽기 전용 조사에 적합합니다.

Use a read-only subagent to inspect auth-related files and return only:
1. the relevant files,
2. likely regression point,
3. tests that should cover it.
Do not edit files.

/agents 패널에서 사용자 수준 또는 프로젝트 수준 custom subagent를 만들 수 있습니다. 설명을 명확히 써야 Claude가 언제 위임할지 판단합니다.

Agent view: 내가 여러 세션을 맡길 때

claude agents는 백그라운드 세션을 한 화면에서 보고, 필요한 세션에 들어가 개입하는 표면입니다. 서로 독립적인 이슈 3개를 맡기거나, 각자 다른 worktree에서 실험하게 할 때 맞습니다. 사람이 작업 큐를 들고 있고 Claude가 각 세션에서 실행합니다.

Agent teams: 팀 리드가 조율할 때

Agent teams는 실험적 기능이며 기본 비활성화입니다. 문서 기준으로 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 설정이 필요하고, Claude Code v2.1.32 이상이 필요합니다. lead 세션이 task list를 관리하고 teammate들이 서로 메시지를 주고받습니다.

좋은 후보는 프론트엔드, 백엔드, 테스트처럼 소유 파일이 분리되는 큰 기능입니다. 나쁜 후보는 한 파일을 순서대로 고쳐야 하는 리팩터링입니다. 팀은 조율 비용이 있으므로 2~4명부터 시작하세요.

Worktrees는 보험이다

병렬 agentic coding에서 가장 실용적인 도구는 worktree입니다. 독립 checkout을 주면 각 세션이 같은 브랜치를 망가뜨리지 않습니다. 다만 agent teams는 teammate별 worktree 격리가 기본이 아니므로 파일 소유권을 더 엄격히 나눠야 합니다.

선임 엔지니어 관점

병렬화는 “더 많은 Claude”가 아니라 “명확한 작업 분할”입니다. 읽기 많은 조사는 subagent, 독립 티켓은 agent view, 상호 조율이 필요한 큰 일은 agent teams, 대량 감사나 마이그레이션은 dynamic workflow를 고르세요. 그리고 어떤 선택이든 파일 소유권, 검증 명령, 병합 기준을 먼저 적으세요. 그 세 가지가 없으면 병렬 AI 코딩은 생산성이 아니라 충돌을 키웁니다.

참고: Claude Code 공식 문서의 Agents overview, Subagents, Agent teams 문서를 기준으로 작성했습니다.