에이전트 하나도 쓸모 있어요. 하지만 첫 번째 에이전트의 diff를 리뷰하는 동안 에이전트 셋이 각자 다른 작업을 하고 있을 때, 터미널 에이전트의 진가가 나와요. 동시에 금방 꼬이기도 해요. 두 에이전트가 같은 파일을 고치거나, 개발 서버끼리 포트를 두고 싸우거나, 오후 중간에 사용량 한도에 걸리는 식이죠.
이 가이드는 그런 문제를 피하는 구성을 다뤄요. 작업 나누기와 리뷰까지 에이전트에게 맡기고 싶다면 AI 코딩 에이전트 팀 운영하기를 보세요. Claude Code, Codex, Gemini CLI는 물론 다른 에이전트 CLI에서도 똑같이 통해요.
요약하면
- 에이전트마다 각자의 작업을, 코드를 바꾸는 작업이라면 각자의 작업 사본(git worktree)을 주세요.
- 한 프로젝트의 에이전트는 격자 하나에 모두 보이게 두세요. 그래야 누가 나를 부르는지 알아챌 수 있어요.
- 같은 코드에서는 두 번째 에이전트를 리뷰어로 쓰세요. 두 번째 작성자가 아니라요.
- 사용량 한도를 지켜보세요. 병렬 에이전트는 한도도 병렬로 써요.
1단계: 서로 독립적인 작업으로 나누기
병렬 에이전트는 작업끼리 같은 파일을 건드리지 않을 때 잘 돌아가요. 좋은 분할 예시는 이래요.
- 한 영역의 기능 개발과 다른 영역의 버그 수정
- 변경 구현과 기존 코드의 테스트 작성
- 한 에이전트는 코딩, 다른 에이전트는 문서나 마이그레이션 계획 작성
- 아무것도 바꾸지 않는 리서치나 코드 읽기
나쁜 분할은 두 에이전트가 같은 컴포넌트를 맡거나, 한 에이전트가 리팩터링하는 코드를 다른 에이전트가 확장하는 경우예요. 작업별로 건드릴 파일을 겹치지 않게 설명할 수 없다면, 차라리 하나씩 순서대로 돌리세요.
2단계: 코딩 에이전트마다 worktree 주기
같은 폴더의 두 에이전트는 작업 트리 하나를 공유해요. 둘 다 수정하면 반쯤 적용된 변경, 뜻밖의 충돌, 누가 만든 건지 알 수 없는 diff가 생겨요. 해결책은 작업마다 git worktree를 두는 거예요. 같은 저장소를 별도 폴더, 별도 브랜치로 하나 더 체크아웃한 것이죠.
git worktree add ../atlas-auth -b feat/auth
git worktree add ../atlas-search -b feat/search그러면 에이전트마다 자기 폴더에서 돌고, 끝나면 브랜치를 머지하면 돼요. Claude Code는 claude --worktree feature-auth로 이걸 한 번에 할 수도 있어요. 의존성, .env 파일, 정리 방법까지 포함한 자세한 내용은 Claude Code와 Codex를 위한 git worktree 가이드에 있어요.
읽기만 하는 에이전트(리뷰, 리서치, 문서 질문)는 메인 폴더를 같이 써도 괜찮아요.
3단계: 모든 에이전트를 한 화면에
병렬 에이전트가 실패하는 흔한 이유는 코드가 아니라 주의력이에요. 백그라운드 탭에서 에이전트가 권한을 묻고 20분 동안 기다리는 거죠.
Vibe Console에서는 프로젝트마다 터미널을 최대 10개까지 탭이나 1×2부터 3×3 격자로 볼 수 있어요. 에이전트 셋에게 잘 맞는 배치는 이래요.
| 칸 | 실행 |
|---|---|
| 1 | ../atlas-auth의 Claude Code |
| 2 | ../atlas-search의 Codex |
| 3 | 메인 폴더의 Claude Code, 리뷰 담당 |
| 4 | 개발 서버 |
터미널마다 다른 에이전트를 돌릴 수 있어요. 시작 버튼 옆에서 하나를 고르고 ⌘K를 누르세요. worktree 안에서 에이전트를 시작하려면 먼저 cd로 들어가세요. 소스 제어 패널에서 worktree를 터미널로 드래그하면 경로가 붙여넣어져요. 터미널 이름을 작업 이름으로 바꿔 두면(이름 변경…) 격자가 할 일 목록처럼 읽혀요.
탭마다 에이전트가 실행 중인지 쉬는 중인지 점으로 보여줘요. 에이전트가 끝나거나 내 입력을 기다리며 멈추면 소리가 나고 노치가 열리며 해당 세션을 보여주니, 화면에서 눈을 떼도 돼요. 자세한 내용과 hook을 쓰는 무료 대안은 Mac에서 Claude Code 알림 받기를 참고하세요.
4단계: 두 번째 에이전트를 리뷰어로
모델마다 잡아내는 실수가 달라요. 저렴하면서 효과 좋은 패턴은 이래요.
- Claude Code가 자기 worktree에서 변경을 구현해요.
- 끝나면 같은 폴더에서 Codex(또는 다른 Claude Code 세션)를 저장된 리뷰 프롬프트로 시작해요. 예를 들면 이렇게요: "커밋되지 않은 diff에서 버그, 빠진 테스트, 보안 문제를 검토해 줘. 파일은 수정하지 말고, 파일과 줄 번호와 함께 발견한 점을 나열해 줘."
- 발견한 내용을 첫 번째 에이전트에게 다시 붙여넣어요.
리뷰 프롬프트는 저장된 프롬프트(⌘⇧S)에 한 번 저장해 두면 어느 터미널에서든 클릭 한 번으로 붙여넣을 수 있어요.
5단계: 사용량 한도 지켜보기
Claude Code와 Codex 요금제는 사용량을 윈도우 단위로 재요. 5시간 롤링 윈도우와 주간 한도가 있죠. 에이전트 셋이면 대략 세 배 빨리 쓰고, 작업 도중 한도에 걸리면 일이 반쯤 끝난 채로 남아요.
Vibe Console은 노치와 터미널 툴바에 Claude Code와 Codex 사용량 링을 리셋 시간과 함께 보여주고, 80%와 100%에서 알려줘요. 윈도우가 어떻게 동작하고 어떻게 계획하면 되는지는 Claude Code 사용량 한도 가이드에서 설명해요.
6단계: 머지하고 정리하기
작업이 끝나면 이렇게 하세요.
- 브랜치 diff를 리뷰해요(소스 제어, ⌘⇧G).
- 그 worktree에서 테스트를 돌려요.
- 브랜치를 머지하고 worktree를 지워요(소스 제어의 Worktree 제거, 또는
git worktree remove ../atlas-auth).
에이전트는 몇 개까지가 적당할까?
대부분은 코딩 에이전트 두세 개에 리뷰어 하나가 쓸모 있는 최대치예요. 그 이상이면 병목은 에이전트가 아니라 리뷰가 돼요. 에이전트를 더 늘리는 건 테스트가 잘 갖춰진, 독립적이고 명확한 작업일 때만 하세요.
자주 묻는 질문
한 프로젝트에서 Claude Code와 Codex를 동시에 돌릴 수 있나요?
네. 둘 다 코드를 바꾼다면 각자 worktree를 주고, 아니면 한쪽을 읽기 전용 리뷰어로 두세요.
병렬 Claude Code 세션끼리 컨텍스트를 공유하나요?
아니요. 세션마다 대화가 따로예요. CLAUDE.md, AGENTS.md, 프로젝트 노트처럼 에이전트가 읽는 파일로 결정 사항을 공유하세요.
에이전트를 병렬로 돌리면 비용이 더 드나요?
에이전트마다 따로 사용량을 쓰니 요금제 한도는 더 빨리 줄어요. 전체 작업량은 비슷하고, 더 짧은 시간에 끝날 뿐이에요.
직접 해 볼까요? Vibe Console 다운로드하고 14일 동안 무료로 써 보세요.