Windows·WSL에서 Orca 세팅하기 — 병렬 에이전트 실행까지

Orca란 무엇이고 왜 주목받나요

Orca는 Claude Code, Codex, OpenCode 같은 CLI 기반 AI 코딩 에이전트를 worktree와 터미널 중심으로 한 화면에서 관리하는 Agent Development Environment(ADE)입니다. 여러 AI 에이전트에게 동시에 다른 작업을 맡기고, 각 작업 결과를 별도 창을 오가지 않고 한 화면에서 확인할 수 있다는 점이 핵심 차별점입니다.

기존에는 AI 코딩 에이전트를 하나씩 순서대로 실행하며 결과를 기다려야 했지만, Orca는 여러 에이전트를 Git worktree 단위로 분리해 서로 다른 브랜치에서 동시에 작업을 진행하게 해줍니다. 예를 들어 한 에이전트는 버그를 수정하고, 다른 에이전트는 새 기능을 개발하는 식으로 병렬 작업이 가능합니다.

기존 터미널 도구와의 차이

Orca의 터미널은 VS Code가 쓰는 것과 동일한 xterm.js 기반이지만, AI 에이전트 워크플로우에 맞춰 몇 가지 기능이 추가됐습니다. Ghostty나 Warp 같은 다른 터미널 앱에서 쓰던 테마·폰트·커서 설정을 그대로 가져올 수 있고, 터미널 창을 분할해 여러 셸을 나란히 띄울 수 있습니다.

또한 특정 터미널 창의 출력 내용을 범위 지정해 복사하는 기능(Copy Context)이 있어, 에이전트가 만든 로그나 결과물을 다른 도구에 붙여넣을 때 유용합니다. 검색 기능(Cmd+F)도 지원해 스크롤백 히스토리에서 정규식 검색까지 가능합니다.

병렬 에이전트 실행의 실제 작동 방식

Orca는 새 탭을 열 때 일반 터미널, 브라우저 탭, Markdown 편집기, 모바일 에뮬레이터와 함께 Claude, Codex, OpenCode 등 설치된 CLI 에이전트를 바로 선택해 실행할 수 있게 해줍니다. 각 에이전트는 독립된 worktree에서 실행되므로, 한 에이전트의 작업이 다른 에이전트의 변경사항과 충돌하지 않습니다.

Orca 온보딩 과정에서는 기본 에이전트 선택 → 테마·알림 설정 → 프로젝트 추가(로컬 폴더 또는 Git URL) → CLI 활성화(브라우저 사용, 컴퓨터 사용, 에이전트 오케스트레이션 skill 설치) 순서로 진행됩니다. 이 순서를 건너뛰면 일부 skill이 제대로 동작하지 않을 수 있으니 첫 실행 시 안내를 끝까지 따라가는 것이 좋습니다.

IDE가 아니라 ADE의 시대 — Orca가 놓인 흐름

Orca를 단순한 터미널 앱이 아니라 ADE(Agentic Development Environment, 에이전트 중심 개발 환경)로 이해하면 이 도구가 왜 주목받는지가 분명해집니다. ADE라는 표현은 터미널 도구 Warp의 CEO 잭 로이드가 제시한 개념으로, 통합 개발 환경을 뜻하는 IDE의 ‘I’(Integrated)를 ‘A’(Agentic)로 바꾼 것입니다. 코드를 손으로 직접 짜는 대신, 터미널에서 자연어로 의도를 전달하고 에이전트가 실행의 대부분을 맡는 방식으로 개발의 무게중심이 옮겨가고 있다는 진단입니다.

ADE는 IDE와 무엇이 다른가

가장 큰 차이는 사람이 무엇을 하느냐에 있습니다. IDE에서는 개발자가 파일을 편집하고 도구는 자동 완성으로 이를 보조했다면, ADE에서는 개발자가 방향을 제시하고 에이전트가 설정·구현·배포·디버깅까지 소프트웨어 생애주기 전반을 수행합니다.

