바이브코딩 도구마다 하나씩 아쉬운 것이 있다. orca는 "이게 있었으면" 했던 것들이 전부 들어 있고, 그 위에 비개발자에게 가장 필요한 안전망까지 갖췄다.
비개발자에게 orca를 추천하는 이유
다른 바이브코딩 도구를 쓰며 한 번쯤 아쉬웠던 것들이 orca에는 전부 들어 있다. 추천 이유 다섯 가지와 프로젝트·작업 트리 개념 정리, 설치부터 첫 작업까지의 가이드.
다른 도구를 쓰며 한 번쯤 아쉬웠던 것들
클로드 데스크탑 앱은 파일을 만들고 보여주는 것까지 많이 좋아졌지만, 대화 중심이라 프로젝트 여러 개를 나란히 놓고 관리하는 구조는 아니다. VS Code나 Antigravity는 프로젝트 하나를 열어두는 구조라, 다른 프로젝트로 넘어가려면 창을 새로 열어야 한다. 화면이 어떻게 나왔는지 보려면 브라우저를 띄우고, 수정을 시키려면 어느 부분인지 말로 길게 설명해야 한다. 하나하나는 사소하지만 매일 반복되면 쌓인다.
orca는 그 "있었으면 했던 것"들이 전부 들어 있는 앱이다. 무료 오픈소스라 비용 부담도 없다. 뒤에서 하나씩 풀어가겠지만, 먼저 목록부터 보면 이렇다.

비개발자에게 추천하는 이유 다섯 가지
1. 지시부터 확인까지 한 화면에서 끝난다. 에이전트 터미널, 파일 탐색기, 내장 브라우저가 한 화면에 있다. 에이전트가 만든 파일을 그 자리에서 열어보고, 화면 결과까지 같은 창에서 확인한다. 결과를 보려고 폴더 앱과 브라우저를 오갈 필요가 없다. 나는 이 확인 환경이 없어서 보조 도구를 따로 만들어 쓰던 사람인데, orca에는 전부 기본으로 들어 있다.

2. 수정할 곳을 말 대신 클릭으로 지목한다. 비개발자가 바이브코딩에서 제일 답답한 순간은 수정 요청이다. "위에서 두 번째 파란 박스 있잖아, 그 안의 작은 글씨"처럼 말로 위치를 설명하다가 에이전트가 엉뚱한 곳을 고치는 일이 반복된다. orca의 디자인 모드에서는 내장 브라우저에 뜬 화면에서 고치고 싶은 요소를 클릭하면, 그 요소의 정보가 스크린샷과 함께 에이전트에게 그대로 전달된다. 설명이 필요 없어지는 것이다.

3. 에이전트가 원본을 망칠 수 없는 구조다. 작업마다 원본의 복사본이 만들어지고 에이전트는 그 안에서만 일한다. 마음에 들면 반영하고, 마음에 안 들면 통째로 버린다. 바이브코딩 환경에서 이것보다 좋은 안전장치를 아직 못 봤다.
4. 프로젝트 여러 개를 한 앱에서 관리한다. 만들고 있는 사이트, 콘텐츠 원고, AI로 만든 도구를 왼쪽 패널에 전부 등록해두고 클릭 한 번으로 오간다. 프로젝트마다 창을 새로 여는 대신 orca 하나가 내 모든 AI 작업의 허브가 된다.

