휴대폰에서 Claude Code permission 요청 승인하기

01permission prompt 때문에 작업이 멈추는 이유

기본 permission 모드에서 Claude Code는 대부분의 셸 명령 실행, 파일 수정, 웹 페이지 가져오기 전에 먼저 물어봐요. prompt는 누군가 답할 때까지 terminal에서 기다려요. 커피를 타러 간 사이라면 작업 전체가 그 질문에서 멈추고, 돌아와서야 그 사실을 알게 되죠.

해결 방법은 세 가지예요.

• 승인 횟수 줄이기. 신뢰하는 명령에 allow 규칙을 추가하거나 더 관대한 모드를 사용하세요. 일상적인 작업에 잘 맞으며, 자세한 내용은 Claude Code permission 모드 설명에서 다뤄요.
• 알림을 받고 자리로 돌아가기. notification hook은 prompt가 기다리고 있다고 알려줄 뿐이에요. 응답하려면 결국 키보드 앞으로 돌아가야 해요.
• 원격으로 응답하기. PermissionRequest hook이 질문을 휴대폰으로 보내고, 응답을 Claude Code에 돌려줘요.

이 가이드는 세 번째 방법을 다뤄요.

02PermissionRequest hook이 대신 응답하는 방식

Claude Code는 tool 호출에 권한 결정이 필요할 때 PermissionRequest를 실행해요. hook은 표준 입력으로 JSON을 받는데, 여기에는 tool_name과 tool_input(예: Bash 명령어), 그리고 선택적으로 Claude Code가 저장을 제안할 규칙 목록인 permission_suggestions가 들어 있어요.

hook은 다음과 같은 JSON을 출력해서 응답해요.

{
  "hookSpecificOutput": {
    "hookEventName": "PermissionRequest",
    "decision": {
      "behavior": "allow"
    }
  }
}

behavior는 allow 또는 deny예요. 거부할 때는 Claude에게 이유를 알려주는 message와, Claude를 완전히 멈추는 interrupt: true를 추가할 수 있어요. 허용할 때는 updatedPermissions로 권한 규칙을 적용해서 다시 묻지 않게 할 수 있어요. hook이 아무것도 반환하지 않으면 Claude Code가 평소처럼 prompt를 띄워요.

즉, 원격 승인 hook이 할 일은 세 가지예요. 요청을 내가 볼 수 있는 곳으로 보내고, 응답을 기다리고, hook이 타임아웃되기 전에 올바른 JSON을 출력하는 거예요. 전체 필드 목록과 동작하는 스크립트는 hook에서 권한 요청에 응답하기에 있어요.

hook 등록하기

hook은 ~/.claude/settings.json(모든 프로젝트) 또는 .claude/settings.json(특정 프로젝트)에 설정해요.

{
  "hooks": {
    "PermissionRequest": [
      {
        "matcher": "*",
        "hooks": [
          { "type": "command", "command": "/path/to/your-approval-script" }
        ]
      }
    ]
  }
}

matcher는 tool 이름으로 필터링하므로, "Bash"로 지정하면 셸 명령어만 휴대폰으로 보내요. command hook의 기본 타임아웃은 600초이고, 이게 hook이 기다릴 수 있는 최대 시간이에요.

03직접 만들기

직접 만들 수도 있어요. 보통은 ntfy 같은 push 서비스로 요청을 보내면서 작은 웹 엔드포인트를 호출하는 액션 버튼 두 개를 넣고, hook이 응답이 오거나 타이머가 끝날 때까지 그 엔드포인트를 폴링하는 방식으로 설계해요. 전송 부분은 ntfy로 Claude Code push 알림 받기를 참고하세요.

시간이 걸리는 건 예외 상황 처리예요.

• 키보드 앞에 있을 때. hook이 항상 휴대폰 응답을 기다리면, 그동안 terminal에서 응답할 수 없어요. 잘 만든 hook은 사용자가 자리에 있는 걸 감지하고 물러나요.
• 타임아웃. hook은 Claude Code의 타임아웃 전에 포기하고 깔끔하게 fallback해야 해요.
• 보안. 콜백 엔드포인트에 접근할 수 있는 사람은 누구나 내 컴퓨터의 명령어를 승인할 수 있어요. 인증이 꼭 필요해요.
• 여러 세션. 각 요청이 올바른 세션으로 가고, 응답도 그 세션으로 돌아와야 해요.

