Orca

Orca는 여러 코딩 에이전트의 작업을 한곳에서 관리하는 데스크톱 앱입니다. Claude Code·Codex 같은 에이전트를 동시에 실행하고, 작업마다 폴더와 브랜치를 나누어 결과를 비교합니다. 변경 내용 검토와 커밋까지 한 앱에서 진행합니다. 브랜치는 같은 프로젝트에서 작업 흐름을 나눈 갈래이며, 커밋은 변경 내용을 Git 이력에 기록하는 동작입니다.

Orca는 답을 만드는 AI 모델이 아닙니다. 이미 사용하는 Claude·Codex 구독으로 각 에이전트를 실행하는 앱이며, Orca 자체는 무료·오픈소스(MIT 라이선스)입니다. Orca가 무료라는 뜻과 에이전트 사용량이 무료라는 뜻은 구분합니다.

왜 초급에서 배웁니까?

에이전트 하나에게 한 작업을 맡기는 방법이 익숙해지면, 여러 작업을 동시에 맡기는 병렬 처리로 넘어갑니다. Orca는 이때 작업을 나누고 결과를 살펴보는 도구입니다. 각 작업 공간은 같은 Git 저장소에서 작업 폴더를 따로 만드는 Git worktree(워크트리)이므로, 먼저 초급 Git 기본 명령 표에서 저장소·브랜치·커밋을 익히면 이해하기 쉽습니다.

설치 전에 준비합니다

• 에이전트: Claude Code 또는 Codex를 먼저 설치하고 내 컴퓨터의 터미널에서 한 번 실행하여 로그인합니다. 시작하기에서 강의 준비와 Claude Code 설치·첫 실행을 확인합니다. Orca 설치와 에이전트 로그인은 별도 과정입니다.
• 작업 폴더: 내 컴퓨터에 있는 Git 저장소를 준비합니다. 일반 폴더를 저장소로 만드는 git init은 초급 Git 기본 명령 표를 참고합니다.

운영체제에 맞게 설치합니다

Orca 공식 다운로드에서 내 컴퓨터에 맞는 설치 파일을 선택합니다.

Mac

Apple Silicon Mac은 orca-macos-arm64.dmg, Intel Mac은 orca-macos-x64.dmg를 내려받아 설치합니다. 내려받은 dmg를 열고 Orca 아이콘을 응용 프로그램(Applications) 폴더로 끌어 넣은 뒤 응용 프로그램에서 실행합니다. 공식 Mac 앱은 서명·공증되어 있지만, 처음 실행할 때 macOS의 확인 창이 나타날 수 있습니다.

Homebrew가 이미 설치되어 있으면 Mac의 일반 터미널(zsh)에서 다음 명령으로 설치할 수도 있습니다.

brew install --cask stablyai/orca/orca

Homebrew로 설치한 Orca를 업데이트하는 명령은 다음과 같습니다.

brew upgrade --cask stablyai/orca/orca

설치·업데이트 모두 stablyai/orca/orca라는 전체 이름을 사용합니다. 이름을 orca로만 쓰면 관계없는 다른 앱을 가리킬 수 있습니다.

Windows

공식 다운로드에서 orca-windows-setup.exe를 받아 실행하고 설치 안내를 따릅니다. 위의 Homebrew 명령은 Windows용이 아닙니다. 이 강의의 Windows 터미널 기준은 PowerShell이며, Orca의 Settings → Terminal에서 기본 셸을 PowerShell로 선택할 수 있습니다.

Linux

공식 다운로드에서 AppImage 또는 배포판에 맞는 .deb·.rpm 패키지를 선택합니다. 앱의 자동 업데이트를 원하면 AppImage를 권장합니다. .deb·.rpm은 업데이트가 있음을 알리고 패키지 관리자로 설치할 명령을 안내하므로, 앱을 종료한 뒤 안내를 따릅니다. Linux의 Orca 명령줄 도구 이름은 orca-ide입니다.

업데이트 확인 — Mac·Windows·Linux 공통

