루플로

에이전트 60개를 지휘하는 도구

단계 3개

한눈에 보기

1루플로 깔기문장 하나면 끝›2클로드 코드에 연결하기클로드가 루플로를 부릴 수 있게›3쓰는 법평소처럼 시키면 됨›

루플로(Ruflo)가 뭐냐면 — 클로드에 붙이는 무료 오픈소스 도구예요(깃허브 스타 3만+, 구 이름 claude-flow). 팀장 역할의 AI(퀸 에이전트)가 지휘하고, 60개가 넘는 AI 일꾼(에이전트)이 조사·코딩·테스트·검토를 나눠서 동시에 처리해요. 기억을 같이 써서 쓸수록 똑똑해지고, 일의 난이도에 맞는 모델을 알아서 골라 사용량(토큰)을 아껴 줘요. 공식 저장소 보기

읽는 순서 — 준비물 → 1 → 2 → 3 → 막히면 이렇게. 1·2단계는 클로드에게 문장 하나씩만 붙여 넣으면 돼요.

준비물

클로드 코드(Claude Code). 작업할 프로젝트 폴더에서 열어 두세요.
그 밖에 필요한 프로그램은 1단계에서 클로드가 알아서 확인하고 깔아요.

루플로 깔기문장 하나면 끝

github.com/ruvnet/ruflo

클로드 코드를 열고 아래 문장을 그대로 붙여 넣으세요. 설치는 클로드가 알아서 해요.

루플로라는 도구를 이 프로젝트에 설치해 주세요. 깃허브 주소는 ruvnet/ruflo 예요. 시작 전에 지금 프로젝트를 먼저 백업해 두시고, 필요한 건 알아서 다 깔아 주세요. 설치 중에 물어보는 건 기본값으로 넘어가 주세요.

직접 명령어로 하고 싶다면

먼저 Node.js가 있는지 확인하세요. 아래 명령을 붙여 넣어 v18 이상이 나오면 통과. 안 나오면 nodejs.org에서 LTS 버전을 받아 "다음"만 계속 누르면 돼요. 설치 후엔 터미널을 새로 여세요.

$ node -v

그다음 프로젝트 폴더의 터미널에 아래를 붙여 넣으면 설치 마법사가 알아서 세팅해 줘요. 질문이 나오면 기본값(엔터)으로 넘어가도 됩니다. (터미널 여는 법: 윈도우는 탐색기로 폴더를 연 뒤 주소창에 powershell 입력 + 엔터, 맥은 폴더 우클릭 → "폴더에서 새로운 터미널 열기")

$ npx ruflo@latest init wizard

이렇게 되면 성공 — 클로드가 "설치 끝났어요"라고 답해요. 에러 없이 마무리돼요.

자주 업데이트되는 도구라서, 시작 전에 프로젝트 백업을 꼭 해 두세요. 문제가 생겨도 되돌릴 수 있게요. 위 문장대로 말하면 클로드가 먼저 백업해 줘요.

클로드 코드에 연결하기클로드가 루플로를 부릴 수 있게

이어서 아래 문장을 그대로 붙여 넣으세요.

방금 설치한 루플로를 클로드 코드에 연결해 주세요. 다 되면 잘 연결됐는지 확인까지 해 주세요.

직접 명령어로 하고 싶다면

$ claude mcp add ruflo -- npx ruflo@latest mcp start

연결됐는지 확인하려면 아래를 붙여 넣으세요. 목록에 ruflo가 보이면 연결 완료.

$ claude mcp list

이렇게 되면 성공 — 클로드가 "루플로 연결됐어요"라고 답해요. 그다음 클로드 코드를 껐다 켜면 적용됩니다.

쓰는 법평소처럼 시키면 됨

설치가 끝나면 그냥 평소처럼 클로드에게 일을 시키세요. 뒤에서 알아서 AI 일꾼 팀을 꾸리고 역할을 나눠요.

클로드에게 이렇게

회원가입 기능을 만들어 주세요. 팀으로 나눠서 조사, 코딩, 테스트까지 한 번에 해 주세요.

이렇게 되면 성공 — 클로드가 "에이전트를 나눠서 진행할게요" 같은 계획을 세우고 여러 작업을 동시에 처리해요.

처음엔 작은 작업부터 시켜 보면서 결과를 확인하는 걸 추천해요. 큰 프로젝트에 바로 풀면 검토할 게 많아져요.

막히면 이렇게

설치가 안 되고 에러가 나요.

설치에 필요한 프로그램(Node.js)이 없거나 막 설치한 참일 수 있어요. 클로드에게 이렇게 말하세요. "루플로 설치에 필요한 프로그램이 있는지 확인하고, 없으면 깔고 다시 설치해 주세요." 직접 명령어로 했다면 터미널을 새로 열어서 다시 붙여 넣어 보세요.

연결했는데 클로드가 루플로를 모르는 것 같아요.

클로드 코드를 완전히 껐다가 다시 켜야 새 연결이 적용돼요.

써 보니 안 맞아요. 어떻게 지워요?

클로드에게 "루플로 연결을 끊어 주세요"라고 말하면 돼요. 프로젝트에 생긴 설정 파일은 지워도 되고 둬도 해가 없어요.

직접 명령어로 하고 싶다면

$ claude mcp remove ruflo

AI 공부방 오픈카카오톡 · 막히면 같이 공부해요

입장하기 ‹ 다른 자료 보러 가기

트렌드코어 스킬공유자료실 · 무료