서너 개의 에이전트 세션이 프로젝트의 서로 다른 부분에서 병렬로 실행되면, 하나가 멈추고 승인을 기다리는 순간을 놓치기 쉽습니다. 알아차렸을 때는 이미 20분이 지나 있습니다.

세션은 진행 중인데 병목은 여러분입니다.

요약

1. Settings → Notifications에서 푸시 알림 켜기
2. 권한 요청 알림 켜기
3. Inbox에서 대기 중인 요청을 한곳에서 보기
4. 알림 액션(Allow/Deny)으로 앱을 열지 않고 응답
5. 세션이 많을 때: 개별 세션이 아니라 Inbox를 주기적으로 확인

문제

여러 에이전트를 실행한다는 건:

• 각 세션이 권한 프롬프트에서 멈출 수 있음
• 모든 세션을 동시에 볼 수 없음
• 상태 확인을 위해 세션을 오가면 시간 낭비
• 멈춘 세션을 알아챌 때쯤엔 지연이 쌓여 있음

병목은 에이전트가 아닙니다. 에이전트가 기다린다는 걸 여러분이 알아채는 것입니다.

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

• 각 세션을 직접 확인: 지루하고, 어떤 걸 이미 확인했는지 잊기 쉽습니다.
• 터미널 창을 여러 개 열어 두기: 어느 창에 대기 중인 프롬프트가 있는지 보기 어렵습니다.
• SSH로 상태 확인 실행: 낫지만 여전히 확인하는 걸 기억해야 합니다.

Happier의 Inbox와 알림이 이를 해결합니다.

• 대기 중인 모든 요청을 한곳에서 보기
• 어떤 세션이든 주의가 필요하면 푸시 알림
• 빠른 응답을 위한 알림 액션

Happier가 처음이라면

Happier는 Claude Code, Codex, OpenCode 같은 AI 코딩 에이전트를 위한 오픈 소스 컴패니언 앱입니다.

여기서의 워크플로: 여러 에이전트를 병렬로 실행하고, Happier가 어떤 것이 주의가 필요한지 추적해 휴대폰으로 알려 줍니다.

설정하기:

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

단계별: 기다리는 에이전트 알림 켜기

1) 푸시 알림 켜기

Happier 앱에서:

1. Settings → Notifications로 이동
2. Push notifications 켜기
3. 요청이 뜨면 알림 권한 허용(iOS/Android)

이렇게 하면 앱이 열려 있지 않아도 알림을 보낼 수 있습니다.

2) 알림 유형 설정

같은 설정 화면에서 다음을 켭니다.

• Permission requests: 에이전트가 도구 권한을 요청할 때 알림
• Ready notifications: 턴이 끝나고 에이전트가 유휴 상태일 때 알림

이 둘이 "에이전트가 기다리는" 주요 상태입니다.

3) 알림 상세 수준 설정

Request previews를 고릅니다.

• On: 요청된 명령/파일이 알림에 포함(맥락이 더 많음)
• Off: 일반적인 "권한 필요" 알림(더 비공개)

알림 설정 문서 (영어)에서:

미리 보기를 켜면 권한 알림에 요청된 명령이나 파일 경로, 그리고 함께 제공된 설명이 포함됩니다.

병렬 세션에서는 모든 세션을 열지 않고 분류할 수 있도록 On을 권장합니다.

4) 동작 확인

1. Claude Code 또는 Codex 세션 시작
2. 권한 프롬프트가 뜨게 하기
3. 휴대폰에 알림이 와야 합니다

알림에서:

• 탭해서 세션 열기
• 또는 Allow / Deny를 눌러 바로 응답

Inbox로 여러 대기 세션 분류하기

병렬 세션이 많으면 Inbox가 분류 화면이 됩니다.

Inbox에 보이는 것

Happier 앱에서:

1. Inbox 탭(홈 화면 또는 하단 내비게이션)
2. 주의가 필요한 모든 항목이 보입니다:
   • 권한 요청
   • 승인 요청
   • 사용자 동작 요청("Exit Plan Mode" 등)
   • 공유 세션 활동

