Paseo 시작하기: 컴퓨터 작업을 휴대폰에서 이어 보는 방법

Paseo는 컴퓨터에서 실행되는 코딩 에이전트를 휴대폰에서도 조작하게 해 주는 도구입니다. 코딩 에이전트는 요청을 받아 파일을 읽고 고치는 AI 프로그램이고, Claude Code와 Codex가 대표적입니다. Paseo를 쓰면 컴퓨터에서 시작한 작업의 진행 상황을 폰에서 보고, 같은 대화에 다음 지시를 보낼 수 있습니다. 설명은 2026년 10월 4일 공식 문서를 기준으로 합니다.

파일은 컴퓨터에 있고 휴대폰은 지시를 보냅니다

Paseo는 네 부분으로 움직입니다. 호스트는 실제 작업을 실행하는 컴퓨터이고, 데몬은 호스트에서 에이전트를 관리하는 상주 프로그램입니다. 클라이언트는 데몬에 지시를 보내고 결과를 보여 주는 데스크톱 앱과 휴대폰 앱이며, 제공자는 실제 AI 작업을 맡는 코딩 도구입니다. 휴대폰에서 보낸 요청은 아래 순서로 전달됩니다.

그래서 호스트가 꺼지거나 절전으로 네트워크가 끊기면 휴대폰만으로는 작업을 이어 갈 수 없습니다. 휴대폰을 연결해도 프로젝트가 클라우드 서버로 옮겨지지 않습니다.

5번 단계도 함께 봐야 합니다. 파일과 에이전트가 내 컴퓨터에 있어도 클라우드 AI를 쓰면 요청과 필요한 코드가 모델 제공자에게 전달될 수 있습니다. Paseo가 사용 기록을 추적하지 않는다는 공식 안내는 Paseo 앱에 관한 설명이고, 데이터 처리 조건은 AI 제공자마다 따로 정해 둡니다. 휴대폰과 데몬 사이를 암호화해도 4번에서 5번으로 가는 통신은 그대로 일어납니다.

공식 저장소가 안내하는 제공자는 Claude Code, Codex, Copilot, OpenCode, Pi, Antigravity, Muse Code입니다. 처음에는 이미 쓰고 있는 도구 하나만 연결해도 충분합니다.

컴퓨터에 데스크톱 앱을 설치하는 순서

1단계를 먼저 하는 이유는 Paseo 앱에 데몬은 들어 있지만 코딩 에이전트까지 설치해 주지는 않기 때문입니다. 터미널에서 쓰던 에이전트를 열어 짧은 질문을 보내고, 로그인과 이용 한도가 정상인지 봅니다.

2단계의 설치 파일은 공식 다운로드 페이지에서 고릅니다. Linux는 Debian과 Ubuntu용 .deb, Fedora용 .rpm처럼 배포판마다 파일이 다릅니다.

4단계에서 에이전트가 목록에 없으면 모델을 새로 결제하기 전에 Settings → 해당 host → Providers → 해당 provider → Diagnostic을 엽니다. 이 화면에 앱이 찾은 실행 파일과 상태가 나옵니다. 터미널에서는 되는데 앱에서만 안 되면 터미널이 쓰는 실행 파일과 Diagnostic에 나온 실행 파일이 같은지 비교합니다.

첫 요청은 읽기만 하고, 그다음 한 곳을 고칩니다

Paseo 화면에 나오는 이름 세 가지부터 정리합니다. 작업 경로는 에이전트가 읽고 수정할 폴더의 위치입니다. 워크스페이스는 그 폴더를 열어 둔 작업 공간이고, 세션은 그 안에서 진행하는 개별 대화입니다.

요청을 보내기 전에 화면에 표시된 폴더 경로가 고른 프로젝트인지 봅니다. 회사 코드가 든 폴더라면 외부 AI에 보내도 되는지 회사 규정부터 봅니다.

첫 요청은 파일을 바꾸지 않는 읽기 요청이 좋습니다. 프로젝트의 README.md처럼 내용을 아는 파일을 읽게 하면 답이 맞는지 바로 대조할 수 있습니다. 답에 파일에 없는 내용이 섞였거나 파일을 못 찾았다는 답이 오면 작업 경로와 파일 이름부터 다시 봅니다.

Paseo 데스크톱, my-project 세션

> README.md를 읽고 실행 방법 부분을 그대로 알려줘. 파일을 수정하거나 다른 도구를 설치하지 마.

README.md의 실행 방법 부분을 원문 그대로 옮깁니다.
설치 명령 한 줄과 실행 명령 한 줄이 있습니다.
파일은 수정하지 않았습니다.

> README.md의 설치 명령 바로 위에 "준비: Node.js 설치" 한 줄만 추가해줘. 다른 줄과 다른 파일은 수정하지 마.

수정 요청은 파일 하나, 줄 하나로 범위를 좁힙니다

수정 요청 뒤에는 완료 문구만 믿지 말고 파일을 다시 엽니다. 요청한 한 줄만 추가됐으면 성공입니다. Paseo 데스크톱의 코드 변경 화면에서도 바뀐 줄을 볼 수 있습니다. 다른 파일까지 바뀌었으면 다음 지시를 멈추고 변경 내용부터 살핍니다.

휴대폰에서 같은 세션을 이어 봅니다