5. 폰으로 이어서 일한다. 전용 모바일 앱으로 밖에서도 작업 상황을 확인하고 다음 지시를 보낸다.
이 중 비개발자에게 가장 중요한 것은 3번인데, 처음 보는 개념이라 설명이 필요하다. 여기서부터 차근히 풀어본다.
진짜 차별점은 안전망이다
클로드 데스크탑 앱이든, VS Code든, Antigravity든, AI에게 일을 시키면 에이전트는 내 프로젝트 폴더의 파일을 직접 고친다. 잘 돌아가면 문제가 없지만, 어제까지 멀쩡하던 결과물이 오늘 지시 한 번에 망가지는 일이 생긴다.
개발자는 이 상황이 무섭지 않다. git이라는 도구로 모든 변경을 기록해두고, 잘못되면 이전 상태로 되돌리기 때문이다. 문제는 바이브코딩을 하는 사람 대부분이 git을 쓰지 않는다는 점이다. 컴퓨터에 git이 설치되어 있어도 마찬가지다. git은 시점마다 기록을 남겨둬야 그 지점으로 되돌아갈 수 있는 도구라서, 기록하는 습관 없이 설치만 되어 있는 상태로는 아무것도 지켜주지 않는다. 에이전트가 파일을 잘못 고치면 그것으로 끝이고, 되돌릴 방법이 없다. 그래서 다들 작업 전에 폴더를 통째로 복사해두거나, 불안한 채로 시킨다.
orca가 하는 일이 바로 이 기록이다. 작업을 시작할 때마다 되돌아갈 지점을 자동으로 만들어주니, 기록하는 습관이 없어도 개발자와 같은 안전망이 생긴다.
이 구조를 이해하는 데 필요한 개념은 프로젝트와 작업 트리, 두 개뿐이다. 이 둘만 잡으면 orca의 좋은 점이 전부 이해된다.
개념 1: 프로젝트는 내가 관리하는 폴더들의 목록이다
orca 왼쪽 패널에는 프로젝트가 여러 개 나열된다. 프로젝트는 어려운 개념이 아니라 그냥 내 컴퓨터의 폴더 하나다. 만들고 있는 사이트가 폴더 하나, 콘텐츠 원고 모음이 폴더 하나, AI로 만든 도구가 폴더 하나라면, 그 폴더들을 각각 프로젝트로 등록하는 것이다.
일단은 프로젝트 = orca에 등록한 작업 폴더, 이 정도로 충분하다. 등록할 때 알아두면 좋은 세부 사항은 아래 가이드에 정리해뒀다.
개념 2: 작업은 복사본에서 하고, 확인한 것만 원본에 반영된다
orca 화면에서는 프로젝트마다 main 옆에 "기본"이라는 표시가 붙어 있다. 어렵게 들리지만 정체는 단순하다. 지금까지 확인이 끝난 내 원본이 여기에 담겨 있다.
새 작업을 시작하면 orca는 이 원본을 그대로 복사한 작업 공간을 만들고, 에이전트(Claude Code 등)를 하나 붙여준다. 이 묶음이 작업 트리다. 에이전트는 복사본 안에서만 일하기 때문에, 작업이 진행되는 동안 원본은 아무것도 바뀌지 않는다.
작업이 끝나면 결과를 확인하고, 마음에 들면 원본에 합친다. 합친 결과가 새로운 원본이 된다. 원본이 바뀌는 통로는 이 합치기 하나뿐이고, 합칠지 말지는 언제나 내가 정한다. 마음에 안 들면 작업 트리를 통째로 버리면 되고, 그 경우 원본은 처음 그대로다.
비개발자가 작업 전에 폴더를 통째로 복사해두던 그 방어가 지시 하나마다 자동으로 일어난다고 생각하면 정확하다. 이 구조는 내부적으로 git을 쓰지만, git을 배울 필요는 없다. 설치만 되어 있으면 쓰는 것은 orca가 알아서 한다.
두 개념이 잡혔으면 이제 orca 사이드바가 그대로 읽힌다. 실제 화면의 각 줄이 어느 개념인지 대입하면 이렇다.
같은 파일을 두 작업이 동시에 고치면?
여기까지 읽으면 생기는 의문 하나만 짚고 가자. 결론부터 말하면 덮어써질 걱정은 없다. 두 작업이 같은 부분을 서로 다르게 고친 채 합치려 하면 조용히 덮어써지는 대신 "충돌"로 감지되고, 겹친 지점을 보면서 어느 쪽을 남길지 내가 정하게 된다. 최악의 상황이 "데이터가 날아감"이 아니라 "선택지를 골라야 함"인 것이다.
다만 그 선택도 번거로우니, 처음에는 같은 파일을 동시에 고치는 작업만 피하면 된다. 자세한 동작은 아래 가이드에 정리해뒀다.
그래서 언제 여러 개를 돌리는가
미리 말해두면, 여러 개를 동시에 돌리는 것은 필수가 아니다. 한 번에 작업 하나씩, 끝나면 확인하고 합치는 식으로만 써도 orca를 쓸 이유는 충분하다. 에이전트가 원본을 망칠 걱정 없이 일을 시킬 수 있고, 파일 탐색기부터 내장 브라우저까지 기본 UI의 완성도가 높아서 작업 하나만 돌려도 다른 도구보다 편하기 때문이다. 여러 개를 돌리는 것은 일이 늘어난 다음에 자연스럽게 오는 단계다.
에이전트에게 일을 맡기면 몇 분씩 걸린다. 하나만 돌리면 그동안 나는 결과를 기다리며 논다. 성격이 다른 작업이 쌓여 있다면 기다리는 대신 다른 작업 트리를 열어 다음 지시를 내리면 된다. 나는 콘텐츠 작업 하나, 도구 개발 하나처럼 서로 파일이 겹치지 않는 단위로 나눠 두세 개를 돌리고, 내가 결과를 확인하는 속도에 맞춰 개수를 조절한다.
모바일 연동: 밖에서도 작업이 굴러간다
orca에는 전용 모바일 앱(iOS·Android)이 있다. 폰에서 무언가를 실행하는 것이 아니라, 컴퓨터에서 돌아가는 작업을 폰으로 보고 조작하는 방식이다. 코드와 에이전트는 전부 컴퓨터에 있고, 폰은 화면을 보여주고 내 입력을 전달하는 역할만 한다. 연결은 데스크톱 orca가 띄워주는 일회용 페어링 코드를 폰 앱에 입력하면 끝나고, 이후 두 기기가 직접 통신한다.
쓰임새는 명확하다. 에이전트에게 일을 시켜놓고 외출하면, 작업이 끝났을 때 폰으로 알림이 오고, 결과를 확인한 뒤 그 자리에서 다음 지시를 보낼 수 있다.

