무료 가이드 댓글 키워드 에이전트

Ruflo 세팅 가이드, 설치부터 백업까지 3단계

클로드 코드에 에이전트 팀 도구 Ruflo를 깔고, 처음 설정하고, 바뀔 수 있는 설정 파일을 백업해 두는 방법이에요.

이걸 따라 하면: 내 클로드 코드에 에이전트 팀 도구 Ruflo가 깔리고, 혹시 설정이 바뀌어도 되돌릴 수 있게 돼요.
걸리는 시간: 아직 직접 재 보지 않았어요. 재 보면 이 칸을 고칠게요.
난이도: 명령어는 몰라도 돼요. 복사해서 붙여 넣기만 해요.
준비물: 클로드 코드가 깔린 컴퓨터. 맥이나 리눅스면 그대로 따라 하면 되고, 윈도는 1단계의 윈도 줄을 쓰세요.

끝까지 따라 하면 클로드 코드 안에서 Ruflo의 에이전트들이 일할 준비가 끝나요. 에이전트는 일 하나를 맡아 하는 AI 도우미예요. Ruflo는 이런 도우미 수십 개를 한 팀으로 묶어 주는 무료 도구예요. 공식 소개 글은 처음 깔고 나면 클로드 코드를 평소처럼 쓰기만 하면 된다고 말해요. 일을 나누는 것도, 배운 것을 기억하는 것도 뒤에서 알아서 한대요.

다만 하나 먼저 알아 둘 게 있어요. Ruflo를 깔면 클로드 코드의 설정 파일 몇 개가 바뀔 수 있어요. 그래서 1단계에서 깔기 바로 전에 설정 파일을 복사해 두고, 3단계에서 어떤 파일이 왜 중요한지 자세히 봐요.

1. 까는 법

그런데 깔기만 하면 끝이 아니에요. 공식 소개 글에 따르면 까는 길이 두 갈래고, 깔리는 양이 크게 달라요.

플러그인으로 깔기: 내 폴더에 파일이 하나도 안 생겨요. 명령 몇 개와 에이전트 설명만 들어와요. 맛보기용이에요.
명령 한 줄로 깔기: 에이전트 98개, 명령 60개 넘게, 스킬 30개, 자동 실행 장치까지 다 들어와요. 공식 소개 글이 “설명한 대로 다 돌아가는 길”이라고 부르는 쪽이에요.

영상에서 말한 팀 전체를 쓰려면 두 번째 길이에요. 이 가이드도 그 길로 가요.

① 깔기 전에 설정 파일 복사해 두기. 클로드 코드를 열고 아래 문장을 통째로 붙여 넣으세요.

지금 이 폴더의 CLAUDE.md, .mcp.json, .claude/settings.json 세 파일과 내 컴퓨터의 ~/.claude/CLAUDE.md 파일을, 있는 것만 골라서 같은 자리에 이름 끝에 .before-ruflo를 붙여 복사해 줘. 없는 파일은 없다고만 알려 주고, 다 끝나면 복사한 파일 목록을 보여 줘.

이렇게 보이면 성공이에요. 클로드가 “복사했어요” 하며 이름 끝이 .before-ruflo인 파일 목록을 보여 줘요.

② Ruflo 깔기. 아래 문장을 붙여 넣으세요. 클로드가 대신 설치 명령을 쳐 줘요.

Ruflo를 공식 안내대로 설치하고 싶어. 터미널에서 npx ruflo@latest init wizard 를 실행해 줘. 묻는 화면이 나오면 나한테 무엇을 고를지 하나씩 보여 주고 내가 고르게 해 줘.

공식 안내의 같은 명령은 아래 한 줄이에요. 직접 터미널에 치고 싶으면 이걸 쓰세요. 맥, 리눅스, 윈도 모두 똑같이 돌아가요.

npx ruflo@latest init wizard

맥이나 리눅스라면 공식 안내에 아래 한 줄 설치도 있어요. 윈도에서는 이 줄 대신 바로 위의 줄을 쓰세요.

curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

③ 무엇이 바뀌었는지 확인하기. 마지막으로 아래 문장을 붙여 넣으세요.

방금 Ruflo 설치로 새로 생기거나 바뀐 파일을 보여 줘. 특히 CLAUDE.md, .mcp.json, .claude/settings.json 이 .before-ruflo 복사본과 어떻게 다른지 쉬운 말로 알려 줘.

이렇게 보이면 성공이에요. 클로드가 새로 생긴 .claude 폴더, .claude-flow 폴더 같은 것과 바뀐 설정 내용을 짚어 줘요. 원래 있던 내용이 사라졌다고 나오면 3단계에서 되돌리는 법을 보세요.

2. 처음 설정

그래서 깔고 나면 클로드 코드가 Ruflo의 도구를 부를 수 있게 이어 줘야 해요. 공식 안내는 이걸 연결 서버, 영어로 MCP 서버라고 불러요.

① 클로드 코드에 Ruflo 연결하기. 아래 문장을 붙여 넣으세요.

Ruflo를 클로드 코드에 연결해 줘. 공식 안내대로 터미널에서 claude mcp add claude-flow -- npx ruflo@latest mcp start 를 실행하고, 연결됐는지 확인해서 알려 줘.

직접 치고 싶으면 공식 안내의 이 줄이에요.

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

이렇게 보이면 성공이에요. 클로드가 연결 목록에 claude-flow가 들어갔다고 알려 줘요.

