Claude Code로 12배 병렬 개발하기 - Worktree x Agents Team 실전기

📝 한줄 요약

Git Worktree 3개에서 각각 Claude Code Agents Team을 돌려, 혼자서 2주 걸릴 작업을 며칠 만에 끝내고 앱 배포 준비 완료했어요.

🎯 이런 분들께 도움돼요

• Claude Code를 쓰고 있지만 Agents Team은 아직 안 써본 개발자

• AI 코딩 도구의 속도를 극한까지 끌어올리고 싶은 분

• 사이드 프로젝트를 빠르게 완성하고 싶은 1인 개발자

😫 문제 상황 (Before)

저는 "Linear Capture"라는 macOS 앱을 만들고 있습니다. 화면을 캡처하면 AI가 분석해서 Linear 이슈를 자동으로 생성해주는 Electron 앱이에요.

초기에는 단순히 캡처해서 이슈 생성해주는 수준으로 구현을 했는데 - 여기에 더해서 Slack 대화, Notion 문서, Gmail까지 자동으로 검색해서 이슈에 맥락을 채워넣는 앱을 만드는 것으로 노선을 변경했어요.

이전 게시글들

문제는 그다음이었습니다. 앱이 돌아가긴 하는데 뭔가 좀 나사 빠진 느낌?

• 디자인이 일관성 없이 산만함 (디자인 시스템 없음)

• 검색 정확도가 떨어짐

• 온보딩에서 macOS 권한 버그

• 애널리틱스 이벤트가 제대로 안 올라옴

• HTML 파일 하나가 3,000줄짜리 모놀리스

이걸 하나하나 순서대로 고치면 2주는 걸릴 판이었습니다. Claude Code의 Agents Team과 Git Worktree를 조합하면 엄청나게 속도를 낼 수 있지 않을까 생각이 들었습니다.

🛠️ 사용한 도구

• Claude Code (CLI)

• 모델: Claude Opus / Sonnet

• 핵심 기능: Agents Team (팀 생성 + 병렬 에이전트), Git Worktree (병렬 브랜치 작업)

일단 완성된 결과물부터 보고 가시죠!

• 리니어 이슈로 만들고 싶은 화면을 단축키로 캡처 (이메일, 카톡 대화, 슬랙 메시지, 채널톡 등 모두 가능)

• 분석 시키면 바로 이슈 텍스트로 정리됨

• (옵션) 희망시 연동을 희망하는 슬랙/리니어/노션/지메일을 선택하면 - 해당 내용이 포함된 이슈 생성

🔧 작업 과정

12배 병렬의 구조 - Worktree x Agents Team

먼저 전체 그림을 설명하겠습니다.

Git Worktree로 3개 브랜치를 동시에 체크아웃합니다. 각 Worktree에서 독립된 터미널을 열고 Claude Code를 실행합니다. 그리고 각 Claude Code 세션 안에서 Agents Team을 구성해 에이전트 3~4명이 동시에 작업합니다.

Worktree 1 (디자인 시스템)             → Agents Team 4명 병렬
Worktree 2 (검색 정확도)              → Agents Team 4명 병렬
Worktree 3 (다국어 처리 하드코딩 개선)   → Agents Team 4명 병렬

3개 워크트리 x 4명 에이전트 = 약 12배 병렬. 혼자 순차적으로 하면 1x인데, 이걸 12x로 돌리는 겁니다.

"CTO팀 구성해서 시켜줘" - Agents Team이 일하는 방식

이렇게 말했더니 Claude Code가 진짜로 팀을 만들었습니다.

team-lead (CTO 역할): 전체 태스크 생성, 에이전트 간 의존성 설정, 최종 통합 검증

ipc-engineer: IPC 에러 처리 전담 — 4개 파일, 16개 핸들러에 try/catch 추가

test-engineer: 테스트 수정 전담 — 3개 테스트 파일 mock 업데이트

team-lead가 먼저 태스크를 쪼개고, 두 엔지니어에게 할당합니다. 핵심은 파일 단위로 태스크를 분리한다는 것입니다. ipc-engineer는 핸들러 파일만, test-engineer는 테스트 파일만 건드리니까 충돌이 안 납니다.

두 에이전트가 동시에 작업하고, 둘 다 완료되면 team-lead가 빌드와 테스트를 한 번 돌려서 통합 검증합니다.

결과:

• IPC 에러 처리: 45% → 81% (39/48 핸들러)

• 테스트: 148/162 (91%) → 160/160 (100%)