기본 설정은 안정 채널의 자동 업데이트입니다. 직접 확인하려면 Settings → General → Updates → Check for Updates를 선택합니다. Linux의 .deb·.rpm은 위에서 설명한 패키지 설치 방식으로 업데이트합니다.

처음 실행할 때 확인합니다

처음 실행하면 저장소를 추가하기 위한 홈 폴더 접근 허용을 요청하고, 기존 Claude Code·Codex 설정을 가져오도록 제안합니다. 공식 설치 문서는 기존 설정 경로를 ~/.claude·~/.codex로 표기하며, ~는 사용자 홈 폴더를 뜻합니다. 제안 내용을 확인한 뒤 빈 시작 화면에서 첫 저장소를 추가합니다.

공식 설치 안내에는 별도 Orca 로그인 단계가 없습니다. 에이전트를 사용하기 위해 앞에서 준비한 Claude Code 또는 Codex 로그인과 구분합니다.

기본 사용법 — 저장소 추가부터 정리까지

1. 저장소를 추가합니다

사이드바의 Add Repo를 누르고 내 컴퓨터의 Git 저장소 폴더를 선택합니다. Orca는 저장소의 기본 브랜치를 base ref로 정합니다. base ref는 새 작업 공간을 만들 때 기준으로 삼는 출발점입니다.

2. 작업 공간을 만듭니다

1. 사이드바에서 저장소 이름 옆의 +를 누릅니다.
2. 작업 이름을 입력합니다. 예를 들어 fix-login은 로그인 문제를 고치는 작업 이름입니다. 비워 두면 바다 생물 이름이 자동으로 붙습니다.
3. Agent에서 실행할 에이전트를 선택합니다. 기본 에이전트가 미리 선택되며, 에이전트 없이 시작하려면 Blank Terminal(빈 터미널)을 고릅니다.
4. Branch from에서 출발점을 확인합니다. 보통 origin/main이며, 실제 저장소의 기준 브랜치 이름에 맞게 선택합니다. origin/main은 원격 저장소 origin의 main 브랜치를 가리킵니다.
5. 생성을 실행하고 작업 공간 준비가 끝날 때까지 기다립니다.

각 작업 공간은 자기 폴더·브랜치·터미널을 가집니다. 에이전트들이 각자의 공간에서 작업하므로 서로의 파일을 덮어쓰지 않도록 분리합니다.

3. 에이전트에게 요청합니다

Terminal 모드는 Claude Code·Codex의 명령줄 화면(CLI)을 그대로 사용합니다. Chat 모드는 대화창에서 요청을 주고받으며, @로 파일을 넣고 /로 명령·스킬 목록을 엽니다. 스킬은 에이전트가 사용할 수 있도록 준비한 작업 방법입니다.

새 설치의 기본값은 Terminal입니다. Settings → Chat UI 또는 Settings → Agents에서 모드를 선택하며, 지원되는 대화는 탭을 우클릭하여 전환할 수 있습니다.

처음에는 작은 요청 하나로 확인합니다. 예를 들어 README.md의 소개 문장을 초보자가 이해하기 쉽게 고쳐 줘. 수정한 내용과 이유도 알려 줘.처럼 대상과 원하는 결과를 함께 적습니다.

4. 여러 작업을 동시에 진행합니다

작업이나 접근 방식마다 작업 공간을 하나씩 더 만들고 각각 에이전트를 실행합니다. 같은 문제를 서로 다른 방법으로 풀게 하려면 같은 요청을 각 작업 공간에 전달하고 결과를 비교합니다.

탭을 화면 구역의 오른쪽·아래 가장자리로 끌면 화면을 분할하여 여러 작업을 함께 볼 수 있습니다. 작업 공간 이동 팔레트(Jump Palette)는 Mac·Windows 공통으로 사이드바 위쪽의 Search 버튼으로 엽니다. Mac에서는 Cmd-J로도 엽니다. Windows 단축키는 공식 문서에 명시되어 있지 않습니다.

5. 결과를 검토하고 수정을 요청합니다

