카피바라 마을

에이전트가 일하는 모습을 한눈에 보는
AI 시대의 IDE.

카피바라 마을은 폴더를 작은 마을로 바꾸고, Claude Code나 Codex 같은 에이전트가 일하는 모습을 카피바라로 보여 줘요. 에이전트를 여러 개 돌려도 누가 지금 무엇을 하는지 한 화면에서 볼 수 있어요.

카피바라 마을 앱 아이콘: 노란 배경에 카피바라 얼굴과 작은 집들

이렇게 보여요

폴더가 마을이 된 앱 화면. 가운데에 카피바라가 컴퓨터, 휴지통, 프린터와 함께 앉아 있고 아래 입력창에 할 일을 적을 수 있다
작업 대상 폴더가 마을이 되고, 그 안의 폴더는 건물이 돼요. 아래 입력창에 시킬 일을 적어요.
카피바라가 마을을 걸어 다니며 폴더를 살펴보는 화면. 말풍선에 폴더를 살펴볼게요라고 적혀 있다
에이전트가 일하는 동안 카피바라가 돌아다니며, 지금 하는 일을 쉬운 말로 알려 줘요.

할 수 있는 일

AI 고르기 창의 필요한 AI 도구 함께 설치 안내. Node.js가 아직 없다는 설명, 받는 곳 nodejs.org와 받을 버전, 이어서 실행할 공식 명령 두 줄, Node.js 설치하고 이어서 설치하기 버튼이 보인다

앱 안에서 Node.js 설치

Claude Code와 Codex를 쓰려면 Node.js(npm)가 필요해요. 없으면 앱이 nodejs.org의 공식 설치 파일을 받아 체크섬과 서명을 확인한 뒤 실행해 줄 수 있어요. 무엇을 받아 무엇을 실행하는지 먼저 보여 주고, 내가 버튼을 눌러야만 시작해요. 맥에서는 macOS가 관리자 비밀번호를 물어보는데, 앱은 그 비밀번호를 보지도 저장하지도 않아요. Windows 판은 베타예요. 원하면 공식 설치 안내 링크도 볼 수 있어요.

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

마을로 보는 내 폴더

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

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

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

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

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

쉬운 안전 모드

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

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

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

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

규칙 게시판에 지침 남기기

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

카피바라 이름 바꾸기 창의 모델 선택. 새 이름, 역할, 모델(Claude) 선택 상자와 모델 이름 입력칸, 저장·취소 버튼이 보이고 아래에는 카피바라 두 마리가 목록에 있다

카피바라별 모델 선택

카피바라마다 이름 바꾸기 창에서 Claude Code가 쓸 모델을 목록에서 고르거나 모델 이름을 직접 적을 수 있어요(Codex는 이름을 직접 적어요). 비워 두면 도구의 기본값을 써요. 정한 모델은 새 대화에도, 이어 가는 대화에도 쓰여요.

터미널 명령 상자. 내 컴퓨터에서 명령을 그대로 실행한다는 주의 문구, 시작 폴더, 입력한 ls 명령과 끝났어요 종료 코드 0 안내, 폴더 안의 파일 이름이 나열된 출력이 보인다

터미널 명령 상자

「터미널」 버튼을 누르면 작은 상자가 열려요. 터미널에서만 실행해야 하는 명령을 입력하세요

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

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

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

파일 보내기 확인 창. 받는 컴퓨터와 폴더, 보낼 파일 두 개의 이름과 크기, 같은 이름의 파일은 덮어쓰지 않는다는 안내, 취소와 보내기 버튼이 보인다

다른 컴퓨터로 파일 보내기

다른 컴퓨터에서 연 마을에서는 파일을 앱 창으로 끌어다 놓을 수 있어요. 그러면 파일 이름과 크기, 받는 컴퓨터와 폴더를 보여 주는 창이 뜨고, 「보내기」를 눌러야만 보내요. 같은 이름의 파일은 덮어쓰지 않고 이름 뒤에 (1)을 붙여 저장해요. 폴더는 보낼 수 없고 파일만 보낼 수 있어요.

