Claude Code Merge Queue
병렬 에이전트의 병합을 순서대로 세우는 지역 대기열
npm install --save-dev claude-code-merge-queue여러 에이전트가 동시에 반영하고 빌드하고 시험하면 밀어넣기 경쟁과 중복 빌드, 공용 자원 때문에 시험이 불안정해집니다. 이 도구가 그 과정을 한 줄로 세웁니다. 설정은 파일 하나에 모여 있어 차선 이름과 워크트리 접미사, 차선별 포트, 통합 브랜치, 보호 브랜치, 심볼릭 링크 대상, 빌드 산출 폴더, 통과 기준 명령을 정합니다. 잘못된 설정은 명령을 부르는 순간 문제를 전부 나열하며 실패합니다. 세 단계 뒤에 알 수 없는 오류로 나타나지 않습니다. 깃허브의 같은 기능과 달리 어떤 요금제에서도 쓸 수 있고 자기 컴퓨터에서 돌아 비용이 들지 않으며 풀 리퀘스트도 필요 없습니다.
판단
이럴 때 씁니다
- 여러 에이전트가 같은 저장소에 동시에 반영할 때
- 무거운 빌드가 겹쳐 자원을 낭비할 때
- 공용 자원 때문에 시험이 불안정할 때
이럴 땐 쓰지 마세요
- 혼자 순서대로 작업하면 필요 없습니다
- 원격 CI 를 대체하지 않습니다
- 차선 수만큼 워크트리와 포트를 씁니다
차별점
- 어떤 요금제와 저장소에서도 쓸 수 있습니다.
- 자기 컴퓨터에서 돌아 반영당 비용이 없습니다.
- 풀 리퀘스트 없이 직접 리베이스하고 밀어넣습니다.
- 기계 전체에서 빌드를 하나로 직렬화하는 잠금을 제공합니다.
워크플로
- 01개발 의존성으로 깝니다.
- 02초기화 명령으로 설정 파일을 만듭니다.
- 03차선 접두사와 포트, 통합 브랜치를 정합니다.
- 04통과 기준 명령을 지정합니다.
- 05에이전트가 차선에서 작업하고 순서대로 반영하게 둡니다.
주요 명령
| 명령 | 설명 |
|---|---|
npm install --save-dev claude-code-merge-queue | 개발 의존성으로 설치합니다. |
npx claude-code-merge-queue init | 설정 파일을 만듭니다. |
claude-code-merge-queue build-lock -- <cmd> | 빌드를 기계 전체에서 한 번에 하나만 돌게 합니다. |
함정
설치 전에 확인하세요
- 잘못된 설정은 명령을 부르는 즉시 문제를 전부 나열하며 실패합니다. 조용히 지나가지 않습니다.
- 차선마다 포트를 기준값에 번호를 더해 씁니다. 다른 서비스와 겹치면 충돌합니다.
- 다시 만들 수 있는 파일 목록을 지정하지 않으면 리베이스가 막힐 수 있습니다.
- 원격 지속 통합을 대신하지 않습니다. 지역에서 순서를 세우는 도구입니다.
비교
호스팅 서비스의 병합 대기열은 비공개 저장소에서 상위 요금제를 요구하고 시도할 때마다 실행 시간이 청구됩니다. 이쪽은 같은 개념을 지역에서 돌립니다. 대신 원격 검증은 여전히 따로 필요합니다.
최근 변경
0.7.1 판은 릴리스 본문에 변경 요약 없이 전체 변경 목록 링크만 걸어 두었습니다. 실제 내용은 커밋 비교로 확인해야 합니다.