Claude Code가 실제 작업에 유용한 이유는, 휴대폰으로 지켜보기가 조금 까다로운 이유이기도 합니다.

세션이 오래 실행될 수 있다는 점입니다.

그게 좋을 때도 있습니다(리팩터링을 꾸준히 진행 중). 곤란할 때도 있습니다(멈춰 있거나, 빠른 답이 필요하거나, 살짝 방향이 틀어져서 일찍 바로잡고 싶을 때).

노트북에서 떨어져 있을 때는 휴대폰에서 가벼운 루프 하나면 충분합니다.

세션 열기 → 무엇을 하는지 보기 → 개입이 필요한지 판단 → 후속 지시 하나 보내기.

흔한 방법(SSH, 원격 데스크톱)은 휴대폰에서 분명한 트레이드오프가 있습니다.

더 가벼운 루프가 더 잘 맞습니다. 세션을 열고, 무엇을 하는지 보고, 필요하면 막힌 것을 풀고, 수정 하나를 보내고 끝.

이 작업을 휴대폰에서 하고 싶다면, Happier는 휴대폰, 데스크톱, 웹에서 Claude Code, Codex 등 여러 에이전트를 크로스 디바이스로 실행하고 오케스트레이션할 수 있는 오픈 소스 앱입니다. Claude Code가 내 머신에서 계속 실행되는 동안 진행 상황 확인, 막힘 해소, 짧은 수정 지시를 할 수 있습니다. 트레이드오프: 세션을 소유한 머신이 온라인 상태로 연결되어 있어야 합니다.

요약

1. 어떤 방식으로 지켜볼지 정합니다.
   • 터미널 전체 제어 (SSH), 또는
   • 가벼운 감독 (모니터링 + 후속 지시 하나)
2. Happier를 사용한다면 설정하고(또는 Direct sessions로 연결하고), 휴대폰에서 Claude 세션을 엽니다.
3. 트랜스크립트와 도구 타임라인으로 실제로 무슨 일이 있었는지 확인합니다.
4. 세션이 입력을 기다리면 짧은 후속 지시를 보내거나 승인을 처리합니다.
5. 터미널 전체 화면이 필요하면 세션을 소유한 머신에서 attach합니다.

문제

실행 중인 세션을 확인하는 이유는 세 가지입니다.

• 진행 상황: "제대로 하고 있나?"
• 개입: "방향이 틀어지고 있다. 파일 200개를 고친 뒤가 아니라 지금 바로잡아야 한다."
• 막힘 해소: "내 승인이나 답변을 기다리고 있다."

휴대폰에서 흔한 실패 패턴은 둘 중 하나입니다.

• 아예 확인하지 않는다 (시간 낭비), 또는
• SSH로 확인하다가 작은 터미널에서 반쯤 작업하게 된다.

흔한 방법과 트레이드오프

• 아무것도 안 하고 기다리기. 위험이 낮은 작업이면 괜찮지만, 방향이 틀어지면 끝에서야 알게 됩니다.
• 휴대폰에서 SSH로 접속하기. 되긴 하지만 "휴대폰으로 모니터링"이 아니라 "휴대폰으로 작업"이 되어버립니다.

도움이 되는 것은 더 가벼운 루프입니다. 세션을 열고, 무엇을 하는지 보고, 필요하면 막힌 것을 풀고, 수정 하나를 보내고 끝.

• Happier: Claude Code가 내 머신에서 계속 실행되는 동안, 휴대폰에서 그 가벼운 루프(진행 상황, 막힘 해소, 후속 지시 하나)를 돌릴 수 있습니다. 트레이드오프: 세션을 소유한 머신이 온라인 상태로 연결되어 있어야 합니다.

Happier를 처음 사용한다면 (무엇이고 어디서 받는지)

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

여기서의 워크플로는, Claude Code는 작업 공간이 있는 머신에서 계속 실행되고, Happier로 휴대폰에서 모니터링하고 후속 지시를 보내는 것입니다.