병렬 세션에서 Inbox가 중요한 이유

이렇게 하는 대신:

Session 1 → check for prompts → back
Session 2 → check for prompts → back
Session 3 → check for prompts → back
Session 4 → check for prompts → back

이렇게 합니다:

Inbox → see 2 pending requests → handle them → done

Inbox와 승인 문서 (영어)에서:

Inbox는 승인 요청, 대기 중인 권한 요청, 들어오는 친구 관련 항목을 위한 액션 센터입니다.

Inbox에서 응답하기

Inbox 항목을 탭하면:

• 요청에 초점을 맞춘 채 세션이 열림
• 요청 맥락이 표시됨
• Allow/Deny/Approve 가능

처리한 항목은 Inbox에서 사라집니다.

알림 액션: 앱을 열지 않고 응답하기

iOS와 Android에서 권한 알림은 다음 액션을 지원합니다.

• Allow: 요청을 즉시 승인
• Deny: 요청을 즉시 거부

이 액션은 다음 경우에 동작합니다.

• 알림 대상이 앱에서 이미 활성인 서버일 때
• 또는 알림 대상이 저장된 서버 프로필일 때

알림 라우팅 문서 (영어)에서:

Happier는 알림의 서버가 기기에서 이미 활성이거나 이미 저장된 경우에만 권한 응답을 자동으로 보냅니다.

Happier를 열어 둔 채 컴퓨터 앞에 있다면, 0.2.16에서 추가된 알림 설정이 컴퓨터에서 Happier에 포커스가 있는 동안 휴대폰 푸시를 음소거합니다. 컴퓨터 포커스를 확인할 수 없으면 푸시는 휴대폰으로 갑니다.

안전을 위해: 알림 대상이 알 수 없는 서버라면, Happier는 조용히 승인하지 않고 서버 추가/전환 화면으로 안내합니다.

여러 병렬 세션을 위한 워크플로

아침 준비

1. 모든 에이전트 세션 시작(Claude Code, Codex 등)
2. 각 세션이 첫 프롬프트를 받거나 작업 시작
3. Happier Inbox 열기: 비어 있음(좋음)

낮 동안

1. 에이전트가 결정이 필요하면 알림이 옴
2. 알림 미리 보기 확인:
   • 단순하면: Allow 또는 Deny
   • 맥락이 필요하면: 알림 탭 → 세션 열기 → 검토 → 응답
3. Inbox를 주기적으로 확인(한 시간마다 또는 작업을 바꿀 때)
4. 읽었지만 나중에 다시 보고 싶은 세션은 그 행의 Remind me 사용(0.2.13에서 추가). 알림 시간까지 Needs attention에서 빠졌다가, 새로운 일이 없어도 다시 돌아옵니다. 리마인더는 앱 안의 주의 상태만 바꾸며 푸시를 보내지 않습니다.
5. 대기 중인 요청에 한꺼번에 응답

하루 마무리

1. Inbox 열기: 남아 있는 멈춘 세션 확인
2. 분류: 정당한 요청은 승인, 탐색적인 요청은 거부
3. 세션은 밤새 계속(끝났으면 중지)

알림과 Inbox 확인, 언제 무엇을 쓸까

알림을 쓸 때:

• 실시간으로 파악하고 싶을 때
• 결정마다 시간이 중요할 때
• 이동 중이라 자주 확인할 수 없을 때

Inbox 주기 확인을 쓸 때:

• 승인을 한 시간마다 몰아서 처리할 때
• 알림이 너무 시끄러울 때
• 정해진 시간에 확인하는 게 좋을 때

둘 다 쓸 때:

• 급한 요청은 알림으로 받고
• 분류할 준비가 되면 Inbox로 전체를 볼 때

여러 서버에 걸친 알림 라우팅

셀프 호스팅 Relay나 여러 Relay 프로필을 쓰고 있다면:

• 알림에 요청이 온 서버가 포함됨
• 탭하면 올바른 서버로 이동
• 서버가 아직 저장되지 않았다면 Happier가 추가를 요청

