# Claude routines 푸시 알림: 클라우드 실행에 내 확인이 필요할 때 알기

> Claude routines는 정해진 일정, API 호출, GitHub 이벤트에 따라 Anthropic 클라우드에서 실행되지만 끝나도 아무에게도 알리지 않습니다. 실행이 끝나거나, 실패하거나, 무언가를 찾았을 때 휴대폰으로 푸시 알림을 받는 방법을 알려드립니다.

*18.10.2026*

<!-- source: https://pocketalert.app/ko/blog/claude-routines-notifications -->

Claude routines는 사용자가 없어도 실행되는 Claude Code의 기능입니다. 프롬프트와 저장소를 한 번 저장해 두면, Anthropic 클라우드가 매일 밤, 새 풀 리퀘스트가 올라올 때마다, 또는 모니터링 도구가 엔드포인트를 호출할 때마다 새 Claude Code 세션을 시작합니다. 노트북은 꺼 두셔도 됩니다.

문제는 routine이 아무에게도 결과를 알리지 않는다는 점입니다. 결과는 claude.ai의 세션 안에 남아 있고, 직접 들어가 보기 전까지는 알 수 없습니다. 실행 목록도 큰 도움이 되지 않습니다. 초록색 상태는 세션이 인프라 오류 없이 시작되고 종료되었다는 뜻일 뿐, 작업이 성공했다는 뜻은 아니기 때문입니다. 밤사이 의존성 점검에서 깨진 빌드를 발견한 실행과 아무것도 발견하지 못한 실행이 똑같이 보입니다.

이 가이드에서는 routine이 Pocket Alert를 통해 휴대폰으로 푸시 알림을 보내도록 설정합니다. 모든 것이 정상이면 조용한 알림을, 사용자가 확인해야 할 일이 있으면 강한 알림을 보냅니다.

## Claude routines가 무엇인지 간단히

Anthropic은 이제 이 기능을 **예약된 작업(scheduled tasks)**이라고 부릅니다. "Routines"는 이전 이름이며, 웹 주소(`claude.ai/code/routines`), CLI 별칭 `/routines`, API에는 아직 이 이름이 남아 있습니다. 같은 기능이고, 현재 리서치 프리뷰 단계입니다.

routine은 저장된 Claude Code 설정입니다. 프롬프트, 하나 이상의 GitHub 저장소, 클라우드 환경, 커넥터 목록으로 구성됩니다. 실행 한 번이 셸 명령을 실행하고, 코드를 수정하고, `claude/` 브랜치에 푸시하고, 커넥터를 호출할 수 있는 완전한 클라우드 세션입니다. 실행은 트리거에서 시작되며, 하나의 routine에 여러 트리거를 둘 수 있습니다.

- **일정**: 시간별, 매일, 매주 프리셋, 사용자 지정 cron 표현식(최소 간격 1시간), 또는 지정한 시각에 한 번 실행.
- **API**: routine 전용 `/fire` 엔드포인트에 베어러 토큰과 함께 POST 요청. 경고 본문 같은 `text` 필드를 보내면 실행이 이를 컨텍스트로 받습니다.
- **GitHub**: Claude GitHub App이 설치된 저장소의 풀 리퀘스트, 릴리스, 이슈 이벤트. 풀 리퀘스트는 작성자, 브랜치, 라벨, 초안 상태 등으로 필터링할 수 있습니다.

