오르카 (Orca) 이해하기

🤔 에이전트 두 개를 같은 폴더에서 돌리다 파일이 꼬일 때

클로드 코드에게 로그인 화면을 고쳐 달라고 하고, 기다리는 동안 코덱스에게 다른 버그를 맡기면 시간이 절약될 것 같습니다. 그런데 두 에이전트가 같은 폴더에서 일하면 한쪽이 고친 파일을 다른 쪽이 덮어쓰거나, 테스트를 돌리다 서로의 미완성 코드 때문에 실패하는 일이 생깁니다.

오르카는 이 문제를 풀려고 나온 도구입니다. 지금부터 오르카가 무엇인지, 그 바탕이 되는 git 워크트리는 어떤 기능인지, VS Code와 무엇이 다른지, 쓰기 전에 알아 둘 비용과 한계를 정리합니다. 화면과 기능은 설치된 버전에 따라 달라질 수 있으므로 공식 안내와 실제 작업 경로를 함께 확인합니다.

🔑 오르카의 정의

오르카(Orca)는 코딩 에이전트의 작업과 변경 내용을 한 화면에서 관리하는 프로그램입니다. 작업별 Git 워크트리를 만들어 폴더를 분리할 수 있습니다.

오르카 자체는 MIT 라이선스로 공개된 프로그램입니다. 코드를 편집하고, 에이전트 터미널을 열고, 바뀐 줄을 비교하는 화면이 함께 있습니다. 지원 에이전트와 설치 파일은 공식 저장소에서 확인합니다.

중요한 점은 오르카가 에이전트를 직접 만들지 않는다는 것입니다. 공식 문서는 에이전트 선택 상자가 터미널에서 해당 에이전트 프로그램을 실행할 뿐이라고 설명합니다. 오르카를 쓰려면 클로드 코드나 코덱스 CLI 같은 에이전트가 먼저 설치되어 있어야 합니다.

🌳 오르카의 바탕이 되는 git 워크트리

git 워크트리(worktree)는 한 저장소를 여러 폴더에 동시에 꺼내 두는 git 기능입니다. git 공식 문서는 워크트리를 쓰면 한 저장소에서 둘 이상의 브랜치를 동시에 꺼내 쓸 수 있다고 설명합니다.

Git의 브랜치는 변경 기록을 따로 이어 가는 기능입니다. 폴더 하나에서도 여러 일을 할 수 있지만 미완성 변경이 섞이기 쉽습니다. 워크트리는 같은 저장소를 폴더 두 개, 세 개에 따로 펼쳐 놓고 폴더마다 다른 브랜치를 연결합니다.

새 워크트리는 선택한 브랜치나 커밋을 시작 지점으로 만듭니다. 커밋은 Git에 저장한 변경 기록입니다. 원래 폴더에서 수정만 하고 기록하지 않은 내용까지 자동으로 가져오는 것은 아닙니다.

• 별도 작업 폴더와 연결된 브랜치를 확인합니다.
• 그 폴더를 작업 경로로 사용하는 에이전트 세션을 엽니다.
• 실행에 필요한 설정과 추가 프로그램 파일이 준비됐는지 확인합니다.

Git의 기록 대상에서 제외한 파일은 새 작업 폴더에 없을 수 있습니다. 공유 경로나 복사 설정이 있는 프로젝트도 있으므로 실제 위치를 확인합니다. 폴더가 나뉘어도 연결된 데이터베이스, 공유 폴더와 외부 계정은 같을 수 있습니다. 워크트리는 에이전트의 접근 권한을 제한하는 샌드박스가 아닙니다.

문서는 이것이 진짜 git 워크트리라서 폴더에 들어가 평소처럼 git 명령을 써도 되고, 오르카가 git을 대신하는 도구가 아니라고 강조합니다.

본문의 워크트리 구조를 가상 작업 A와 B로 나타냈습니다. 작업 결과를 합칠 때의 충돌 검토까지 자동으로 없어지는 것은 아닙니다.

🧩 오르카로 일하는 순서

처음에는 이미 사용할 수 있는 에이전트 하나로 시작합니다. 병렬 실행은 작업 경로와 검증 방법을 익힌 뒤 늘립니다.

1. 연습용 저장소 폴더를 추가하고 현재 변경이 있는지 확인합니다.
2. 새 워크트리를 만들 때 시작 브랜치나 커밋과 작업 이름을 확인합니다.
3. 설치와 로그인이 준비된 에이전트를 선택하고 실제 작업 폴더를 확인합니다.
4. 파일 하나를 바꾸는 작은 요청을 맡깁니다.
5. 변경 비교 화면에서 요청한 줄만 바뀌었는지 보고 결과를 직접 확인합니다.
6. 잘못된 줄은 구체적으로 설명해 수정을 요청하고 다시 비교합니다.

