AX 팁 10 — 다른 탭의 승인 대기 알아채기

작성

  • AX 팁
  • Claude Code
  • 개발 환경 자동화
  • 알림

Claude Code 를 여러 탭에서 돌리면 다른 탭의 「이 명령을 실행할까요?」 창이 뜬 줄 모르고 몇 분씩 멈춰 있게 됩니다. 그래서 권한 창이 뜰 때 도는 훅(PermissionRequest)으로 어떤 도구인지 기록해 두고, 창이 몇 초 이상 떠 있으면 도는 알림 훅(Notification)으로 맥 알림을 띄우게 했습니다. 알림을 누르면 그 탭으로 바로 이동하고, 처리가 끝나면 기록은 자동으로 지워집니다. 이 글은 꺼진 세션의 서브에이전트를 되살린 지난 편에 이은 연재 열 번째 편입니다.

두 모니터 앞에서 알림을 확인하는 개발자 AI 생성 이미지

왜 다른 탭이 멈춘 줄 몰랐을까?

저는 탭 하나에서 코드를 고치고, 다른 탭에서 조사를 시키고, 또 다른 탭에서 문서를 정리합니다. 권한 창은 그 탭이 눈앞에 있을 때만 보입니다. 다른 탭을 보고 있는 동안 조사 탭은 「Yes / No」 앞에서 조용히 기다립니다.

나중에 돌아와 보면 아무 일도 하지 않은 채 몇 분이 지나 있었습니다. 일을 시켜 놓고 기다리는 시간이 사실은 제가 답하기를 기다리는 시간이었던 셈입니다. 탭 이름을 자주 훑어보는 습관으로는 해결되지 않았습니다.

무엇이 권한 창이 뜬 순간을 알려 줄까?

Claude Code 의 훅은 여러 시점에 끼어들 수 있습니다. 공식 문서에는 권한 창을 띄우기 직전에 도는 PermissionRequest 와, 입력을 기다릴 때 도는 Notification 이 따로 나옵니다. 저는 둘을 모두 씁니다. 앞의 것이 「무슨 도구를 쓰려 했나」를 기록하고, 뒤의 것이 「창이 실제로 떠 있다」를 확인해 알림을 보냅니다.

{
  "hooks": {
    "PermissionRequest": [{ "hooks": [{ "type": "command", "command": "python3 hooks/approval-wait.py record" }] }],
    "Notification": [{ "matcher": "permission_prompt", "hooks": [{ "type": "command", "command": "python3 hooks/approval-wait.py mark" }] }]
  }
}

두 단계로 나눈 이유가 있습니다. 권한 창은 도구 호출마다 뜨는 것이 아니라 허용 목록에 없을 때만 뜨는데, 알림 훅은 창이 한동안 떠 있었을 때 도착합니다. 그래서 곧바로 허용되는 호출이 알림을 울리는 일이 없고, 정말 기다리는 창에만 알림이 갑니다.

알림에는 무엇을 담았나?

기록에는 세션 이름, 작업 폴더, 터미널 핸들, 도구와 명령의 요지를 한 줄로 남깁니다. 다만 알림센터와 잠금 화면에는 흔적이 남기 때문에 알림 본문에는 도구 이름만 넣습니다. 명령 요지에는 비밀값이 들어갈 수 있어서, 기록하기 전에 토큰·비밀번호·인증 헤더·카드번호 꼴의 숫자를 별표로 가립니다.

알림 도구로는 terminal-notifier 를 씁니다. 이 도구는 알림을 눌렀을 때 실행할 명령을 줄 수 있어서, 누르면 그 세션의 터미널 탭으로 곧장 이동합니다. 같은 세션에서 새 대기가 생기면 알림을 새로 쌓지 않고 하나를 갈아 끼웁니다.

cmd = [tn, "-title", title, "-subtitle", subtitle, "-message", body,
       "-sound", "Glass",
       "-execute", "%s terminal switch --terminal %s" % (orca, handle)]
if group:
    cmd += ["-group", group]   # 같은 세션의 새 대기는 알림 하나를 갈아 끼운다

기록은 언제 지울까?

알림만 보내고 기록을 안 지우면 이미 처리한 대기가 계속 남습니다. 그래서 도구 실행이 끝났을 때(PostToolUse), 실패했을 때, 턴이 끝났을 때(Stop) 짝이 되는 삭제 스크립트가 해당 세션의 기록을 지웁니다. 서브에이전트에서 온 이벤트는 부모 세션의 권한 창과 무관하니 지우지 않습니다.

이 삭제 스크립트만은 파이썬이 아니라 셸로 남겼습니다. 도구를 호출할 때마다 도는 훅이라 파이썬 기동 시간이 쌓이기 때문입니다. 파일 맨 위에 그 이유를 적어 두었습니다.

