🧭 Paseo (paseo.sh) 사용법 정리

Paseo는 Claude Code, Codex, Cursor, OpenCode, Pi, GitHub Copilot 등 여러 AI 코딩 에이전트를
데스크톱·모바일·웹·CLI에서 원격으로 실행·관리할 수 있게 해주는 오픈소스 오케스트레이션 도구입니다.

1. 사전 요구사항

아래 에이전트 CLI 중 최소 1개는 미리 설치 & 로그인(인증) 되어 있어야 합니다.

2. 설치 방법 (3가지)

① 데스크톱 앱 — 가장 간편 (권장)

  1. paseo.sh/download 또는 GitHub Releases에서 Windows용 .exe 다운로드
  2. 실행 파일 더블클릭 → 설치
  3. 앱 실행 시 데몬(daemon)이 자동 시작 → 추가 설정 불필요

② CLI / 헤드리스 설치

npm install -g @getpaseo/cli
paseo

최초 실행 시 E2E 암호화 릴레이(폰-PC 원격 접속용) 활성화 여부를 물어봅니다.

③ Docker 설치

docker run -d --name paseo \
  -p 6767:6767 \
  -e PASEO_PASSWORD=change-me \
  -v "$PWD/paseo-home:/home/paseo" \
  -v "$PWD:/workspace" \
  ghcr.io/getpaseo/paseo:latest
⚠️ 설치는 직접 진행해 주세요.
파일 다운로드·실행이나 npm install -g(전역 패키지 설치, 임의 스크립트 실행 가능) 같은 명령은 보안상 제가 대신 실행하지 않습니다. 위 명령을 그대로 복사해서 PowerShell/터미널에서 직접 실행하시면 됩니다.

3. 주요 CLI 명령어

명령어설명
paseo run "작업 내용"기본 에이전트로 새 작업 실행
paseo run --provider claude/opus-4.6 "..."특정 provider/모델 지정 실행
paseo run --provider codex/gpt-5.5 --worktree feature-x "..."특정 git worktree에서 격리 실행
paseo ls현재 실행 중인 에이전트 목록 조회
paseo attach <id>실시간 출력 스트림 확인
paseo send <id> "추가 지시"실행 중인 작업에 후속 지시 전송
paseo --host workstation.local:6767 run "..."원격 데몬(다른 PC)에 접속해서 실행

4. 모바일(폰) 연동

데스크톱 앱 → Settings → your host → Pair Device 에서 QR코드로 휴대폰을 페어링하면, 외출 중에도 폰 앱/웹으로 진행 상황 확인 및 후속 지시가 가능합니다.

5. 특징 요약

참고 링크: github.com/getpaseo/paseo · paseo.sh/docs
자료에 오류가 있으면 알려 주세요 — 문의메일 보내기