터미널에서 멍하니 기다리지 마세요: Claude Code, Codex, OpenCode에 '주인 호출' 알림 추가하기

여러분은 분명 Claude Code, Codex, 또는 오픈소스 OpenCode를 일상 워크플로에 통합했을 것입니다 (예: Flutter/Next.js 프로젝트를 미친 듯이 리팩터링하는 경우).

이들 자동화 Agent 도구의 추론(Reasoning) 메커니즘은 확실히 강력하지만, 공통적인 엔지니어링 고충이 하나 있습니다: 복잡한 작업, 긴 연쇄 리팩터링, 또는 자동 블로그 작성을 실행할 때 수 분에서 그 이상이 걸리는 경우가 많다는 것입니다.

이 과정에서 터미널만 계속 주시하고 있을 수는 없습니다. 하지만 웹서핑을 하거나 다른 코드를 작성하느라 화면을 전환하면, Agent는 'Bash 실행 권한 필요' 또는 '인간의 승인 대기' 때문에 언제든 일시 중단(Suspend)되어 멈춰 버릴 수 있습니다. 다시 돌아왔을 때는 이미 10분 동안 헛되이 기다린 뒤라는 것을 알게 됩니다.

이 글은 **수명 주기 훅(Lifecycle Hooks)**을 통해 권한이 필요하거나 작업이 끝났을 때, 이 최고 수준의 AI 도구들이 시스템 기본 팝업이나 버블 알림으로 자동으로 '주인을 호출'하도록 하는 프로덕션급 전 플랫폼 구성 방법을 바로 제시합니다.

1. 왜 자동 알림이 가능한가?

Claude Code든 Codex든, 내부적으로는 표준 상태 머신 수명 주기를 구현하고 있습니다:

[Agent 思考/运行中] ────> 遇到敏感操作 ────> 触发 PermissionRequest 状态 ──> (挂起等待)
                 └───> 任务闭环结束 ────> 触发 Idle/Stop 状态 ──────────> (终端闲置)

이 도구들은 모두 개발자가 특정 상태 노드에 사용자 정의 Shell 명령(Command Hooks)을 연결할 수 있게 해줍니다. 우리는 각 운영체제의 기본 알림 명령(Windows의 PowerShell, Mac의 AppleScript, Linux의 notify-send)을 해당 설정 파일에 집어넣기만 하면, 터미널과 데스크톱 사이의 '물리적 단절'을 완벽하게 깨뜨릴 수 있습니다.