구분	IDE	ADE
작업 방식	키보드 입력·파일 편집 중심	자연어 프롬프트로 의도 전달
도구의 범위	코드 편집 보조	설정·배포·디버깅 등 생애주기 전반
사람의 역할	직접 구현	에이전트 가이드·오케스트레이션·검토

Orca가 CLI 에이전트를 worktree 단위로 나눠 한 화면에서 병렬로 굴리도록 설계된 것도 이 흐름의 연장선입니다. 여러 에이전트에게 각기 다른 작업을 맡기고 그 결과를 오케스트레이션하는 경험 자체가 ADE가 말하는 작업 방식에 해당합니다.

개발자의 역할은 오케스트레이션으로

ADE 시대에 개발자의 일은 ‘모든 것을 직접 구현하는 사람’에서 ‘무엇을 만들지 소통하고 에이전트를 지휘하는 사람’으로 이동합니다. 구현의 상당 부분을 에이전트가 담당하는 대신, 사람은 의도를 명확히 전달하고 결과물의 품질·보안·아키텍처 적합성을 검토하는 역할을 맡게 됩니다.

다만 에이전트를 여러 개 띄워 두고 프로젝트 곳곳을 알아서 건드리게 방치하는 이른바 ‘바이브 코딩’은 주의해야 합니다. 잭 로이드는 이런 방식이 프로 개발자에게는 ‘쓰레기를 빠르게 배포하는 가장 빠른 길’이 될 수 있다고 경고합니다. Orca의 worktree 격리와 병렬 실행도 방치가 아니라, 각 에이전트와 단계별로 짝을 이뤄 결과를 확인·검토하며 쓸 때 제 값을 합니다.

Orca 설치와 초기 설정 순서

Orca는 공식 다운로드 페이지에서 앱을 받아 설치한 뒤, 온보딩 화면을 따라가면 초기 설정이 끝납니다. 설치 자체는 일반적인 데스크톱 앱과 크게 다르지 않지만, 온보딩 단계에서 놓치기 쉬운 항목들이 있어 순서대로 짚어보겠습니다.

단계별 설치 절차

1. 공식 다운로드 페이지에서 운영체제에 맞는 설치 파일을 내려받아 실행합니다.
2. 첫 화면에서 이미 설치된 CLI 에이전트(Claude, Codex, OpenCode 등)가 자동으로 감지되며, 이 중 기본 에이전트를 선택합니다.
3. 테마(시스템/다크/라이트)와 알림(작업 완료·도움 필요 시 OS 알림) 설정을 지정합니다.
4. 프로젝트를 추가합니다 — 로컬 폴더 선택, Git URL 복제, 새 프로젝트 생성 중 원하는 방식을 고릅니다.
5. CLI 활성화 단계에서 에이전트 오케스트레이션, 브라우저 사용, 컴퓨터 사용 관련 skill을 npx 명령으로 설치합니다.
6. 온보딩 완료 후 새 탭 메뉴에서 원하는 에이전트나 터미널을 바로 실행합니다.

이 흐름에서 특히 중요한 것은 CLI 활성화 단계에서 skill 설치를 건너뛰지 않는 것입니다. 브라우저 사용이나 컴퓨터 사용 skill을 설치하지 않으면 이후 에이전트가 웹 검색이나 화면 제어 작업을 요청할 때 오류가 발생할 수 있습니다.

Windows 환경에서 셸 선택하기

Windows에서는 기본 셸을 PowerShell, Command Prompt, WSL 중에서 설정 메뉴(Settings → Terminal)에서 고를 수 있습니다. WSL 옵션은 wsl.exe --status 명령이 정상 응답할 때만 자동으로 노출되므로, WSL이 설치되어 있지 않다면 이 옵션이 보이지 않습니다.

