AI 세션 5개 동시 운영, 관건은 격리였다

클로드 코드(Claude Code) 세션 다섯 개를 동시에 돌려 개발하는 팀이 그 운영법을 통째로 공개했다. 드레이퍼(Draper)의 공동창업자 겸 최고기술책임자 올리버 배긴은 8월 31일 글에서, 병렬 작업의 핵심은 모델이 아니라 각 세션에 완전히 분리된 환경을 주는 일이라고 정리했다. 브랜치만 나누는 것으로는 부족하다는 것이 요지다.

무슨 일인가 / 배경

깃 워크트리(git worktree)는 세션마다 별도의 체크아웃과 브랜치를 준다. 두 에이전트가 같은 파일을 고칠 일은 이것으로 사라진다. 문제는 그다음이다. 두 번째 세션이 개발 서버를 띄우는 순간 충돌이 시작된다. 이 팀의 모노레포는 채팅 앱, API, 노드 그래프 편집기, 워크플로 서버, CMS, 수집기까지 각기 다른 포트를 쓰는데 병렬 세션은 그 전부를 자기 몫으로 원한다.

여기서 두 가지 실패가 나온다. 하나는 포트 충돌로 그냥 죽는 경우다. 더 비싼 실패는 두 번째다 — 세션이 조용히 다른 세션의 서버에 붙어, 자기가 쓰지도 않은 코드를 대상으로 검증을 마쳤다고 보고하는 것이다. 에이전트가 틀린 게 아니라 에이전트가 보고 있는 세계가 틀렸다. 데이터베이스 하나를 공유하면 한쪽의 미완성 마이그레이션이 다른 쪽의 전제를 바꿔버리고, 환경변수 파일 하나를 공유하면 누군가의 임시 수정이 전원에게 상속된다.

핵심 짚어보기

해법은 워크트리가 코드를 나누고 도커(Docker)가 세계를 나누는 구조다. 개발 환경까지 전부 도커 컴포즈로 띄우되 서비스마다 프로필을 걸어 필요한 부분만 돌리고, 워크트리마다 컴포즈 프로젝트 이름을 다르게 줘서 컨테이너와 네트워크, 볼륨을 통째로 분리한다. 같은 설정 파일을 쓰지만 서로 남남인 스택이 만들어진다.

포트 문제는 아예 없애버렸다. 호스트 포트를 하나도 열지 않고 컨테이너마다 자동으로 붙는 도메인 이름으로 접속하는 방식이다. 서비스 이름과 프로젝트 이름이 주소에 함께 들어가므로 다섯 개 스택이 떠 있어도 주소가 겹치지 않고, 포트 목록을 관리할 일도 사라진다.

작업 흐름 쪽도 자동화돼 있다. 티켓은 슬랙(Slack)에서만 들어오고 에이전트가 이슈 관리 도구에 정리해 넣는다. 버그 제보는 해당 기능의 하위 이슈로 붙고 제보자의 멘션이 그대로 보존돼, 나중에 병합될 때 한 번에 닫히고 알림도 함께 나간다. 사람이 손대는 상태는 분류와 대기 두 개뿐이고 진행 중·스테이징·완료는 브랜치 푸시와 병합에 반응해 저절로 바뀐다 — 보드는 관리 대상이 아니라 깃의 읽기 전용 화면이 된다. 명령 한 줄이면 티켓 번호로 격리된 작업 공간이 생기고 초안 PR까지 열린다. 글쓴이는 이 도구 일체를 손으로 짠 게 아니라 에이전트에게 시켜 만들었다고 밝혔다.

1인기업 실전 적용 포인트

• 세션을 두 개 이상 돌릴 생각이면 워크트리부터 쓴다. 같은 폴더에서 두 개를 돌리는 순간 서로의 수정이 섞이고, 그 사고는 결과물만 봐서는 티가 잘 안 난다.
• 개발 서버를 띄우는 작업이면 컨테이너 이름부터 분리한다. 데이터베이스와 캐시를 공유한 채 병렬 실행하면 분명히 됐는데 안 되는 재현 불가 버그가 쌓인다.
• 에이전트가 확인을 마쳤다고 말한 대상이 무엇인지 되묻는 습관을 들인다. 어느 주소, 어느 데이터베이스에서 확인했는지 묻는 한 문장이 잘못된 검증을 걸러낸다.
• 상태 관리는 자동으로 넘긴다. 작업 시작·완료 표시를 손으로 옮기고 있다면 그 표시를 브랜치와 병합 이벤트에 연결하는 것만으로 하루에 몇 번씩 반복하던 정리 작업이 사라진다.

전망 / 주의점

이 구성은 개발 환경 전체가 컨테이너로 돌아간다는 전제 위에 서 있어서, 로컬에 직접 설치한 서비스로 개발하는 환경이라면 옮기는 비용이 작지 않다. 특정 컨테이너 도구의 도메인 기능에 의존하는 부분도 있어 운영체제에 따라 대체 수단을 찾아야 한다. 그리고 세션을 다섯 개로 늘리면 검토해야 할 PR도 다섯 배가 된다. 병렬화가 늘리는 것은 산출량이지 판단력이 아니라는 점에서, 사람이 감당할 수 있는 검토량이 실제 상한선이 된다.

출처: Draper (https://draper.chat/dev/the-ultimate-claude-code-parallelisation-guide-2026)