Paseo란? Claude Code와 Codex를 휴대폰에서 이어 쓰는 방법

AI 에이전트에게 맡기는 일이 늘면서 작업을 이어가는 방식도 달라지고 있습니다. 컴퓨터 앞에서 코드 수정을 요청하고, 결과를 확인한 뒤 다음 일을 맡기는 흐름이 익숙해지면 이런 생각이 듭니다. “이 작업을 휴대폰에서도 계속할 수 없을까?”

출근길 지하철에서 진행 상황을 확인하고, 버스를 기다리며 추가 요청을 보내거나, 산책 중 떠오른 아이디어를 음성으로 전달하고 싶은 순간이 생깁니다. 에이전트가 작업하는 동안 계속 책상 앞에 앉아 있을 필요는 없지만, 자리를 옮긴 뒤에도 필요한 대화와 지시는 이어가고 싶은 것입니다.

이런 필요에 맞춰 컴퓨터와 모바일 사이에서 에이전트 작업을 연결하는 도구들이 등장하고 있습니다. Paseo(파세오) 도 그중 하나입니다. 내 컴퓨터에서 실행되는 Claude Code와 Codex에 휴대폰으로 접속해, 진행 중인 작업을 확인하고 다음 지시를 보낼 수 있게 해줍니다.

컴퓨터에서 시작한 일을 밖에서도 이어가려면 무엇이 필요할까요? Paseo가 어떤 역할을 하고, 컴퓨터와 휴대폰을 어떻게 연결하는지부터 살펴보겠습니다.

Paseo 공식 화면 기반 · AI 편집

Paseo는 무엇을 하는 도구인가

Paseo는 여러 AI 코딩 에이전트를 실행하고 관리하는 오픈소스 도구입니다. Claude Code, Codex, OpenCode, Pi 등을 지원하며, 데스크톱·모바일·웹·CLI에서 접속할 수 있습니다. 지원하는 도구와 기능은 공식 저장소에서 확인할 수 있습니다.

예를 들어 컴퓨터의 Paseo에서 Codex에 오류 수정을 맡긴 뒤 외출했다고 생각해보겠습니다. 작업이 진행되는 동안 휴대폰으로 같은 작업에 접속해 어떤 내용을 수정했는지 읽고, 추가로 확인할 부분을 전달할 수 있습니다.

이때 실제 파일을 읽고 수정하는 곳은 에이전트가 실행되는 컴퓨터입니다. 휴대폰은 작업에 접속해 지시하고 결과를 확인하는 역할을 합니다. 작업 환경은 컴퓨터에 두고, 접속하는 기기를 상황에 맞게 바꾸는 방식입니다.

이 글에서 말하는 ‘이어 쓰기’는 Paseo에서 관리하는 작업을 여러 기기로 이어가는 의미입니다. 기존에 별도 터미널에서 실행하던 모든 세션이 자동으로 연결된다고 이해할 필요는 없습니다.

Paseo의 주요 특징

Paseo의 기능은 ‘여러 기기에서 내 에이전트에 접속한다’는 구조를 중심으로 살펴보면 이해하기 쉽습니다.

이 기능들은 Paseo 공식 소개와 FAQ에 안내되어 있습니다. 특히 워크트리는 필요할 때 선택하는 기능입니다. Git을 사용하지 않는 디렉터리에서도 에이전트를 실행할 수 있어, 문서가 있는 폴더처럼 일반적인 작업 공간에도 적용할 수 있습니다.

컴퓨터와 휴대폰은 어떻게 연결될까

Paseo는 서버와 클라이언트로 구성됩니다. 서버에 해당하는 프로그램은 데몬(daemon) 이라고 부릅니다. 컴퓨터나 서버에서 실행되면서 에이전트를 관리하고, 모바일 앱과 웹 화면 같은 클라이언트가 여기에 접속합니다.

공식 문서 기반 연결 구조도

에이전트를 실행할 장비는 노트북일 수도 있고, 집에 두는 Mac mini나 별도 서버일 수도 있습니다. 휴대폰에서 작업을 이어가려면 해당 장비와 Paseo 데몬이 실행되고 있어야 합니다. 컴퓨터가 잠들거나 연결이 끊기면 원격 작업에도 영향을 줍니다.

외부에서 연결할 때는 릴레이(relay) 를 선택적으로 사용할 수 있습니다. 릴레이는 휴대폰과 컴퓨터의 연결을 중계합니다. 공식 연결·보안 문서에 따르면 이 방식은 별도의 VPN이나 포트포워딩 설정 없이 사용할 수 있으며, 클라이언트와 데몬 사이의 통신에는 종단간 암호화가 적용됩니다. 직접 연결이나 Tailscale 같은 VPN을 사용하는 방법도 있습니다.

처음 시작할 때 필요한 것과 연결 순서

