CallMe: Plugin de Claude Code para llamadas telefónicas — Configuración rápida
CallMe – El plugin minimalista de Claude Code para llamadas telefónicas
Si alguna vez soñaste con que Claude terminara una tarea y luego te llamara para discutir los siguientes pasos, CallMe convierte ese deseo en realidad. Es un plugin de código abierto ultra ligero que transforma Claude Code en un asistente con voz. Ya sea que quieras mantenerte informado después de una revisión de código o recibir retroalimentación instantánea sobre una función, CallMe te entrega una llamada telefónica en lugar de un correo electrónico o un mensaje de Slack.
El plugin admite dos proveedores de API de voz populares – Telnyx (recomendado por su bajo costo) y Twilio – y utiliza ngrok para exponer webhooks locales de forma segura. Una vez configurado, el plugin ofrece cuatro herramientas convenientes a tus solicitudes:
| Herramienta | Función |
|---|---|
initiate_call |
Iniciar una nueva llamada telefónica |
continue_call |
Preguntar una pregunta de seguimiento |
speak_to_user |
Hablar sin esperar una respuesta |
end_call |
Terminar la conversación |
A continuación, un tutorial completo y paso a paso que hará que CallMe suene en tu bolsillo en minutos.
Prerequisitos
| Elemento | Por qué lo necesitas |
|---|---|
| Un número de teléfono | El número desde el que Claude marcará |
| Una cuenta de Telnyx o Twilio | Acceso a la API de voz y administración de webhooks |
| Una cuenta de OpenAI | Servicios TTS (Texto‑a‑voz) y STT (voz‑a‑texto) |
| Cuenta de ngrok | Túnel del servidor HTTP local a internet público |
git y un CLI moderno |
Clonar el repositorio y ejecutar comandos |
Todos los proveedores ofrecen una capa gratuita, haciendo que el costo sea prácticamente nulo durante las pruebas.
1️⃣ Configurar el proveedor
Opción A: Telnyx (recomendado)
- Visita portal.telnyx.com y verifica tu cuenta.
- Solicita un número de teléfono (~$1/mes).
- Crea una aplicación Voice API:
- Webhook URL:
https://<your‑ngrok‑url>/twiml - API version:
v2 - Copia el Application ID y el API Key.
- (Opcional) En Account Settings → Keys & Credentials, copia la Public Key para la firma del webhook.
Opción B: Twilio (alternativa)
- Regístrate en twilio.com y obtén el número de prueba gratuito.
- Copia el Account SID y el Auth Token del panel.
2️⃣ Configurar Variables de Entorno
Crea un archivo JSON en ~/.claude/settings.json (recomendado) con la siguiente estructura:
{
"env": {
"CALLME_PHONE_PROVIDER": "telnyx",
"CALLME_PHONE_ACCOUNT_SID": "YOUR_APPID_OR_SID",
"CALLME_PHONE_AUTH_TOKEN": "YOUR_API_KEY_OR_TOKEN",
"CALLME_PHONE_NUMBER": "+15551234567",
"CALLME_USER_PHONE_NUMBER": "+15559876543",
"CALLME_OPENAI_API_KEY": "sk-…",
"CALLME_NGROK_AUTHTOKEN": "YOUR_NGROK_TOKEN"
}
}
Tip: Para Twilio simplemente cambia el valor de
CALLME_PHONE_PROVIDERy reemplaza las dos entradas SID/Token.
Si optaste por la firma opcional del webhook, añade:
"CALLME_TELNYX_PUBLIC_KEY": "YOUR_PUBLIC_KEY"
Todas las demás variables de entorno son opcionales y tienen valores por defecto razonables.
3️⃣ Instalar el Plugin
# En Claude Code
/plugin marketplace add ZeframLou/call-me
/plugin install callme@callme
Reinicia Claude Code para cargar las nuevas herramientas.
4️⃣ Ejecutar el Servidor MCP Local
El plugin incluye un servidor MCP (Multi‑Channel Provider) ligero que crea automáticamente un túnel ngrok.
cd call-me
bn run dev # (o bun run dev si tienes bun instalado)
El servidor mostrará la URL pública; esta es tu punto de entrada para el webhook.
5️⃣ Iniciar una Llamada
En tu prompt de Claude, ahora puedes invocar las herramientas. Por ejemplo:
¡Has terminado el flujo de autenticación! Llámame para discutir los próximos pasos.
Claude responderá con:
{
"tool": "initiate_call",
"arguments": {
"message": "¡Hola! He terminado el sistema de autenticación. ¿En qué debería trabajar ahora?"
}
}
Claude marcará la llamada, tocará tu teléfono y te permitirá hablar. Durante la conversación, puedes
continue_call
o usar
speak_to_user
para manejar la voz sin bloqueo.
6️⃣ Instantánea de Costos
| Artículo | Telnyx | Twilio |
|---|---|---|
| Llamada saliente por minuto | ~\$0.007 | ~\$0.014 |
| Número de teléfono por mes | ~\$1 | ~\$1.15 |
| OpenAI TTS / STT | ~\$0.02/min | Igual |
| Totales | ~\$0.03–$0.04/min | ~\$0.04–$0.05/min |
Todos los valores son estimaciones y varían según el volumen de uso.
7️⃣ Guía de Solución de Problemas
| Problema | Causa Probable | Solución |
|---|---|---|
| Claude no usa la herramienta | Variables de entorno faltantes | Añade todas las variables obligatorias a settings.json |
| No suenan llamadas | URL del webhook incorrecta | Asegúrate de que la URL coincida con la salida del ngrok |
| Problemas de audio | Número de teléfono no verificado | Re‑verifica el número del proveedor |
| Errores de ngrok | Token de autenticación incorrecto | Regenera y establece CALLME_NGROK_AUTHTOKEN |
| Nombre de herramienta incorrecto | Versión antigua de Claude Code | Actualiza a la última versión del plugin |
Revisa claude --debug para obtener registros detallados de MCP.
8️⃣ Uso Avanzado
Voz TTS Personalizada
Añade una línea a tu entorno:
"CALLME_TTS_VOICE": "onyx" // opciones: alloy, echo, fable, onyx, nova, shimmer
Usar un Dominio ngrok Personalizado
Si tienes un plan pago de ngrok, configura:
"CALLME_NGROK_DOMAIN": "mycustom.ngrok.io"
El servidor MCP se vinculará a ese dominio.
9️⃣ Escalado y Despliegue
Si bien el servidor MCP local funciona bien para prototipos, puedes contenerizarlo o exponerlo mediante una función en la nube. El repositorio ya incluye un Dockerfile y el comando bun run dev para crear fácilmente imágenes Docker.
docker build -t callme .
docker run --env-file ~/.claude/settings.json -p 3333:3333 callme
Una vez desplegado, apunta la URL del webhook del proveedor al punto final público.
📌 Conclusión
CallMe le brinda a Claude la carencia de un toque humano a través de una llamada telefónica real, combinando comprensión del lenguaje natural, TTS/STT y telefonía en un esfuerzo mínimo. Ya sea que estés construyendo una startup remoto‑primero, orquestando un equipo distribuido o simplemente quieras una forma más atractiva de interactuar con Claude, el plugin entrega comunicación inmediata y sin manos.
¿Listo para probarlo? Clona el repositorio, configura Telnyx o Twilio, y deja que Claude suene en tu teléfono. ¡Feliz llamada!