② 한 번에 돌릴 에이전트 수 맞추기. 그런데 에이전트가 60개 넘게 있다고 60개를 한꺼번에 돌리는 게 아니에요. Ruflo 저장소의 지시 파일은 서로 잘 맞춰 일하려면 한 번에 6개에서 8개만 돌리라고 해요. 팀을 짜는 모양도 여러 가지인데, 권하는 건 관리자가 작업자를 이끄는 방식과 서로 고르게 이어지는 방식을 섞은 hierarchical-mesh예요. 아래 문장을 붙여 넣으세요.

Ruflo 설정에서 한 번에 돌리는 에이전트 수(maxAgents)를 8 이하로, 팀 모양(topology)을 hierarchical-mesh로 맞춰 줘. 바꾸기 전 값과 바꾼 뒤 값을 같이 보여 줘.

이렇게 보이면 성공이에요. 클로드가 바꾸기 전 값과 바꾼 뒤 값을 나란히 보여 줘요.

③ 평소처럼 쓰기. 이제 따로 배울 명령은 없어요. 공식 소개 글은 도구 314개나 명령 26개를 외울 필요 없다고 해요. 클로드 코드에 하던 대로 일을 시키면 Ruflo가 뒤에서 일을 나누고, 잘된 방식을 기억해요.

3. 백업할 파일

그런데 Ruflo 설치가 설정 파일을 덮어쓴 일이 실제로 있었어요. 그래서 이 세 파일은 깔기 전에 꼭 복사해 두고, 문제가 생기면 이 복사본으로 되돌려요.

파일	무엇이 들어 있나	설치 뒤 실제로 있었던 일
`CLAUDE.md`	클로드에게 주는 내 규칙	통째로 Ruflo 내용으로 바뀜
`.mcp.json`	클로드 코드에 연결한 도구 목록	다른 연결 4개가 지워지고 claude-flow 하나만 남음
`.claude/settings.json`	자동 실행 장치와 모델 설정	내가 만든 자동 실행 장치 11개가 지워지고 모델 설정이 새로 들어감

이 기록은 init --force로 다시 깔았을 때 생긴 일이에요. 그때 CLAUDE.md는 .pre-ruflo라는 이름으로 백업이 남았지만 나머지 둘은 손으로 되돌려야 했어요.

내 컴퓨터 전체에 쓰이는 ~/.claude/CLAUDE.md도 챙기세요. Ruflo 저장소에는 3.5.78 버전에서 이 파일이 4줄짜리로 덮어써졌고 백업도 없었다는 보고가 있어요. 원래 42줄이던 규칙이 다 사라졌대요. 관리자는 3.5.79 버전부터 고쳤다고 답했어요. 바꾸기 전에 늘 ~/.claude/CLAUDE.md.backup-날짜 이름으로 복사본을 만들고, 내용은 덮어쓰지 않고 뒤에 덧붙인대요.

① 백업이 다 있는지 확인하기. 아래 문장을 붙여 넣으세요.

이 폴더와 ~/.claude 폴더에서 이름에 .before-ruflo, .pre-ruflo, .backup- 이 들어간 파일을 모두 찾아서, 원래 파일 이름과 짝지어 목록으로 보여 줘.

이렇게 보이면 성공이에요. 네 파일마다 짝이 되는 복사본이 하나 이상 보여요.

② 되돌리기. 설정이 이상해졌을 때만 아래 문장을 붙여 넣으세요.

CLAUDE.md, .mcp.json, .claude/settings.json, ~/.claude/CLAUDE.md 를 .before-ruflo 복사본과 비교해서 사라진 내용을 보여 줘. 내가 "되돌려"라고 하기 전에는 아무 파일도 바꾸지 마.

이렇게 보이면 성공이에요. 클로드가 사라진 줄을 먼저 보여 주고 내 대답을 기다려요.

③ 앞으로 전체 설정 파일을 아예 안 건드리게 하기. 관리자 답글에 따르면 3.5.79 버전부터는 아래 설정을 켜 두면 Ruflo가 ~/.claude/CLAUDE.md를 전혀 바꾸지 않아요.

내 셸 설정 파일(~/.zshrc)에 export CLAUDE_FLOW_SKIP_GLOBAL_CLAUDE_MD=1 한 줄을 넣어 줘. 이미 있으면 그대로 두고 알려 줘.

이렇게 보이면 성공이에요. 클로드가 그 줄을 넣었거나 이미 있다고 알려 줘요.

막히면 이렇게

화면에 빨간 오류 글이 나오면 그 글을 그대로 복사해 클로드 코드에 붙여 넣고 “이 오류 왜 났어? 쉽게 알려 주고 고쳐 줘”라고 하세요.
윈도에서 'bash' is not recognized가 나오면 curl 줄 대신 npx ruflo@latest init wizard 줄을 쓰세요. 공식 안내가 두 줄은 같은 설치로 이어진다고 해요.
설치 뒤 클로드가 예전 규칙을 잊은 것 같으면 3단계 ② 문장으로 사라진 내용부터 확인하세요.

다음에 해 볼 것

다시 설치하거나 업데이트하기 전에는 1단계 ① 복사를 또 해 두세요. 다시 깔면 지웠던 파일도 되살아나요.
공식 저장소 https://github.com/ruvnet/ruflo 의 Quick Start 문서에서 설치 방식별 차이를 더 볼 수 있어요.

여기서부터는

나머지도 무료예요.

메일 주소만 남기시면 이 가이드 뒷부분과 다른 가이드까지 전부 열려요. 새 가이드가 나올 때만 메일을 보내 드려요.

결제 정보는 묻지 않아요. 메일 아래 해지 링크 한 번이면 메일이 멈춰요.