Ruflo

Claude Code를 다중 에이전트 스웜으로 바꾸는 오케스트레이션 메타하니스

npx ruflo@latest init wizard

Claude Code 한 인스턴스를 100개 넘는 에이전트가 협업하는 다중 에이전트 스웜으로 바꾸는 오케스트레이션 플랫폼입니다. 훅이 작업을 자동 라우팅하고, 벡터 메모리(AgentDB)로 패턴을 학습하며, MCP로 200개 넘는 도구를 노출합니다. 옛 이름은 Claude Flow입니다.

판단

이럴 때 씁니다

  • 여러 에이전트를 동시에 굴려 큰 작업을 분산·병렬 처리하고 싶을 때.
  • 에이전트가 과거 성공 패턴을 기억(벡터 메모리)하며 점점 나아지길 원할 때.
  • MCP로 200개 넘는 오케스트레이션·메모리·DevTools 도구를 한 번에 붙이고 싶을 때.
  • 머신·팀을 넘어 에이전트를 federation으로 묶는 대규모 구성이 필요할 때.

이럴 땐 쓰지 마세요

  • @alpha라 breaking change가 잦습니다. 안정성이 중요하면 시기상조입니다.
  • RAM을 많이 먹습니다. 에이전트 8개면 3~4GB, 메모리 적은 노트북에선 2~3개만으로도 버겁습니다.
  • 같은 프롬프트가 실행마다 다른 구조를 내놓는 비결정성이 보고됩니다. 재현성이 필요한 작업엔 부담입니다.
  • 'pip install and go'가 아닌 복잡한 도구입니다. 가벼운 워크플로 강제가 목적이면 superpowers가 맞습니다.

차별점

  • Claude Code 한 세션을 100개 넘는 에이전트의 스웜으로 확장합니다. 계층·메시·적응형 토폴로지로 에이전트들이 협업합니다.
  • 훅이 작업을 백그라운드에서 자동 라우팅·조정합니다. init 후엔 평소처럼 Claude Code를 쓰면 됩니다.
  • HNSW 벡터 메모리(AgentDB)로 에이전트가 과거 패턴을 기억하고, MCP로 210개 넘는 도구를 노출합니다.
  • 옵트인 federation(WireGuard 메시)으로 머신·팀·신뢰 경계를 넘어 에이전트를 묶습니다.

워크플로

  1. 01npx ruflo@latest init wizard로 설치·초기화합니다.
  2. 02필요하면 claude mcp add ruflo로 Claude Code에 MCP 서버를 붙입니다.
  3. 03이후 평소처럼 Claude Code를 쓰면 훅이 작업을 자동 라우팅하고 에이전트를 백그라운드로 조정합니다.
  4. 04대규모 구성은 federation init로 메시를 세우고 federation join으로 피어를 묶습니다.

주요 명령

명령설명
npx ruflo@latest init wizard설치 마법사로 초기화합니다
claude mcp add ruflo -- npx ruflo@latest mcp startClaude Code에 MCP 서버로 등록합니다
/plugin install ruflo-swarm@ruflo슬래시 명령만 쓰는 lite 플러그인(MCP 미등록)
federation init머신·팀을 넘는 federation을 초기화합니다

함정

설치 전에 확인하세요

  • npm 패키지가 @alpha 태그입니다. breaking change를 각오해야 합니다.
  • 에이전트 하나가 풀 Claude CLI 프로세스라, 8개 이상이면 RAM을 3~4GB 먹습니다. M1 16GB에선 2~3개만 띄워도 대부분을 차지합니다.
  • 설치 경로가 둘인데, 플러그인 경로는 슬래시 명령만 깔고 MCP 서버는 등록 안 됩니다. 풀 기능은 CLI 경로(init wizard)를 써야 합니다.
  • Windows 기본 셸(cmd/PowerShell)에선 curl 설치가 안 되니 npx를 씁니다.

직접 써본 메모

야심이 큰 도구입니다. Claude Code 한 세션을 100개 넘는 에이전트의 스웜으로 바꾸고, 벡터 메모리로 패턴을 학습하며, MCP로 200개 넘는 도구를 붙입니다. 가장 많이 채택된 다중 에이전트 플랫폼으로 꼽히고, 만든 이(Reuven Cohen)가 빠르게 갱신합니다.

다만 수치는 거리를 두고 봐야 합니다. SWE-bench 84.8%·API 비용 75% 절감 같은 숫자는 전부 벤더(프로젝트) 주장이고 독립 검증치가 아닙니다. 벤치마크 자체도 자기네 도구를 다른 프레임워크와 비교한 자료라, 도입 판단의 단일 근거로 쓰긴 이릅니다.

실사용 한계가 분명히 보고됩니다. npm 패키지가 아직 @alpha라 breaking change가 잦고, 같은 프롬프트가 실행마다 다른 구조를 내놓는 비결정성이 지적됩니다. 무엇보다 에이전트 하나가 풀 Claude CLI 프로세스여서, 8개를 띄우면 RAM 3~4GB, 16GB 노트북에선 2~3개만으로도 대부분을 먹습니다. 한 정리는 광고된 스웜 조정·에이전트 실행 상당수가 아직 미완성이라며 현재 안정 동작 범위를 메모리·임베딩으로 좁혔습니다. 큰 자원과 복잡도를 감수할 수 있는 실험적 도입에 맞습니다.

비교

superpowers·gstack이 단일 에이전트의 워크플로를 다듬는다면, Ruflo는 여러 에이전트를 동시에 굴리는 스웜이라 무게가 다릅니다. 그만큼 자원·복잡도도 큽니다 — 가벼운 방법론 강제가 목적이면 superpowers, 본격 다중 에이전트 오케스트레이션이면 이쪽입니다. 옛 이름 Claude Flow로 알려진 도구와 같습니다.

최근 변경

v3.32.22에서 --scan-content CLI 설정이 환경 변수보다 우선하도록 수정하고 CI를 정상화했다.

공식 변경 내역