다른 결과와 비교해야 할 이유가 생기면 같은 시작 지점의 두 번째 워크트리를 만듭니다. 에이전트 수가 늘었다는 사실만으로 결과가 좋아지는 것은 아닙니다. 결과를 실제 브랜치에 합치거나 원격 저장소로 올리는 일은 연습 결과 확인과 구분합니다.

이 흐름을 돕는 기능도 몇 가지 들어 있습니다.

• 세션 상태 표시: 에이전트마다 작업 중인지, 사람의 입력을 기다리는지 목록에 표시됩니다
• 변경 내용 주석: 에이전트가 바꾼 줄에 주석을 달면 그 주석이 다음 요청으로 에이전트에게 돌아갑니다
• 워크트리별 브라우저: 작업마다 브라우저 탭이 따로 있어서, 웹 화면을 고친 결과를 작업별로 열어 봅니다
• 이슈 연동: 깃허브와 리니어(Linear)의 이슈를 골라 워크트리를 만들면 브랜치 이름도 이슈에서 가져옵니다

워크트리를 삭제하면 작업 폴더가 제거됩니다. 합치지 않은 커밋 때문에 브랜치가 남는 경우에도 폴더의 미기록 파일이 보존된다는 뜻은 아닙니다. 삭제 전 변경 내용과 필요한 결과의 보존 여부를 확인합니다.

🆚 VS Code, 코딩 에이전트와 무엇이 다른지

오르카 화면은 VS Code와 비슷해 보입니다. 실제로 VS Code의 편집기 바탕인 모나코(Monaco) 편집기와 파일 탐색기, 터미널이 들어 있습니다. 그래도 화면의 중심에 무엇이 있는지가 다릅니다.

그래서 오르카는 VS Code나 코딩 에이전트를 대신하는 도구가 아니라 그 위에 얹어 쓰는 관리 화면에 가깝습니다. 편집기를 지울 필요도 없습니다. 세 종류의 코딩 에이전트 화면을 비교한 설명은 터미널형, IDE형, 브라우저형 코딩 에이전트에 있고, 두 프로그램을 자세히 비교한 글은 오르카와 VS Code 비교입니다.

💳 요금과 사용량

오르카 프로그램과 연결한 AI의 사용 비용은 별개입니다. 에이전트는 로그인 방식에 따라 구독의 포함 사용량이나 API 과금을 사용합니다. 코덱스나 클로드 코드를 연결했다고 항상 챗봇 구독에서 차감되는 것은 아닙니다.

여러 세션을 실행하면 각 세션의 사용량이 합산됩니다. 같은 요청을 세 개에 보내도 읽은 파일과 실행 단계 등이 달라 정확히 세 배가 된다고 볼 수는 없습니다. 처음에는 하나의 요청 전후 사용량을 확인하고 필요한 경우에만 세션을 늘립니다. 자세한 조건은 요금과 한도 비교에서 확인합니다.

💻 지원 운영체제와 설치

공식 저장소는 맥, 윈도우와 리눅스 설치 파일을 제공합니다. 공식 다운로드에서 운영체제와 CPU에 맞는 파일을 선택합니다. 이미 설치된 환경이라면 새 설치보다 현재 버전과 에이전트 연결 상태를 먼저 확인합니다.

모바일 앱은 연결한 컴퓨터나 서버의 작업을 확인하고 요청을 전달하는 용도입니다. 실제 에이전트가 실행되는 환경이 켜져 있고 연결되어 있어야 합니다. 원격 실행을 사용한다면 노트북 화면이 아니라 실제 작업이 실행되는 컴퓨터나 서버를 기준으로 확인합니다. 설치 단계는 오르카 쉬운 사용 가이드에서 이어집니다.

⚠️ 쓰기 전에 알아 둘 한계

• 메뉴가 달라질 수 있습니다: 인터넷 글의 버전 번호를 현재 최신으로 가정하지 말고 공식 안내와 설치된 화면을 대조합니다.
• 변경을 합치는 판단이 필요합니다: 파일이 분리되어도 같은 줄을 다르게 고친 결과를 합칠 때 충돌할 수 있습니다.
• 컴퓨터 자원을 씁니다: 세션과 실행 프로그램이 늘면 메모리나 저장 공간 사용이 늘 수 있습니다.
• 대기와 완료는 다릅니다: 에이전트가 입력을 기다리거나 멈춘 상태라면 요청한 결과가 생겼는지 먼저 확인합니다.