탭 바의 + 드롭다운 메뉴에서는 기본 셸을 바꾸지 않고도 특정 탭만 다른 셸(예: WSL)로 여는 서브메뉴가 제공됩니다. WSL 안의 저장소 파일을 다루는 작업이 많다면, 기본 셸을 WSL로 지정해두는 것이 경로 혼동을 줄이는 데 도움이 됩니다.

WSL 연동 시 자주 겪는 문제와 대응법

Orca에서 WSL 셸을 선택해 사용할 때, WSL 자체의 상태나 버전이 최신이 아니면 셸이 정상적으로 뜨지 않거나 명령 실행이 지연되는 경우가 있습니다. 이 문제는 Orca가 아니라 WSL 환경 설정 문제인 경우가 대부분입니다.

WSL 상태 점검 순서

• PowerShell을 열고 wsl --update로 WSL을 최신 버전으로 갱신합니다.
• wsl --status로 기본 배포판과 버전(WSL1/WSL2)을 확인합니다.
• 기본 배포판이 원하는 배포판(Ubuntu 등)과 다르면 wsl --set-default <배포판명>으로 변경합니다.
• Orca를 재시작해 WSL 셸 옵션이 정상적으로 노출되는지 확인합니다.

컨테이너 기반 작업 환경 준비

WSL 환경에서 컨테이너를 활용해 에이전트 작업을 격리하고 싶다면, Windows에 기본 제공되는 컨테이너 CLI를 사용할 수 있습니다. wslc version으로 설치 여부를 확인하고, wslc run --rm hello-world로 간단한 테스트 이미지를 실행해 정상 동작 여부를 점검하는 방식이 일반적입니다.

• wslc image list — 로컬에 있는 이미지 목록 확인
• wslc container list --all — 중지된 컨테이너까지 포함한 전체 목록 확인
• wslc stats — 실행 중인 컨테이너의 리소스 사용량 확인

이런 컨테이너 환경은 에이전트가 실행하는 스크립트가 호스트 시스템에 직접 영향을 주지 않도록 격리하는 용도로 활용할 수 있어, 여러 에이전트를 병렬로 돌릴 때 안전장치 역할을 합니다.

모바일 페어링 설정하기

Orca 모바일 앱은 데스크톱에서 실행 중인 에이전트의 상태를 확인하고 간단한 작업 지시를 내릴 수 있는 companion 앱입니다. 페어링은 네트워크 환경에 따라 난이도가 크게 달라지므로, 먼저 자신의 네트워크 조건을 파악하는 것이 중요합니다.

같은 Wi-Fi 환경에서 페어링

데스크톱과 모바일이 같은 Wi-Fi 네트워크에 있을 때가 가장 안정적으로 페어링되는 조건입니다. 데스크톱 앱에서 모바일 안내 화면을 열고 표시되는 QR코드나 코드를 모바일 앱에 입력하면 자동으로 연결됩니다.

다른 네트워크에서 접근할 때 주의점

다른 네트워크(예: 이동통신 데이터, 다른 Wi-Fi)에서 접근하려면 데스크톱에 직접 접근 가능한 주소를 모바일 앱에 직접 입력해야 합니다. 이 경우 방화벽이나 포트 포워딩 설정이 필요할 수 있습니다.

회사나 카페처럼 AP 격리(클라이언트 격리)가 켜진 네트워크에서는 같은 Wi-Fi에 연결되어 있어도 기기 간 통신이 차단되어 데스크톱을 찾지 못할 수 있습니다. 페어링이 안 될 때는 가장 먼저 네트워크의 AP 격리 설정을 확인하는 것이 문제 해결의 지름길입니다.

병렬 에이전트 실행과 사용량 확인

Orca의 핵심 가치는 여러 에이전트를 동시에 굴려 작업 시간을 단축하는 데 있습니다. 다만 각 CLI 에이전트(Claude, Codex 등)는 자체 API 사용량 한도가 있으므로, 병렬로 많이 띄울수록 사용량 소진 속도도 빨라진다는 점을 염두에 둬야 합니다.