이것이 진가를 발휘하는 조합이 맥미니다. 맥미니처럼 항상 켜둘 수 있는 컴퓨터에 orca를 설치해두고 폰으로 연결하면, 카페에서든 이동 중이든 에이전트에게 일을 시키고 결과를 확인하는 것이 가능해진다. 집에 있는 컴퓨터가 나 대신 일하는 작업 기지가 되고, 폰은 그 기지에 지시를 내리는 리모컨이 되는 셈이다. 에이전트 작업의 특성상 지시 한 번에 몇 분씩 걸리기 때문에, 자리에 붙어 있지 않아도 일이 굴러가는 이 구조와 잘 맞는다.
언제 넘어오면 되는가
바이브코딩이 처음이면 orca부터 쓸 이유가 없다. Antigravity가 제일 쉽고, 만들어보는 단계에서는 그것으로 충분하다.
갈아탈 시점은 결과물이 소중해지는 순간이다. 며칠을 들여 만든 사이트, 계속 다듬어온 문서, 실제로 쓰고 있는 도구처럼 망가지면 곤란한 것이 생겼는데 git은 쓸 줄 모른다면, 그때가 orca로 넘어올 때다. 클로드 데스크탑 앱이나 VS Code에서 에이전트가 파일을 고칠 때마다 조마조마했던 사람일수록 체감이 크다. cmux를 쓰고 있는 사람에게도 권한다. 병렬 능력은 그대로 가져가면서 확인 환경이 채워진다.
허들은 하나다. git을 배울 필요는 없지만 설치는 되어 있어야 한다. 설치는 한 번이면 끝나고, 아래 가이드에 그대로 따라 하면 되게 정리해뒀다.
도구는 앞으로도 계속 바뀔 것이다. 남는 것은 도구가 아니라 골격이다. 에이전트가 일할 환경을 설계한다는 관점은 어떤 도구로 갈아타도 그대로 가져갈 수 있고, 그 관점을 처음부터 세우는 방법은 AI 네이티브 퀀텀점프에 정리해뒀다.
orca 시작 가이드: 설치부터 첫 작업 완료까지
여기서부터는 실제로 따라 하는 순서다. 이 순서대로 하면 설치부터 첫 작업을 원본에 합치는 것까지 한 번에 끝난다.
1. 준비물 확인: git과 에이전트
orca를 설치하기 전에 두 가지가 컴퓨터에 있어야 한다.
git: 작업 트리라는 격리된 복사본을 만들 때 orca가 git의 기능을 쓰기 때문에 반드시 필요하다. 설치만 하면 되고, 이후에 직접 다룰 일은 없다.
- macOS: 터미널을 열고
git --version을 입력한다. 설치 안내 창이 뜨면 그대로 설치하면 된다. - Windows: git-scm.com에서 설치 파일을 받아 기본 옵션 그대로 설치한다.
설치 확인은 터미널(Windows는 명령 프롬프트)에서 git --version을 입력해 버전 번호가 나오는지 보면 된다.
에이전트: orca는 에이전트를 직접 내장한 것이 아니라 내 컴퓨터에 설치된 에이전트(Claude Code, Codex 등)를 불러 쓴다. 이미 Claude Code를 쓰고 있다면 준비가 끝난 것이고, 없다면 먼저 설치해야 한다.
2. orca 설치와 첫 실행
onorca.dev에서 운영체제에 맞는 버전을 내려받아 설치한다. macOS는 Apple Silicon용과 Intel용이 나뉘어 있으니 내 기기에 맞는 것을 받는다. Windows와 Linux도 지원한다.
처음 실행하면 두 가지를 물어본다.
- 홈 폴더 접근 권한: 프로젝트 폴더를 등록하려면 필요하니 허용한다.
- 기존 설정 가져오기: Claude Code를 쓰고 있었다면 그 설정을 가져올지 물어보는데, 가져오기를 선택하면 로그인이나 설정을 다시 할 필요가 없다.
그러면 프로젝트를 추가하라는 빈 화면이 나온다. 여기까지 왔으면 설치는 끝났다.
3. 프로젝트 등록
사이드바에서 저장소 추가를 눌러 작업할 폴더를 선택한다. 등록하면 왼쪽 패널에 프로젝트가 나타난다.
등록하려는 폴더가 git 저장소가 아니라면 세 가지 경우로 나뉜다.
- 부모 폴더 어딘가에 저장소가 있는 경우: orca가 위로 올라가며 저장소를 찾아 그 상위 폴더를 기준으로 잡는다. 내가 고른 폴더보다 큰 범위가 프로젝트로 잡혔다면 이 경우다. 작업 트리도 그 저장소 전체의 복사본으로 만들어진다.
- 어디에도 저장소가 없는 경우: 폴더 모드라는 제한된 상태로 열린다. 작업 자체는 가능하지만 작업 트리, 변경 내역 비교 같은 git 기반 기능이 전부 꺼진다. 이 글에서 설명한 안전망이 없는 상태이므로 그대로 쓰지 않는 것이 좋다.
- 해결법: 폴더를 등록할 때 뜨는 대화상자에서 git 저장소로 전환하는 옵션을 선택하면 된다. orca가 그 폴더를 저장소로 만들어주고, 이후부터는 정상적으로 작업 트리를 쓸 수 있다.
4. 첫 작업 트리 만들기
프로젝트 이름 옆의 + 버튼을 누르면 "작업 트리 만들기" 대화상자가 뜬다.

