작지만 반복되는 문제입니다(그리고 쌓입니다).

에이전트(Claude Code나 Codex)가 실행 중입니다. 여러분은 휴대폰을 보고 있습니다. 실행을 더 깔끔하게 만들 작은 수정이 눈에 띕니다.

• 설정 값이 틀렸다
• 파일 이름을 바꿔야 한다
• 남아 있는 로그 줄이 있다
• 에이전트가 엉뚱한 디렉터리에 파일을 만들었다

무시하면 보통 나중에 대가를 치릅니다(diff가 커지고 커밋이 지저분해짐).

휴대폰에서 SSH로 들어가면 고칠 수는 있지만, 모바일에서 터미널 작업을 하게 됩니다.

그래서 목표는 세션이 머신에서 계속 실행되는 동안 휴대폰으로 워크스페이스를 작게 편집하는 워크플로입니다.

요약

1. 어떤 "휴대폰 편집"이 필요한지 정합니다:
   • 세션이 계속 실행되는 동안의 아주 작은 정밀 편집, 또는
   • 본격적인 리팩터링(보통 노트북/터미널이 필요한 순간)
2. Happier를 쓴다면: 설정하고(또는 Direct sessions로 연결하고) 휴대폰에서 세션을 엽니다.
3. Files에서 탐색/검색하고 파일을 편집 모드로 엽니다.
4. 작은 수정을 합니다.
5. Review / 도구 타임라인으로 무엇이 바뀌었는지 확인합니다.
6. 휴대폰에서 커밋할 거라면 Git 작업을 켜고, 아니면 나중에 커밋합니다.

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

• 휴대폰에서 SSH: 동작하지만 diff가 얽힌 작업(검토, 스테이징, 엉뚱한 파일을 건드리지 않았는지 확인)은 서두르기 쉽습니다.

• 원격 데스크톱: 동작하지만 빠른 편집에는 무겁고 번거롭습니다.

• Happier: 코딩 에이전트를 크로스 디바이스로 실행하고 오케스트레이션하는 오픈 소스 앱입니다. 세션 UI에 리포지토리를 인식하는 Files 화면과 에디터가 있어서 세션 맥락을 떠나지 않고 작은 변경을 할 수 있습니다. 트레이드오프: 머신/데몬에 접근할 수 있어야 하고, 큰 리팩터링에는 풀 키보드가 낫습니다.

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

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

여기서의 워크플로: 세션(과 리포지토리/Git)은 워크스페이스가 있는 머신에 그대로 두고, Happier로 휴대폰에서 실제 워크스페이스 파일을 편집합니다.

설정하기:

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

사전 요구 사항

• 세션을 소유한 머신/데몬이 온라인이고 접근 가능해야 합니다.
• 세션에서 리포지토리/워크스페이스에 접근할 수 있어야 합니다.

단계별: 휴대폰에서 파일 편집

1) Files 열기

세션 UI에서 Files를 엽니다.

휴대폰 크기 레이아웃에서는 사이드바 + 상세 창이 아니라 전체 화면 흐름입니다.

2) 파일 찾기

다음 중 하나를 사용합니다:

• 트리 탐색
• 이름을 알면 검색
• 바뀐 것에 집중하고 싶을 때는 수정된 파일만 보기 필터

3) 파일을 편집 모드로 열기

파일을 열고 편집 모드로 전환합니다.

변경합니다.

4) 무엇이 바뀌었는지 확인

휴대폰에서 확인하는 방법은 두 가지입니다:

• Review를 열어 커밋되지 않은 diff 묶음을 훑어보기
• 도구 타임라인으로 어떤 편집이 있었는지 보기(에이전트가 아직 실행 중일 때 특히 유용)

5) 지금 커밋할지 나중에 할지 결정

• 이미 "휴대폰에서 커밋" 모드라면 스테이징하고 커밋할 수 있습니다.
• 정리만 하는 중이라면 커밋하지 않은 채 두고 나중에 노트북에서 마지막 커밋을 해도 괜찮습니다.

첨부 파일 vs 워크스페이스 파일 (헷갈리기 쉬움)

목표가 "이게 git에 들어가야 한다"라면 워크스페이스 파일을 편집해야 합니다.

첨부 파일은 로그나 산출물을 모델과 공유하기에 좋지만, 리포지토리를 편집하는 것과는 다릅니다.

문제 해결

증상: Files가 비어 있거나 로드되지 않음

가능한 원인:

• 소유 머신/데몬에 접근할 수 없음

해결:

• 연결을 복구하세요. Files는 머신 워크스페이스 API에 의존합니다

증상: 파일은 탐색되는데 편집이 저장되지 않음

가능한 원인:

• 실제 워크스페이스 파일이 아니라 첨부 파일이나 미리보기 화면을 편집 중

해결:

• Files에서 파일을 열고 편집 모드인지 확인

관련 가이드

• 휴대폰에서 diff 리뷰하는 방법
• 휴대폰에서 코드 커밋하는 방법
• 휴대폰으로 Claude Code 모니터링하는 방법