❓ 자주 묻는 질문

코딩을 모르는 사람도 오르카를 써야 하나요?

꼭 쓸 필요는 없습니다. 에이전트 하나로 충분한 일이라면 클로드 코드나 코덱스를 바로 쓰는 편이 단순합니다. 같은 요청을 여러 에이전트에게 보내 비교하고 싶거나, 서로 다른 작업을 동시에 맡기고 싶을 때 오르카가 쓸모 있어집니다.

오르카를 쓰면 VS Code를 지워도 되나요?

지우지 않아도 됩니다. 오르카 안에도 편집기가 있지만 VS Code나 커서를 대신하려고 만든 것은 아니고, 오히려 커서 CLI나 안티그래비티를 오르카 안에서 실행하는 대상으로 연결합니다.

워크트리에서 만든 결과는 어떻게 원래 브랜치에 합치나요?

먼저 어떤 브랜치에 무엇을 합칠지 정하고 변경 비교와 관련 테스트를 확인합니다. Git의 병합이나 선택한 커밋 반영 방법을 사용할 수 있지만, 충돌이 있다면 내용을 읽고 해결해야 합니다. 로컬에 변경을 기록하는 커밋, 브랜치에 합치는 병합, 원격으로 보내는 푸시는 서로 다른 단계입니다.

오르카도 코딩 에이전트인가요?

아닙니다. 오르카는 에이전트를 관리하는 작업 환경이고, 실제로 파일을 읽고 고치는 것은 연결한 에이전트입니다. 그래서 어떤 에이전트를 연결하느냐에 따라 결과 품질과 비용이 달라집니다.

두 작업 폴더의 결과를 비교하기

설치 없이 먼저 아래 가상 예제로 판단해 봅니다. 시작 파일 notice.txt에는 접수 마감: 10월 15일이라고 적혀 있습니다. 같은 기록에서 만든 작업 A와 B의 폴더가 각각 있다고 가정합니다.

두 결과가 서로 덮어쓰이지 않은 것은 다른 파일 경로에서 작업했기 때문입니다. 하지만 두 변경을 같은 원본 줄에 합치려면 18일과 20일 가운데 어떤 요청이 맞는지 판단해야 합니다. 워크트리가 업무의 정답을 골라 주지는 않습니다.

실제 연습은 Git의 첫 기록 연습을 할 수 있고, 선택한 에이전트의 설치와 로그인이 끝난 경우에 진행합니다. Git에 기록된 notice.txt가 있는 연습용 저장소로 시작합니다. 새 워크트리의 시작 지점에 이 파일이 있는지 확인한 뒤 에이전트 하나에 요청합니다.

현재 작업 폴더의 notice.txt에서 마감일만 10월 18일로 바꿔 줘. 다른 파일과 원래 작업 폴더는 바꾸지 마. 커밋, 푸시와 게시를 하지 말고 파일을 저장한 뒤 변경 내용을 보여 줘.

작업 폴더의 파일은 18일, 원래 폴더의 파일은 15일인지 직접 엽니다. 둘 다 바뀌었다면 같은 경로를 열었거나 공유 연결이 있는지 확인하고 다음 수정을 멈춥니다. 파일이 없다면 시작 지점에 기록돼 있었는지 확인합니다.

다시 요청할 때는 이 작업 폴더의 날짜만 19일로 바꿉니다. 변경 비교 화면과 실제 파일이 일치하고 원래 폴더는 15일로 남아 있는지 확인합니다. 첫 연습에서는 결과 확인까지 마치고 병합이나 삭제는 따로 판단합니다.

📋 3줄 요약

1. 오르카는 연결한 코딩 에이전트의 작업과 변경 내용을 한 화면에서 관리합니다.

2. 워크트리는 작업 폴더를 나누지만 공유 경로와 외부 서비스 및 병합 충돌까지 없애지는 않습니다.

3. 첫 작업은 한 세션에서 작은 변경을 확인하고 필요할 때 세션을 늘리며 사용량을 확인합니다.

참고 자료

• Orca 공식 저장소와 설치 안내
• Orca 워크트리와 공유 경로
• Git 워크트리 공식 설명
• Orca 모바일 연결

공식 안내 확인: 2026년 10월 3일. 날짜 비교는 가상 예제입니다.