먼저 사용할 에이전트를 준비해야 합니다. Paseo는 에이전트를 관리하는 도구이므로, Claude Code나 Codex 등 사용할 CLI가 설치되어 있고 해당 계정으로 정상적으로 동작해야 합니다.

처음 사용하는 경우에는 데스크톱 앱으로 시작하는 흐름이 간단합니다. 공식 문서상 데스크톱 앱에는 데몬이 포함되어 있으며, 앱을 열면 자동으로 시작됩니다.

1. 컴퓨터에서 에이전트 실행을 확인합니다

Claude Code나 Codex가 원하는 프로젝트에서 정상적으로 작동하는지 확인합니다. 인증이나 개발 환경 문제는 이 단계에서 해결해두면 이후 연결 문제와 구분하기 쉽습니다.

2. Paseo 데스크톱 앱을 설치합니다

공식 다운로드 페이지에서 운영체제에 맞는 앱을 설치합니다. 처음에는 컴퓨터에서 프로젝트를 열고 작은 작업을 실행해봅니다.

3. 휴대폰을 연결합니다

휴대폰에 Paseo 앱을 설치한 뒤, 컴퓨터의 Paseo 앱에서 설정(Settings)을 엽니다. 연결할 컴퓨터를 선택하고 기기 연결(Pair Device)을 누릅니다. 이어서 화면 안내에 따라 휴대폰을 연결합니다.

외부에서도 접속하려면 연결 과정에서 릴레이 사용을 선택할 수 있습니다. 연결을 마치면 휴대폰에서 해당 컴퓨터의 작업을 열어볼 수 있습니다.

4. 작은 작업으로 이어 쓰기를 확인합니다

프로젝트 구조를 설명하게 하거나 문서의 특정 부분을 확인하도록 요청합니다. 그다음 휴대폰에서 해당 작업을 열어 결과를 읽고, 한 번의 후속 메시지를 보내봅니다.

설치와 페어링 순서는 공식 시작 문서를 기준으로 정리했습니다. 메뉴와 지원 범위는 버전에 따라 달라질 수 있습니다.

어떤 사람에게 잘 맞을까

Paseo는 이미 AI 에이전트를 사용하고 있고, 컴퓨터 밖에서도 작업을 이어갈 필요가 있는 사람에게 검토할 만합니다.

오래 걸리는 코드 수정이나 테스트를 맡기는 사람이 한 가지 예입니다. 작업이 진행되는 동안 자리를 비웠다가 필요한 순간에 결과를 확인하고 다음 지시를 전달할 수 있습니다. 여러 에이전트 도구를 사용하는 사람이라면 같은 인터페이스에서 작업을 살펴보는 점도 의미가 있습니다.

아직 Claude Code나 Codex를 사용해본 적이 없다면 먼저 한 가지 에이전트를 컴퓨터에서 익혀보는 편이 수월합니다. 어떤 일을 맡길 수 있고 언제 사람이 확인해야 하는지 알아야 모바일 연결이 자신에게 얼마나 필요한지도 판단할 수 있습니다.

사용 전에 알아둘 조건

Paseo는 무료 오픈소스 도구로 안내되지만, 연결하는 에이전트의 이용 조건과 비용까지 없어지는 것은 아닙니다. 사용하는 에이전트의 계정과 인증, 사용량 조건은 별도로 확인해야 합니다.

또한 로컬 실행이라는 설명이 AI 처리 전체가 오프라인으로 이루어진다는 뜻도 아닙니다. 공식 FAQ에 따르면 에이전트는 평소처럼 자신이 사용하는 API와 통신합니다. 휴대폰과 컴퓨터 사이의 연결 방식, 에이전트와 모델 서비스 사이의 통신은 구분해서 이해하면 됩니다.

책상에서 시작한 일을 모바일로 이어가기

AI 에이전트에게 맡기는 일이 많아질수록, 사람이 결과를 확인하고 다음 방향을 정하는 순간도 늘어납니다. Paseo는 이런 대화를 컴퓨터 앞에서 시작해 휴대폰에서도 이어갈 수 있게 해줍니다. 익숙한 개발 환경은 그대로 두고, 필요한 순간에 작업으로 돌아올 수 있다는 점이 이 도구의 매력입니다.

처음에는 작은 작업 하나를 맡겨보세요. 컴퓨터에서 시작한 작업의 결과를 휴대폰으로 읽고, 추가 요청을 보내보는 것만으로도 충분합니다. 지하철이나 버스를 기다리는 짧은 시간에도 하던 일을 자연스럽게 이어갈 수 있다면, Paseo가 자신의 작업 방식에 어떻게 도움이 되는지 느낄 수 있을 것입니다.

실제 사용자들이 어떤 부분을 편리하게 느끼는지는 다음 글인 사람들이 Paseo를 쓰는 이유에서 이어서 살펴봅니다.