diff 보기는 작업 전후에 달라진 줄을 비교하는 화면입니다. 변경된 줄 옆의 +를 누르거나 해당 줄에 커서를 두고 c 키를 눌러 메모를 남깁니다. 예를 들어 이 설명에 처음 쓰는 사람이 따라 할 예시를 추가해 줘.처럼 원하는 수정을 적습니다.

검토 메모를 모은 뒤 Send to agent를 누르고 수정할 에이전트를 선택합니다. 수정 결과를 다시 확인하고 해결한 메모는 Resolve로 정리합니다.

6. 커밋하고 푸시합니다

1. Source Control에서 기록할 파일 또는 변경 부분을 선택하여 Stage합니다. Stage는 다음 커밋에 넣을 변경을 고르는 동작입니다.
2. 커밋 메시지를 직접 쓰거나 Generate with AI로 초안을 만든 뒤 내용을 확인합니다.
3. Commit을 누릅니다. Source Control에 입력 초점이 있고 기본 동작이 Commit일 때, Mac은 Cmd-Enter, Windows·Linux는 Ctrl-Enter로 실행할 수 있습니다.
4. 원격 저장소로 보낼 준비가 되면 Push를 누릅니다. 첫 푸시에는 upstream, 즉 이 브랜치가 연결할 원격 브랜치가 설정됩니다. 초급 실습에서는 강제 푸시를 하지 않습니다.
5. 푸시한 변경을 다른 사람에게 검토받으려면 Source Control의 리뷰 요청 동작에서 PR(Pull Request)을 만듭니다. 대상 브랜치·제목·설명을 확인한 뒤 제출합니다.

7. 작업 공간을 정리합니다

작업 공간을 우클릭하면 archive·sleep·delete 동작을 선택할 수 있습니다. 삭제는 확인 창을 거쳐 작업 폴더와 브랜치를 제거하는 동작이므로, 필요한 결과를 보관했는지 먼저 확인합니다.

여러 작업 공간을 정리할 때 병합하지 않은 커밋이 있을 수 있어 Git이 브랜치 삭제를 거부하면 Orca는 브랜치를 남기고 Review N Branches 안내를 표시할 수 있습니다. N은 남겨 둔 브랜치 수입니다. 이 안내가 있어도 삭제된 작업 폴더가 복원되지는 않습니다. 남은 브랜치는 내용을 확인하기 전까지 유지합니다.

초급자가 기억할 주의사항

• 새 작업 공간의 실행 준비: 새 워크트리는 Git에 기록된 파일로 만든 깨끗한 체크아웃입니다. Git이 관리하지 않도록 제외한 .env(환경 설정 파일)·node_modules(설치한 의존성 폴더) 등은 별도로 준비해야 합니다. 고급 설정에는 .worktreeinclude 같은 복사·공유 방법이 있습니다.
• 내 구독 사용량: 에이전트 사용량은 로그인한 내 구독에서 차감됩니다. 동시에 실행하는 에이전트가 늘면 사용량도 함께 살펴봅니다. Orca는 Claude 사용량과 한도에 가까워졌는지를 표시합니다.
• 같은 대화의 동시 사용 금지: 같은 대화를 Terminal과 Chat에서 동시에 사용하지 않습니다. 진행 중인 작업이 끝났는지 확인하고 한쪽 에이전트를 종료한 뒤 다른 화면에서 이어갑니다.
• 삭제 전 확인: 작업 공간 삭제는 되돌리기 어렵습니다. 검토·커밋·필요한 보관 여부를 확인한 뒤 정리하며, 남겨 둔 브랜치를 무심코 강제 삭제하지 않습니다.

화면 이름·메뉴는 버전에 따라 다를 수 있습니다.

확인일: 2026-11-08. 확인일 기준 최신 배포: v1.4.253(2026-11-07). 공식 출처: Orca GitHub·MIT 라이선스 · 설치 · 첫 작업 · 작업 공간 · Chat 모드 · 변경 내용 검토 · 커밋·푸시 · 사용량·한도 표시.