카피바라 마을 리플레이 창. 폴더 건물 사이에서 카피바라 두 마리가 일하는 장면이 보이고, 아래에 처음으로·재생 버튼과 시간 막대가 있으며 위쪽에 기록 중이라는 표시와 기록 끄기·기록 모두 지우기 버튼이 있다

작업 리플레이

카피바라들이 한 일을 나중에 다시 볼 수 있도록 기본으로 기록해요. 기본 녹화는 어떤 카피바라가 어느 폴더에서 어떤 일(읽기·고치기 등)을 했는지만 남기고, 대화·명령·파일 내용은 남기지 않아요. 내 작업 노하우를 나누고 싶다면 직접 「심층 녹화」를 켤 수 있어요. 그러면 대화·명령·파일 경로·고친 부분의 앞부분도 남겨요(비밀값처럼 보이는 글은 가려서요). 기록은 이 컴퓨터에 14일 동안만 저장되고 어디로도 보내지 않아요. 리플레이 창에서 끄거나 모두 지울 수 있고, 기본으로 폴더·카피바라 이름을 가린 영상(webm)으로 내려받을 수도 있어요. 심층 녹화 영상에는 대화·명령·경로가 보일 수 있으니 나누기 전에 확인해 주세요.

팀 보드 창. 연결된 컴퓨터 이름 표시줄과, 컴퓨터·팀원·카피바라·상태·마지막 활동·작업 폴더가 한 줄씩 나열된 표, 그 아래 직접 접속 목록과 최근 바뀐 파일 목록이 보인다. 연결되지 않은 컴퓨터는 붉게 표시된다

같이 작업하는 팀 보드

SSH로 함께 쓰는 컴퓨터에서 팀원의 카피바라가 일하는 모습을 볼 수 있지만, 보기만 가능해서 조종하거나 멈출 수는 없어요. 「팀 보기」는 기본이 꺼져 있어서 켜기 전에는 아무것도 하지 않고, 켜면 서버의 팀 폴더에 별명·카피바라 이름·상태 같은 정해진 항목만 적어요. 더 자세히 보여 주기(하는 일·파일 이름·AI 답 한 문장)는 내가 단계마다 따로 켜요. 내 말과 명령은 적지 않고, 직접 접속 보기와 최근 바뀐 파일은 따로 켜야 해요. 초대 창에서 서버에 팀원을 추가하는 명령을 확인하고, 직접 복사해 실행하거나 「실행」을 눌러 앱이 대신 실행하게 할 수 있어요(비밀번호 없는 sudo일 때만).

클라우드 서버 창. 구글 클라우드 도구, 구글 계정 로그인, 프로젝트 고르기, 결제 계정 연결, 가상 컴퓨터 기능의 다섯 점검 단계가 모두 됐어요로 표시돼 있고, 아래에 내 클라우드 서버 두 개(켜져 있어요·꺼져 있어요)와 새 서버 만들기 선택지가 보인다

클라우드 서버 만들기(구글 클라우드)

내 컴퓨터에 설치된 구글 클라우드 도구(gcloud)로, 정해진 명령만 실행해 내 구글 클라우드 프로젝트에 서버를 만들고, 목록을 보고, 끄고, 켜고, 지워요. gcloud·구글 로그인·프로젝트·결제 계정·Compute Engine, 다섯 가지를 한 단계씩 점검해 안내해 줘요. 로그인은 gcloud가 직접 처리하고 앱은 구글 계정 정보를 읽거나 저장하지 않아요. 서버는 내 프로젝트에 만들어지고 요금은 내 구글 계정에 청구돼요. 앱은 프로젝트 ID·지역·서버 이름만 이 컴퓨터에 저장해요.

시작하는 법

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

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

신뢰와 개인정보

파일은 내 컴퓨터에 있어요

앱이 내 폴더와 데이터를 운영 서버에 업로드하지 않아요. 공식 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 고르기” 창에서 볼 수 있어요.