시작 가이드

마블로 시작하기

설치부터 첫 미션 실행까지, 신규 사용자가 순서대로 따라올 수 있는 스텝바이스텝 가이드입니다. 왼쪽 목차로 원하는 단계로 바로 이동할 수 있어요.

16단계 중 1단계

앱 다운로드 · 설치 · 첫 실행

가장 먼저 마블로 데스크톱 앱을 내려받아 설치합니다. macOS와 Windows를 지원하며, 첫 실행 시 필요한 에이전트 CLI가 자동으로 설치됩니다.

다운로드 페이지에서 앱 받기

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

마블로 다운로드 페이지에서 macOS·Windows 빌드를 선택하는 화면
스크린샷 준비 중

설치하고 처음 실행하기

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

처음 실행 시 macOS Gatekeeper 또는 Windows SmartScreen 경고가 나타날 수 있습니다. macOS는 '시스템 설정 > 개인정보 보호 및 보안'에서 '확인 없이 열기'를, Windows는 '추가 정보 > 실행'을 선택해 진행하세요. 정식 서명된 빌드입니다.

마블로 앱 최초 실행 시 나타나는 시작 화면
스크린샷 준비 중

필수 CLI · 마블로 MCP 자동 설치

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

따로 설치할 것은 없습니다. 다음 단계에서 각 CLI에 로그인(인증)만 하면 바로 사용할 수 있습니다.

마블로 첫 실행 시 필수 CLI와 MCP가 자동 설치되는 진행 화면
스크린샷 준비 중
26단계 중 2단계

CLI 인증(로그인)

필수 CLI는 자동으로 설치되므로, 사용자가 할 일은 각 CLI에 로그인(인증)하는 것뿐입니다.

Claude Code 로그인

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

shell
claude login

Codex 로그인

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

shell
codex login

Antigravity 인증

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

세 에이전트 중 실제로 사용할 CLI만 인증해도 됩니다. 여러 에이전트를 동시에 운용하려면 모두 인증해 두세요.

인증 확인

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

인증 정보는 각 CLI가 로컬에 저장하며, 마블로는 계정 비밀번호나 API 키를 저장하지 않습니다. 모든 실행은 사용자의 컴퓨터에서 이뤄집니다.

36단계 중 3단계

폴더 선택 · 프로젝트 자동 등록

작업할 코드 폴더를 선택하기만 하면, 별도 확인 절차 없이 프로젝트가 자동으로 등록되고 오케스트레이터가 함께 기동됩니다.

폴더 선택 = 무클릭 자동 등록

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

git 저장소인 폴더를 권장합니다. 마블로는 격리된 git worktree로 여러 에이전트를 안전하게 병렬 실행하고, 변경 내용을 diff로 추적합니다.

마블로에서 폴더를 선택하면 무클릭으로 프로젝트가 등록되는 화면
스크린샷 준비 중

오케스트레이터 자동 기동

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

먼저 한 개의 에이전트로 작은 작업을 돌려 흐름에 익숙해진 뒤, 여러 에이전트를 동시에 운용하는 것을 권장합니다.

프로젝트 등록과 동시에 오케스트레이터가 자동 기동된 화면
스크린샷 준비 중
46단계 중 4단계

첫 미션 · 플로우 실행

이제 실제 작업을 지시할 차례입니다. 오케스트레이터에게 첫 미션을 맡겨 보세요.

미션 작성

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

칸반 보드에 미션이 티켓으로 분해되어 올라온 화면
스크린샷 준비 중

실행 · 진행 추적

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

리뷰 게이트

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

에이전트의 변경을 병합하기 전에 반드시 diff를 검토하세요. 마블로는 병합 전 사람의 REVIEW 게이트를 두어 의도치 않은 변경이 그대로 반영되는 것을 막습니다.

56단계 중 5단계

결제 · 플랜

마블로는 무료로 시작할 수 있으며, 더 많은 기능이 필요하면 Pro로 업그레이드할 수 있습니다.

플랜 살펴보기

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

에이전트 CLI(Claude·Codex·Antigravity)의 사용 요금은 각 제공사 계정에 별도로 청구되며, 마블로 구독과는 별개입니다.

구독 관리

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

66단계 중 6단계

자주 묻는 질문 · 도움말

막히는 부분이 있으면 아래 자료가 도움이 됩니다.