AI 지식 / / 2025. 6. 26. 17:52

[AI 도구] Claude Squad - 다중 AI 터미널 에이전트 관리 도구 (Claude Squad)

Claude Squad는 Claude Code, Aider, Codex, OpenCode, Amp와 같은 여러 AI 터미널 에이전트를 별도의 워크스페이스에서 관리하는 터미널 애플리케이션으로, 여러 작업을 동시에 수행할 수 있게 해줍니다.

Claude Squad Screenshot

주요 특징

  • 백그라운드에서 작업 완료 (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 ..."
  • 설정 파일을 수정하여 기본값으로 설정 (위치 확인: cs debug)

메뉴

화면 하단의 메뉴는 사용 가능한 명령어를 보여줍니다:

인스턴스/세션 관리

  • n - 새 세션 생성
  • N - 프롬프트와 함께 새 세션 생성
  • D - 선택된 세션 종료(삭제)
  • ↑/j, ↓/k - 세션 간 탐색

액션

  • ↵/o - 선택된 세션에 연결하여 재프롬프트
  • ctrl-q - 세션에서 분리
  • s - 브랜치를 커밋하고 GitHub에 푸시
  • c - 체크아웃. 변경사항을 커밋하고 세션 일시정지
  • r - 일시정지된 세션 재개
  • ? - 도움말 메뉴 표시

탐색

  • tab - 미리보기 탭과 diff 탭 간 전환
  • q - 애플리케이션 종료
  • shift-↓/↑ - diff 보기에서 스크롤

작동 방식

  1. tmux를 사용하여 각 에이전트에 대한 격리된 터미널 세션 생성
  2. git worktrees를 사용하여 코드베이스를 격리하므로 각 세션이 자체 브랜치에서 작업
  3. 쉬운 탐색과 관리를 위한 간단한 TUI 인터페이스

라이선스

AGPL-3.0

프로젝트 정보

주요 태그

  • CLI
  • Codex
  • Aider
  • Vibe-coding
  • Claude-code

최신 릴리스

v1.0.6 (2025년 6월 25일)


출처: https://github.com/smtg-ai/claude-squad

관련 태그: #AI도구 #터미널 #개발도구 #Claude #멀티에이전트

반응형
  • 네이버 블로그 공유
  • 네이버 밴드 공유
  • 페이스북 공유
  • 카카오스토리 공유