01 Por qué un solo agente no escala
El primer agente que monta casi todo el mundo acaba siendo un cajón de sastre: un CLAUDE.md enorme que mezcla correo, tienda online, documentación interna y atención al cliente. Al principio funciona; a las pocas semanas elige mal las herramientas, consume contexto en cada turno con instrucciones que no tocan y nadie sabe si se ha caído hasta que alguien se queja.
La solución es la de siempre en software: separar responsabilidades. Cada pieza hace una cosa, tiene sus propias instrucciones y su propio contexto, y se comunica con las demás por un canal sencillo y auditable.
02 Las tres capas
1. Enrutador
Único punto de entrada. Recibe el mensaje (por ejemplo de Telegram), decide a qué especialista corresponde y devuelve la respuesta por el mismo canal. No resuelve nada por su cuenta.
2. Especialistas
Un agente por dominio: correo, conocimiento de la empresa, tienda online, finanzas. Cada uno en su carpeta, con sus herramientas MCP y solo su contexto.
3. Subagentes
Dentro de cada especialista, tareas finas con su propio archivo en .claude/agents/: clasificar, redactar, resumir, investigar. El especialista coordina; ellos ejecutan.
Monitor de salud
Un agente mínimo que lee un registro de agentes, comprueba cuándo respondió cada uno por última vez y avisa si alguno está caído o lento.
03 Estructura de carpetas
La forma más simple de comunicar agentes es mediante archivos: el enrutador deja el mensaje en la bandeja de entrada del especialista y recoge la respuesta de su bandeja de salida. Es lento comparado con una cola de mensajes, pero se puede leer, auditar y depurar con un editor de texto.
mkdir -p ~/agentes/{monitor,enrutador,correo,empresa,tienda}/{entrada,salida,logs}
mkdir -p ~/agentes/{correo,empresa,tienda}/.claude/agents
echo '{"agentes":["monitor","enrutador","correo","empresa","tienda"]}' > ~/agentes/registro.json- ✓Cada carpeta de agente tiene su propio CLAUDE.md, corto y centrado en su papel.
- ✓Los subagentes del especialista viven en su .claude/agents/ como archivos Markdown con frontmatter (name, description, tools).
- ✓Las credenciales van en variables de entorno o en la configuración MCP del agente que las necesita, nunca en el CLAUDE.md.
- ✓Cada mensaje en entrada/ y salida/ lleva marca de tiempo y canal de origen, para poder reconstruir cualquier conversación.
04 Plantillas de instrucciones
# Enrutador
Tu única función es clasificar cada mensaje entrante y pasarlo al agente correcto. No respondes preguntas de negocio.
## Tabla de reparto
- Correo, bandeja, redactar o responder emails → correo
- Productos, tarifas internas, contratos, políticas → empresa
- Pedidos, stock, catálogo, reseñas → tienda
- Estado del sistema → monitor
- Otro tema → responde: «Aún no tengo un agente para eso; lo dejo anotado.»
## Procedimiento
1. Elige un único destino. Si dudas entre dos, pregunta al usuario cuál.
2. Escribe el mensaje original en ~/agentes/DESTINO/entrada/ con fecha, canal y remitente.
3. Espera la respuesta en ~/agentes/DESTINO/salida/. Si tarda más de 5 minutos, avisa al usuario.
4. Devuelve la respuesta sin reescribirla.# Agente de correo
Gestionas la bandeja del usuario: clasificar, resumir y preparar borradores.
## Permisos
- Puedes leer, etiquetar y crear borradores. Nunca envías ni borras correos.
- Un envío solo ocurre si el usuario lo confirma de forma explícita en un mensaje posterior.
## Subagentes
- clasificador: etiqueta hilos como acción, espera o archivo.
- redactor: prepara respuestas con el tono descrito en tono.md.
- resumidor: resume hilos largos en tres puntos.
## Forma de trabajar
Lee la petición de entrada/, delega en el subagente adecuado y deja el resultado en salida/. Si la petición no es de correo, responde indicando qué agente debería atenderla.En esta carpeta de agente, crea tres subagentes en .claude/agents/ siguiendo la documentación oficial de subagentes de Claude Code: [NOMBRE 1], [NOMBRE 2] y [NOMBRE 3]. Para cada uno: frontmatter con name, una description que explique cuándo usarlo y la lista mínima de tools que necesita; cuerpo con su objetivo, pasos, formato de salida y reglas. Ninguno debe tener permisos de escritura sobre sistemas externos salvo que te lo indique. Al acabar, muéstrame los tres archivos y explica por qué elegiste esas herramientas.05 Entrada por Telegram con canales
Claude Code tiene canales (en vista previa de investigación): servidores MCP que empujan mensajes a una sesión abierta y permiten responder por la misma vía. Telegram, Discord e iMessage están disponibles como plugins oficiales y necesitan Bun instalado. Es la forma más directa de que el enrutador reciba mensajes de tu móvil.
-
1
Crea el bot
En Telegram, habla con BotFather, envía /newbot, elige nombre y usuario terminado en bot y guarda el token.
-
2
Instala el plugin
Dentro de Claude Code, en la carpeta del enrutador, instala el plugin de Telegram del marketplace oficial y configúralo con el token.
-
3
Arranca con el canal activo
Reinicia Claude Code con la opción --channels para que empiece a escuchar al bot.
-
4
Empareja y restringe
Envía un mensaje al bot, introduce el código de emparejamiento y deja la política en lista blanca para que solo tú puedas escribirle.
# Dentro de Claude Code
/plugin install telegram@claude-plugins-official
/telegram:configure TU_TOKEN
# Reinicia con el canal activo
claude --channels plugin:telegram@claude-plugins-official
# Tras recibir el código del bot
/telegram:access pair CODIGO
/telegram:access policy allowlist06 Mantenerlo funcionando
| Necesidad | Opción | Límite a conocer |
|---|---|---|
| Revisión periódica dentro de una sesión | /loop con intervalo, por ejemplo /loop 1h revisa el estado de los agentes | La sesión debe seguir abierta y las tareas recurrentes caducan a los 7 días |
| Tareas programadas con archivos locales | Tareas programadas de Claude Code Desktop | El ordenador tiene que estar encendido |
| Tareas que no dependen de tu equipo | Rutinas en la nube con /schedule | Trabajan sobre un clon limpio, sin tus archivos locales |
# Mientras dure la sesión
caffeinate -dimsu &
# De forma permanente y con arranque tras un corte de luz
sudo pmset -a sleep 0 disksleep 0 autorestart 107 Errores habituales
El enrutador empieza a contestar
Le has añadido lógica de negocio. Déjalo en tabla de reparto y reglas de paso; todo lo demás va a los especialistas.
Un especialista hace demasiado
Divide en subagentes. Si su CLAUDE.md pasa de unas pocas decenas de líneas, probablemente estás mezclando tareas.
Acciones sin supervisión
Enviar correos, cambiar precios o stock debe requerir confirmación explícita. Configura permisos de herramientas, no solo instrucciones.
Nadie se entera de las caídas
Monta el monitor el primer día, antes que los especialistas, y que escriba alertas en un log que el enrutador pueda consultar.
Credenciales esparcidas
Un único lugar por agente para secretos, con los permisos mínimos de cada servicio y rotación periódica.
Preguntas frecuentes
No. Sirve cualquier ordenador que pueda quedarse encendido, incluido un servidor Linux. El Mac mini es popular por consumo y silencio, pero el patrón no depende del hardware.
El enrutador, el monitor y un solo especialista. Cuando ese especialista funcione bien durante un par de semanas, añade el siguiente.
Para empezar, los archivos son fáciles de inspeccionar y no requieren infraestructura. Si el volumen crece, puedes sustituir la capa de comunicación sin tocar las instrucciones de los agentes.
Puedes cobrar el diseño, la configuración y el mantenimiento. El uso de Claude debe ir a nombre del cliente, con su propia suscripción o su clave de API, no con la tuya.
Las sesiones abiertas se pierden y los /loop no se recuperan solos. Prepara un script de arranque que vuelva a abrir cada agente o usa tareas programadas persistentes.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.