채울 것은 사실상 두 개다.
- 프로젝트: 어느 폴더에서 일할지 고른다. 방금 등록한 프로젝트가 선택되어 있을 것이다.
- 에이전트: Claude 등 어떤 에이전트에게 시킬지 고른다.
이름은 선택 사항이라 비워두면 orca가 알아서 지어주고, 나머지 항목(GitHub, 브랜치 등)은 지금 단계에서는 몰라도 된다. "작업 트리 만들기" 버튼을 누르면 격리된 복사본이 만들어지고 에이전트가 켜진 화면이 열린다.
5. 지시하고, 확인하고, 합치기
이제 평소 쓰던 대로 에이전트에게 지시하면 된다. 첫 작업은 파일 하나를 수정하는 가벼운 지시가 좋다. 전체 흐름을 익히는 것이 목적이기 때문이다.
- 지시: 열린 에이전트 화면에 평소처럼 할 일을 적는다.
- 확인: 작업이 끝나면 파일 탐색기에서 만들어진 파일을 바로 열어본다. 변경 내역 화면에서는 무엇이 어떻게 바뀌었는지 원본과 비교해서 보여준다. 화면을 고치는 작업이었다면 내장 브라우저로 결과를 띄워보고, 수정할 곳이 보이면 디자인 모드로 그 요소를 클릭해 바로 다음 지시로 넘긴다.
- 합치기 또는 버리기: 마음에 들면 합쳐서 원본에 반영하고, 마음에 안 들면 작업 트리를 삭제한다. 삭제해도 원본은 그대로다.

