내 에이전트들이 일하는 모습을
카피바라 마을로 확인해요.

카피바라 마을은 폴더를 작은 마을로 바꾸고, Claude Code나 Codex 같은 에이전트가 그 안에서 읽고, 쓰고, 마무리하는 모습을 카피바라로 보여 줘요.

Apple Silicon 맥용 다운로드M1 이후 맥 · dmg Intel 맥용 다운로드인텔 맥 · dmg Windows용 다운로드Windows 10 이상 · 64비트 · 베타, 불안정

macOS 13 이상 또는 Windows 10 이상(64비트)이 필요해요. 버전 . 어떤 맥인지 모르겠다면 화면 왼쪽 위 메뉴 → “이 Mac에 관하여”에서 칩(Apple M…) 또는 프로세서(Intel)를 확인하세요.

Windows 판은 베타라서 불안정할 수 있어요. 아직 서명되지 않은 설치 파일이라 SmartScreen이 경고를 띄울 수 있어요. “추가 정보”를 눌러 실행하세요.

이렇게 보여요

폴더가 마을이 된 앱 화면. 가운데에 카피바라가 컴퓨터, 휴지통, 프린터와 함께 앉아 있고 아래 입력창에 할 일을 적을 수 있다 — 작업 대상 폴더가 마을이 되고, 그 안의 폴더는 건물이 돼요. 아래 입력창에 시킬 일을 적어요.

카피바라가 마을을 걸어 다니며 폴더를 살펴보는 화면. 말풍선에 폴더를 살펴볼게요라고 적혀 있다 — 에이전트가 일하는 동안 카피바라가 돌아다니며, 지금 하는 일을 쉬운 말로 알려 줘요.

할 수 있는 일

폴더가 마을로 열린 화면. 폴더마다 이름표가 붙은 건물이 흩어져 있고, 가운데에서 카피바라가 한가롭게 쉬고 있다

마을로 보는 내 폴더

작업 대상 폴더를 고르면 마을이 열려요. 안에 있는 폴더는 건물이 되고, 들어가 보면 무엇이 있는지 볼 수 있어요.

카피바라가 서재 건물 안에서 책을 읽는 화면. 읽는 중이라는 말풍선, 지금 하는 일을 알리는 한 줄 안내, 오른쪽 아래의 멈추기 버튼이 함께 보인다

에이전트가 일하는 모습을 한눈에

파일을 읽고, 쓰고, 마무리하는 모습을 카피바라가 보여 주고, 한 줄 안내가 지금 상황을 알려 줘요. 중지 버튼도 늘 있어요.

규칙 게시판의 지침 패널. 항상 쉬운 말로 짧게 설명해 달라는 지침 한 줄이 적혀 있고, 모든 마을에서와 이 마을에서만 중 하나를 고르는 탭이 보인다

규칙 게시판에 지침 남기기

“항상 쉽게 설명해 줘” 같은 지침을 한 번 적어 두면 에이전트가 일할 때마다 따라요. 모든 마을에 적용하거나 이 마을에만 적용할 수 있어요. 지침은 안내일 뿐이라 구경만·수정 허용 같은 권한은 바꾸지 못하고, 권한은 안전 모드가 정해요.

다른 컴퓨터(연구실 서버)의 폴더가 마을로 열린 화면. 위쪽에 컴퓨터 별칭이 보이고 아래에는 다른 컴퓨터의 폴더를 마을로 열었다는 안내가 나온다

다른 컴퓨터(원격) 폴더 열기

이미 SSH로 접속할 수 있는 다른 컴퓨터가 있다면 그곳의 폴더도 마을로 열 수 있어요(원격 대상은 macOS·Linux만 지원해요). 앱이 비밀번호를 받거나 열쇠를 대신 만들어 주지는 않아요.

아래쪽 모드 메뉴가 펼쳐진 화면. 구경만, 수정 허용, 모두 허용이 나란히 보이고 모두 허용에는 명령 실행과 파일 삭제가 가능하다는 주의 문구가 붙어 있다

쉬운 안전 모드

에이전트가 할 수 있는 일의 범위를 쉬운 말로 고를 수 있어요.

👀 구경만 — 읽기만 하고 아무것도 바꾸지 않아요
✏️ 수정 허용 — 파일을 고치거나 새로 만들 수 있어요
⚡ 모두 허용 — 명령 실행·파일 삭제까지 가능해요 (주의)

