Paseo에서 Codex가 안 보일 때: 호스트·PATH·설정 적용을 분리해 진단하기
터미널에서는 codex가 실행되는데 Paseo의 provider 목록에는 보이지 않는다면, 재설치부터 하기 쉽다. 먼저 확인할 것은 지금 어느 컴퓨터의 어떤 프로세스를 보고 있는가다. 노트북 앱에서 원격 서버를 선택했다면 노트북의 터미널이 정상이라는 사실만으로 서버의 Codex 환경을 설명할 수 없다.
대상: Paseo Desktop과 원격 호스트를 함께 쓰는 개발자. 2026-11-07 공개 문서 기준이며, 로컬 CLI 0.15.0에서 명령 도움말을 확인했다. 경로와 호스트명은 설명용이다.
1. 화면, 데몬, provider의 위치부터 적는다
Paseo 앱은 작업을 보여주는 클라이언트다. 에이전트를 실제 실행하는 데몬의 위치가 별도로 있다. Desktop이 관리하는 로컬 데몬, 따로 실행한 standalone 데몬, Docker 내부의 데몬을 구분해야 한다. Desktop을 쓴다는 이유로 현재 선택한 모든 호스트가 Desktop의 내장 데몬이라고 볼 수는 없다.
진단 메모는 세 줄이면 충분하다.
클라이언트: Windows 노트북의 Paseo Desktop
대상 데몬: Linux 개발 서버의 standalone 설치
연결 경로: SSH
이 사례에서 provider 실행 파일, 로그인 상태, 작업 디렉터리와 데몬 로그는 Linux 서버에서 확인한다. 반대로 앱 자체가 뜨지 않거나 화면이 이상하다면 클라이언트의 버전과 로그가 관련된다. 실제 상태는 Settings → 대상 호스트 → Overview → Full status에서 확인한다.
2. 읽기 전용 진단 세 가지로 범위를 좁힌다
대상 데몬 머신에서 다음 순서로 확인한다. paseo --version은 실행한 CLI의 버전이다. 접속한 서버 버전과 같다고 가정하지 말고 status 결과와 비교한다.
paseo --version
paseo daemon status --json
paseo provider diagnostic codex --json
원격 호스트를 검사할 때는 대상을 명시한다. 다음의 devbox는 실제 SSH 설정에 맞게 바꾼다.
paseo --host ssh://devbox daemon status --json
paseo --host ssh://devbox provider diagnostic codex --json
진단 결과에서 볼 것은 실행 파일의 resolved path, 데몬 PATH, provider 버전이다. 경로가 없으면 탐색 문제를, 경로가 있는데 버전 확인이 실패하면 실행 권한이나 실행 환경을 살핀다. 실행 파일이 정상인데 에이전트 시작이 실패하면 인증·모델 설정·해당 provider의 오류까지 조사 범위를 옮긴다. PATH를 고치는 것만으로 모든 시작 오류가 해결되는 것은 아니다.
3. 새 터미널과 기존 프로세스의 환경은 다를 수 있다
공식 문제 해결 문서에 따르면 macOS와 Linux의 Desktop은 시작할 때 로그인 셸 환경을 가져온다. standalone 데몬은 자신을 시작한 터미널의 환경을 물려받는다. Windows는 앱이 실행될 때 받은 환경을 사용한다.
따라서 Windows에서 CLI를 설치한 뒤 새 PowerShell에서는 보이지만, 이전부터 켜 둔 앱에서는 보이지 않는 상황을 생각할 수 있다. 확인 기준은 기존 터미널의 성공 여부가 아니라 대상 데몬이 보고한 PATH다. 셸 alias나 함수도 실행 파일 경로와 구별해야 한다.
실제 바이너리를 고정해야 한다면 provider의 command 설정은 [실행 파일, 인수...] 형태다. 기존 설정을 통째로 덮어쓰지 말고 필요한 provider 항목만 수정한다. 수정 후 paseo reload 결과를 확인하면 적용된 항목과 재시작이 필요한 항목을 구분할 수 있다. 잘못된 JSON이나 스키마 오류가 있으면 변경이 적용되지 않는다.
4. SSH의 두 포트를 혼동하지 않는다
Paseo의 SSH 연결은 원격 데몬을 설치하거나 시작하는 기능이 아니다. 서버의 데몬이 이미 실행 중이고 키 또는 SSH agent를 통한 비대화형 인증이 가능해야 한다.
paseo --host 'ssh://devbox:2222?daemonPort=7777' ls -a
여기서 2222는 SSH 서버 포트, 7777은 원격 머신 내부 데몬 포트다. SSH 로그인은 되지만 Paseo 연결이 거절되면 원격 데몬의 실행 상태와 listen 주소를 확인한다. SSH 연결 문제를 해결하기 위해 데몬을 무조건 모든 인터페이스에 공개할 필요는 없다.
5. 다음 조사자가 바로 이어받을 증거를 남긴다
문제를 기록할 때는 “Paseo가 안 됨” 대신 다음 항목을 남긴다.
- 클라이언트 버전과 대상 데몬 버전, 설치 방식
- 로컬·SSH·relay 등 연결 방식과 재현 절차
- provider의 resolved path와 버전 확인 성공 여부
- 오류가 발생한 시각의 좁은 로그 구간
로그 경로는 status가 알려주는 값을 우선한다. 기본 경로만 믿고 다른 데몬의 로그를 읽으면 조사가 엇나간다. 공유용 기록에서는 토큰, pairing 링크, 비밀번호와 개인 코드가 빠졌는지도 확인한다. 이 정도 증거가 모이면 환경 문제인지 연결 문제인지, provider 자체 문제인지 다음 행동을 결정하기 쉬워진다.
댓글
댓글 쓰기