Notificaciones push de Claude Code con ntfy (hazlo tú mismo)

01Paso 1: elige un topic y suscríbete

ntfy no requiere registro. Un topic se crea la primera vez que alguien publica o se suscribe a él, y cualquiera que conozca el nombre puede leerlo. La propia documentación de ntfy dice que el topic es básicamente una contraseña, así que hazlo largo y aleatorio, por ejemplo claude-7f3k9q2xw4mz. Los nombres de topic admiten letras, números, guiones bajos y guiones, hasta 64 caracteres.

Instala la app de ntfy (App Store, Google Play o F-Droid), toca + y suscríbete a tu topic en ntfy.sh.

Comprueba que funciona desde una terminal:

curl -H "Title: Test" -d "Hello from my computer" https://ntfy.sh/claude-7f3k9q2xw4mz

El móvil debería vibrar en un segundo o dos. En Windows, curl.exe viene incluido en Windows 10 y 11 y acepta la misma línea.

02Paso 2: un script de hook (Mac y Linux)

Claude Code pasa a cada hook un objeto JSON por la entrada estándar. Ambos eventos comparten campos como cwd y hook_event_name. Notification añade message y notification_type, y Stop añade last_assistant_message, el texto de la última respuesta de Claude. Este script convierte cualquiera de los dos en un push legible. Necesita jq (brew install jq, o apt install jq en Debian y Ubuntu).

Guárdalo como ~/.claude/ntfy-notify.sh y ejecuta chmod +x ~/.claude/ntfy-notify.sh:

#!/bin/sh
TOPIC_URL="https://ntfy.sh/claude-7f3k9q2xw4mz"

input=$(cat)
event=$(printf '%s' "$input" | jq -r '.hook_event_name')
project=$(basename "$(printf '%s' "$input" | jq -r '.cwd')")

if [ "$event" = "Stop" ]; then
  title="Claude finished: $project"
  body=$(printf '%s' "$input" | jq -r '(.last_assistant_message // "Done") | .[0:300]')
  priority=3
else
  title="Claude needs you: $project"
  body=$(printf '%s' "$input" | jq -r '.message // "Needs your attention"')
  priority=4
fi

curl -s -H "Title: $title" -H "Priority: $priority" -H "Tags: robot" \
  -d "$body" "$TOPIC_URL" > /dev/null
exit 0

La prioridad va de 1 (mínima) a 5 (urgente). Tags añade un emoji a la notificación; robot muestra una cara de robot.

03Paso 3: conéctalo en settings.json

Añade los hooks a ~/.claude/settings.json. Si el archivo ya tiene un objeto hooks, añade estos eventos dentro en lugar de reemplazarlo.

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt",
        "hooks": [
          { "type": "command", "command": "~/.claude/ntfy-notify.sh" }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          { "type": "command", "command": "~/.claude/ntfy-notify.sh", "async": true }
        ]
      }
    ]
  }
}

"async": true hace que el hook Stop envíe en segundo plano, así una red lenta nunca retrasa a Claude. Inicia una nueva sesión de Claude Code, porque los hooks se cargan al empezar la sesión.

¿Stop o idle_prompt?

Stop se dispara en cuanto Claude termina, aunque estés delante del teclado. Si te resulta excesivo, quita el bloque Stop y usa el matcher permission_prompt|idle_prompt. Según la documentación de Anthropic, idle_prompt se dispara unos 60 segundos después de que Claude termine, solo si no has escrito nada desde entonces, y permission_prompt se dispara cuando una solicitud de permiso lleva unos seis segundos esperando sin que pulses ninguna tecla. Así tienes gratis un filtro aproximado de "solo cuando no estoy". La guía del Notification hook y la guía del Stop hook cubren todos los campos y tiempos.

04Windows (PowerShell)

En Windows, guarda esto como %USERPROFILE%\.claude\ntfy-notify.ps1. No necesitas instalar nada más:

$in = [Console]::In.ReadToEnd() | ConvertFrom-Json
$project = Split-Path $in.cwd -Leaf

if ($in.hook_event_name -eq 'Stop') {
  $title = "Claude finished: $project"
  $body = [string]$in.last_assistant_message
  if ($body.Length -gt 300) { $body = $body.Substring(0, 300) }
  $priority = '3'
} else {
  $title = "Claude needs you: $project"
  $body = [string]$in.message
  $priority = '4'
}

Invoke-RestMethod -Method Post -Uri 'https://ntfy.sh/claude-7f3k9q2xw4mz' `
  -Headers @{ Title = $title; Priority = $priority } `
  -Body ([Text.Encoding]::UTF8.GetBytes($body)) | Out-Null

Luego usa esta entrada de hook en lugar de las líneas command de arriba:

{
  "type": "command",
  "shell": "powershell",
  "command": "powershell -NoProfile -ExecutionPolicy Bypass -File \"$HOME\\.claude\\ntfy-notify.ps1\""
}

Si ejecutas Claude Code dentro de WSL, usa el script de Mac y Linux; para el hook, WSL es Linux.

05Mantenerlo privado

Todo lo que va en el push pasa por el servidor de ntfy, y en ntfy.sh cualquiera con el nombre del topic puede leerlo. El mensaje de Stop de arriba incluye el comienzo de la respuesta de Claude, que puede contener código o nombres de archivo. Tres formas de reforzarlo:

1. Envía menos. Sustituye el cuerpo de Stop por un texto fijo como "Done" y deja solo el nombre del proyecto en el título.
2. Usa un token de acceso. ntfy acepta -H "Authorization: Bearer tk_..." en cualquier publicación. En tu propio servidor, configura auth-default-access: "deny-all", crea un usuario con ntfy user add y un token con ntfy token add.
3. Monta tu propio servidor. ntfy se puede autoalojar. Para entrega instantánea en la app de iPhone, la documentación de ntfy indica configurar upstream-base-url: "https://ntfy.sh", que solo reenvía un ID de mensaje y un hash del topic a ntfy.sh para despertar el móvil; después la app descarga el mensaje desde tu servidor.

Si Claude Code corre en un servidor remoto, el mismo hook funciona allí sin cambios, lo que hace de ntfy una buena opción para notificaciones por SSH.

06Dónde encaja Claude Code Notifier

Para alertas en un solo sentido, la configuración de arriba es una solución completa y no vamos a intentar convencerte de lo contrario. Eso sí, se queda en avisarte. Cuando el push dice que Claude necesita un permiso, la sesión sigue esperando hasta que vuelvas al teclado.

ntfy admite botones de acción que hacen una petición HTTP, así que podrías montarte tú mismo una vía de respuesta: un hook PermissionRequest que publique la solicitud, espere una respuesta en un segundo topic y devuelva una decisión. Algunos proyectos open source hacen exactamente eso (consulta la comparativa).

Claude Code Notifier te da esa vía ya hecha. Con un móvil emparejado, puedes permitir una vez, permitir durante la sesión o denegar un permiso, elegir una respuesta cuando Claude hace una pregunta y enviar la siguiente instrucción cuando Claude termina, todo desde el móvil. También detecta si estás presente: si has escrito en los últimos 30 segundos, la terminal pregunta como siempre y no queda nada pendiente en el móvil. Si no estás, la terminal espera tu respuesta hasta el límite que configures, y deja de esperar en cuanto tocas el teclado. ccn funciona en Mac, Windows y Linux; consulta la página de ccn y los precios de las apps móviles.

07Preguntas frecuentes