Claude Squad
여러 터미널 에이전트를 한 화면에서 굴리는 관리자
brew install claude-squad여러 코딩 에이전트를 각각 다른 작업 공간에서 동시에 돌립니다. 작업마다 격리된 깃 작업 공간이 생기므로 서로 충돌하지 않습니다. 배경에서 일을 끝내게 두고 필요할 때만 들여다보는 방식이 가능하고, 자동 수락 모드도 지원합니다. 변경은 적용 전에 검토하고 밀기 전에 꺼내 볼 수 있습니다. 한 터미널 창에서 인스턴스와 작업을 함께 관리합니다. 홈브루로 깔든 스크립트로 깔든 명령 이름은 짧게 잡힙니다. AGPL 라이선스이므로 사내 배포 시 조건을 확인해야 합니다.
판단
이럴 때 씁니다
- 여러 작업을 동시에 에이전트에게 맡길 때
- 작업끼리 충돌하지 않게 나눠야 할 때
- 배경에서 돌려 두고 나중에 확인하고 싶을 때
이럴 땐 쓰지 마세요
- 작업이 하나면 관리 계층이 늘어날 뿐입니다
- tmux 를 쓰지 않는 환경에서는 부적합합니다
- AGPL 이라 사내 배포 조건을 확인해야 합니다
차별점
- 작업마다 격리된 깃 작업 공간을 만듭니다.
- 여러 에이전트를 한 터미널 창에서 관리합니다.
- 배경 진행과 자동 수락 모드를 지원합니다.
- 적용 전에 변경을 검토하는 단계가 들어 있습니다.
워크플로
- 01설치하고 짧은 명령 이름을 잡습니다.
- 02작업마다 인스턴스를 만듭니다.
- 03각각 격리된 깃 작업 공간에서 돌립니다.
- 04배경 진행을 두고 필요할 때 들여다봅니다.
- 05변경을 검토하고 적용합니다.
주요 명령
| 명령 | 설명 |
|---|---|
brew install claude-squad | 홈브루로 설치합니다. |
curl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash | 스크립트로 설치합니다. 실행 파일이 지역 경로에 들어갑니다. |
cs | 짧은 이름으로 실행합니다. |
함정
설치 전에 확인하세요
- 홈브루로 깔면 짧은 이름 연결을 직접 걸어야 합니다.
- tmux 세션이 서버와 함께 죽으면 인스턴스가 사라졌습니다. 최근 판에서 복구되도록 고쳐졌습니다.
- 자동 수락 모드는 편하지만 검토 없이 진행됩니다. 어디에 쓰는지 정해 두어야 합니다.
- AGPL 3.0 입니다. 배포 형태에 따라 조건이 붙습니다.
비교
터미널 여러 개를 띄워 직접 관리하면 작업 공간이 섞이고 무엇이 어디까지 갔는지 놓칩니다. 이쪽은 그 관리 부담을 도구가 맡습니다. 대신 작업이 하나뿐이라면 계층만 늘어납니다.
최근 변경
이미 있는 브랜치로 시작한 세션의 기준 커밋을 제대로 기록하도록 고쳤습니다. 터미널 세션이 서버와 함께 죽은 인스턴스를 복구하는 수정도 함께 들어갔습니다.