효율적인 병렬 작업 배치 방법

• 서로 코드 영역이 겹치지 않는 작업(예: 프론트엔드 수정 vs 백엔드 API 수정)을 각각 다른 에이전트에 배정합니다.
• 같은 파일을 여러 에이전트가 동시에 수정하게 하면 merge 충돌 위험이 커지므로, worktree 단위로 작업 범위를 명확히 나눕니다.
• 사용량이 한정된 에이전트는 우선순위가 높은 작업에, 무료이거나 한도가 넉넉한 에이전트는 반복적인 검증 작업에 배정하는 방식이 효율적입니다.

사용량 및 상태 모니터링

데스크톱 앱과 모바일 앱 모두에서 각 에이전트의 작업 진행 상태와 완료 여부를 확인할 수 있으며, 작업 완료 시 OS 알림으로 즉시 통지받을 수 있습니다. 여러 worktree에서 동시에 작업이 진행될 때는 알림 설정을 켜두는 것이 각 에이전트의 상태를 놓치지 않는 데 도움이 됩니다.

Orca 설치 전 체크리스트

확인 항목	권장 사항
운영체제	macOS 또는 Windows(WSL 병행 가능)
CLI 에이전트	Claude Code, Codex, OpenCode 중 최소 1개 사전 설치
WSL 버전(Windows)	wsl --update로 최신 상태 유지
네트워크(모바일 페어링용)	AP 격리 없는 동일 Wi-Fi 권장
프로젝트 형태	Git 저장소(로컬 폴더 또는 Git URL)

자주 묻는 질문

Q. Orca를 사용하려면 CLI 에이전트를 미리 설치해야 하나요?

네, Claude Code·Codex·OpenCode 같은 CLI 에이전트가 시스템에 설치되어 있어야 Orca 온보딩 과정에서 자동으로 감지됩니다. 아직 설치하지 않았다면 각 도구의 공식 설치 가이드를 먼저 따라 설치한 뒤 Orca를 실행하는 것이 좋습니다.

Q. Windows에서 WSL 셸이 설정 메뉴에 보이지 않는데 어떻게 해야 하나요?

WSL 옵션은 wsl.exe --status 명령이 정상적으로 응답할 때만 노출됩니다. PowerShell에서 wsl --update로 WSL을 최신 버전으로 업데이트하고, WSL이 설치되어 있지 않다면 먼저 설치를 완료한 뒤 Orca를 재시작해 보세요.

Q. 모바일 앱과 데스크톱 앱이 같은 Wi-Fi인데도 페어링되지 않습니다.

회사나 카페 Wi-Fi처럼 AP 격리(클라이언트 격리) 기능이 켜진 네트워크에서는 같은 네트워크에 있어도 기기 간 통신이 차단됩니다. 이 경우 개인 핫스팟이나 AP 격리가 없는 네트워크로 전환해 다시 시도하는 것이 가장 확실한 해결법입니다.

Q. 여러 에이전트를 동시에 실행하면 API 사용량이 더 빨리 소진되나요?

네, 병렬로 실행하는 에이전트 수만큼 각 CLI 도구의 API 호출 빈도가 늘어나므로 사용량 한도 소진 속도도 빨라집니다. 작업 우선순위에 따라 에이전트별로 작업량을 배분하고, 데스크톱·모바일 앱에서 상태를 주기적으로 확인하는 것이 좋습니다.

Q. Ghostty나 Warp에서 쓰던 터미널 테마를 그대로 가져올 수 있나요?

네, Orca는 첫 실행 시 Ghostty의 테마·폰트·커서 설정을 자동으로 가져올 수 있고, 이후에도 설정 메뉴(Settings → Terminal → Import from Ghostty)에서 재실행할 수 있습니다. Warp 테마는 같은 메뉴에서 YAML 형식 테마 파일을 선택해 가져올 수 있습니다.