이 지시, 확인, 합치기 한 바퀴가 orca 사용의 전부다. 이후에는 작업 트리를 두세 개로 늘려보면서 본문에서 설명한 병렬 작업을 시도하면 된다.
6. 모바일 연동
폰에 orca 앱을 설치한다. iOS는 App Store에서 받고, Android는 onorca.dev에서 안내하는 방법으로 설치한다. 데스크톱 orca의 계정/상태 메뉴에서 페어링을 열면 일회용 코드가 뜨는데, 이 코드를 폰 앱에 입력하면 연결이 끝난다. 이후 에이전트가 작업을 마치면 폰으로 알림이 오고, 폰에서 결과 확인과 다음 지시까지 가능하다.
7. 처음에 당황하기 쉬운 지점
- 에이전트의 작업 결과물은 원본 폴더가 아니라 작업 트리에 먼저 생긴다. 원본 폴더만 보고 "왜 아무 변화가 없지?"라고 당황하지 않아도 된다. 확인 후 합치는(merge) 단계를 거쳐야 원본에 반영된다.
- 결과가 마음에 안 들면 합치지 말고 그 작업 트리를 버리면 된다. 원본은 그대로다. 이 "버려도 된다"는 감각이 orca를 쓰는 핵심 이유이니, 초반에 한 번 일부러 버려보는 것도 좋다.
- 같은 파일을 건드리는 작업 두 개를 동시에 돌리면 이렇게 된다: 합치기 전에는 서로 아무 영향이 없고, 먼저 합치는 쪽이 그대로 원본에 반영되며, 나중에 합치는 쪽에서 "충돌"이 감지된다. orca가 편집 화면에 충돌 지점을 표시해주니 어느 쪽을 남길지 정해서 마무리하면 되고, 데이터가 날아가는 일은 없다. 다만 번거로우니 병렬 작업은 서로 다른 영역을 건드리도록 나누는 것이 요령이고, 같은 파일을 고치는 작업 두 개라면 순서대로 돌리면 된다.
흔들리지 않고 AI를 다루려는 분들을 위한 책
새 도구가 매달 쏟아져도, 무엇이 나오든 통하는 기준을 한 권으로 정리했습니다
2장까지 무료책 보러가기

