가이드

동일한 Git 저장소에서 여러 AI 에이전트를 동시 실행하는 방법 (충돌 방지)

프로젝트에서 여러 에이전트를 실행하려면 세 가지가 필요합니다. 에이전트를 호스팅할 머신, 에이전트가 공유할 디렉터리, 그리고 누가 어디에 쓸지 결정하는 규칙입니다. 세 번째가 없으면 두 번째 에이전트는 아무 알림도 없이 첫 번째 에이전트의 작업을 지워버립니다.

단계별로

1. 프로젝트를 만드세요. 캔버스는 자체 머신과 비공개 저장소를 시작합니다. 이곳이 공유 디렉터리가 살아 있는 곳이며, 이후 여는 모든 에이전트에게 같은 장소입니다.
2. 계정을 연결하세요. Anthropic, OpenAI, 또는 다른 제공자에서 이미 결제 중인 구독이나 API 키를 연결하세요. 토큰은 되팔리지 않고, 사용량은 여러분의 계정에 기록됩니다.
3. 에이전트마다 창을 여세요. Claude Code, Codex, Kimi, OpenCode는 각각 실제 터미널을 가진 자체 창에서 열립니다. Solo 요금제는 두 개, Pro는 다섯 개입니다.
4. 작업이 아니라 파일로 나누세요. 프로젝트 전체를 가로지르는 작업 대신, 프로젝트의 한쪽을 각 에이전트에 맡기세요. 두 에이전트가 두 영역에 있으면 나란히 진행되고, 같은 파일에 있으면 서로를 기다립니다.
5. 보드가 조정하게 두세요. 에이전트는 쓰기 전에 건드릴 경로를 점유하고, 서버는 소유자가 놓아줄 때까지 다른 에이전트에게 그 경로를 거부합니다. 누가 무엇을 쥐고 있는지, 누가 기다리는지가 보입니다.

미리 준비해야 할 것

비어 있어도 상관없는 저장소 하나와 모델 제공자 계정 하나. 나머지는 프로젝트가 마련해 줍니다. 머신, 디렉터리, 파일을 분배하는 보드입니다.

저장소 루트에 있는 지침 파일은 어떤 설정보다도 결과를 크게 바꿉니다. 에이전트는 시작할 때 이를 읽고, 각자의 처음 다섯 가지 실수를 막아줍니다.

효과적인 분할 방식

적절한 단위는 기능이 아니라 파일입니다. API에 하나, 인터페이스에 하나, 테스트에 하나씩 에이전트를 두면 거의 겹치지 않고 거의 기다리지 않습니다. "결제 페이지"에 에이전트 셋을 두면 한 시간 내내 같은 세 파일을 두고 다투게 됩니다.

작업 중에 보게 되는 것

터미널은 각자의 창에서 흘러가고, 보드는 누가 어떤 경로를 쥐고 있는지 보여줍니다. 막힌 에이전트는 피해를 내기 전에 보이며, 이것이 보이지 않는 대기열과의 진짜 차이입니다. 메커니즘 자세히 보기.

직접적인 답변