컴퓨터에서 Pi Coding Agent가 실행 중일 때: 휴대폰으로 모니터링하는 방법
Pi Coding Agent 전용 가이드: 설치, 환경 변수 기반 인증, 연결된 서비스 프로필, 그리고 휴대폰으로 진행 확인과 후속 메시지를 처리하는 워크플로.
- CLI
- 0.2.17
- 프리뷰 ref
- a2c45c8
Pi Coding Agent는 "진짜" 컴퓨터에서 실행할 때 잘 맞는 도구입니다.
- 리포지토리가 로컬에 있다
- 도구가 로컬에 있다
- 긴 세션이 흔하다
그러다 보면 익숙한 바람이 생깁니다.
휴대폰으로 상황을 보고 싶다.
리팩터링 전체를 하려는 게 아닙니다.
그저:
- 무엇을 하고 있는지 보기
- 입력이 필요한지 보기
- 수정 하나 보내기
이 가이드는 이를 무리 없이 할 수 있게 해 주는 프로바이더별 워크플로입니다.
일반적인 방법과 트레이드오프
-
휴대폰에서 SSH
-
원격 데스크톱
-
기다리기
-
Happier: 진행 확인, 승인, 후속 메시지 하나를 위한 휴대폰 UI를 제공합니다. 트레이드오프: 세션을 실행하는 컴퓨터가 온라인 상태여야 합니다.
Happier가 처음이라면 (무엇이고 어디서 받는지)
Happier를 처음 본다면: 코딩 세션을 위한 오픈 소스 컴패니언 앱(모바일/웹/데스크톱)입니다.
설정하기:
- GitHub: https://github.com/happier-dev/happier
- 설치/다운로드: https://github.com/happier-dev/happier#how-it-works
- Discord: https://discord.gg/W6Pb8KuHfg
요약
- 세션을 실행할 컴퓨터에 Pi를 설치합니다(
pi --version). - Pi 인증은 환경 변수 기반입니다(대화형 로그인 흐름 없음).
- 연결된 자격 증명을 지원하는 시스템을 쓴다면 호환되는 프로필을 고릅니다(OpenAI Codex 구독 OAuth, OpenAI API 키 등).
- Pi가 감지되지 않으면
HAPPIER_PI_PATH를pi바이너리의 절대 경로로 설정합니다. - 휴대폰에 맞는 세션 UI로 모니터링, 승인, 후속 메시지를 처리합니다.
문제
Pi는 앱 안에 "로그인" 절차가 없다는 점에서 많은 프로바이더와 다릅니다.
버그가 아닙니다.
자격 증명 모델입니다.
- Pi는 지원되는 자격 증명을 환경 변수 기반 소스에서 읽는다
그래서 휴대폰 워크플로는 "휴대폰에서 로그인"이 아닙니다.
다음과 같습니다.
- 컴퓨터에 올바른 자격 증명이 있는지 확인
- 그다음 휴대폰으로 세션 따라가기
1단계: Pi Coding Agent 설치
프로바이더 문서에 따르면:
npm install -g @mariozechner/pi-coding-agent
pi --version또는 hstack으로:
hstack providers install pi
pi --version(hstack을 처음 들어본다면: Happier 생태계의 선택형 도우미로, 프로바이더 CLI를 설치해 줍니다. 꼭 필요하지는 않으며 npm install -g ...로도 충분합니다.)
2단계: 인증 모델 (환경 변수 전용)
Pi는 "자격 증명은 채팅 UI가 아니라 컴퓨터에 있다"를 보여 주는 명확한 예입니다.
소스에서 Pi 인증 확인은 piEnvOnly로 지정되어 있습니다.
전제로 삼아야 할 동작은:
- 그 컴퓨터에 환경 변수 기반 자격 증명이 있으면 Pi가 실행된다
- 없으면 실행되지 않는다
실용적인 자격 증명 체크리스트
Pi를 실행할 컴퓨터에서:
pi --version이 동작하는지 확인합니다.- 사용할 자격 증명 유형을 정합니다:
- OpenAI Codex 구독 OAuth(연결됨)
- OpenAI API 키
- Anthropic API 키
- Claude 구독 setup-token 프로필(OAuth 아님)
- 작은 세션 하나를 시작하고 후속 메시지를 보낼 수 있는지 확인합니다.
한 번 동작하면 휴대폰 워크플로는 간단해집니다. 모니터링, 승인, 살짝 밀어 주기.
3단계: 연결된 자격 증명 프로필 (사용 가능한 경우)
Pi는 실행될 때 Connected services 프로필을 재사용할 수 있습니다:
openai-codex(구독 OAuth)openai(API 키)claude-subscription은 setup-token만(토큰을 환경 변수로 전달)anthropic(API 키)
프로바이더 문서의 중요한 제한:
- Pi는 Claude OAuth 프로필을 받지 않습니다. 대신 setup-token 프로필을 사용하세요.
4단계: HAPPIER_PI_PATH로 "pi를 찾을 수 없음" 해결
터미널에서는 pi --version이 동작하는데 앱이 Pi를 감지하지 못하면 다음을 설정합니다:
HAPPIER_PI_PATH
이 재정의는 CLI 테스트에서 검증됩니다.
5단계: 휴대폰 워크플로
잘 통하는 휴대폰 워크플로는 일부러 좁게 잡았습니다.
- 세션 열기
- 승인을 기다리는지 확인
- 후속 메시지 하나 보내기
- 나가기
휴대폰에서 할 일 (그리고 건너뛸 일)
휴대폰에서 해도 괜찮은 일:
- 승인
- 짧은 제약("다음 단계 후에 멈춰", "먼저 요약해")
- diff 빠르게 훑어보기
휴대폰에서는 피하는 게 좋은 일:
- 큰 리팩터링
- 복사/붙여넣기가 많이 필요한 작업
- 경로나 명령을 확인할 수 없는 작업
Pi에 잘 맞는 복사용 후속 메시지 3가지
- 체크포인트
다음 단계가 끝나면 멈추고 다음을 요약해 줘:
- 변경한 것
- 변경하지 않은 것
- 다음에 하려는 것
- 제약
마이그레이션/인증은 건드리지 마. 필요하다고 생각되면 멈추고 물어봐.
- 검증
계속하기 전에 지금 실행하려는 명령을 그대로 붙여 넣고 이유를 설명해 줘.
Pi에 본격적인 터미널 작업이 필요하다면 키보드 앞으로 돌아올 때까지 기다리세요.
Happier가 처음이라면
Happier를 처음 본다면: Pi 같은 세션을 컴퓨터에서 실행하고 휴대폰으로 모니터링하는 오픈 소스 컴패니언 앱입니다.
설정하기:
- GitHub: https://github.com/happier-dev/happier
- 설치/다운로드: https://github.com/happier-dev/happier#how-it-works
- Discord: https://discord.gg/W6Pb8KuHfg
문제 해결
Pi가 감지되지 않음
pi --version확인- 앱 다시 시작
HAPPIER_PI_PATH설정
Pi가 자격 증명이 없다고 함
그 컴퓨터의 자격 증명 문제로 다루세요:
- 어떤 프로필을 선택했는지 확인(연결된 프로필을 쓰는 경우)
- 그 머신에 어떤 환경 변수/토큰이 있는지 확인
Claude OAuth를 썼는데 Pi가 여전히 실행되지 않음
예상된 동작입니다.
Pi는 Claude setup-token 프로필은 받지만 Claude OAuth는 받지 않습니다.
FAQ
왜 그냥 "휴대폰에서 로그인"할 수 없나요?
Pi가 환경 변수 기반 자격 증명 모델을 쓰기 때문입니다.
자격 증명 저장소는 휴대폰 UI가 아니라 컴퓨터입니다.