Claude Code 세션 하나를 관찰하는 것은 쉽습니다. 작업을 부여하고, 그것이 무엇을 하는지 읽고, 다음 단계를 승인하기만 하면 됩니다. 하지만 5개 세션부터는 문제가 발생합니다. 어떤 터미널이 자신을 기다리고 있는지 놓치게 되고, 두 에이전트가 같은 파일을 수정하며, 하나는 사용량 제한에 도달하면 조용히 멈춰버립니다.
저희는 자체 코드베이스에서 한 번에 약 30개의 에이전트를 실행합니다. 여기에 도달하기 위해 저희가 변경한 사항은 다음과 같습니다.
1. 모든 에이전트에게 전용 영역을 부여하세요
각 세션에는 코드베이스의 특정 영역과 그 영역이 소유하고 있다는 서면 설명이 주어집니다. 경계를 아는 에이전트는 서로를 건드리는 일이 훨씬 적습니다.
2. 작업을 보드에 올리세요
에이전트들은 공유된 보드에서 작업을 선택하고 증거와 함께 완료 표시를 합니다. 한 시간 후에 돌아왔을 때, 보드는 무슨 일이 일어났는지 알려주며, 서른 개의 터미널을 읽을 필요가 없습니다.
3. 에이전트들이 서로 대화하게 하세요
한 에이전트가 다른 영역의 무언가가 필요할 때, 해당 코드를 소유한 에이전트에게 메시지를 보냅니다. 소유자가 변경 사항을 적용합니다.
4. 자동으로 복구하세요
세션은 충돌하고, 속도 제한(rate limits)에 도달하며, 컨텍스트를 채웁니다. 감독자(supervisor)가 이를 재시작하여 중단했던 지점부터 다시 시작하므로, 실패 비용이 몇 분으로 줄어듭니다.
5. 휴대폰에서 조종하세요
에이전트들이 인간에게 필요한 대부분의 것은 '예' 또는 짧은 답변입니다. 휴대폰을 이용해 이를 제공하면 책상 자리를 비웠을 때도 에이전트를 계속 움직이게 할 수 있습니다.
도구
저희는 이 요소들을 amux라는 오픈 소스 도구로 만들었습니다. 이 도구는 tmux 환경에서 Claude Code, Codex 및 Gemini CLI 세션을 실행하며, 그 위에 대시보드와 휴대폰 앱을 추가했습니다. 코드는 https://github.com/mixpeek/amux에 있으며 사이트는 https://amux.io입니다. 하지만 위에서 언급한 다섯 가지 습관은 어떤 설정에도 도움이 됩니다.
여러분이 에이전트를 병렬로 실행할 때 가장 먼저 문제가 되는 부분은 무엇인가요?