Paseo: Claude Code, Codex 등 코딩 에이전트를 휴대폰과 데스크톱에서 쓰는 셀프 호스팅 도구

9bow · 6월 8, 2026, 1:30오전

Paseo 소개

Paseo는 Claude Code, Codex, Copilot, OpenCode, Pi 같은 코딩 에이전트 CLI들을 하나의 인터페이스로 묶어주는 셀프호스팅(Self-hosted) 도구입니다. 코딩 에이전트가 여러 종류로 늘어나면서 작업마다 다른 CLI를 열고, 자리를 비우면 진행 상황을 확인할 수 없는 불편이 생겼습니다. Paseo는 "Run agents in parallel on your own machines. Ship from your phone or your desk." 라는 문구로 자신을 소개합니다. 에이전트는 내 컴퓨터에서 병렬로 돌고, 확인과 지시는 책상에서든 휴대폰에서든 가능하다는 접근입니다.

핵심 차별점은 에이전트가 클라우드 샌드박스가 아니라 내 개발 환경 그대로 실행된다는 점입니다. 자신이 쓰던 도구, 설정, 스킬을 그대로 활용하면서 작업마다 적합한 제공자(provider)와 모델을 골라 쓸 수 있습니다. 음성 모드로 작업을 받아쓰게 하거나 문제를 말로 풀어가는 음성 제어도 지원합니다. 텔레메트리, 추적, 강제 로그인이 없다는 점도 프로젝트가 내세우는 원칙입니다.

클라이언트는 iOS, Android, 데스크톱, 웹, CLI를 모두 지원합니다. 책상에서 시작한 작업을 휴대폰으로 점검하고, 터미널에서 스크립트로 제어하는 흐름이 하나의 인터페이스 안에서 이어집니다. 저장소는 TypeScript 모노레포로 구성되어 있으며, 데몬 서버부터 Expo 기반 모바일 앱, Electron 데스크톱 앱, CLI, 원격 연결용 릴레이까지 패키지별 디렉토리로 나뉘어 있습니다.

Paseo의 데몬 구조

Paseo는 데몬(daemon)이라는 로컬 서버를 중심으로 동작합니다. 데몬은 내 컴퓨터에서 실행되면서 코딩 에이전트 프로세스들을 관리하고, 데스크톱 앱, 모바일 앱, 웹 앱, CLI 같은 클라이언트가 여기에 접속합니다. 저장소의 packages/server가 이 데몬에 해당하며, 에이전트 프로세스 오케스트레이션과 WebSocket API, MCP 서버를 담당합니다.

휴대폰에서 접속할 때는 데스크톱 앱 설정 화면이나 터미널에 표시되는 QR 코드를 스캔하면 됩니다. 원격 머신이나 서버에서는 CLI로 데몬을 띄워두고 어느 클라이언트에서든 연결하는 헤드리스 구성이 가능합니다. 외부에서 접근해야 하는 환경을 위해 릴레이(relay) 패키지가 포함되어 있고, 커뮤니티가 만든 Go 구현체인 paseo-relay를 직접 호스팅하는 방법도 안내합니다.

Paseo 설치 및 사용 방법

먼저 Claude Code, Codex, Copilot, OpenCode, Pi 중 하나 이상의 에이전트 CLI가 설치되어 자격 증명까지 설정되어 있어야 합니다. 가장 간단한 경로는 paseo.sh/download에서 데스크톱 앱을 내려받는 것입니다. 앱을 열면 데몬이 자동으로 시작되고 추가 설치가 필요 없습니다.

서버나 원격 머신에서는 CLI로 시작합니다.

npm install -g @getpaseo/cli
paseo

앱에서 할 수 있는 일은 터미널에서도 동일하게 할 수 있습니다. 제공자와 모델을 지정해 작업을 던지고, 실행 중인 에이전트를 나열하고, 라이브 출력을 스트리밍하고, 후속 지시를 보내는 명령이 준비되어 있습니다.

paseo run --provider claude/opus-4.6 "implement user authentication"
paseo run --provider codex/gpt-5.4 --worktree feature-x "implement feature X"

paseo ls                           # list running agents
paseo attach abc123                # stream live output
paseo send abc123 "also add tests" # follow-up task

# run on a remote daemon
paseo --host workstation.local:6767 run "run the full test suite"

Paseo의 에이전트 오케스트레이션 스킬

Paseo는 에이전트가 Paseo를 통해 다른 에이전트를 지휘하도록 가르치는 스킬 4종을 함께 배포합니다. npx skills add getpaseo/paseo 로 설치한 뒤 에이전트 대화에서 바로 쓸 수 있습니다.

/paseo-handoff: 에이전트 간 작업 인계입니다. 작성자는 Claude로 계획을 세운 뒤 Codex에 구현을 넘기는 용도로 쓴다고 설명합니다.
/paseo-loop: 명확한 수용 기준을 두고 에이전트를 반복 실행하는 루프(일명 Ralph loops)로, 검증자(verifier)를 붙일 수 있습니다.
/paseo-advisor: 작업을 위임하지 않고 두 번째 의견을 줄 자문 에이전트 하나를 띄웁니다.
/paseo-committee: 상반된 시각의 에이전트 둘로 위원회를 구성해 근본 원인 분석과 계획 수립을 맡깁니다.

Paseo의 라이선스

Paseo는 AGPL-3.0 라이선스로 공개되어 있습니다. LICENSE 파일은 서드파티 컴포넌트에는 각자의 원 라이선스가 적용되고 나머지 부분이 AGPLv3 라는 점을 명시합니다. AGPL은 코플레프트 라이선스로, 수정한 버전을 네트워크 서비스로 제공할 때에도 소스 코드 공개 의무가 적용되므로 상업적 활용 시 조건을 확인해야 합니다.

Paseo 공식 홈페이지

Paseo 문서 사이트

Paseo GitHub 저장소

더 읽어보기

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~