휴대폰으로 기존 Claude Code나 Codex 세션을 모니터링하는 방법(Direct sessions)

참고: 기능 매트릭스에 따르면 프로바이더 Direct 세션은 실험적 기능입니다. 지원 범위는 에이전트와 백엔드마다 다릅니다. 동작이 바뀔 수 있다는 점을 이해하고 사용하세요.

"잠깐, 처음부터 다시 해야 하나?" 하는 순간 중 자주 있는 것이 이것입니다.

이미 Claude Code나 Codex 세션이 실행 중이고, 그걸 휴대폰으로 모니터링하고 싶습니다.

흔히 떠올리는 방법은 두 가지입니다.

세 번째 선택지가 도움이 됩니다.

먼저 기존 프로바이더 세션을 열고, 그다음 더 이동하기 쉬운 워크플로로 "편입"할지 결정하기.

Happier는 코딩 에이전트를 크로스 디바이스로 실행하고 오케스트레이션하는 오픈 소스 앱으로, Direct sessions라는 기능으로 이를 지원합니다.

요약

세션을 소유한 머신에 Happier를 설정하고 휴대폰을 연결합니다.
서버에서 필요하다면 Direct sessions(실험적)를 켭니다.
프로바이더 세션을 Direct 세션으로 엽니다.
앞으로 Happier가 관리하길 원한다면 다음 중 하나를 고릅니다.
- Take over(제어권 넘겨받기)
- Take over + import(Happier가 관리하는 동기화 세션으로 변환)

Happier에서 새 세션 시작: 되긴 하지만 이미 실행 중인 프로바이더 네이티브 세션의 맥락을 잃습니다.
휴대폰에서 SSH 접속: 되긴 하지만 모바일로 터미널 작업을 하게 됩니다.
Happier(Direct sessions): 기존 세션을 휴대폰에서 따라가다가, 원할 때만 변환할 수 있습니다. 트레이드오프: 실험적 기능이고 지원 여부에 따라 달라집니다. 프로바이더나 백엔드에 따라 쓸 수 있는 인계 기능이 다릅니다.

Happier는 Claude Code, Codex, OpenCode 같은 AI 코딩 에이전트를 위한 오픈 소스 컴패니언 앱(모바일 / 웹 / 데스크톱)입니다.

여기서의 워크플로는 워크스페이스를 소유한 머신에서 세션이 계속 실행되는 동안, 휴대폰의 Happier로 기존 세션을 모니터링하는(필요하면 넘겨받는) 것입니다.

설정하기:

동기화(Synced) 세션: Happier 안에서 만든 세션입니다. Happier가 세션 메타데이터를 관리하고, 프로바이더가 지원하면 resume / attach를 쓸 수 있습니다.
Direct 세션: 프로바이더 네이티브 세션을 보여 주는 화면으로, 명시적으로 변환하지 않으면 Happier에 동기화되지 않습니다.

Direct 세션이 "저장되지 않은" 것은 아닙니다. 동기화를 선택하기 전까지 동기화되지 않았을 뿐입니다.

프로바이더 세션의 제어권을 넘겨받고 싶을 때 씁니다.

프로바이더 세션을 Happier가 관리하는 동기화 세션으로 바꾸고 싶을 때 씁니다.

기준: "Happier 네이티브" 방식으로 세션을 재개하고 공유하고 싶다면, 보통 Take over + import를 고르면 됩니다.

가능한 원인:

해결: