본문으로 건너뛰기
Vibe Console

Mac에서 AI 코딩 에이전트 팀 운영하기

에이전트 팀은 Claude Code, Codex, Gemini CLI 등 에이전트 CLI를 작은 개발팀으로 만들어요. 매니저가 계획하고 엔지니어가 만들고 QA가 검증해요.

Nes

Nes

@nesdesignco

· 업데이트 · 5분 분량

AI 코딩 에이전트 조직도: Claude Code 매니저 아래 Codex 테크 리드와 Gemini CLI 디자이너, 그 아래 Claude Code, Grok Build, Qwen Code

에이전트 여러 개를 병렬로 돌리는 것도 잘 통해요. 하지만 그러면 내가 프로젝트 매니저가 돼요. 일을 나누고, 터미널마다 프롬프트를 쓰고, 누가 끝났는지 확인하고, 전부 직접 리뷰해야 하죠. Vibe Console의 에이전트 팀은 그 일을 에이전트에게 넘겨요.

나는 매니저 한 명과만 대화해요. 매니저가 계획하고, 일을 나눠 주고, 리뷰해요. 나머지 팀원은 백그라운드에서 일하고, 나는 그 전체를 실시간 조직도로 지켜봐요.

에이전트 팀이란?

팀은 프로젝트별로 만드는 에이전트 CLI 조직도예요. 카드 하나가 팀원 한 명이고, 각자 역할, 에이전트, 모델을 가져요.

  • 매니저: 내가 대화하는 유일한 팀원이에요. 요청을 브리프로 정리하고, 작업으로 나눠서 배분해요.
  • 테크 리드: 큰 작업을 맡아 아래 팀원들에게 나눠 주고 그 결과를 리뷰해요.
  • 엔지니어: 맡은 작업이 요구하는 변경을 구현해요.
  • 디자이너: 기존 디자인과 어울리게 인터페이스와 문구를 만들어요.
  • QA: 테스트를 돌리고, 바뀐 동작을 직접 써 보고, 빠진 테스트를 작성하고, 실패한 걸 보고해요.
  • 보안, DevOps, 연구원: 보안 문제를 검토하거나, 빌드와 CI를 맡거나, 질문을 조사해 보고해요.

모든 자리에 Vibe Console에서 팀에 참여할 수 있는 에이전트 9종 중 아무거나 앉힐 수 있어요. Claude Code, Codex, Gemini CLI, Grok Build, GitHub Copilot CLI, Cursor CLI, Qwen Code, OpenCode, Kiro CLI요. 그래서 Claude Code가 매니저를 맡고, Codex가 백엔드를, Gemini CLI가 UI를, Grok Build가 테스트를 쓰는 식으로 구성할 수 있어요. 팀원마다 모델도 따로 골라요.

요청은 팀 안에서 어떻게 흘러가나요?

  1. 매니저에게 요청해요. 단순한 질문엔 단순하게 답해요. 변경 요청이면 먼저 브리프를 써요.
  2. 매니저가 브리프를 써요. 프로젝트를 살펴보고, 목표, 관련 파일, 완료 기준, 범위 밖의 것을 담아 요청을 다시 써요. 나는 고를 수 있어요. 브리프대로 가거나, 내 버전을 직접 쓰거나, 원래 요청을 그대로 보내거나요.
  3. 일이 작업으로 나뉘어요. 매니저가 공유 보드에 작업을 만들고, 역할이 맞는 팀원에게 하나씩 배정해요. 테크 리드는 자기 작업을 엔지니어와 QA에게 더 잘게 나눌 수 있어요.
  4. 팀원들은 백그라운드에서 일해요. 팀원마다 자기 터미널이 있고, 소통은 보드로만 해요. 작업을 제출하거나, 다른 작업에 코멘트를 달거나, 질문을 하죠. 나와 대화하는 건 매니저뿐이에요.
  5. 일을 맡긴 사람이 리뷰해요. 자기 작업을 스스로 승인하는 사람은 없어요. 리뷰어는 변경을 요청하며 작업을 되돌려보낼 수 있어요.
  6. 결과는 내가 리뷰해요. 보드가 다 끝나면 매니저가 팀이 한 일과 남은 일을 알려줘요.

조직도에서는 바쁜 에이전트의 카드 테두리를 따라 빛이 돌고, 작업이 담당자에게 내려갔다가 리뷰를 위해 다시 올라올 때 카드 사이 선이 움직여요. 조직도 옆의 작업 목록에는 모든 작업이 할당됨, 검토 중, 완료 상태로 표시돼요.

프로젝트 폴더에서 바로 일해요

