AI 에이전트에 확인이 필요하면 휴대폰 알림을 받으세요.
Claude Code의 휴대폰 알림은 Remote Control을 통해 전달됩니다. Claude Cowork도 작업 완료 등의 알림을 휴대폰으로 보내며, 자격 요건을 충족하는 기존 사용자는 별도로 Dispatch를 이용할 수 있습니다. Codex는 Mac에 알림을 표시하므로, Codex CLI 알림을 휴대폰에서 받으려면 간단한 훅을 추가해야 합니다.
Anthropic이 제공하는 Claude Code 휴대폰 알림 방식은 Claude 모바일 앱과 Remote Control을 사용하는 것입니다. Pro, Max, Team 또는 Enterprise 요금제에서 /remote-control로 연결하고 /config에서 Push when actions required를 켜세요. Claude Cowork 작업도 휴대폰으로 알림을 보냅니다. Dispatch는 자격 요건을 충족하는 기존 Pro 또는 Max 사용자만 이용할 수 있습니다. Codex CLI와 다른 에이전트에서는 훅을 사용하세요. ntfy를 통해 정해진 알림 문구를 보내는 명령입니다.
사용하는 도구에 맞는 방식을 선택하세요.
에이전트가 내 컴퓨터에서 실행된다면, 여기에 소개된 어떤 방식을 사용하든 그 컴퓨터를 계속 켜 두어야 합니다.
| 도구 | 휴대폰 알림 방식 | 필요 조건 |
|---|---|---|
| Claude Code | Remote Control을 통해 Claude 모바일 앱으로 푸시 알림 전송 | Pro, Max, Team 또는 Enterprise 요금제가 필요합니다. API 키로는 사용할 수 없습니다. 컴퓨터를 계속 켜 두어야 합니다. |
| Claude Cowork 작업 | 작업이 끝나거나 사용자의 입력이 필요할 때 휴대폰 알림 전송 | Claude 모바일 앱이 필요합니다. Pro와 Max에서는 새 Cowork 작업이 클라우드에서 실행되므로 노트북을 닫아도 계속 진행됩니다. |
| Dispatch | 작업이 끝나거나 Claude에 사용자의 승인이 필요할 때 푸시 알림 전송 | 자격 요건을 충족하는 Pro 또는 Max 요금제에서 이미 Dispatch를 이용하고 있어야 합니다. 신규 사용자와 Team 또는 Enterprise 요금제에는 제공되지 않습니다. Claude Desktop 앱을 열어 두고 컴퓨터가 잠자기 상태로 전환되지 않게 해야 합니다. |
| ChatGPT의 Codex | 로컬 Codex 이벤트를 휴대폰으로 알리는 방법은 문서에 나와 있지 않습니다. | 데스크톱 앱 자체 알림은 Mac에만 표시됩니다. 웹 버전 ChatGPT에는 별도의 알림 채널이 있으며, 계정에 따라 다릅니다. |
| 훅을 지원하는 에이전트(Claude Code, Codex CLI, Gemini CLI) | ntfy를 통해 짧은 문구를 보내는 훅 | ntfy 앱과 길고 무작위로 만든 토픽 이름이 필요합니다. 직접 설정해야 합니다. |
Claude Code: Remote Control 푸시 알림을 켜세요.
Anthropic이 제공하는 Claude Code 휴대폰 알림 방식은 Remote Control입니다. Remote Control이 활성화되어 있는 동안 Claude는 Claude 모바일 앱을 통해 휴대폰으로 푸시 알림을 보낼 수 있습니다.
- 휴대폰에 Claude 모바일 앱을 설치하고 로그인하세요.
- Claude Code 세션에서
/remote-control을 입력해 연결하세요. /config를 입력하고 Push when actions required, Push when Claude decides 중 하나 또는 둘 다 켜세요. 기본적으로 둘 다 꺼져 있습니다.
Anthropic에 따르면 푸시 알림을 보낼 시점은 Claude가 결정합니다. 보통 오래 걸리는 작업이 끝났거나 계속 진행하려면 사용자의 결정이 필요할 때 보냅니다. 이 두 스위치 외에 이벤트별 설정은 없습니다.
Pro, Max, Team 또는 Enterprise 요금제가 필요하며, API 키는 지원되지 않습니다. 컴퓨터를 계속 켜 두고 claude 프로세스도 계속 실행해야 합니다. 터미널에 입력하고 있거나 터미널에 포커스가 있는 동안에는 푸시 알림을 보내지 않습니다.
Claude Cowork: 클라우드 작업과 Dispatch.
Anthropic의 Cowork 안내에 따르면 Claude가 작업을 마치거나 사용자의 입력이 필요할 때 휴대폰으로 알림을 받습니다. Pro와 Max 요금제에서는 새 Cowork 작업이 클라우드에서 실행되므로 노트북을 닫아도 계속 진행됩니다.
Dispatch는 별도의 방식입니다. 자격 요건을 충족하는 Pro 또는 Max 요금제에서 이미 Dispatch를 이용하고 있다면 휴대폰으로 컴퓨터에 작업을 맡길 수 있습니다. Anthropic은 다음과 같이 설명합니다. ‘작업이 끝나거나 Claude에 사용자의 승인이 필요하면 휴대폰으로 푸시 알림을 받습니다.’
- Dispatch는 신규 사용자를 받지 않습니다. 일부 기존 Pro 또는 Max 사용자만 계속 이용할 수 있으며, Team 또는 Enterprise 요금제에서는 이용할 수 없습니다.
- 컴퓨터에서 실행되는 작업은 Claude Desktop 앱을 열어 두고 컴퓨터가 잠자기 상태로 전환되지 않게 해야 합니다.
- 작업 상태가 Awaiting input 또는 Awaiting answer라면 사용자의 응답을 기다리고 있다는 뜻입니다.
Mac에 표시되는 내용: Claude Cowork 작업이 끝났거나 확인이 필요할 때 알아보세요.
Codex: 데스크톱 알림과 휴대폰 알림용 훅.
2026년 7월 9일부터 Codex는 ChatGPT 데스크톱 앱에 포함되어 있습니다. Settings > Notifications에서 턴 완료 알림을 표시할 시점을 설정할 수 있습니다. 표시하지 않거나, ChatGPT가 백그라운드에 있을 때만 표시하거나, 항상 표시하도록 선택합니다. 권한 요청과 질문 알림에는 별도의 스위치가 있습니다. 이 알림은 Mac에 표시됩니다.
웹 버전 ChatGPT에는 별도의 Settings > Notifications가 있으며, 알림 유형과 계정에 따라 푸시, 이메일 또는 SMS 등의 채널을 제공합니다. OpenAI 문서에는 이 채널이 로컬 Codex의 턴 완료, 권한 요청 또는 질문을 휴대폰으로 보낸다는 설명이 없습니다. 로컬에서 오래 걸리는 작업을 할 때는 Prevent sleep while running을 켜서 Mac이 잠자기 상태로 전환되지 않게 하세요.
Codex CLI.
OpenAI 문서에서 Codex CLI의 휴대폰 알림 설정은 찾지 못했습니다. notify 설정은 승인 요청 시에는 작동하지 않습니다. 훅을 사용하면 가능합니다. PermissionRequest는 Codex가 승인을 요청하기 직전에, Stop은 턴이 끝날 때 실행됩니다. Codex는 새로 추가되거나 변경된 훅을 /hooks에서 신뢰하도록 허용하기 전까지 실행하지 않습니다. 자세한 내용은 Codex에 승인이 필요하거나 작업이 끝났을 때 확인하기를 보세요.
여러 에이전트에서 ntfy로 짧은 알림을 보내세요.
훅은 에이전트가 턴을 마치거나 사용자의 승인을 기다리는 등 정해진 시점에 실행하는 명령입니다. ntfy.sh는 짧은 메시지를 ntfy 앱으로 전달하는 공개 서비스입니다. 훅이 토픽으로 짧은 문구를 보내면, 그 토픽을 구독하는 앱에 표시됩니다.
토픽 이름은 비밀번호처럼 다루세요. ntfy 공식 문서에 따르면 ntfy.sh의 모든 토픽은 공개되어 있습니다. 따라서 이름을 알거나 추측한 사람은 누구나 전송한 내용을 읽을 수 있습니다. 길고 무작위로 만든 이름을 사용하세요. 이 코드 조각은 정해진 문구만 보내며, 폴더 이름이나 프롬프트, 에이전트의 답변은 절대 보내지 않습니다.
- 휴대폰에 ntfy 앱을 설치하고, 길고 무작위로 만든 이름의 토픽을 구독하세요.
~/.claude/settings.json에 코드 조각을 추가하세요. 모든 프로젝트에 적용됩니다. 두 곳의REPLACE-WITH-A-LONG-RANDOM-TOPIC을 모두 내 토픽 이름으로 바꾸세요.- 변경 사항은 보통 자동으로 반영됩니다. 반영되지 않으면 세션을 다시 시작하세요.
~/.claude/settings.json에 추가
{
"hooks": {
"Stop": [
{ "hooks": [ { "type": "command", "command": "/usr/bin/curl -s -m 10 -H 'Title: Claude Code' -d 'Claude Code finished' https://ntfy.sh/REPLACE-WITH-A-LONG-RANDOM-TOPIC >/dev/null 2>&1", "async": true } ] }
],
"Notification": [
{ "matcher": "permission_prompt", "hooks": [ { "type": "command", "command": "/usr/bin/curl -s -m 10 -H 'Title: Claude Code' -H 'Priority: 4' -d 'Claude Code needs you' https://ntfy.sh/REPLACE-WITH-A-LONG-RANDOM-TOPIC >/dev/null 2>&1", "async": true } ] }
]
}
}
덮어쓰지 말고 병합하세요. 파일에 이미 "hooks" 객체가 있다면 그 안에 이 키들을 추가하거나, 기존 목록에 이 항목들을 추가하세요. 두 번째 "hooks" 블록을 붙여 넣지 마세요. 이 파일은 엄격한 JSON 형식이므로 주석과 마지막 항목 뒤의 쉼표를 허용하지 않습니다.
각 부분은 이렇게 작동합니다.
- 완료 알림.
Stop은 전체 작업이 끝날 때뿐 아니라 Claude가 응답을 마칠 때마다 발생합니다. 공개 ntfy.sh 서버는 하루에 메시지 250개를 허용합니다. - 응답 대기 알림.
permission_prompt는 사용자가 자리를 비운 것으로 보이는 동안 권한 요청이 약 6초간 대기하면 발생합니다. 터미널에서 키를 누를 때마다 발생 시점이 늦춰집니다.Priority: 4는 ntfy에서 메시지를 높은 우선순위로 표시합니다. - 기다리지 않고 계속 진행.
"async": true를 사용하면 그동안 Claude Code가 계속 작업할 수 있습니다.
알림이 오지 않으면 확인하세요.
- 폴더를 신뢰하도록 허용하세요. Claude Code는 해당 폴더의 작업 공간 신뢰 대화상자에서 동의하기 전까지 직접 만든 훅을 포함해 모든 훅의 실행을 보류합니다.
- 업무용 Mac. 조직에서 관리하는 훅만 허용하도록 설정할 수 있습니다. 이 경우 개인 훅은 실행되지 않습니다.
- Cowork Island도 사용한다면. 코드 조각처럼 각 훅을 별도 항목으로 두고, 직접 만든 스크립트는
~/.perch/밖에 보관하세요. Cowork Island는/.perch/가 포함된 명령을 자신의 명령으로 인식하며, 해당 항목 전체를 교체할 수 있습니다.
Codex CLI나 Gemini CLI에서는 알림 훅 생성기로 무작위 토픽이 포함된 맞춤 코드 조각을 만들 수 있습니다. 파일 이름도 안내하며, 붙여 넣은 파일 사본에 코드를 병합할 수도 있습니다. 모든 과정은 브라우저 안에서 이루어집니다.
설정 없이 시작하는 방법.
Cowork Island는 이 가이드를 만든 사람이 개발한 Mac 앱입니다. AI 에이전트 세션을 노치 패널에 모아 두고 각 세션의 상태를 보여 주므로, 어떤 세션이 ‘확인 필요’ 상태인지 한눈에 볼 수 있습니다. 지원되는 여러 도구의 세션이 같은 아일랜드에 나타나며, 세션마다 고유한 이름, 출처, 상태가 표시됩니다.
- Claude Code는 자동으로 연결됩니다. Codex, Cline, 그리고 직접 추가한 도구는 설정에서 켜기 전까지 꺼져 있습니다. Codex는 Cowork Island의 훅도 허용해야 합니다.
- 기본적으로 세션이 ‘확인 필요’ 상태가 되면 아일랜드가 자동으로 펼쳐집니다. 단, 해당 세션의 터미널이나 앱이 이미 맨 앞에 있으면 펼쳐지지 않습니다.
- 지원되는 Claude Code 요청이라면 무료 요금제에서도 아일랜드에서 동작을 허용하거나 거부하고, 객관식 질문에 답할 수 있습니다. 다른 도구에서는 해당 도구의 앱이나 터미널에서 응답해야 할 수 있습니다.
- Mac에서 자리를 비울 때: Pro에서는 Cowork Island의 설정에서 Shortcuts에 있는 단축어 하나를 선택해 카드가 ‘확인 필요’ 상태가 될 때마다 실행할 수 있습니다. 예를 들어 휴대폰으로 메시지를 보내는 단축어를 사용할 수 있습니다. 단축어를 선택하고 기능을 켜기 전까지는 꺼져 있으며, ‘다음일 때 음소거’ 규칙도 적용됩니다. 단축어에는 ‘Claude에서 확인이 필요합니다’ 같은 짧은 문구만 전달하며, 제목이나 폴더, 프롬프트는 절대 전달하지 않습니다. 이 기능을 위해 Cowork Island가 외부로 보내는 것은 없습니다. 그 문구로 무엇을 할지, 어떤 내용을 전송할지는 직접 만들거나 설치한 단축어에 달려 있습니다.
- Cowork Island는 자체 알림을 보내지 않습니다. 소리는 직접 켜기 전까지 꺼져 있으며, ‘승인 필요’ 알림음은 무료입니다.
무료 요금제는 세션 카드를 한 번에 하나씩 보여 줍니다. Pro는 모든 세션을 보여 주고, 해당 세션의 윈도우, 탭 또는 분할 창으로 바로 이동하며, 사용자의 단축어를 실행합니다. 결제 정보 없이 Pro 7일 체험이 자동으로 시작되며, Mac마다 한 번만 제공됩니다. 요금제와 설치 가이드를 확인하세요.
무료 다운로드출처.
- Claude Code 문서: Remote Control
- Claude Code 문서: 설정 참조
- Claude Code 문서: 훅 참조
- Claude Code 문서: 훅 가이드
- Claude Code 문서: 설정
- Claude Code 문서: 데스크톱 앱
- Claude 도움말 센터: Cowork의 Dispatch
- Claude 도움말 센터: 웹, 데스크톱, 모바일에서 사용하는 Cowork
- Anthropic: Dispatch 작업 상태
- ChatGPT 문서: 알림
- ntfy: 휴대폰에서 구독하기
- Codex 변경 이력
- Codex 문서: 오래 걸리는 작업
- Codex 문서: 고급 설정
- Codex 문서: 훅
- Gemini CLI 문서: 훅
- ntfy 문서: 메시지 전송
출처 확인일: 2026년 10월 18일. 이 가이드는 Cowork Island를 만든 사람이 작성했습니다. 수정할 내용이 있으면 support@coworkisland.com으로 메일을 보내거나 GitHub에 이슈를 등록하세요.