마블로 시작하기

다운로드 페이지에서 사용 중인 운영체제(macOS 또는 Windows)에 맞는 최신 빌드를 내려받으세요. Apple Silicon·Intel Mac, Windows 10/11을 지원합니다.

내려받은 설치 파일을 실행합니다. macOS는 .dmg를 열어 마블로를 응용 프로그램 폴더로 드래그하고, Windows는 설치 관리자를 그대로 진행하면 됩니다.

첫 실행 시 마블로가 필수 에이전트 CLI(Claude Code · Codex · Antigravity)와 마블로 MCP를 자동으로 설치합니다. 하네스 탭에서 직접 설치할 필요가 없으며, 잠시 기다리면 설치가 끝납니다.

터미널에서 아래 명령을 실행하고 안내에 따라 브라우저에서 Anthropic 계정으로 로그인하세요.

claude login

Codex도 동일하게 로그인합니다. OpenAI 계정으로 인증하세요.

codex login

Antigravity도 로그인해 인증합니다. 처음 사용할 때 나타나는 안내에 따라 계정으로 로그인하세요.

모델을 연결하는 방법은 두 가지입니다. 네이티브 CLI 계정에 로그인하거나, Bring Your Own Model(BYOM)으로 벤더 키를 등록할 수 있습니다. 벤더 키를 등록하면 네이티브 CLI 계정 대신 해당 모델로 에이전트가 부팅됩니다. GLM·Kimi·MiniMax와 Ollama를 통한 로컬 모델을 지원합니다.

로그인이 끝나면 각 CLI가 인증된 상태로 전환됩니다. 상태가 갱신되지 않으면 앱을 재시작해 보세요.

작업할 로컬 폴더를 선택하면 마블로가 곧바로 프로젝트로 등록합니다. '등록하시겠습니까' 같은 확인 클릭은 없습니다 — 폴더 선택만으로 끝납니다. 등록한 프로젝트는 사이드바에서 전환할 수 있습니다.

프로젝트가 등록되면 오케스트레이터가 자동으로 기동돼 전용 터미널 세션이 열립니다. 오케스트레이터는 요청을 분석해 작업을 티켓으로 나누고, 역할(프론트엔드·백엔드 등)과 모델(Claude·GPT/Codex·Antigravity)을 배정해 각 에이전트를 스폰합니다.

만들고 싶은 기능이나 고치고 싶은 버그를 자연어로 오케스트레이터에게 설명합니다. 오케스트레이터가 이를 티켓으로 분해해 칸반 보드에 올립니다.

에이전트들이 각 티켓을 병렬로 처리하는 동안 칸반 보드에서 진행 상황을 실시간으로 추적할 수 있습니다. 각 에이전트의 터미널 출력도 탭에서 확인할 수 있습니다.

작업이 끝난 티켓은 REVIEW 상태로 이동합니다. 사람이 변경 내용을 확인하고 승인해야 병합됩니다.

오케스트레이터는 목표를 티켓 그래프로 분해한 뒤 각 태스크에 맞는 모델을 스폰합니다. 모델 선택에는 태스크 성격·비용·사용 가능한 쿼터를 고려하며, 한 벤더에 전체 fleet이 갇히지 않도록 모델을 다양화합니다.

Lanes 탭에서 레인을 만들고 작업을 설명한 뒤 시작하세요. 독립적인 작업마다 반복하면 각 레인이 서로 나란히 실행됩니다.

각 레인에는 독립적인 모델 선택기가 있습니다. 해당 태스크에 맞는 모델을 고르고, 모델 레지스트리에 표시되는 BYOM 또는 로컬 옵션도 선택할 수 있습니다.

레인 작업은 자체 lane context로 태깅되고 격리된 worktree에서 실행됩니다. 레인 터미널이나 상세 화면에서 미션 티켓과 섞이지 않게 상태·모델·worktree·재시작 액션을 확인하세요.

Board는 프로젝트 티켓을 칸반으로 보여줍니다. 대기·진행 중·리뷰·완료 상태를 확인하고, 티켓을 열어 에이전트와 변경 내용을 살펴보세요.

Agents에서는 에이전트별 라이브 터미널과 현재 상태를 봅니다. 에이전트 watchdog이 중단된 작업을 재연결하거나 자가 복구하고, 패널에는 최신 모델과 활동이 표시됩니다.

Code는 선택한 worktree의 파일과 diff를 엽니다. 병합 전에 정확한 변경을 확인하고 리뷰 피드백을 남기세요.

Worktrees에서는 티켓마다 만들어진 격리 브랜치와 파일 시스템 작업공간을 봅니다. 병렬 에이전트가 별도 worktree에서 작업하므로 개발 중 서로 무관한 변경이 충돌하지 않습니다.

Lanes는 앞서 설명한 직접 병렬 모드입니다. 레인마다 모델을 골라 오케스트레이터 미션과 나란히 독립 에이전트를 실행합니다.

Usage는 에이전트와 모델 활동을 기간별로 요약하고, 기록된 일별 비용 합계도 보여줍니다. 어떤 벤더와 모델이 예산이나 쿼터를 사용했는지 확인하세요.

History는 진행·비용·provenance·병합 이벤트를 남기는 append-only 작업 원장입니다. 완료된 뒤에도 무엇이 일어났는지 재구성하고 관련 티켓이나 diff를 열 수 있습니다.

Free 플랜으로 핵심 기능을 무료로 사용할 수 있습니다. Pro 플랜은 월 구독으로 추가 기능을 제공합니다. 가격 페이지에서 플랜별 차이를 확인하세요.

로그인 후 내 계정에서 구독 상태와 결제 내역을 확인하고 관리할 수 있습니다.

FAQ에서 자주 묻는 질문의 답을 확인하고, 문제가 있으면 버그를 신고해 주세요. 파운더 프로그램 정보도 함께 살펴보세요.