Claude Squad는 Claude Code, Aider, Codex, OpenCode, Amp와 같은 여러 AI 터미널 에이전트를 별도의 워크스페이스에서 관리하는 터미널 애플리케이션으로, 여러 작업을 동시에 수행할 수 있게 해줍니다.
주요 특징
- 백그라운드에서 작업 완료 (yolo / 자동 승인 모드 포함!)
- 하나의 터미널 창에서 인스턴스와 작업 관리
- 변경사항을 적용하기 전에 검토, 푸시하기 전에 변경사항 체크아웃
- 각 작업은 격리된 git 워크스페이스를 가지므로 충돌 없음
설치
Homebrew와 수동 설치 모두 Claude Squad를 시스템에 cs
로 설치합니다.
Homebrew
brew install claude-squad
ln -s "$(brew --prefix)/bin/claude-squad" "$(brew --prefix)/bin/cs"
수동 설치
Claude Squad는 다음 명령어를 실행하여 설치할 수도 있습니다:
curl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash
이 명령어는 cs
바이너리를 ~/.local/bin
에 설치합니다.
바이너리에 사용자 정의 이름을 사용하려면:
curl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash -s -- --name <your-binary-name>
사전 요구사항
- tmux
- gh
사용법
Usage:
cs [flags]
cs [command]
Available Commands:
completion Generate the autocompletion script for the specified shell
debug Print debug information like config paths
help Help about any command
reset Reset all stored instances
version Print the version number of claude-squad
Flags:
-y, --autoyes [experimental] If enabled, all instances will automatically accept prompts for claude code & aider
-h, --help help for claude-squad
-p, --program string Program to run in new instances (e.g. 'aider --model ollama_chat/gemma3:1b')
애플리케이션 실행:
cs
다른 AI 어시스턴트와 Claude Squad 사용하기:
- Codex의 경우:
export OPENAI_API_KEY=<your_key>
로 API 키 설정 - 특정 어시스턴트로 실행:
- Codex:
cs -p "codex"
- Aider:
cs -p "aider ..."
- Codex:
- 설정 파일을 수정하여 기본값으로 설정 (위치 확인:
cs debug
)
메뉴
화면 하단의 메뉴는 사용 가능한 명령어를 보여줍니다:
인스턴스/세션 관리
n
- 새 세션 생성N
- 프롬프트와 함께 새 세션 생성D
- 선택된 세션 종료(삭제)↑/j
,↓/k
- 세션 간 탐색
액션
↵/o
- 선택된 세션에 연결하여 재프롬프트ctrl-q
- 세션에서 분리s
- 브랜치를 커밋하고 GitHub에 푸시c
- 체크아웃. 변경사항을 커밋하고 세션 일시정지r
- 일시정지된 세션 재개?
- 도움말 메뉴 표시
탐색
tab
- 미리보기 탭과 diff 탭 간 전환q
- 애플리케이션 종료shift-↓/↑
- diff 보기에서 스크롤
작동 방식
- tmux를 사용하여 각 에이전트에 대한 격리된 터미널 세션 생성
- git worktrees를 사용하여 코드베이스를 격리하므로 각 세션이 자체 브랜치에서 작업
- 쉬운 탐색과 관리를 위한 간단한 TUI 인터페이스
라이선스
AGPL-3.0
프로젝트 정보
- GitHub: https://github.com/smtg-ai/claude-squad
- 웹사이트: https://smtg-ai.github.io/claude-squad/
- Stars: 2.2k
- Forks: 158
- 라이선스: AGPL-3.0
- 주요 언어: Go (85.3%), Shell (5.7%), TypeScript (4.5%), CSS (4.3%), JavaScript (0.2%)
주요 태그
- CLI
- Codex
- Aider
- Vibe-coding
- Claude-code
최신 릴리스
v1.0.6 (2025년 6월 25일)
출처: https://github.com/smtg-ai/claude-squad
관련 태그: #AI도구 #터미널 #개발도구 #Claude #멀티에이전트
반응형