routine은 [claude.ai/code/routines](https://claude.ai/code/routines)에서 **New task**를 누르거나, 데스크톱 앱에서 만들거나, Claude Code CLI에서 `/schedule`을 사용해 만들 수 있습니다(예: `/schedule daily PR review at 9am`). Pro, Max, Team 또는 Enterprise 플랜이 필요하며, 실행은 대화형 세션과 마찬가지로 구독 사용량을 차감합니다.

## 준비물

- Pocket Alert 계정, [API 키 페이지](/account/apikeys)에서 발급받은 API 키, 그리고 [iPhone 또는 Android](/get-app) 휴대폰의 앱. 무료 플랜으로도 가능합니다.
- routine 하나, 또는 만들 계획.

실행 결과를 휴대폰으로 보내는 방법은 두 가지입니다. 세션에서 Pocket Alert API로 `curl`을 호출하거나, [Pocket Alert MCP 서버](/tools/mcp)를 커넥터로 추가하는 방식입니다. curl로 시작하시기를 권합니다. routines를 쓸 수 있는 모든 플랜에서 작동하고, API 키가 세션 안으로 들어가지 않습니다.

## 설정: 네트워크 시크릿을 사용한 curl

routine의 클라우드 환경은 기본적으로 **Trusted** 네트워크 접근 권한을 가집니다. 패키지 레지스트리, GitHub, 클라우드 제공자 API만 허용되고 그 밖에는 허용되지 않습니다. `api.pocketalert.app`은 이 목록에 없으므로, 그대로 `curl`을 실행하면 `403`과 `x-deny-reason: host_not_allowed`로 실패합니다.

**네트워크 시크릿**을 사용하면 네트워크 문제와 키 문제를 함께 해결할 수 있습니다. 환경에 키를 저장해 두면, 세션의 VM을 벗어난 요청에 Anthropic 프록시가 지정한 호스트 대상으로 키를 추가해 줍니다. 네트워크 시크릿에 등록된 호스트는 접근 수준과 관계없이 연결할 수 있고, Claude는 키를 보지 못합니다.

1. [claude.ai/code/routines](https://claude.ai/code/routines)에서 routine을 열고 **Edit**를 선택한 뒤, **Advanced settings > General > Cloud environment**로 이동합니다. 환경 위에 마우스를 올리고 설정 아이콘을 클릭합니다.
2. **Network secrets**에서 **Add secret**을 클릭하고, 유형은 **Bearer**로 둡니다.
3. **Name**에 `Pocket Alert`, **Allowed websites**에 `api.pocketalert.app`을 입력합니다.
4. **Custom headers**에서 헤더 이름을 `Authorization`에서 `Token`으로 바꾸고, `Bearer` 접두사를 지운 뒤 API 키를 값으로 붙여 넣습니다.
5. **Add**를 클릭합니다. 시크릿은 바로 저장되며, 이후에는 다시 볼 수 없습니다.

이제 요청에 키를 넣을 필요가 없습니다. routine 프롬프트 끝에 다음 내용을 추가하세요.

```text
When you are done, send exactly one push notification with curl:

curl -sS https://api.pocketalert.app/v1/messages \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'EOF'
{"title": "<routine name>: <one-line result>", "message": "<2-3 sentence summary>", "level": "<level>"}
EOF

Do not add any auth header; the environment adds it. Build valid JSON.
Pick the level:
- "low" if the run finished and nothing needs my attention.
- "default" if you opened a pull request or found something worth reading today.
- "high" only if the work failed, tests are broken, or you found a real problem.
Include the session link from:
echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"
```

마지막 줄은 Anthropic 문서에 나온 방식입니다. 각 클라우드 세션은 `CLAUDE_CODE_REMOTE_SESSION_ID`에서 자신의 ID를 읽을 수 있고, 이 명령이 그것을 대화 기록 URL로 바꿔 줍니다. 알림에 이 링크가 포함되면 푸시에서 실행 기록까지 한 번의 탭으로 이동할 수 있습니다.

첫 예약 실행 전에 routine 페이지에서 **Run now**를 클릭해 테스트해 보세요.

환경 대화상자에 **Custom headers** 항목이 없다면(관리자 역할이 없는 Team 플랜에서는 호스트와 값만 입력하도록 되어 있습니다), **Network access**를 **Custom**으로 바꾸고, 기본 목록은 그대로 둔 채 **Allowed domains**에 `api.pocketalert.app`을 추가하세요. 그리고 `POCKETALERT_KEY` 같은 환경 변수에 키를 넣고, `-H "Token: $POCKETALERT_KEY"` 형태로 보내면 됩니다. 다만 환경 변수는 해당 환경을 사용하는 누구나 읽을 수 있으므로, 시크릿을 쓰는 편이 더 낫습니다.

## 또는 MCP 서버를 커넥터로 연결

routines는 claude.ai 커넥터를 사용할 수 있고, 커넥터 트래픽은 Anthropic 서버를 거치므로 허용 목록을 바꿀 필요가 전혀 없습니다. 이 경우 프롬프트에는 제목, 메시지, 레벨과 함께 "pocketalert `create_message` 도구를 호출하라"고만 적으면 됩니다.

다만 인증에 제약이 있습니다. Pocket Alert MCP 서버는 API 키를 `Authorization: Bearer KEY` 형태로 받는데, claude.ai의 사용자 지정 커넥터는 **Add custom connector** 대화상자의 **Request headers** 섹션을 통해서만 고정 키를 보낼 수 있습니다. Anthropic은 이 섹션을 제한된 조직에만 제공하는 베타 기능으로 표시하고 있습니다. 해당 섹션이 보인다면 다음과 같이 설정하세요(Team 및 Enterprise 플랜에서는 Owner가 **Organization settings > Connectors**에서 커넥터를 추가합니다).

1. [claude.ai/customize/connectors](https://claude.ai/customize/connectors)에 들어가 **Add custom connector**를 클릭합니다.
2. URL: `https://mcp.pocketalert.app/mcp`. 인증: **No sign-in**.
3. **Request headers**에서 `authorization`을 고르고 `Bearer YOUR_API_KEY`를 입력합니다.

새 routine에는 기본적으로 모든 커넥터가 포함되므로, routine의 **Connectors** 탭에서 필요한 것만 남기세요. Claude Code CLI의 `claude mcp add`는 여기서 도움이 되지 않습니다. 이 명령으로 추가한 서버는 사용자의 컴퓨터에 남고 routine에는 나타나지 않습니다. 로컬에서도 Claude Code를 사용한다면 그 설정은 [Claude Code 푸시 알림](/blog/claude-code-push-notifications)에 있고, 다른 MCP 옵션은 [최고의 MCP 알림 서버](/blog/best-mcp-notification-servers)에서 확인하세요.

## 2단계: 모델에 의존하지 않는 푸시

위 두 방법은 모두 Claude가 프롬프트의 마지막 단락을 따른다는 전제에 기대고 있습니다. 대개는 그렇게 합니다. 하지만 속도 제한이나 API 오류에 걸린 실행은 그 단락까지 가지 못하는데, 바로 그런 실행을 가장 먼저 알아야 합니다.

훅도 routines에서 실행됩니다. 저장소가 하나인 클라우드 세션은 저장소의 `.claude/settings.json`을 읽습니다. `Stop` 훅은 Claude가 작업을 마칠 때 실행되고, 턴이 `StopFailure`이나 `rate_limit` 같은 API 오류로 끝나면 `server_error`가 대신 실행됩니다. 다음 내용을 `.claude/settings.json`으로 커밋하세요.

```json
{
  "hooks": {
    "Stop": [
      { "hooks": [{ "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/notify.sh done" }] }
    ],
    "StopFailure": [
      { "hooks": [{ "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/notify.sh failed" }] }
    ]
  }
}
```

그리고 `.claude/hooks/notify.sh` 스크립트를 실행 가능하게 만듭니다.

```bash
#!/usr/bin/env bash
[ "$CLAUDE_CODE_REMOTE" = "true" ] || exit 0

payload=$(cat)
last=$(jq -r '.last_assistant_message // ""' <<<"$payload")
link="https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"

if [ "$1" = "failed" ]; then
  title="Claude run failed: $(jq -r '.error // "unknown"' <<<"$payload")"
  level=high
else
  title="Claude run finished · $(basename "$CLAUDE_PROJECT_DIR")"
  level=low
fi

jq -n --arg t "$title" --arg m "${last:0:300}
$link" --arg l "$level" '{title: $t, message: $m, level: $l}' |
  curl -sS --max-time 10 https://api.pocketalert.app/v1/messages \
    -H 'Content-Type: application/json' --data-binary @- >/dev/null 2>&1 || true
```

`CLAUDE_CODE_REMOTE` 검사 덕분에 이 훅은 해당 변수가 절대 `true`가 되지 않는 노트북에서는 조용히 있습니다. `jq`는 클라우드 세션에 기본 설치되어 있고, 첫 섹션의 네트워크 시크릿이 키를 제공합니다. 프롬프트 기반 푸시는 내용("패키지 3개 오래됨, PR 생성됨")을 전하는 용도로 두고, 훅은 "끝났다"는 것을 확실히 알려 주는 신호로 쓰세요. 둘 중 하나만 써도 됩니다.

훅은 routine 실행뿐 아니라 그 저장소의 모든 클라우드 세션에서 실행되므로, 같은 저장소에서 웹의 Claude Code를 사용할 때도 푸시가 올 수 있습니다.

## 레벨과 버튼

위 프롬프트에는 가장 중요한 요소인 레벨이 이미 들어 있습니다. `low`는 조용히 도착하고 기록에 남습니다. `high`는 iPhone에서 시간 민감 알림으로 전달되어 집중 모드도 통과합니다. "문제일 때만 high"라는 규칙은 일주일 뒤 전체 알림을 꺼 버리는 상황을 막아 줍니다. `critical`도 있으며, 유료 플랜에서는 방해 금지 모드를 뚫고 들어오지만, 매일 밤 실행되는 routine에는 거의 필요하지 않습니다. 각 레벨이 iOS와 Android에서 어떻게 동작하는지는 [우선순위 레벨](https://info.pocketalert.app/features/priority-levels.html)을 참고하세요.

유료 플랜에서는 메시지에 최대 세 개의 [액션 버튼](https://info.pocketalert.app/features/action-buttons.html)을 넣을 수 있습니다. 여기서 유용한 것은 세션 URL을 연결한 `view` 버튼이며, JSON에 다음과 같이 추가합니다.

```json
"actions": [{"type": "view", "label": "Open run", "value": "https://claude.ai/code/session_..."}]
```

모든 푸시는 앱의 기록과 웹 대시보드에도 저장되며, 서버와 CI에서 온 알림과 함께 보관됩니다. 그래서 일주일 치 야간 실행 기록을 한 번에 훑어볼 수 있습니다.

## 솔직한 한계

- **프롬프트는 요청이지 보장이 아닙니다.** Claude는 보통 푸시를 보내지만, 건너뛰거나 두 번 보내거나 JSON을 잘못 쓸 수 있습니다. 확실성이 필요하다면 훅을 사용하세요.
- **실행이 멈추고 기다릴 수 있습니다.** routine은 자동 모드로 시작하지만, 확인 규칙에 걸리는 작업이나 반복된 차단이 발생하면 세션에서 응답을 기다리며 멈춥니다. 프롬프트도 `Stop`도 이 대기 상태는 알려 주지 않습니다. 보통 7시 10분에 알림이 오던 routine이 오지 않는다면, 직접 들여다보세요.
- **사용량 한도가 적용됩니다.** 실행은 구독에서 차감됩니다. 사용량 크레딧이 없으면 한도에 도달한 뒤의 추가 실행은 거부되고, 시작되지 못한 실행은 아무 알림도 보내지 않습니다. 시간당 상한도 있습니다. 계정당 예약 실행은 시간당 100회, routine당 Run now 또는 API 호출은 30회입니다.
- **리서치 프리뷰입니다.** Anthropic은 동작, 한도, API가 바뀔 수 있다고 밝히고 있습니다.
- **무료 플랜.** 기기 한 대에서 하루 50개 메시지입니다. 실행당 푸시 하나를 보내는 시간별 routine은 가능하지만, 수정한 파일마다 푸시를 보내면 한도를 넘습니다.

## 알림이 오지 않을 때

1. **실행 기록을 여세요.** routine의 **History**에 있는 각 실행은 전체 세션으로 열립니다. 대화 기록에서 `api.pocketalert.app`을 검색하고 curl의 출력을 읽어 보세요.
2. **`403`와 함께 `host_not_allowed`.** 이 routine이 사용하는 환경에 시크릿이 없거나, 호스트 이름의 철자가 틀린 경우입니다. **Allowed websites**를 확인하세요.
3. **`401`.** "No token provided"는 API에 키가 전달되지 않았다는 뜻입니다. 시크릿이 연결되지 않았거나 헤더 이름의 철자가 틀린 것입니다. "token contains an invalid number of segments"는 헤더가 아직 `Authorization`이라는 뜻이므로 `Token`으로 바꾸세요. "Invalid token"은 `Bearer` 접두사가 남아 있거나 키가 폐기되었다는 뜻입니다.
4. **`400`.** 본문이 올바른 JSON이 아닙니다. 보통 요약문에 이스케이프되지 않은 따옴표가 들어 있는 경우입니다. 훅 버전은 `jq`로 JSON을 만들기 때문에 이 문제를 피할 수 있습니다.
5. **훅이 전혀 실행되지 않음.** `.claude/settings.json`이 기본 브랜치에 커밋되어 있는지, 스크립트에 실행 권한이 있는지, routine에 저장소가 하나만 있는지 확인하세요.

## FAQ

### Claude routines와 예약된 작업은 같은 것인가요?

네, 같습니다. Anthropic이 routines의 이름을 예약된 작업으로 바꿨고, 웹 주소, `/routines` 별칭, API에는 예전 이름이 남아 있습니다.

### routine이 제 Pocket Alert API 키를 볼 수 있나요?

네트워크 시크릿을 쓰면 볼 수 없습니다. 프록시가 요청이 세션을 벗어난 뒤에 헤더를 추가하므로, Claude가 읽을 수 있는 환경 변수나 파일에는 키가 들어 있지 않습니다. 환경 변수를 쓰면 세션 안에서 읽을 수 있습니다.

### routine이 밤에 저를 깨울 수 있나요?

유료 플랜에서 `"level": "critical"`을 쓰면 가능합니다. 프로덕션을 감시하는 routine, 예를 들어 모니터링 도구가 오류 급증 시 API로 호출하는 routine에만 아껴서 쓰세요.

### /loop나 데스크톱 예약 작업을 이용한 로컬 예약은 어떤가요?

이것들은 사용자의 컴퓨터에서 실행되므로, 로컬 Claude Code 훅과 MCP 서버를 평소처럼 사용할 수 있습니다. 설정 방법은 [Claude Code 푸시 알림](/blog/claude-code-push-notifications)에 있습니다. 더 많은 에이전트 활용 패턴은 [AI 에이전트 알림](/use-cases/ai-agent-alerts)을 참고하세요.

[무료 계정 만들기](/signup)를 하고 네트워크 시크릿을 추가한 뒤, 내일 아침 routine이 어떻게 되었는지 직접 알려 주도록 해 보세요.
