클로드 코드로 작은 수정은 잘 되는데, 큰 작업을 맡기면 버거울 때가 있죠. 파일 수십 개를 고치거나, 조사하고 코딩하고 테스트까지 한 번에 시키면 대화가 길어지다 앞에서 한 얘기를 놓치고, 한 단계씩 순서대로 하느라 시간도 오래 걸립니다.
이럴 때 쓰는 게 작업을 여러 에이전트에게 나눠 맡기는 도구예요. 클로드 코드 쪽에서 가장 많이 알려진 게 Ruflo(옛 이름 claude-flow)입니다. 이 글에서는 Ruflo가 어떤 작업에 도움이 되는지, 그리고 홍보 문구 중 과장된 부분을 실제 문서로 확인한 결과를 정리했어요.
결론부터 말씀드리면 큰 작업을 쪼개 돌리는 용도로는 쓸모가 있습니다. 다만 "에이전트 60개 동시 실행", "토큰 50% 절약" 같은 숫자는 문서와 다르거나 근거를 찾지 못했어요. 2026년 10월 6일 기준입니다.
작업이 길어서 대화가 앞 내용을 놓친다 : 한 세션에 조사, 코딩, 테스트를 다 넣으면 맥락이 넘칩니다
같은 일을 매번 처음부터 설명한다 : 지난번에 정한 방식이 다음 작업에 이어지지 않습니다
쉬운 일에도 비싼 모델을 쓴다 : 오타 수정과 설계 판단이 같은 모델로 돌아갑니다
멀티 에이전트 도구는 이 셋을 각각 역할 나누기, 공유 메모리, 모델 나눠 쓰기로 풀겠다고 나온 도구예요.
그럼 Ruflo가 실제로 뭘 해 주는지부터 보겠습니다.
README는 Ruflo를 "클로드 코드와 Codex를 감싸는 실행 계층"이라고 소개합니다. 모델을 따로 주는 게 아니라, 내 클로드 위에 에이전트 역할 정의, 조율 규칙, 메모리를 얹는 방식이에요. 클로드 코드에는 MCP 서버로 붙습니다.
npx ruflo@latest init wizard
claude mcp add claude-flow -- npx ruflo@latest mcp start문서 기준으로 해 주는 일은 이렇습니다.
역할 나누기 : 조사, 코딩, 테스트, 리뷰 같은 전문 에이전트 유형이 미리 정의돼 있고, "퀸"이 일꾼들을 조율하는 구조입니다
공유 메모리 : 에이전트들이 같은 저장소에 패턴을 쌓고 다음 작업에 다시 씁니다
모델 나눠 쓰기 : 작업 복잡도를 매겨 하이쿠, 소네트, 오퍼스 중 하나로 보냅니다
Ruflo가 스스로 쓴 감사 문서에도 학습 루프와 모델 선택기는 실제로 작동한다고 적혀 있어요. 버전은 v3.53.0, MIT 라이선스, GitHub 별은 약 7만 4천 개입니다.
여기까지는 쓸 만해 보이죠. 문제는 홍보 숫자입니다.
홍보 문구 | 실제 문서 | 판정 |
|---|---|---|
에이전트 60개 이상 동시 실행 | 60+는 에이전트 종류 수 | 과장 |
완전 무료 | 도구는 MIT 무료, 클로드 사용량은 내 몫 | 반만 맞음 |
퀸이 전문 에이전트를 지휘 | 위계 구조가 문서에 있음 | 맞음 |
쓸수록 학습 | 학습 루프는 작동, 성능 배수 수치는 근거 없음 | 반만 맞음 |
토큰 50% 절약 | 설명서 표의 추정치 30~50%, 측정 결과 없음 | 근거 없음 |
가장 많이 오해받는 건 첫 줄입니다. 등록부에 60개 넘는 유형이 있다는 뜻인데, 깔면 60개가 동시에 일한다는 말로 퍼졌어요.
학습 부분은 Ruflo 쪽이 스스로 인정한 내용이 있습니다. 감사 문서에 대표 성능 배수 수치들은 대부분 벤치마크 없이 문서에 박아 둔 문구였고, 하나는 실행 중에 지어낸 값이었다고 적혀 있어요.
토큰 절약은 특히 조심해서 보셔야 합니다. 실제 사용자들이 겪은 일은 반대 방향이었거든요.
30분 안에 토큰 수백만 개가 나갔다는 신고 : 세션마다 일을 시작하기도 전에 1만 5천~2만 5천 토큰이 도구 설명으로 들어간다는 분석이 붙었습니다
쓰지도 않는데 사용량 한도가 줄어든다는 신고 : 백그라운드 데몬이 기본으로 켜져 있던 게 원인이었고 고쳐졌습니다
데몬이 몇 초마다 클로드를 따로 띄웠다는 신고 : 전역 설정 파일(~/.claude/CLAUDE.md)까지 고쳤다는 내용인데, 이것도 고쳐졌습니다
MCP 도구 대부분이 겉모양만 있다는 지적 : 메인테이너는 이후 버전에서 해결했다고 답했습니다
전부 닫힌 이슈라 지금 버전에서는 고쳐졌을 수 있습니다. 제가 직접 설치해서 다시 재 보지는 않았어요. 그래도 "아낀다"를 보고 깔았다가 오히려 사용량이 빨리 바닥나는 경우가 있다는 건 알고 시작하시는 게 좋습니다.
그럼 큰 작업을 나눠 돌리고 싶을 때 다른 방법은 없을까요?
위에서 말한 세 가지 문제는 클로드 코드 기본 기능으로도 상당 부분 풀립니다. 공식 문서 기준이에요.
서브에이전트 : 각자 따로 맥락을 갖고 일하는 보조 에이전트라, 메인 대화가 길어지지 않습니다
에이전트별 모델 지정 : 서브에이전트마다 하이쿠, 소네트, 오퍼스를 정할 수 있고, 공식 문서도 싸고 빠른 모델로 보내 비용을 줄이라고 안내합니다
남는 메모리 : 서브에이전트에 대화가 끝나도 남는 전용 폴더를 줄 수 있습니다
에이전트 팀(실험 기능) : 한 세션이 팀장이 되어 일을 나누고 결과를 모읍니다. 기본으로는 꺼져 있어요
공식 문서는 비용 경고도 함께 적어 둡니다. 서브에이전트도 같은 사용량 한도에서 차감되고, 에이전트 팀은 혼자 할 때보다 토큰을 훨씬 많이 쓴다고요. 여러 에이전트를 돌리는 건 어떤 도구를 쓰든 원래 비싼 일이라는 뜻이죠.
【직접 확인 · 2026-10-06】 저는 작업 성격에 따라 모델을 나눠 쓰는 규칙을 설정 파일 한 곳에 적어 두고 씁니다. 기계적인 작업은 작은 모델, 판단이 필요한 작업은 큰 모델로 넘기는 식이에요. 별도 도구 없이 이 정도는 됩니다.
기본 서브에이전트로 먼저 나눠 본다. 이걸로 충분하면 여기서 멈춘다
부족하면 실제 프로젝트가 아니라 연습용 폴더에 설치한다
설치 후 내 설정 파일(~/.claude) 어디가 바뀌었는지 확인한다
백그라운드 데몬이 자동으로 켜지는지 확인한다
하루 써 보고 사용량이 평소보다 얼마나 늘었는지 비교한다
Ruflo는 오래 다듬어 온 도구이고, 큰 프로젝트에서 에이전트 여러 개를 엮어야 한다면 쓸모가 있을 수 있어요. 다만 홍보 숫자를 보고 깔기보다, 내 작업이 정말 나눠 돌릴 만큼 큰지부터 보시길 권합니다.
여러 에이전트를 엮기 전에 지시를 어디에 둘지 정리하고 싶다면 클로드코드 스킬 만들기를 같이 보세요.
ruvnet/ruflo 저장소 README: https://github.com/ruvnet/ruflo
Ruflo 자체 감사 문서(docs/reviews/intelligence-system-audit-2026-05-29.md): https://github.com/ruvnet/ruflo/blob/main/docs/reviews/intelligence-system-audit-2026-05-29.md
Ruflo 이슈 #1330, 과도한 토큰 사용: https://github.com/ruvnet/ruflo/issues/1330
Ruflo 이슈 #1427, 사용량 한도 감소: https://github.com/ruvnet/ruflo/issues/1427
Ruflo 이슈 #2098, 데몬 토큰 사용: https://github.com/ruvnet/ruflo/issues/2098
Ruflo 이슈 #653, MCP 도구 구현 상태: https://github.com/ruvnet/ruflo/issues/653
Claude Code 문서, Subagents: https://code.claude.com/docs/en/sub-agents
Claude Code 문서, Agent teams: https://code.claude.com/docs/en/agent-teams