알림 라우팅 문서 (영어)에서:

알림 대상이 현재 활성이 아닌 저장된 서버 프로필이면, 딥 링크가 동작하도록 Happier가 그 프로필로 자동 전환합니다.

문제 해결

증상: 알림이 오지 않음

가능한 원인:

• 앱 설정에서 푸시 알림이 꺼져 있음
• 앱에 알림 권한이 없음
• 기기에 활성 푸시 토큰이 없음

해결:

1. Settings → Notifications → Push notifications가 켜져 있는지 확인
2. 기기 설정 확인: 알림 → Happier → 알림 허용
3. 앱을 다시 시작해 새 푸시 토큰 등록
4. 세션 하나로 테스트

증상: 알림은 오지만 액션이 동작하지 않음

가능한 원인:

• 알림 대상이 알 수 없거나 비활성인 서버
• 앱 버전이 너무 오래되어 알림 액션 미지원

해결:

1. 서버 프로필이 Settings → Relays에 저장되어 있는지 확인
2. Happier 앱을 최신 버전으로 업데이트
3. 액션 대신 알림을 탭해 보기

증상: Inbox는 비어 있는데 기다리는 세션이 있는 것 같음

가능한 원인:

• 세션이 다른 Relay/서버에 있음
• 다른 계정/프로필을 보고 있음
• 요청이 이미 처리됨

해결:

1. 어떤 서버가 활성인지 확인: Settings → Relays
2. 필요하면 올바른 서버로 전환
3. 각 세션을 직접 열어 상태 확인
4. 처리된 요청은 Inbox에서 사라집니다

증상: 알림이 너무 많음

가능한 원인:

• 모든 알림 유형이 켜져 있음
• 많은 세션이 자주 프롬프트를 띄움

해결:

1. Settings → Notifications에서 덜 급한 유형 끄기
2. Request previews를 Off로 해서 잠금 화면 정보 줄이기
3. In-app notifications를 Silent 또는 Off로 설정하는 것 고려
4. 푸시보다 Inbox 주기 확인에 더 의존하기

자주 묻는 질문

셀프 호스팅 Relay에서도 알림이 되나요?

네. Relay는 Expo의 푸시 서비스를 통해 알림을 보냅니다.

셀프 호스팅 Relay는 Expo API에 닿기 위해 인터넷 접속이 필요하지만, 특별한 방화벽 규칙은 필요 없습니다.

데스크톱에서도 알림을 받을 수 있나요?

데스크톱 앱은 앱 내 알림을 표시하지만 현재 시스템 푸시 알림은 지원하지 않습니다.

푸시는 모바일 앱을 쓰거나, 데스크톱에서 Inbox를 주기적으로 확인하세요.

알림을 놓치면요?

놓친 알림은 사라지지 않습니다. 처리할 때까지 요청은 Inbox에 남습니다.

다음도 할 수 있습니다.

• Inbox 직접 확인
• 세션 직접 열기

승인 요청을 webhook으로 보낼 수 있나요?

네. Settings → Notifications → Webhook notifications에서 같은 이벤트를 HTTP 엔드포인트로 보낼 수 있습니다.

다음에 유용합니다.

• 내부 대시보드
• Slack/Discord 봇
• 홈 자동화 트리거

webhook 설정은 알림 설정 문서 (영어)를 참고하세요.

세션이 10개 이상이어도 되나요?

네, 다만 다음을 고려하세요.

• Inbox는 개별 세션 확인보다 확장성이 좋음
• 알림 미리 보기로 각 세션을 열지 않고 분류 가능
• 소음을 줄이도록 알림 유형을 조정하는 게 좋을 수 있음

관련 가이드

• 휴대폰에서 Claude Code 권한 요청을 승인하는 방법
• "승인 대기"에서 멈추는 문제 해결
• Claude Code, Codex, OpenCode 세션 여러 개를 병렬로 실행하기 (흐름을 놓치지 않고)
• Claude Code나 Codex가 작업 중일 때 휴대폰에서 메시지를 큐에 넣는 방법