팀은 별도의 복사본이 아니라 내 프로젝트 폴더에서 직접 일해요.

  • 수정은 바로 반영돼요. 팀원들이 프로젝트 파일을 직접 고치니, 작업 중인 변경을 에디터와 소스 제어에서 그대로 따라갈 수 있어요.
  • 멋대로 커밋하지 않아요. 내가 요청하지 않는 한 팀원들은 커밋, 푸시, 병합, 브랜치 전환을 하지 않아요. 무엇을 커밋할지는 여전히 내가 정해요.
  • 모든 작업은 검토를 거쳐요. 작업을 맡긴 쪽이 완료 처리 전에 검토하고, 누구도 자기 작업을 스스로 승인하지 않아요.
  • 팀 중지는 터미널을 닫지만 매니저와의 대화와 작업은 다음을 위해 남겨 둬요.

시작하기 좋은 프리셋

조직도를 직접 만들 필요는 없어요. 프리셋을 고르고 수정하면 돼요.

프리셋 구성
소규모 팀 매니저, 엔지니어, QA
엔지니어링 팀 매니저, 테크 리드, 엔지니어 2명, QA, 디자이너
코딩 매니저, 엔지니어 2명, QA
버그 리뷰 매니저, QA 2명, 엔지니어
보안 검토 매니저, 보안 검토자 2명, 엔지니어
리서치 매니저, 연구원 2명
디자인 매니저, 디자이너, 엔지니어, QA
DevOps 매니저, DevOps, 엔지니어, QA

그다음 카드를 클릭해 역할, 에이전트, 모델, 보고 대상을 바꾸면 돼요.

왜 한 팀에 여러 에이전트를 섞나요?

에이전트마다 잘하는 게 다르고, 코드를 쓴 에이전트보다 다른 에이전트가 더 좋은 리뷰어예요. 팀을 쓰면 이게 애써 지켜야 하는 습관이 아니라 기본값이 돼요.

  • 코드를 쓰지 않은 리뷰어가 실수를 더 많이 잡아요. 각자 어디서 빛나는지는 Codex vs Claude Code를 참고하세요.
  • 일을 여러 제공자에 나누면 사용량 한도도 나눠 쓰게 돼요.
  • 팀원마다 역할에 맞는 모델을 줄 수 있어요. 매니저와 테크 리드엔 큰 모델, 테스트엔 빠른 모델처럼요.

Vibe Console에서 팀 시작하기

  1. 프로젝트를 열고 ⌘⇧E를 누르거나 툴바의 팀 버튼을 눌러요.
  2. 프리셋을 고르고 조직도를 조정해요.
  3. 팀 시작을 누르고 매니저의 터미널에 요청을 써요.
  4. 조직도를 지켜보다가, 일이 끝나면 소스 제어에서 변경 사항을 검토해요.

에이전트 CLI와 계정은 내 것을 가져와요. Vibe Console은 그걸 실행하고, 보드를 관리하고, 모두가 뭘 하는지 보여줘요.

자주 묻는 질문

모든 에이전트와 대화해야 하나요?

아니요. 매니저와만 대화해요. 다른 팀원은 백그라운드에서 일하고 작업 보드로 조율해요. 그래도 카드에서 아무 팀원의 터미널이나 열어 일하는 모습을 볼 수 있어요.

어떤 에이전트를 팀에 넣을 수 있나요?

다음 9종이에요. Claude Code, Codex, Gemini CLI, Grok Build, GitHub Copilot CLI, Cursor CLI, Qwen Code, OpenCode, Kiro CLI. Kimi Code, Command Code, Devin CLI는 Vibe Console 터미널에서는 돌아가지만 팀에는 들어갈 수 없어요. 팀원마다 자기 에이전트와 모델을 가져요.

팀이 내 커밋 안 한 작업을 덮어쓰나요?

같은 파일을 건드릴 수는 있어요. 팀은 나와 같은 폴더에서 일하니, 따로 두고 싶은 작업은 시작 전에 커밋하거나 stash해 두세요. 팀원들은 고치기 전에 파일을 다시 읽고 다른 사람의 변경을 지키도록 지시받으며, 내가 요청하지 않는 한 아무것도 커밋되지 않아요.

추가 비용이 드나요?

아니요. 에이전트 팀은 체험판과 구독 모두에 포함된 Vibe Console 기능이에요. 에이전트는 내 계정과 구독으로 돌아가니, 팀원마다 해당 제공자의 한도를 써요.

에이전트에게 창 하나를 주세요.

Mac에서 14일 동안 무료로 써 보세요. 이후 월 $4.99 또는 연 $39.99.