Claude Squad는 여러 개의 Claude Code, Codex, Gemini (및 Aider를 포함한 기타 로컬 에이전트들)을 별도의 작업 공간(workspace)에서 관리하는 터미널 애플리케이션입니다. 이를 통해 사용자는 여러 작업을 동시에 진행할 수 있습니다.
Claude Squad Screenshot
주요 특징 (Highlights)
- 백그라운드에서 전체 작업 완료 (yolo / auto-accept 모드 포함!)
- 하나의 터미널 창에서 인스턴스와 작업을 관리
- 변경 사항을 적용하기 전에 검토하고, 푸시하기 전에 변경 사항을 체크아웃할 수 있음
- 각 작업은 자체적으로 격리된 git 작업 공간을 가지므로 충돌이 없음
<br />
설치 (Installation)
Homebrew를 사용하든 수동으로 설치하든, Claude Squad는 시스템에서 cs로 설치됩니다.
Homebrew
brew install claude-squad
ln -s "$(brew --prefix)/bin/claude-squad" "$(brew --prefix)/bin/cs"
수동 설치 (Manual)
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>
전제 조건 (Prerequisites)
사용법 (Usage)
Usage:
cs [flags]
cs [command]
...
다음 명령어로 애플리케이션을 실행합니다:
참고: 기본 프로그램은 claude이며, 최신 버전을 사용하는 것을 권장합니다.
<br />
다른 AI 어시스턴트와 함께 Claude Squad 사용하기:
- Codex의 경우:
export OPENAI_API_KEY=<사용자 키> 명령어로 API 키를 설정합니다.
- 특정 어시스턴트로 실행하기:
- Codex:
cs -p "codex"
- Aider:
cs -p "aider ..."
- Gemini:
cs -p "gemini"
- 설정 파일을 수정하여 기본값으로 지정합니다 (위치는
cs debug로 확인).
메뉴
화면 하단의 메뉴에는 사용 가능한 명령어가 표시됩니다:
인스턴스/세션 관리 (Instance/Session Management)
n - 새 세션을 생성합니다.
N - 프롬프트와 함께 새 세션을 생성합니다.
D - 선택된 세션을 종료(삭제)합니다.
↑/j, ↓/k - 세션 간 탐색을 합니다.
실행 동작 (Actions)
↵/o - 선택된 세션에 연결하여 재프롬프트합니다.
ctrl-q - 세션에서 분리됩니다.
s - 변경 사항을 커밋하고 GitHub에 브랜치를 푸시합니다.
c - 체크아웃(Checkout). 변경 사항을 커밋하고 세션을 일시 중지합니다.
r - 일시 중지된 세션을 재개합니다.
? - 도움말 메뉴를 표시합니다.
탐색 (Navigation)
tab - 미리보기 탭과 diff 탭 사이를 전환합니다.
q - 애플리케이션을 종료합니다.
shift-↓/↑ - diff 보기에서 스크롤합니다.
설정 (Configuration)
Claude Squad는 설정을 ~/.claude-squad/config.json에 저장합니다. 정확한 경로는 cs debug를 실행하여 확인할 수 있습니다.
프로필 (Profiles)
프로필을 사용하면 여러 개의 이름 지정 프로그램 구성을 정의하고, 새 세션을 생성할 때 이들 사이를 전환할 수 있습니다. 프로필이 하나 이상 정의된 경우, 세션 생성 오버레이에는 ←/→로 탐색할 수 있는 프로필 선택기가 표시됩니다.
프로필을 구성하려면 설정 파일에 profiles 배열을 추가하고, 기본값으로 선택할 프로필의 이름으로 default_program을 설정합니다:
{
"default_program": "claude",
"profiles": [
...
각 프로필은 두 개의 필드를 가집니다:
| 필드 | 설명 |
|---|
name | 프로필 선택기에서 표시되는 이름 |
program | 해당 프로필의 에이전트를 실행하는 셸 명령어 |
프로필이 정의되지 않은 경우, Claude Squad는 기본 실행 명령어(launch command)로 default_program을 직접 사용합니다 (기본값은 claude입니다).
자주 묻는 질문 (FAQs)
새 세션 시작 실패 (Failed to start new session)
failed to start new session: timed out waiting for tmux session과 같은 오류가 발생하면, 기본 프로그램(underlying program)(예: claude)을 최신 버전으로 업데이트하세요.
작동 방식 (How It Works)
- 각 에이전트를 위한 격리된 터미널 세션(isolated terminal sessions)을 생성하는 tmux
- 각 세션이 자체 브랜치에서 작업할 수 있도록 코드베이스를 격리하는 git worktrees
- 쉬운 탐색 및 관리를 위한 간단한 TUI 인터페이스
라이선스 (License)
AGPL-3.0
스타 기록 (Star History)
Star History Chart