이 가이드 기준으로는, SSH에 붙어 있지 않고도 오래 실행되는 Claude Code 세션을 지켜보고 방향이 틀어지는 것을 일찍 잡을 수 있다는 뜻입니다.

시작하기:

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

실제로 쓰는 워크플로 (단계별)

1) 세션 열기

휴대폰에서 실행 중인 Claude 세션을 엽니다.

먼저 확인할 것은 출력을 계속 내고 있는지, 아니면 막혀 있는지입니다.

2) 트랜스크립트로 방향 이탈을 일찍 발견하기

최신 메시지를 PR 설명을 읽듯이 읽습니다.

• 무엇을 하고 있다고 생각하는지
• 어떤 파일을 건드렸는지
• 범위를 넓히고 있지 않은지

범위가 틀어지는 게 보이면 바로 짧은 수정 메시지를 보냅니다 (나중에 고치는 것보다 비용이 적습니다).

3) 도구 활동 확인하기 (실제로 무슨 일이 있었는지)

도구 타임라인으로 다음을 확인합니다.

• 어떤 명령이 실행됐는지
• 어떤 파일이 작성됐는지
• 같은 작업을 반복하고 있지 않은지

Happier는 도구 이벤트를 일관된 용어(Bash, Edit, Read, Diff 등)로 정리하므로, 프로바이더의 원시 로그를 읽지 않아도 무슨 일이 있었는지 훑어볼 수 있습니다.

휴대폰에서 도구 화면이 너무 복잡하다면 Settings → Session → Tool rendering에서 상세 수준(Title only / Summary / Full)을 조정할 수 있습니다.

4) 승인과 사용자 작업 요청 처리하기

세션이 막혀 있다면:

• 권한 요청을 승인하거나 거부합니다
• 또는 사용자 작업 요청(AskUserQuestion / Exit Plan Mode)에 답합니다

위험이 낮은 작업에 자꾸 승인을 누르고 있다면, 그 작업 동안만 Safe YOLO로 바꾸는 것을 고려하세요 (diff는 나중에 검토합니다).

5) 전체 화면이 필요하면 터미널에서 attach하기

정말로 터미널 전체가 필요할 때도 있습니다.

세션을 소유한 머신에서:

happier attach <session-id>

문제 해결

증상: 세션이 막혀도 알림이 오지 않음

가능한 원인:

• 알림 유형이 켜져 있지 않음
• 모바일에서 세션이 실행 중인 것과 다른 Relay / 서버 프로필로 로그인되어 있음

해결:

• 알림을 켜고, 모바일에서 올바른 서버 / 프로필을 사용 중인지 확인합니다

증상: 세션은 열리지만 업데이트되지 않음

가능한 원인:

• 세션을 소유한 머신(데몬)에 연결할 수 없음

해결:

• 머신을 다시 온라인으로 만들고 연결을 복구합니다. 모니터링하려면 실행 환경에 연결할 수 있어야 합니다

증상: 휴대폰에서 도구 카드가 너무 장황함

가능한 원인:

• 도구 렌더링 상세 수준이 Full로 설정되어 있음

해결:

• Settings → Session → Tool rendering을 열고, 모바일에서는 Summary(또는 Title only)로 바꿉니다

자주 묻는 질문

휴대폰에서 Claude Code를 실행하는 것과 같은가요?

아닙니다.

휴대폰에서는 모니터링과 감독을 할 수 있습니다. Claude Code는 저장소와 도구가 있는 머신에서 계속 실행됩니다.

실행 중인데 왜 세션이 "멈춘" 것처럼 보이나요?

흔한 이유는 사용자를 기다리고 있기 때문입니다.

• 권한 요청 (허용 / 거부)
• 사용자 작업 요청 (AskUserQuestion / Exit Plan Mode)

세션을 열고 트랜스크립트의 최신 메시지를 확인하세요.

관련 가이드

• 휴대폰에서 Happier 사용하는 방법
• 휴대폰에서 Claude 권한 요청을 승인하는 방법
• 휴대폰에서 diff 리뷰하는 방법