만드는 걸 좋아한다면 주말 프로젝트로 딱 좋아요. 당장 쓰고 싶다면 완성된 도구를 쓰는 게 수고를 덜어줘요.

04Claude Code Notifier 사용하기

Claude Code Notifier는 TouchTap Ltd에서 만든 독립 도구예요. Anthropic이 만들었거나 제휴한 제품이 아니에요. Mac, Windows, Linux용 무료 커맨드라인 도구인 ccn과 iPhone, Android용 휴대폰 앱, 이렇게 두 부분으로 구성돼요.

1. ccn 설치하기

Mac과 Linux:

curl -fsSL https://claudecodenotifier.com/install.sh | sh

Windows의 PowerShell(Windows 지원은 베타예요):

irm https://claudecodenotifier.com/install.ps1 | iex

Homebrew, npm, 플러그인 설치 방법은 ccn 페이지에 있어요. 설치하면 ~/.claude/settings.json에 ccn hook을 실행하는 hook 항목 7개가 추가되고, 파일 백업도 남겨요. 그중 하나가 PermissionRequest hook이에요. ccn은 Claude Code가 호출할 때 몇 밀리초 동안 실행된 뒤 종료돼요. 백그라운드에서 돌아가는 건 없고, IDE terminal을 포함한 어떤 terminal에서도 동작해요.

2. 휴대폰 페어링하기

ccn pair를 실행하고 QR 코드를 스캔하거나, 앱에 표시된 6자리 코드를 입력하세요. 운영체제별 단계별 안내는 휴대폰을 Claude Code에 연결하기에 있어요.

3. 알림에서 응답하기

자리를 비운 사이 Claude에 권한이 필요하면, 실행하려는 명령어처럼 무엇을 하려는지 휴대폰에 표시돼요. 이렇게 응답할 수 있어요.

• 한 번 허용: 이번 호출만 허용해요.
• 세션 동안 허용: 해당 세션에서 같은 종류의 요청은 다시 묻지 않아요.
• 거부: Claude는 거부됐다는 걸 알고 작업을 이어가요.

hook이 응답을 반환하면 Claude가 작업을 계속해요.

자리에 있을 때는 어떻게 되나요

ccn은 사용자가 자리에 있는지 확인해요. 최근 30초 안에 입력했다면 기다리지 않고, terminal이 평소처럼 묻고 휴대폰에는 기껏해야 알림 정도만 가요. 자리를 비웠다면 terminal은 설정한 최대 시간까지 휴대폰 응답을 기다리다가, 키보드를 건드리는 순간 대기를 멈춰요. 그래서 언제든 더 가까운 쪽에서 응답할 수 있어요.

최대 대기 시간은 설정으로 바꿀 수 있어요.

ccn config set hold_ceiling_seconds 900

30~3600초 사이로 지정할 수 있고 기본값은 600초예요. 30초 기준은 presence_threshold_seconds로 바꿀 수 있어요. 대부분의 설정은 휴대폰 앱에서 컴퓨터별로 변경할 수도 있어요.

동작 확인하기

ccn doctor   # checks hooks, credentials, server connection and presence detection
ccn test     # sends a test notification

휴대폰 앱은 무료로 다운로드할 수 있지만, 사용하려면 구독이나 평생 이용권 구매가 필요해요. 요금제를 확인하세요. 휴대폰이 없어도 ccn은 Claude에 권한이 필요할 때 컴퓨터에 데스크톱 알림을 무료로 띄워줘요.

05승인할 일 자체를 줄이기

원격 승인은 적절한 allow 규칙과 함께 쓸 때 가장 효과적이에요. 하루에 npm test를 스무 번씩 승인하고 있다면 permissions.allow에 Bash(npm test *) 같은 규칙을 추가하고, 휴대폰으로는 꼭 확인해야 할 요청만 받으세요. 작은 화면에서 승인하기 전에는 명령어를 꼭 읽어 보세요. 무엇을 확인해야 하는지는 휴대폰에서 Claude Code 작업을 승인해도 안전할까요?에서 다뤄요.

06FAQ