GitHub ruvnet/ruflo 설치 및 활용 가이드: Claude Code Plugin vs CLI

ruFlo란?

ruFlo는 지능형 에이전트 기반의 애플리케이션을 구축하기 위한 프레임워크입니다. 여러 에이전트가 협력하여 복잡한 작업을 수행하는 멀티플레이어 스웜, 자율 워크플로우 조정, 대화형 AI 시스템 구축 등을 지원합니다. 적응형 메모리, 자기 학습 기능 등을 포함하고 있습니다.

설치 경로 선택

ruFlo는 두 가지 설치 경로를 제공하며, 필요한 기능에 따라 선택할 수 있습니다.

• Claude Code Plugin (경량, 슬래시 명령어만): 특정 플러그인의 명령어만 사용하고 싶을 때 적합합니다. 워크스페이스에 파일을 추가하지 않으면서 간단한 기능을 바로 사용할 수 있습니다.
• CLI install (npx ruflo init) (전체 기능): 프로덕션 환경에서 ruFlo의 모든 기능(98개 에이전트, 60개 이상 명령어, 30개 스킬, MCP 서버, 훅, 데몬 등)을 사용하고 싶을 때 적합합니다. .claude/, .claude-flow/ 등 관련 파일들이 워크스페이스에 생성됩니다.

Path A: Claude Code Plugin 설치 (간편 모드)

이 경로는 워크스페이스에 별도 파일 추가 없이, 특정 플러그인의 슬래시 명령어만 사용하고 싶을 때 유용합니다.

1. Claude IDE에서 플러그인 설치: 사용하려는 ruFlo 관련 Claude Code Plugin을 Claude IDE에 설치합니다.
2. 슬래시 명령어 사용: IDE 내에서 /를 입력하여 설치된 플러그인의 사용 가능한 명령어를 확인하고 실행합니다.

예시: 특정 플러그인이 create-agent 명령어를 제공한다면, /create-agent를 입력하여 해당 기능을 즉시 사용할 수 있습니다.

Path B: CLI Install (전체 기능 모드)

이 경로는 ruFlo의 모든 기능을 프로덕션 환경에서 활용하고자 할 때 사용합니다.

1. Node.js 및 npm 설치 확인: 시스템에 Node.js와 npm이 설치되어 있는지 확인합니다. (버전 호환성은 ruFlo 공식 문서를 참고하세요.)
2. ruFlo 초기화: 터미널 또는 명령 프롬프트에서 다음 명령어를 실행합니다.

   npx ruflo init
   

3. 설치 진행: 명령어를 실행하면 ruFlo 설치 및 초기화 과정이 시작됩니다. MCP 서버 등록, 훅 설치 등이 자동으로 진행됩니다.
4. 설정 확인: 설치 후 워크스페이스에 .claude/, .claude-flow/, CLAUDE.md 등의 파일과 설정이 생성됩니다. 이 파일들을 통해 ruFlo의 동작을 커스터마이징할 수 있습니다.

활용 사례

상황 1: 새로운 AI 에이전트 아이디어를 빠르게 프로토타이핑하고 싶을 때

• 누가: AI 개발자
• 무엇을 하려다 막혔나: 복잡한 설정 없이, 간단한 에이전트 생성 명령어를 바로 써보고 싶었으나, 전체 CLI 설치는 부담스러웠음.
• 어떤 단계 사용: Path A - Claude Code Plugin 설치 및 사용
• 결과: IDE 내에서 /create-agent (가정) 명령어를 사용하여 즉시 새로운 에이전트 프로토타입을 생성하고 테스트할 수 있게 되었다. 별도의 설치 과정 없이 아이디어를 빠르게 검증할 수 있었다.

상황 2: 여러 자율 에이전트가 협력하는 복잡한 워크플로우를 구축하고 싶을 때

• 누가: 백엔드 개발자
• 무엇을 하려다 막혔나: 98개의 내장 에이전트와 30개 이상의 스킬을 활용하여 복잡한 자율 워크플로우를 완전히 구현하고 싶었으나, CLI 설치 옵션이 필요했음.
• 어떤 단계 사용: Path B - CLI Install (npx ruflo init)
• 결과: npx ruflo init 명령어로 ruFlo 전체 기능을 설치하고, MCP 서버 및 훅 설정을 통해 여러 에이전트 간의 복잡한 상호작용과 워크플로우 조정을 성공적으로 구축할 수 있었다. 프로덕션 수준의 에이전트 시스템을 운영할 준비가 되었다.

출처: https://github.com/ruvnet/ruflo