처음에는 “구경만”이 기본이에요. 가장 강한 모드를 다른 컴퓨터에서 쓰려 할 때는 앱이 쉬운 말로 먼저 물어봐요.

시작하는 법

필요한 것은 macOS 13 이상의 맥(또는 Windows 10 이상 PC, 베타), 그리고 Claude Code 또는 Codex(둘 중 하나)예요. 설치는 앱 안에서 함께 할 수 있어요.

앱을 내려받아 열어요. 맥은 dmg를 열고 카피바라 마을을 응용 프로그램 폴더로 끌어다 놓으세요. Windows는 내려받은 설치 파일(exe)을 실행하세요. SmartScreen 경고가 뜨면 “추가 정보”를 눌러 실행해요.
폴더를 고른 뒤 “AI 고르기” 창에서 도구를 골라요. 처음 실행하면 폴더를 고른 뒤 “AI 고르기” 창이 떠요. 설치된 도구가 없으면 그 창에서 필요한 도구(Claude Code·Codex)를 골라, 보여 주는 공식 명령을 확인한 뒤 앱이 함께 설치해요. Node.js(npm)가 없으면 설치 안내 링크를 보여 줘요.
로그인해요. 로그인은 공식 도구가 직접 처리하고 앱은 계정이나 토큰을 받지 않아요. 요청을 보낼 때만 에이전트가 일해요.
시킬 일을 적어요. 예: “이 폴더에 뭐가 있는지 알려줘”.

신뢰와 개인정보

파일은 내 컴퓨터에 있어요

앱이 내 폴더와 데이터를 운영 서버에 업로드하지 않아요. 공식 API(Claude, GPT)를 제외하고 모든 작업은 로컬에서 진행돼요.

사용 통계를 자동으로 보내지 않아요

앱에는 분석·추적 도구가 없고, 이 홈페이지에도 없어요. 새 버전을 확인할 때만 앱이 다운로드 주소에서 업데이트 정보를 받아 올 수 있어요.

자주 묻는 질문

인텔 맥과 Apple Silicon 맥 모두 되나요?

둘 다 준비돼 있고 파일이 따로 있어요. M1 이후 맥은 Apple Silicon용, 그보다 오래된 맥은 Intel용을 받으세요. macOS 13 이상이 필요해요. Windows용은 아래 Windows 항목을 봐 주세요.

Windows에서도 되나요?

네, Windows 10 이상(64비트만)에서 쓸 수 있어요. 베타 버전이라 불안정할 수 있어요.

Windows 설치 파일을 실행하니 경고가 떠요. 괜찮나요?

Windows 설치 파일은 아직 코드 서명이 되어 있지 않아서, SmartScreen이 “인식할 수 없는 앱”이라는 경고를 띄울 수 있어요. 지금은 그게 정상이에요. 이 페이지에서 받은 파일인지 확인하고, 진행하기로 했다면 “추가 정보”를 누른 뒤 실행하세요.

Windows 컴퓨터를 원격 대상으로 연결할 수 있나요?

아니요. 다른 컴퓨터의 폴더를 여는 원격 기능은 macOS나 Linux 컴퓨터만 대상으로 지원해요. Windows 컴퓨터는 원격 대상으로 지원하지 않아요.

무료인가요?

현재는 무료예요. 정책이 바뀌면 이 홈페이지에 미리 알려요.

어떤 에이전트와 함께 쓸 수 있나요?

카피바라 마을에는 AI가 들어 있지 않아요. 내 컴퓨터에 설치된 에이전트와 함께 일해요. 설치돼 있지 않으면 Claude Code와 Codex는 보여 주는 공식 명령을 확인한 뒤 앱이 함께 설치해요.

Claude Code, Codex: 공식 도구에 연결해요. 로그인은 각 도구가 처리해요.
OpenCode(베타, 불안정): 아직 충분히 시험되지 않아 문제가 생길 수 있어요. 구경만 같은 앱의 모드가 완전히 지켜지지 않을 수 있어요.
내 하네스: 직접 만든 명령줄 에이전트를 설정 파일(harnesses.json)로 연결해 같은 마을에서 볼 수 있어요. 연결 방법은 앱의 “AI 고르기” 창에서 볼 수 있어요.

내 에이전트들이 일하는 모습을 카피바라 마을로 확인해요.