승인 대기 알림의 흐름권한 창이 뜸 → 도구 요지 기록(비밀값 가림); 도구 요지 기록(비밀값 가림) → 창이 계속 떠 있나?; 창이 계속 떠 있나? → 맥 알림(도구 이름만) (예); 창이 계속 떠 있나? → 처리 끝 - 기록 삭제 (아니오); 맥 알림(도구 이름만) → 알림 클릭 - 그 탭으로 이동; 알림 클릭 - 그 탭으로 이동 → 처리 끝 - 기록 삭제예아니오권한 창이 뜸도구 요지 기록(비밀값가림)창이 계속 떠 있나?맥 알림(도구 이름만)알림 클릭 - 그 탭으로이동처리 끝 - 기록 삭제
승인 대기 알림의 흐름 — 기록 - 알림 - 이동 - 삭제

그 자리에서 대신 답하게 만들면 안 될까?

처음에는 알림 화면에서 바로 승인까지 하게 만들었습니다. 그런데 기록해 둔 요지만 믿고 승인 번호를 보내는 방식은 다른 도구의 창에 잘못 승인하는 경우가 재현되어 버렸습니다. 그래서 같은 날 설계를 바꿨습니다.

지금은 답하기 직전에 그 터미널 화면을 다시 읽어 질문과 선택지의 지문(해시)을 만들고, 사용자가 본 지문과 같을 때만 번호 한 글자를 보냅니다. 엔터는 보내지 않습니다. 「다시 묻지 않기」「항상」 같은 선택지와 자유 입력, 여러 개를 고르는 창은 아예 막습니다. 되돌리기 어려운 명령처럼 보호 장치가 직접 확인을 요구한 건은 이동해서 직접 보게 합니다.

PERM_OK_RE = re.compile(r"(?i)^(yes|no(,.*)?)(\s*\(esc\))?$")  # 권한 창은 Yes 와 No 만
# 보내기 직전: 화면을 다시 읽어 지문이 같을 때만 숫자 한 글자 전송
if not same_t or cur["fp"] != fp:
    return "그 화면의 질문이 바뀌었습니다 — 다시 보십시오(보내지 않음)"

지금은 무엇이 달라졌나?

이 장치는 2026-09-30 에 처음 만들었고, 2026-10-22 에는 알림을 누르면 그 탭으로 이동하게 바꿨습니다. 2026-11-02 기준 기록·알림 스크립트는 410줄, 삭제 스크립트는 38줄이며 git 이력은 11건입니다.

다른 탭의 권한 창알림 장치 전: 탭을 훑어봐야 알 수 있음, 멈춘 시간이 눈에 안 보임, 일이 조용히 기다림 → 알림 장치 후: 창이 뜨면 알림이 옴, 클릭하면 그 탭으로 이동, 처리가 끝나면 기록이 지워짐알림 장치 전탭을 훑어봐야 알 수있음멈춘 시간이 눈에 안보임일이 조용히 기다림알림 장치 후창이 뜨면 알림이 옴클릭하면 그 탭으로이동처리가 끝나면 기록이지워짐
다른 탭의 권한 창

가장 크게 달라진 것은 탭 사이를 오가며 상태를 확인하는 일이 사라진 점입니다. 알림이 오기 전까지는 지금 하는 일에 집중해도 됩니다. 대가도 있습니다. 알림은 창이 한동안 떠 있어야 울리므로 아주 빠르게 답해야 하는 상황에서는 늦을 수 있고, 맥 알림 도구가 없는 환경에서는 클릭 이동 대신 일반 알림만 나옵니다.

자주 묻는 질문

Notification 훅만 쓰면 충분하지 않나요?

알림 훅만으로도 「입력이 필요하다」는 사실은 알 수 있습니다. 하지만 어떤 도구가 기다리는지는 권한 요청 훅에서 기록해 둔 요지가 있어야 보입니다. 두 훅을 같이 쓰면 알림에는 도구 이름만 보이면서도 나중에 목록에서 자세한 요지를 볼 수 있습니다.

알림에 명령 내용을 그대로 넣으면 안 되나요?

알림센터와 잠금 화면에는 알림이 남습니다. 명령에 비밀값이 섞여 있을 수 있어서 본문에는 도구 이름만 넣고, 기록하는 요지도 비밀값 꼴을 가린 뒤 저장합니다.

맥이 아닌 환경에서도 쓸 수 있나요?

이 구성은 맥 알림을 전제로 합니다. 다른 운영체제에서는 알림 부분만 그 환경의 알림 도구로 바꾸면 되고, 기록과 삭제 흐름은 같습니다. 공개 저장소에도 권한 요청을 휴대폰으로 보내거나 소리로 알리는 도구들이 있어 참고할 수 있습니다.

사이트를 만들어볼까요?

무료 상담 받기