목표는 단순한 약속입니다.

"터미널에서 Claude Code를 시작했어요. 처음부터 다시 하지 않고 휴대폰에서 이어갈 수 있을까요?"

답은 '예'입니다. 다만 이 문장 안에는 사실 두 가지 다른 워크플로가 숨어 있습니다.

• 같은 세션을 유지하면서 터미널 UI와 휴대폰 UI 사이를 전환하고 싶다
• 터미널에서 시작한 기존 세션을 처음부터 다시 하지 않고 휴대폰에 맞는 UI로 열고 싶다

Happier는 이를 위한 방법 중 하나이고, 어떤 경로를 쓸지는 세션을 처음에 어떻게 시작했는지에 따라 달라집니다.

둘 다 "휴대폰에서 이어가기"라는 같은 문제를 풀지만 동작 방식이 다르므로, 이 가이드에서는 두 가지를 모두 다룹니다.

요약

1. Claude Code를 실행 중인 머신에 Happier를 설정하고 휴대폰을 연결합니다.
2. 세션을 Happier에서 시작했다면: attach와 로컬 ↔ 원격 전환을 씁니다(같은 세션).
3. 세션을 Happier 밖에서 시작했다면: Direct sessions로 연 다음 Take over + import를 고릅니다.

일반적인 방법과 트레이드오프

• 휴대폰에서 새 세션 시작하기: 되긴 하지만 기존 맥락을 잃습니다.

• 휴대폰에서 SSH: 되긴 하지만 작은 화면에서 터미널 작업을 하게 됩니다.

• Happier: 세션이 시작된 방식에 따라 두 가지 실제 경로를 제공합니다. 트레이드오프: Direct 세션은 동기화하기 전까지 그 머신에 묶여 있습니다.

Happier가 처음이라면(무엇이고 어디서 받는지)

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

여기서의 워크플로는 Claude Code를 머신에서 계속 실행하면서, 휴대폰의 Happier로 맥락을 다시 설명하지 않고 같은 작업을 이어가는 것입니다.

설정하기:

• 휴대폰에서 Happier 사용하는 방법
• GitHub: https://github.com/happier-dev/happier
• 설치 / 다운로드: https://github.com/happier-dev/happier#how-it-works
• Discord(커뮤니티와 지원): https://discord.gg/W6Pb8KuHfg

워크플로 A: Happier에서 세션을 시작한 경우(로컬 ↔ 원격 전환)

처음부터 Happier 네이티브 세션이므로 이상적인 워크플로입니다.

어떤 모습인가

• Happier 앱에서 Claude 세션을 시작한다.
• 나중에 같은 머신에서 happier attach <session-id>를 실행한다.
• 이제 Claude Code의 터미널 UI(로컬 모드)에 들어와 있습니다.
• 그 뒤 새 세션을 시작하지 않고 휴대폰(원격 모드)으로 돌아가 이어갈 수 있습니다.

단계별 방법

1. Happier 앱에서 세션을 시작합니다(동기화 세션).
2. 세션을 소유한 머신에서:

happier attach <session-id>

3. 터미널에서 로컬로 Claude Code를 씁니다.
4. 휴대폰에서 이어가고 싶으면 원격 모드로 다시 전환합니다(Switch to remote, 같은 세션).

참고:

• tmux가 있는 머신에서는 보통 tmux 기반 attach 흐름입니다.
• Windows에서는 tmux를 기대하지 말고 Happier의 Windows 세션 모드를 쓰세요.

워크플로 B: Happier 밖에서 Claude Code를 시작한 경우(Direct → Take over + import)

이미 중요한 프로바이더 네이티브 Claude 세션이 있을 때 쓰는 워크플로입니다.

단계별 방법

1. Happier에서 Direct sessions를 엽니다.
2. 세션을 소유한 머신에서 Claude의 프로바이더 세션을 탐색합니다.
3. 기존 세션을 Direct로 엽니다.
4. Take over + import를 고릅니다.

일어나는 일:

• Happier가 프로바이더의 대화 기록을 가져옵니다.
• 세션이 Happier 동기화 세션이 됩니다.
• 이후로는 일반 Happier 세션처럼 다룰 수 있습니다(휴대폰 워크플로 포함).

문제 해결

증상: Direct sessions가 보이지 않는다

가능한 원인:

• Direct sessions가 꺼져 있다(실험적 기능 플래그)

해결:

• 서버에서 Direct sessions를 켠다

증상: attach는 되는데 원격으로 다시 전환할 수 없다

가능한 원인:

• 세션이 지금 로컬 제어 중이고 작업 중이다

해결:

• 현재 턴이 끝나길 기다리거나, 대기 큐 / 중단 패턴을 쓴다

관련 가이드

• 휴대폰으로 기존 Claude Code나 Codex 세션을 모니터링하는 방법(Direct sessions)
• 휴대폰으로 Claude Code 모니터링하는 방법
• Claude Code나 Codex가 작업 중일 때 휴대폰에서 메시지를 큐에 넣는 방법