Paseo란? AI 코딩 에이전트를 원격으로 관리하는 오픈소스 워크스페이스 사용법

AI 코딩 에이전트를 활용하면 코드 작성과 리팩터링, 디버깅, 리뷰 등 여러 작업을 동시에 다방면으로 진행할 수 있습니다. 하지만 작업이 길어질수록 사용자가 자리를 지켜야 한다는 제약이 따릅니다. 

Paseo는 이 제약을 해결하기 위해 개발된 오픈소스 AI 코딩 에이전트 워크스페이스입니다. 

이미 사용 중인 Claude Code, Codex, OpenCode, Copilot 같은 AI 에이전트를 모바일과 데스크톱, 웹, CLI에서 함께 다루도록 연결하는 제어 계층과 가깝습니다.

이번 글에서는 Paseo가 어떤 도구인지, 왜 AI 코딩 에이전트 환경에서 주목받는지, 실제로 어떻게 활용하는지 정리하겠습니다.

Paseo 핵심 요약

• Paseo는 AI 코딩 에이전트를 관리하는 워크스페이스입니다. Claude Code, Codex, OpenCode, Copilot 같은 에이전트를 하나의 인터페이스에서 실행하고 확인할 수 있도록 돕습니다.
• 자체 에이전트를 제공하지 않습니다. 사용자가 이미 설치하고 인증해 둔 CLI를 그대로 실행하므로, 기존 구독과 설정, MCP 서버가 유지됩니다. 
• 모바일과 데스크톱에서 에이전트 작업을 이어볼 수 있습니다. 개발 PC나 원격 서버에서 에이전트를 실행해두고, 다른 기기에서 작업 상태와 결과를 확인할 수 있습니다.
• 에이전트에 작업을 위임하는 오케스트레이션을 지원합니다. 한 에이전트가 다른 에이전트를 생성해 역할을 나누므로, 구현과 리뷰, 테스트를 병렬로 진행할 때 조율 부담이 줄어듭니다. 

Paseo란?

* 이미지 출처: Paseo GitHub 공식 저장소

Paseo는 AI 코딩 에이전트를 여러 화면에서 실행하고 관리할 수 있도록 만든 오픈소스 AI 코딩 에이전트 워크스페이스입니다. 

일반적인 AI 코딩 에이전트가 터미널 안에서만 작업을 수행해야 했다면 Paseo는 모바일, 데스크톱, 웹, CLI 환경에서 AI 에이전트 작업을 확인하고 제어할 수 있습니다.

Paseo가 주목받는 이유

터미널 밖으로 확장된 AI 코딩 에이전트

Paseo는 모바일 환경에서도 호환 가능한 AI 에이전트 워크스페이스입니다.  

AI 코딩 에이전트를 활용한 작업이 늘면서 tmux 같은 터미널 멀티플렉서로 여러 에이전트를 한 화면에 띄우는 방식이 자리 잡았습니다. 

다만 이 방식은 데스크톱에 묶여 있습니다. 사용자가 자리를 뜨면 진행 상황을 확인할 방법이 없습니다.

Paseo는 이 제약을 걷어냅니다. 데몬이 PC에서 에이전트를 실행하고, 모바일과 웹은 그 데몬에 접속해 같은 세션을 봅니다. 

덕분에 이동 중에도 모바일이나 다른 기기로 작업 진행을 확인하고 후속 지시를 내릴 수 있습니다.

여러 에이전트 작업을 하나의 작업 공간에서

AI 모델이 다양해지고 각각의 특색이 뚜렷해진 만큼 이제는 작업 성격에 따라 모델을 나눠 씁니다. 기획과 계획 수립에는 추론 능력이 높은 프론티어 모델을, 단순 코딩이나 코드 리뷰처럼 토큰 효율이 중요한 작업에는 저가형 모델을 배치합니다.

Paseo는 이 방식에 맞춘 워크스페이스입니다. Claude Code, Codex를 포함한 6종을 기본 지원하고 30여 종을 추가로 설치할 수 있습니다. 오케스트레이션 기능도 지원해 서로 다른 AI 모델끼리 작업 위임도 가능합니다.

덕분에 AI 모델별로 화면을 오가며 지시할 필요 없이, 하나의 세션에서 작업을 위임할 수 있습니다. 

Paseo vs Orca, 무엇이 다를까? 

두 도구 모두 여러 AI 코딩 에이전트를 한곳에서 운영하기 위해 만들어졌지만, 설계 방식이 다릅니다.

Orca는 IDE를 대체하기 위해 개발되었습니다. 같은 작업을 여러 에이전트에 동시에 맡기고 결과를 비교해 병합하는 흐름이 기본이며, 터미널과 브라우저를 앱 안에 갖췄습니다. 

▶ Orca란 무엇인지 5분만에 확인하기

반면 Paseo는 실행과 조작 위치를 분리합니다. 데몬이 PC나 서버에서 에이전트를 돌리고, 데스크톱 · 웹 · 모바일 · CLI가 동일한 기능으로 접속가능해, 데스크톱을 꺼도 데몬이 살아 있으면 다른 기기에서 작업이 가능합니다.

Paseo 사용법 - 설치부터 오케스트레이션 설정까지

Paseo CLI 설치하기

Paseo를 사용하기 위해 위의 명령어를 입력해 Paseo CLI를 설치합니다.

설치가 완료되면 위의 명령어를 입력해 Paseo를 실행합니다. 음성 기능의 사용 유무를 묻는 화면이 나옵니다. 필요에 따라 Enter를 눌러 선택합니다.

QR 코드와 페어링 링크가 출력된 화면이 나옵니다. 이 링크로 폰이나 웹 앱을 지금 Paseo가 실행되는 PC의 데몬에 접속시킵니다. 

별도의 로그인 절차 없이 링크를 가졌다는 사실이 인증을 대신하는 방식이기 때문에 공식 문서에서는 이 링크를 비밀번호처럼 다루고 공개하지 말 것을 권장하고 있습니다.

* 데몬이란?

화면 없이 백그라운드에서 계속 실행되는 프로그램입니다. 실제 작업은 전부 PC에서 진행하면서, 그 과정을 외부 기기와 주고 받게 도와줍니다.

Paseo가 실행되는 PC에서 폰이나 웹에서 온 지시를 받아 AI 코딩 에이전트를 실행하고, 결과를 다시 돌려보내는 역할을 맡습니다.

링크로 접속하면 Paseo의 대시보드 화면이 나옵니다. 여기서 프로바이더를 등록하고 작업할 프로젝트 폴더를 지정하면 AI 에이전트 작업을 시작할 수 있습니다. 

Paseo CLI에서 AI 에이전트 모델 연동하기

Paseo 대시보드에는 3가지 버튼이 있습니다. 각각의 기능은 아래와 같습니다.

• Setup providers: Claude Code, Codex 등 실제로 작업을 수행할 에이전트를 등록합니다. 프로바이더가 없으면 프로젝트를 추가해도 실행할 에이전트가 없으므로 가장 먼저 처리해야 하는 항목입니다.
• Add a project: PC의 폴더를 작업 대상으로 지정합니다. 이 경로 안의 코드를 에이전트가 읽고 씁니다.
• Import session: 터미널에서 진행하던 CLI 세션을 Paseo로 가져옵니다. 이미 작업하던 내용을 이어서 관리할 때 사용합니다.

AI 에이전트를 실행하기 위해 Setup providers를 클릭합니다.

Providers 설정 화면에 AI 에이전트 CLI 목록이 나옵니다. 기본 지원하는 프로바이더 6종이 표시되며, 추가로 설치 가능한 목록도 확인할 수 있습니다.

Paseo는 Claude Code, Codex, Copilot, OpenCode, Pi를 기본 제공하고, 하단 검색창에서 30종 이상의 에이전트를 추가로 찾아 설치할 수 있습니다. 사용할 CLI를 선택해 설치하고 인증하면 준비가 끝납니다.

AI 에이전트 모델을 선택하면 선택한 AI의 모델을 확인하는 화면이 나옵니다. 하단 세 버튼의 기능은 아래와 같습니다.

• Add model: 목록에 없는 모델을 수동으로 등록합니다. 자동 감지에 잡히지 않는 신규 모델이나 사용자 지정 엔드포인트를 연결할 때 사용합니다.
• Diagnostic: CLI 연결 상태를 점검합니다. 모델이 조회되지 않거나 실행이 실패할 때 원인을 확인하는 용도입니다.
• Refresh: 모델 목록을 다시 불러옵니다. 좌측의 "Updated 18m ago"가 마지막 조회 시점이며, 새 모델이 출시됐거나 CLI를 업데이트한 뒤 눌러 최신 상태로 맞춥니다.

Provider에서 토글 스위치로 각 AI 에이전트를 모델 선택 목록에 표시할지 결정합니다. 사용하지 않는 에이전트는 꺼두면 작업 화면이 간결해집니다. 새 모델이 추가됐거나 목록이 갱신되지 않을 때는 Refresh를 눌러 다시 불러옵니다. 

AI 에이전트 실행하기

AI 에이전트 모델 연동이 완료되었다면 이제 AI 에이전트를 실행할 프로젝트를 추가합니다. Add a project를 클릭하면 아래와 같이 3가지 옵션이 나옵니다.

• Search for directory: PC에 이미 있는 폴더를 검색해 등록합니다. 기존 프로젝트를 Paseo로 가져올 때 사용합니다.
• Clone from GitHub: GitHub 계정의 저장소를 조회해 PC로 내려받고 그대로 등록합니다. 원격 저장소에서 바로 작업을 시작할 때 사용합니다.
• New directory: PC에 빈 폴더를 새로 만들어 등록합니다. 아무것도 없는 상태에서 프로젝트를 시작할 때 사용합니다.

Paseo는 프로젝트를 추가할 때 폴더를 경로로 지정합니다. 입력창에 전체 경로를 직접 입력하거나, 상위 경로부터 입력해 하위 폴더를 탐색하며 선택합니다. 지정한 폴더가 작업 대상으로 연동됩니다. 

