Orca 시작하기: 코딩 AI 하나로 파일을 수정하고 확인하는 방법
Orca는 Claude Code와 Codex 같은 코딩 AI의 작업 공간과 결과를 관리하는 앱입니다. 새 연습 폴더에서 AI 하나로 안내문을 고치고 실제 변경을 확인한 뒤 작업 공간 분리와 여러 AI 사용을 이해합니다.
목차
세 줄로 먼저 읽기
이번 방문에서 한 편은 바로 볼 수 있습니다.
Orca(오르카)는 Claude Code와 Codex 같은 코딩 AI의 대화, 작업 폴더와 변경 내용을 한 화면에서 관리하는 앱입니다. 여러 AI를 동시에 실행할 수 있지만 처음부터 여러 개를 켤 필요는 없습니다. 이 글에서는 AI 하나로 작은 파일을 고치고 결과를 확인한 뒤 작업 공간 분리를 설명합니다.
앱 자체는 무료로 공개되어 있습니다. AI 사용은 연결한 서비스의 구독 한도나 API 과금을 따릅니다. API는 프로그램에서 AI 서비스에 요청하는 연결 방식입니다. 2026년 10월 4일 기준 기능을 설명하며 아래 캡처와 만화는 이전 화면을 보존한 자료입니다.
Orca가 관리하는 세 가지
코딩 AI는 파일을 읽고 수정하거나 명령을 실행하는 도구입니다. Orca는 이 도구들을 불러와 작업 상태와 결과를 관리합니다. 여러 직원에게 작업을 나눠 주는 관제탑에 비유할 수 있지만, 담당자를 늘리는 것만으로 일이 정확히 끝나는 것은 아닙니다.
| 용어 | 뜻 | 먼저 확인할 것 |
|---|---|---|
| 에이전트 | Claude Code처럼 모델과 도구를 사용해 일을 수행하는 프로그램 | 어떤 계정과 모델을 쓰는지 |
| 세션 | 한 작업의 대화와 실행 기록 | 지금 어느 대화에 지시하는지 |
| 작업 공간 | 파일과 터미널, 세션이 작업하는 환경 | 실제 폴더 경로가 어디인지 |
Git은 파일의 변경 이력을 관리하는 도구입니다. 워크트리(worktree)는 같은 Git 저장소의 파일을 별도 폴더에서 작업하도록 나눈 공간입니다. 세션 두 개나 창 두 개가 곧 워크트리 두 개는 아닙니다.
아래 공식 캡처에서는 왼쪽 작업 목록, 가운데 AI 창, 오른쪽 파일 목록을 봅니다. 화면에 보이는 예전 모델명과 권한 설정을 그대로 따라 할 필요는 없습니다.
무료 앱과 AI 사용량은 다릅니다
Orca는 Stably AI가 만든 공개 프로그램이며 기존 코딩 AI의 로그인을 사용합니다. 같은 계정으로 세션을 세 개 열어도 세 계정 분량의 한도가 생기지는 않습니다. 구독 한도를 더 빨리 쓰거나, 사용량 과금 연결에서는 비용이 늘 수 있습니다.
앱 하단의 사용량 표시를 열어 계정과 남은 한도를 확인합니다. 숫자가 없으면 0원이나 무제한이라고 해석하지 않습니다. Orca의 비용 추정치는 실제 청구서와 다를 수 있으므로 최종 지출은 제공자 계정에서 확인합니다. 사용량 표시 안내
여러 AI를 쓰는 이유는 서로 독립적인 작업을 동시에 처리하거나 같은 과제의 결과를 비교하기 위해서입니다. 먼저 한 번 맡긴 결과를 확인할 수 있어야 여러 결과 중 무엇을 채택할지도 판단할 수 있습니다.
설치와 첫 실행 준비
공식 다운로드에서 운영체제에 맞는 안정 버전을 고릅니다. Mac은 Apple Silicon과 Intel을 구분하고 Windows는 지원되는 설치 파일을 확인합니다. Linux도 별도 배포 파일을 제공합니다. 시험 배포판인 RC를 입문 필수 조건으로 삼지 않습니다.
처음 실행하면 폴더 접근과 기존 AI 설정 가져오기가 안내될 수 있습니다. 사용할 계정과 작업 폴더를 확인하며 진행합니다. 코딩 AI가 아직 준비되지 않았다면 Claude Code Mac 설치 또는 Windows 설치에서 AI 하나를 먼저 사용할 수 있게 준비합니다. Orca 설치 안내
아래 연습에는 Orca, 이미 로그인해 사용할 수 있는 코딩 AI 하나, Git이 필요합니다. GitHub 계정 연결이나 원격 게시, 여러 AI 구독은 필요하지 않습니다.
첫 연습: 안내문 한 줄을 수정합니다
실제 업무 폴더와 별도로 orca-first-practice 폴더를 만듭니다. 텍스트 편집기에서 다음 가상 안내를 notice.txt로 저장합니다. Mac 텍스트 편집기는 일반 텍스트 형식을 사용하고 Windows에서는 이름이 notice.txt.txt가 되지 않았는지 확장자를 확인합니다.
행사 시작: 오후 2시
참가비: 무료터미널은 명령을 입력해 프로그램을 사용하는 창입니다. Windows에서는 만든 폴더의 주소 표시줄에 powershell을 입력해 그 위치에서 PowerShell을 엽니다. Mac에서는 터미널에 cd와 공백을 입력한 뒤 Finder의 폴더를 터미널로 끌어 놓고 Enter를 누릅니다. Linux는 파일 관리자의 터미널 열기 기능이나 cd로 해당 폴더로 이동합니다.
pwd를 입력해 표시된 경로가 방금 만든 orca-first-practice 폴더인지 확인한 뒤 아래 명령을 한 줄씩 실행합니다. 다른 폴더라면 먼저 위치를 바로잡습니다.
git init
git add notice.txt
git commit -m "Add practice notice"
git branch --show-current커밋은 현재 파일을 비교 기준으로 이력에 남기는 동작입니다. 외부 업로드가 아닙니다. 마지막 명령에 나온 브랜치 이름을 적습니다. 브랜치는 변경 이력을 나누어 관리하는 이름입니다. Git을 찾을 수 없다면 Git 설치 안내를, 커밋에서 이름과 이메일을 요청하면 Git 최초 설정 안내를 따릅니다. 이 단계의 커밋이 성공한 뒤 작업 공간 만들기로 넘어갑니다.
- Orca 왼쪽
Add Repo에서orca-first-practice폴더를 선택합니다. - 저장소 옆
+에서notice-edit작업 공간을 만듭니다. 시작 기준은 방금 기록한 로컬 브랜치입니다. 원격 주소가 없는 연습이므로origin/main을 무조건 고르지 않습니다. - AI 하나를 선택하고 준비 완료를 기다립니다. AI가 실행된 작업 폴더가 새
notice-edit워크트리인지 확인합니다. - 다음 지시를 AI 입력 칸에 보냅니다.
현재 작업 폴더의 notice.txt를 읽어 주세요.
행사 시작을 오후 2시에서 오후 3시로 바꾸고 파일을 저장해 주세요.
참가비 문장은 그대로 두세요.
다른 파일 수정, 설치, 외부 전송은 하지 마세요.
끝나면 수정한 파일 경로와 바뀐 줄을 알려 주세요.AI의 완료 메시지가 나오면 notice-edit 안의 파일 목록에서 notice.txt를 직접 엽니다. 기대하는 내용은 다음과 같습니다.
행사 시작: 오후 3시
참가비: 무료변경 내역(diff)은 이전 파일과 바뀐 파일의 차이를 보여주는 화면입니다. 비교 기준을 처음 커밋한 상태로 두고 행사 시간 한 줄만 바뀌었는지 확인합니다. 기본 폴더의 파일은 여전히 오후 2시인지도 함께 봅니다. 처음 만든 기본 폴더와 notice-edit는 다른 경로이므로 결과를 엉뚱한 폴더에서 찾지 않습니다. 워크트리 만들기, 파일 목록 안내
이제 같은 세션에서 행사 시간을 오후 4시로 바꾸되 참가비는 유지하도록 혼자 요청합니다. 실제 파일을 다시 열어 오후 4시와 참가비 무료 두 줄을 확인합니다. 중간에 커밋하지 않았다면 diff는 처음 기준인 오후 2시에서 오후 4시로 바뀐 내역을 보여줍니다. 정상적인 누적 변경입니다. 작업 공간 이름, 결과 경로, 바뀐 줄을 설명할 수 있으면 첫 실습은 끝입니다. 공개 게시나 여러 AI 실행까지 할 필요는 없습니다.
멈췄을 때 확인하는 순서
| 증상 | 확인할 내용 |
|---|---|
| AI가 실행되지 않음 | 해당 AI가 컴퓨터에 설치됐는지와 선택 계정의 로그인 상태 |
| 파일이 없다고 함 | 현재 작업 경로와 실제 파일명, 새 워크트리 시작 전에 커밋했는지 |
| 완료됐는데 내용이 그대로임 | 기본 폴더가 아니라 AI가 작업한 워크트리의 파일을 열었는지 |
| 추가 권한이나 설치를 요청함 | 요청이 연습 파일 한 줄 수정에 필요한지 확인하고 불필요하면 거절 |
| 응답이 오래 멈춤 | 사용량 제한, 승인 대기와 오류 문구를 구분 |
중단이 필요하면 해당 세션의 중지 동작을 사용합니다. 중지해도 이미 저장된 변경이 자동으로 되돌아가지는 않습니다. 파일을 확인한 뒤 원래 문장으로 돌리는 수정만 요청할 수 있습니다. 도움을 요청할 때는 앱 버전, 운영체제, AI 이름과 오류 문구를 남기고 인증 정보는 제외합니다.
여러 AI로 늘릴 때는 파일 분리부터 확인합니다
별도 워크트리를 만들면 같은 저장소의 파일을 다른 폴더에서 수정할 수 있습니다. 하지만 공유 경로, 외부 계정과 네트워크 접근까지 모두 분리하는 보안 장치는 아닙니다. 같은 워크트리에 터미널만 더 열었다면 같은 파일을 함께 바꿀 수 있습니다. 워크트리와 공유 경로
아래 이미지는 브라우저 탭과 파일 탭을 나란히 둔 화면입니다. 이 한 장만으로 AI마다 파일이 분리됐는지 확인할 수는 없습니다.
처음 두 작업을 나눌 때는 각 작업 공간의 이름과 경로, 수정할 파일, 완료 기준을 적습니다. 결과를 합칠 때는 어느 변경을 가져올지 검토하고 충돌을 해결합니다. 두 AI가 같은 답을 냈다는 사실이 정답의 증거는 아닙니다.
AI가 다른 AI에 일을 배정하는 기능도 있지만 첫 실습의 필수 단계는 아닙니다. 한 작업의 파일과 완료 여부를 확인하는 방법부터 익힙니다.
VS Code, 커서와 무엇이 다른가요?
현재 Orca에도 파일 편집기, 브라우저와 변경 검토 기능이 있습니다. ‘편집기가 전혀 없는 프로그램’으로 이해하면 안 됩니다. CLI는 명령어로 프로그램을 사용하는 방식입니다. Orca는 여러 CLI 에이전트와 작업 공간을 관리하는 데 초점을 두며 화면 앱과 자동화용 CLI를 함께 제공합니다.
VS Code 역시 여러 에이전트 세션을 관리하는 기능이 있습니다. ‘기존 편집기는 AI 하나만, Orca는 여러 개’라는 구분은 현재 기능을 설명하지 못합니다. VS Code 에이전트 안내
| 비교할 질문 | 판단에 사용할 내용 |
|---|---|
| 주로 직접 코드를 편집하나요? | 익숙한 편집기와 확장, 검토 기능으로 현재 일이 끝나는지 |
| 서로 다른 CLI 에이전트를 자주 함께 쓰나요? | 계정과 세션, 작업 폴더를 한 앱에서 관리할 필요가 있는지 |
| 기다림이 줄어드나요? | 독립 작업을 나눌 수 있는지와 결과 검토에 드는 시간 |
| 휴대폰에서 이어서 확인하나요? | 연결된 컴퓨터나 서버가 켜져 있고 접근 가능한지 |
커서나 안티그래비티 이름이 지원 목록에 있다고 해당 편집기 전체가 Orca 안에 들어간다는 뜻은 아닙니다. 연결되는 CLI와 사용 가능한 기능을 확인합니다. 기존 편집기를 삭제할 필요도 없습니다.
이전 오류 사례를 현재 상태와 구분합니다
2026년 7월 원문에는 음성 입력 중 종료, Android 설치 중단, 모델 선택 미적용과 여러 AI 실행 중 종료 사례를 소개했습니다. 당시의 문제 수와 사례를 모든 현재 버전에 그대로 적용하지 않습니다. 반대로 업데이트가 빠르다고 내 오류가 해결됐다고 가정하지도 않습니다.
문제가 생기면 설치 버전과 같은 오류를 공식 이슈 및 변경 기록에서 찾아봅니다. 상태가 닫혔다는 표시만 보지 말고 어느 버전에 수정이 들어갔는지와 내 재현 결과를 함께 확인합니다.
자주 묻는 질문
기존 구독만 연결하면 추가 비용이 전혀 없나요?
앱 설치는 무료지만 AI 사용 한도와 사용량 과금은 제공자 조건을 따릅니다. 같은 계정으로 여러 AI 작업을 돌리면 사용량을 함께 소비할 수 있습니다.
코딩 AI를 두 개 구독해야 하나요?
아닙니다. 이미 사용할 수 있는 AI 하나로 시작합니다. 지금 작업을 확인하는 데 어려움이 없다면 여러 구독이나 새 앱을 늘리지 않아도 됩니다.
스마트폰만으로 실행하나요?
모바일 앱은 실행 중인 데스크톱이나 연결 서버의 작업을 확인하고 지시하는 보조 앱입니다. 해당 호스트가 꺼졌거나 연결되지 않으면 그곳의 작업을 계속 조작할 수 없습니다. Relay는 기기 사이 연결을 중계하는 방식이며 별도 로그인을 요구할 수 있습니다. 모바일 안내
이번 연습에서 파일 경로와 변경 내용을 직접 확인했다면, 다음에는 독립적인 작업 두 개를 따로 맡길 이유가 있는지 판단해 봅니다. 화면에 띄운 AI 수보다 결과를 검토할 수 있는 범위가 먼저입니다.
8컷 만화로 정리한 Orca
2026년 7월에 만든 만화입니다. 여러 작업을 나누어 보는 비유는 유지하되 3컷의 방 분리는 별도 워크트리를 만들었을 때의 설명입니다. 창만 나누면 같은 파일을 수정할 수 있습니다. 4컷과 달리 현재 Orca에도 파일 편집기가 있고, 6컷의 무료는 앱 설치를 뜻하며 AI 사용료와 한도는 별도입니다. 7컷의 신고 수는 현재 오류율이 아닙니다.
그림은 DGX Spark에서 Qwen-Image-2.1로 그렸고 대사는 따로 얹었습니다. 기존 대사는 당시 표현을 보존했으며 현재 조건은 위 설명과 함께 읽습니다. 방 분리는 모든 접근의 차단을 뜻하지 않고 같은 계정의 병렬 사용은 한도를 소비합니다.
만화 대사 전문
- 민준: AI가 일을 끝낼 때까지 화면만 보고 있어요. / 준이아빠: 그 기다림을 줄이려고 나온 게 Orca예요.
- (지금까지는 계산대 하나에 줄 하나) 준이아빠: 지금은 일을 하나 맡기고, 끝나야 다음 일을 맡기잖아요. / 민준: 그러니 한 줄로 서서 기다릴 수밖에요.
- (Orca: AI마다 방을 하나씩) 준이아빠: Orca는 AI마다 방을 따로 주고 한꺼번에 일을 시켜요. / 민준: 방이 따로면 서로 작업을 망칠 일도 없겠네요.
- (편집기가 아니라 관제탑) 민준: 그럼 VS Code는 지우고 이걸 써야 해요? / 준이아빠: 아니요. 편집기는 그대로 두고, AI 지휘만 여기서 해요.
- (같은 지시를 여러 AI에 한 번에) 준이아빠: 같은 일을 클로드 코드와 코덱스에 한 번에 보내 볼게요. / 민준: 어느 쪽이 나을지 미리 고민하지 않아도 되겠어요!
- (결과를 나란히 놓고 더 나은 쪽을 고른다) 준이아빠: 둘 다 끝나면 결과를 나란히 놓고 고르면 돼요. / 민준: 그러려면 구독을 하나 더 해야 해요? / 준이아빠: 아니요. 쓰던 구독을 연결하면 되고, 프로그램도 무료예요.
- (2026년 7월 기준, 공개 4개월 차) 준이아빠: 다만 해결되지 않은 문제 신고가 600건이 넘어요. / 민준: 그럼 지금 쓰기엔 불안하지 않아요? / 준이아빠: 대신 수정판이 하루 이틀마다 나와요. 빠르게 자라는 중이에요.
- (필요해졌을 때 꺼내 보면 되는 도구) 민준: 저는 아직 클로드 코드 하나도 익숙하지 않은데요. / 준이아빠: 그럼 그 하나부터 익숙해지세요. Orca는 그다음이에요.
Sources
3줄 요약
-
Orca는 코딩 AI의 세션과 작업 공간, 파일과 변경 내용을 한 화면에서 관리하는 무료 공개 앱입니다.
-
처음에는 새 연습 저장소에서 AI 하나로 안내문 한 줄을 수정하고 실제 파일과 변경 내역을 확인합니다.
-
워크트리를 나눠도 계정 사용량이나 공유 자원이 자동 분리되지는 않으므로 작업 범위와 비용을 확인한 뒤 병렬 실행을 늘립니다.
제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
같은 작업 공간에서 AI 창 두 개를 열면 파일이 자동으로 분리되나요?
이 글이 도움이 되었나요?
코딩 에이전트가 무엇이고 도구마다 무엇이 다른지, 비개발자 눈높이로 고르는 기준까지
코스 전체 보기 →
새 글과 AI 소식을 메일로 받아 보세요
AI가 바꾸는 일과 도구, 측정 실무 이야기를 매주 한 번 보내 드려요.