Claude Code 알림을 iPhone에서 받기

작동 방식

• Claude Code는 자체 이벤트에서 훅을 실행합니다. 턴이 끝나면 Stop, 권한이나 입력을 요청하면 Notification. 모델이 알림 보내기를 기억하는지와 상관없습니다.
• AgentAlarm 훅은 이를 “Claude Code: task finished in my-app”, “Claude Code needs your decision in my-app” 같은 조용한 알림으로 iPhone에 보냅니다.
• 스팸 없음: 컴퓨터에서 떠나 있을 때(2분간 입력이 없을 때)만 알리고, ‘작업 완료’는 3분 이상 걸린 턴에만, 세션당 5분에 한 번까지만 보냅니다.
• 알림에는 프로젝트 폴더 이름과 작업 시간만 담깁니다. 프롬프트, 코드, Claude의 출력은 보내지 않습니다.

플러그인으로 설정하기

1. iPhone에 AgentAlarm을 설치하고 Apple로 로그인하세요.
2. Claude Code에서 플러그인을 추가하세요:

   /plugin marketplace add achubnet/agentalarm-plugins
   /plugin install agentalarm@agentalarm

3. /agentalarm:setup을 실행하세요. MCP 도구 연결(/mcp에서 agentalarm 선택, Authenticate, iPhone에서 허용)과 훅용 키를 Claude가 안내합니다.
4. 마지막으로 테스트하면 iPhone에 알림이 옵니다.

훅을 직접 추가하기

플러그인 없이 쓰려면 CLI에 한 번 로그인하세요(Node 18 이상). 앱에서 설정 → 연결된 에이전트 → AI 에이전트 연결을 열어 텍스트를 복사한 다음 실행하세요:

npx agentalarm login "<앱에서 복사한 텍스트>"

그리고 ~/.claude/settings.json에 다음을 추가하세요:

{
  "hooks": {
    "UserPromptSubmit": [{ "hooks": [{ "type": "command", "command": "npx -y agentalarm hook claude-code", "async": true }] }],
    "Stop": [{ "hooks": [{ "type": "command", "command": "npx -y agentalarm hook claude-code", "async": true }] }],
    "Notification": [{ "matcher": "permission_prompt|elicitation_dialog|elicitation_url_dialog|agent_needs_input",
      "hooks": [{ "type": "command", "command": "npx -y agentalarm hook claude-code", "async": true }] }]
  }
}

훅은 백그라운드에서 실행되므로 Claude가 기다리지 않습니다. UserPromptSubmit은 턴이 시작된 시각만 기록해 작업 시간을 계산합니다.

끝나면 울려 달라고 하기

MCP 도구를 연결했다면 채팅에서 요청하기만 하면 됩니다:

• “테스트가 통과하면 울려 줘.”
• “마이그레이션이 실패하면 iPhone을 울려 줘.”
• “오후 6시에 이 PR 리뷰를 알려 줘.”

긴급 알림은 무음 모드와 집중 모드에서도 ‘완료’나 ‘다시 알림’을 탭할 때까지 알람 시계처럼 울립니다. “결정이 필요함” 알림을 모두 울리게 하려면 npx agentalarm config set ringOnDecision true를 실행하세요.

Apple Watch에서도

iPhone이 잠겨 있을 때는 다른 iPhone 알림처럼 AgentAlarm 알림도 Apple Watch로 옵니다. 오지 않으면 Watch 앱 → 알림 → AgentAlarm을 확인하세요.

조정과 일시 중지

npx agentalarm setup              # 알림 조건
npx agentalarm config set minTaskMinutes 10
npx agentalarm pause 1h           # 다시 시작: npx agentalarm resume
npx agentalarm test               # iPhone을 한 번 울림

조용한 시간을 설정하면 훅에서 오는 알람은 일반 알림이 됩니다. 예: npx agentalarm config set quietHours 23:00-08:00