Repolode
cj-vana

cj-vana/claude-swarm

프로토콜 기반 동작 제약과 실시간 대시보드를 갖춘, tmux와 git worktree에서 Claude Code 워커를 병렬로 조율하는 MCP 서버입니다.

스타
117
포크
10
열린 이슈
0
마지막 커밋
8개월 전

어떤 프로젝트인가요?

Claude Swarm은 Claude Code 세션이 여러 Claude Code 워커를 조율하도록 해주는 MCP 서버입니다. 각 워커는 격리된 git worktree 안의 별도 tmux 세션에서 기능 하나를 구현하고 상태를 보고합니다. 서버는 세션 상태를 디스크에 저장하므로 체크포인트와 하트비트 기반 복구를 통해 컨텍스트 압축, 충돌, 머신 재시작 후에도 작업을 이어갈 수 있습니다.

이 프로젝트는 장시간 자율 코딩을 위한 몇 가지 메커니즘을 추가합니다. 워커는 구현 전에 읽기 전용 계획 단계를 거칠 수 있고, 복잡한 기능에는 여러 계획을 경쟁적으로 생성할 수 있으며, Ralph Loop는 반복할 때마다 새로운 Claude 세션을 시작하고 진행 상황을 파일에 저장합니다. 기능 완료 처리 전에 검증 명령을 통과해야 하고, 실패한 기능은 자동으로 재시도할 수 있으며, 완료 후에는 코드와 아키텍처를 검토해 구조화된 결과를 생성합니다.

프로토콜은 도구 제한, 파일 접근 규칙, 리소스 한도 등의 동작 제약을 정의합니다. 프로토콜은 워커 시작 전에 검사되고 실행 중에도 모니터링되며, 위반 사항은 검토를 위해 기록됩니다. localhost:3456의 웹 대시보드는 Server-Sent Events를 통해 워커의 터미널 출력과 세션 진행 상황을 실시간으로 전달합니다.

핵심 기능

  • 01각각 별도의 git worktree를 사용하는 Claude Code 워커를 tmux 세션에서 병렬로 실행합니다.
  • 02세션 상태와 체크포인트를 저장해 충돌이나 재시작 후에도 작업을 이어갑니다.
  • 03복잡한 기능을 위해 계획 후 구현의 2단계 작업 흐름을 실행합니다.
  • 04기능 완료 처리 전에 검증 명령을 실행하고, 실패 시 자동으로 재시도합니다.
  • 05워커 실행 전에 동작 프로토콜을 검증하고 실행 중에도 준수 여부를 모니터링합니다.
  • 06터미널 출력을 실시간으로 보여주는 웹 대시보드를 제공합니다.

활용 사례

  • 인증과 테스트가 포함된 REST API처럼 큰 기능 묶음을 여러 코딩 에이전트에 나눠 맡기기.
  • 중단 상황을 견뎌야 하는 여러 시간짜리 자율 코딩 세션 실행하기.
  • 명시적인 프로토콜로 자율 코딩 에이전트의 접근 대상이나 실행 가능한 작업 제한하기.
  • 브라우저 대시보드에서 여러 에이전트 워커를 한 번에 모니터링하기.

빠른 시작

  1. 1

    필수 항목 설치: Node.js 18 이상, tmux, Claude Code CLI

  2. 2

    한 줄 명령으로 설치(클론, 빌드, MCP server 등록, skill 설치)

    README의 공식 안내에 따라 설치
  3. 3

    또는 수동으로 설치: 클론, 의존성 설치, 빌드

    git clone https://github.com/cj-vana/claude-swarm.git && cd claude-swarm && npm install && npm run build
  4. 4

    Claude Code에 MCP server 등록

    claude mcp add claude-swarm --scope user -- node $(pwd)/dist/index.js

사용 전 알아둘 점

  • Node.js 18 이상과 함께 tmux 및 Claude Code CLI를 설치해야 합니다.
  • Claude Code 작업자를 오케스트레이션하므로 해당 도구와 사용 비용에 종속됩니다.

토픽

자주 묻는 질문

claude-swarm은(는) 무엇인가요?
프로토콜 기반 동작 제약과 실시간 대시보드를 갖춘, tmux와 git worktree에서 Claude Code 워커를 병렬로 조율하는 MCP 서버입니다. Claude Swarm은 Claude Code 세션이 여러 Claude Code 워커를 조율하도록 해주는 MCP 서버입니다. 각 워커는 격리된 git worktree 안의 별도 tmux 세션에서 기능 하나를 구현하고 상태를 보고합니다. 서버는 세션 상태를 디스크에 저장하므로 체크포인트와 하트비트 기반 복구를 통해 컨텍스트 압축, 충돌, 머신 재시작 후에도 작업을 이어갈 수 있습니다.
claude-swarm은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
claude-swarm은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
claude-swarm은(는) 아직 유지보수되고 있나요?
6개월 이상 커밋 없음. claude-swarm의 마지막 커밋은 2026년 2월 11일입니다.
claude-swarm은(는) 어디에 사용할 수 있나요?
인증과 테스트가 포함된 REST API처럼 큰 기능 묶음을 여러 코딩 에이전트에 나눠 맡기기. 중단 상황을 견뎌야 하는 여러 시간짜리 자율 코딩 세션 실행하기. 명시적인 프로토콜로 자율 코딩 에이전트의 접근 대상이나 실행 가능한 작업 제한하기. 브라우저 대시보드에서 여러 에이전트 워커를 한 번에 모니터링하기.
claude-swarm는 어떻게 설치하나요?
필수 항목 설치: Node.js 18 이상, tmux, Claude Code CLI 한 줄 명령으로 설치(클론, 빌드, MCP server 등록, skill 설치) 또는 수동으로 설치: 클론, 의존성 설치, 빌드: git clone https://github.com/cj-vana/claude-swarm.git && cd claude-swarm && npm install && npm run build Claude Code에 MCP server 등록: claude mcp add claude-swarm --scope user -- node $(pwd)/dist/index.js
claude-swarm은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/cj-vana/claude-swarm

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트