프로젝트 폴더를 설정하면 워크스페이스 화면이 나옵니다. 왼쪽에는 등록한 프로젝트와 그 아래 워크스페이스가 표시되고, 가운데에는 모델을 선택하고 작업을 지시하는 프롬프트 창이 있습니다. 

프롬프트 창 왼쪽 하단의 Select model을 선택하면 AI 에이전트와 AI 모델을 선택할 수 있습니다.

모델을 선택하면 프롬프트에 작업을 입력해 바로 실행할 수 있습니다. Paseo는 자체 코딩 에이전트를 제공하지 않고 이미 설치하고 인증해 둔 CLI를 실행합니다. 해당 CLI에 로그인된 상태라면 별도 인증 없이 곧바로 사용합니다. 

AI 에이전트 오케스트레이션 설정하기

Paseo는 AI 에이전트 기능에 특화된 AI 에이전트 워크스테이션입니다. 한 화면에서 여러 AI 모델을 사용하고 동시에 오케스트레이션까지 가능해 한 에이전트가 다른 프로바이더와 모델에 작업 위임이 가능합니다.

오케스트레이션 기능을 사용하기 위해서는 Enable Paseo tools을 활성화 해야합니다. 이를 위해 왼쪽 하단의 설정 창을 클릭합니다.

좌측 사이드바의 Host 메뉴에서 Agents를 클릭한 뒤 Enable Paseo tools를 활성화합니다.

이미 열려 있는 세션에는 설정이 반영되지 않으므로 에이전트를 재실행하면 오케스트레이션 기능이 적용됩니다. 이후 프롬프트로 다른 에이전트에 작업을 위임하도록 지시할 수 있습니다. 

Opus 5가 Codex 에이전트를 생성해 폴더 구조 분석을 위임한 결과를 확인할 수 있습니다. 

Paseo 사용 시 주의사항 4가지

1. 데몬이 종료되면 모든 작업이 중단됩니다

CLI로 데몬을 실행한 경우 터미널 창을 닫으면 데몬도 함께 종료됩니다. 데몬이 모든 상태를 관리하므로 재시작하면 실행 중이던 에이전트가 전부 중지됩니다. 장시간 작업을 맡기실 계획이라면 데스크톱 앱을 쓰거나 서버에 데몬을 상주시키는 편이 안전합니다.

2. 화면 분할은 프롬프트로 제어할 수 없습니다

에이전트에 주입되는 도구는 워크트리, 하위 에이전트, 스케줄, 터미널 관리로 한정됩니다. 화면 레이아웃은 포함되지 않습니다. 위임을 지시하면 하위 에이전트가 생성돼 좌측 워크스페이스 목록에 추가되지만, 이 세션을 분할 화면에 배치하는 작업은 직접 해야 합니다.

3. 병렬 작업 시 파일 충돌에 주의해야 합니다

같은 폴더에서 여러 에이전트가 동시에 파일을 수정하면 서로의 작업을 덮어씁니다. 코드를 실제로 수정하는 작업을 병렬로 돌릴 때는 워크트리 옵션을 사용해 각 에이전트를 격리된 브랜치에 배치해서 진행하는 것이 좋습니다.

4. 페어링 링크와 QR 코드는 공개하면 안 됩니다

Paseo에는 별도의 로그인 절차가 없고, 링크를 가졌다는 사실이 인증을 대신합니다. 이 링크로 접속하면 PC의 코딩 에이전트를 실행하고 프로젝트 폴더의 코드를 읽고 쓸 수 있습니다. 

링크가 외부로 노출되었을 경우 타인이 무단으로 내 AI 에이전트를 조작할 수 있습니다. QR과 링크가 모르는 곳에 노출됐다면 데몬을 재시작해 새로 발급받아서 사용합니다.

추가로 확인하면 도움이 되는 콘텐츠 3가지

AI 시대, 채용 검증의 어려움을 해결하는 방법 3가지

ECC란, Anthropic 해커톤 우승자가 만든 AI 에이전트 하네스 활용법

Grill-with-docs란? AI 에이전트 작업 기준을 문서화하는 스킬 사용법

AI 에이전트 기반 개발 환경 구축,

검증된 IT 프리랜서와 시작하세요.

대한민국 최대 IT 프리랜서 매칭 플랫폼 이랜서

이랜서는 27년간 삼성 · 현대 · SK · 카카오 등 주요 기업에 매칭하며 축적한 8만 건 이상의 IT 프리랜서 매칭 데이터를 바탕으로, AI 에이전트 시스템 구축 경험과 클라우드 실무 역량을 갖춘 검증된 전문가를 매칭합니다.

 - 이랜서를 이용한 기업들의 평가

"IT 전문가가 필요할 때 기업이 다시 찾는 이랜서" 

AI 에이전트 기반 개발 환경을 기획부터 구축, 운영 자동화까지 안정적으로 추진하세요. 프로젝트에 적합한 AI 전문 프리랜서를 24시간 내, 매칭해 드립니다.