사람 팀장이 주니어 개발자 2명에게 일을 나눠주고, 완료되면 코드 리뷰하고 머지하는 것과 똑같은 흐름이었습니다.

35분 만에 디자인 시스템 전체 리빌드

디자인 시스템이 아예 없는 상태에서 시작했습니다. CSS 파일마다 하드코딩된 색상, 제각각인 간격, 모놀리스 구조.

디자인 시스템 토큰부터 시작해서 전체 CSS를 체계적으로 정리해줘

이 한 마디에 Claude Code가 6단계 계획을 세우고, 35분 만에 전부 실행했습니다.

• 10:34 Cycle 1 — 디자인 토큰 파일 193줄 생성, Inter 폰트, CSS reset

• 10:47 Cycle 2 — 기존 CSS 6개 파일, 900줄의 하드코딩 값을 토큰으로 일괄 교체

• 10:57 Cycle 3 — 모놀리스 CSS를 components / features / pages로 구조 분리

• 11:06 Cycle 4 — 모든 spacing을 8px 그리드 토큰으로 정규화

• 11:07 Cycle 5 — Focus ring, hover 트랜지션 추가

• 11:09 Cycle 6 — HTML inline style을 CSS 클래스로 이동

10:34에 시작해서 11:09에 끝. 혼자 손으로 했으면 하루 이상 걸렸을 CSS 아키텍처 리빌드를 35분에 끝낸 겁니다.

작업 타임라인

02/08 - Worktree 3개 풀가동

• 디자인 시스템 35분 만에 6 Cycle 완성

• Settings 페이지 성능 최적화 (Notion 로드 프리징 해결)

• 45개 하드코딩 문자열 → i18n 전환

• Manual Context Search 탭 추가

• Linear API 키 저장 276회 → 1회 쿼리로 최적화

02/09 - 버그 사냥 + 고도화

• 검색 파이프라인 7가지 수정 + 18개 테스트 추가

• macOS TCC 권한 리셋 자동화

• 온보딩 윈도우 버그 2건 수정

• 애널리틱스 이벤트 전수 검증 (4개 버그 수정 + 3개 신규 이벤트)

• Related Context 소스별 리치 스니펫 + LLM 요약 기능

• 메인 윈도우 리사이즈 + bounds persistence

유일한 병목 - Electron 빌드 테스트

완벽하진 않았습니다. Electron 앱은 macOS에서 같은 Bundle ID를 가진 앱은 1개만 실행할 수 있습니다. Worktree 3개에서 각각 빌드해도 동시에 테스트할 수가 없었어요.

Bundle ID를 분리하면 해결할 수 있지만 번거로워서, 결국 빌드 테스트는 순차로 돌렸습니다. 코드 작업은 12배 병렬인데, 테스트 확인은 하나씩. 그래도 빌드 대기 시간에 다른 Worktree 작업을 확인할 수 있으니 시간 낭비는 최소화했습니다.

✅ 결과 (After)

Before vs After

💬 이 과정에서 배운 AI 활용 팁

효과적이었던 것

1. Git Worktree + Agents Team = 곱셈 효과

이 조합이 핵심입니다. Worktree로 기능 단위를 분리하고, Agents Team으로 작업 단위를 분리하면 효과가 곱해집니다.

• Worktree: "디자인 시스템" / "검색 개선" / "버그 수정" 으로 기능 분리

• Agents Team: 각 기능 안에서 "파일 A 수정" / "파일 B 수정" / "테스트 작성" 으로 작업 분리

혼자 순차로 하면 1x, Worktree만 쓰면 3x, 거기에 Agents Team까지 붙이면 12x입니다.

2. 에이전트 태스크는 파일 단위로 나눠라

Agents Team에서 가장 중요한 건 같은 파일을 동시에 수정하지 않는 것입니다. ipc-engineer는 핸들러 파일만, test-engineer는 테스트 파일만 건드리도록 명확하게 분리해야 충돌이 안 납니다.

3. 병렬 작업 후 통합 검증은 반드시 순차로

12명이 동시에 일해도, 마지막에 team-lead가 빌드 + 테스트를 한 번 돌리는 건 꼭 필요합니다. 이 과정을 생략하면 각자 "내 파트는 됩니다"인데 합치면 안 되는 상황이 생깁니다.

🚀 앞으로의 계획

지금은 팀원들에게 앱을 공유하고 피드백을 수집하는 단계입니다. 버그나 UX 개선점이 나오면 수정하고, 안정화되면 Reddit에 홍보글을 올려 외부 사용자도 확보할 예정입니다.