컴퓨터에서 첫 세션이 동작하면 공식 다운로드 페이지에서 iOS나 Android 앱을 받아 휴대폰에 설치합니다. 휴대폰과 데몬을 잇는 방법 가운데 하나가 공식 릴레이입니다. 릴레이는 두 기기 사이의 연결을 중계하는 서버입니다. Paseo를 새로 설치하면 릴레이 설정이 꺼져 있어서 직접 켜야 합니다.

QR과 연결 링크는 다른 사람에게 보내지 않습니다. 공식 보안 문서에 따르면 휴대폰과 데몬 사이는 종단간 암호화로 보호됩니다. 종단간 암호화는 연결한 두 기기에서만 메시지를 읽을 수 있게 하는 방식입니다.

5단계에서는 휴대폰에서 README.md에서 방금 추가한 줄을 그대로 보여줘. 수정하지 마.처럼 읽기만 요청합니다. 앞에서 추가한 줄이 답에 나오고 컴퓨터의 기존 대화에도 이 요청이 나타나면 같은 세션에 연결된 것입니다. 새 세션에는 이전 대화가 이어지지 않으므로 4단계에서 새 대화를 만들지 않고 기존 세션을 고릅니다.

연결이 안 될 때 확인 순서

컴퓨터 쪽 원인부터 휴대폰 쪽 원인 순서로 좁혀 갑니다.

2번에서 컴퓨터가 절전 상태였다면 깨운 뒤 앱의 호스트 연결 상태를 다시 봅니다. 3번은 새 대화를 만들기 전에 봅니다. 새 대화에는 이전 대화 내용이 이어지지 않습니다.

릴레이를 쓰지 않으려면 Tailscale 같은 사설 네트워크로 연결할 수도 있습니다. Tailscale은 여러 기기를 하나의 사설 네트워크로 묶어 주는 서비스입니다. 이 방식은 컴퓨터와 휴대폰 양쪽에 접속 설정이 필요하고, 앱에 나오는 기본 로컬 주소를 폰에 입력하는 것만으로는 연결되지 않습니다. 설정 방법은 공식 연결 문서에 있습니다.

화면 없는 서버에서는 CLI나 Docker를 씁니다

CLI는 터미널에 명령을 입력해 프로그램을 다루는 방식입니다. 화면이 없는 서버에서 Paseo를 쓰려면 Node.js와 npm이 있는 환경에서 공식 CLI를 설치하고 실행합니다. Node.js는 자바스크립트 실행 환경이고, npm은 Node.js용 프로그램 설치 도구입니다. 데스크톱 앱을 쓰면 CLI 설치는 건너뜁니다.

첫 줄은 CLI를 설치하고, 둘째 줄은 Paseo를 실행합니다. 설치 뒤 이미 실행 중인 에이전트에 지시를 보내는 순서는 이렇습니다.

Docker는 프로그램을 별도 실행 환경에 담아 운영하는 방식입니다. Docker로 Paseo를 띄우면 에이전트 설치, 파일 연결, 접속 인증을 따로 설정해야 합니다. 문서의 기본 비밀번호 예시나 컴퓨터 전체 폴더를 연결하는 예시는 그대로 복사하지 말고, Docker 문서의 설명에 따라 내 환경에 맞게 바꿉니다.

여러 에이전트를 함께 쓸 때

Orca 소개 글은 여러 코딩 에이전트에 일을 맡기고 결과를 비교하는 흐름을 다룹니다. 이 글의 Paseo는 기기를 바꿔 같은 작업을 이어 보는 데 초점을 맞췄습니다. 두 도구 중 무엇을 쓸지는 필요한 작업 흐름을 각 도구의 현재 버전이 지원하는지로 정합니다.

Paseo의 스킬은 에이전트에게 추가 작업 지침을 주는 기능입니다. 현재 저장소는 일을 다른 에이전트에 넘기는 /paseo-handoff, 조언을 받는 /paseo-advisor, 두 관점으로 검토하는 /paseo-committee를 소개합니다. 에이전트를 여러 개 실행하면 그만큼 각 제공자의 이용 한도와 비용도 함께 씁니다.

Git worktree는 같은 저장소의 작업 파일을 별도 폴더로 나누는 Git 기능입니다. 여러 에이전트가 한 저장소에서 일할 때 파일 충돌을 줄여 주지만, 권한까지 나눠 주지는 않습니다.

worktree로 나뉘는 것과 나뉘지 않는 것

항목	한 폴더에서 두 작업	worktree로 나눈 두 작업
작업 파일 충돌 줄이기	제공하지 않음	제공
외부 계정 접근 분리	제공하지 않음	제공하지 않음
명령 실행 권한 분리	제공하지 않음	제공하지 않음

비용과 라이선스

Paseo가 기존 에이전트 계정을 쓰더라도 AI 이용료는 연결한 제공자의 조건대로 나갑니다. 제공자 쪽에서 볼 조건은 세 가지입니다.

2026년 10월 4일 공식 저장소의 본체 라이선스는 Apache-2.0입니다. 수정본을 배포하거나 다른 사람에게 제공할 때는 실제로 쓰는 버전의 LICENSE 파일과 포함된 구성 요소의 조건을 따릅니다.

처음에는 데스크톱에서 읽기 요청과 한 곳 수정이 되는지 본 뒤 휴대폰을 연결합니다. CLI, Docker, 여러 에이전트 운영은 그 흐름이 익숙해진 다음에 필요한 것만 고르면 됩니다.

Sources

• Paseo 공식 저장소
• 설치와 사전 준비
• 기기 연결
• 보안과 인증
• CLI 레퍼런스