Cómo crear un agente de chat con IA para tu negocio + Claude Code

Vas a crear un chatbot de atención al cliente completamente funcional, con personalidad propia y lenguaje natural, listo para embeber en cualquier web. Lo más importante: no vas a escribir código manualmente. Usarás Claude Code como tu asistente de desarrollo que construirá todo mientras tú tomas las decisiones.

npm install -g @anthropic-ai/claude-code

Una vez instalado, crea una carpeta para tu proyecto y accede a ella. Al ejecutar `claude`, se abre una interfaz interactiva donde describes lo que quieres construir y Claude Code ejecuta las acciones necesarias.

mkdir mi-proyecto-chatbot
cd mi-proyecto-chatbot
claude

Claude generará automáticamente un archivo estructurado con: descripción del proyecto, stack tecnológico, estructura de archivos, convenciones de nombrado, y reglas de negocio. Tú solo revisas y corriges si algo no es correcto.

docker run -d --name n8n -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

Importante: Cuando abras la credencial creada en n8n, fíjate en la URL del navegador. Verás algo como `https://tu-n8n.com/credentials/123`. Ese número (123) es el ID de la credencial que necesitarás para que Claude Code configure el workflow correctamente.

Aquí ocurre la magia. En lugar de arrastrar nodos manualmente en la interfaz de n8n, le describes a Claude Code exactamente qué necesitas y él construye el JSON del workflow completo, lo valida y lo despliega vía API directamente en tu instancia.

Claude Code generará el archivo JSON del workflow y lo desplegará automáticamente usando la API de n8n. Verás en la terminal cómo crea los nodos, configura las conexiones y activa el webhook. El buffer de 3 segundos es clave: si el usuario envía 3 mensajes seguidos, el agente los acumula y responde una sola vez en lugar de generar 3 respuestas separadas y confusas.

El system prompt es la 'personalidad' y el 'conocimiento' de tu agente. Define cómo habla, qué sabe sobre tu negocio y cómo estructura las respuestas. Claude Code te ayuda a redactarlo profesionalmente basándose en la información que le proporciones.

Claude generará un prompt estructurado con secciones claras. Aquí tienes un ejemplo completo de cómo queda el system prompt para el agente Luna:

Eres Luna, la asistente virtual oficial de la Academia de Idiomas GlobalTalk.

## IDENTIDAD Y TONO
Eres cercana, amable y profesional. Hablas como una persona real.
Tratas a cada persona de tú. Usas lenguaje natural e inclusivo.

## CÓMO ESCRIBIR TUS RESPUESTAS
Escribe como mensajes de WhatsApp: cortos y naturales.
Separa cada bloque con una línea en blanco.
Máximo 3 bloques por respuesta. Cada bloque: 1-2 frases.

## CIERRE DE CONVERSACIÓN
Nunca termines de forma seca. Siempre deja la conversación abierta.
Ejemplos: "Si quieres, te explico cómo es la primera clase de prueba."
Nunca uses: "¿Algo más?" ni "¿Necesitas algo más?"

## INFORMACIÓN DE LA ACADEMIA
### Qué es GlobalTalk
Academia de idiomas presencial y online. Inglés, francés y alemán.
Más de 2.000 estudiantes desde 2015.

### Primera clase de prueba
Gratuita y sin compromiso. Reserva en la web o por WhatsApp.

### Precios
Mensual: desde 89€ (2 clases por semana).
Trimestral: 240€.
Clases individuales: 35€/hora.

### Horarios
Mañanas: 9:00-13:00. Tardes: 16:00-21:00. Sábados: 9:00-14:00.

### Ubicación
Calle Gran Vía 45, Madrid.

### Contacto
Web: globaltalk.com | Email: hola@globaltalk.com | WhatsApp: en la web

## LÍMITES
- Solo información oficial y pública
- Si no sabes algo: "No tengo ese dato, contáctanos en hola@globaltalk.com"

Mensaje del usuario: {{ $json.chatInput }}

Antes de crear el widget visual, debes asegurarte de que el agente responde correctamente. Claude Code puede hacer pruebas directamente desde la terminal sin necesidad de abrir navegador, enviando peticiones curl al webhook y mostrándote las respuestas en tiempo real.

Claude ejecutará tests automáticos y te mostrará resultados formateados así:

=== TEST: ¿Cuánto cuesta? ===
[1] La tarifa mensual es desde 89€ con dos clases por semana.
[2] Si prefieres un pack trimestral, son 240€ y te ahorras algo.
[3] Si quieres, te cuento qué incluye cada opción o cómo es la clase de prueba gratuita.

=== TEST: ¿Hacéis clases de chino? ===
[1] Por ahora solo trabajamos inglés, francés y alemán.
[2] Si tienes interés en otros idiomas, puedes escribirnos a hola@globaltalk.com y lo valoramos.

Una vez que el backend funciona perfectamente, necesitas la interfaz visual que los usuarios verán en la web. Claude Code genera un archivo HTML único, sin dependencias externas, que incluye todo el CSS y JavaScript necesario.

• Botón flotante en esquina inferior derecha con icono de chat
• Panel de chat con header personalizado (logo, nombre, cerrar)
• Área de mensajes con burbujas diferenciadas (usuario vs agente)
• Animación de '...' mientras el agente 'escribe'
• Burbujas que aparecen secuencialmente con delay humanizado
• Input de texto con botón de enviar y soporte para Enter
• Responsive: se adapta a móvil (pantalla completa) y desktop
• Cierra al hacer clic fuera del panel
• Sin dependencias externas: no requiere jQuery, React, ni frameworks

El archivo resultante (`widget.html`) está listo para copiar y pegar directamente en WordPress, Webflow, o cualquier CMS que permita insertar HTML personalizado.

Claude ejecutará automáticamente el servidor local y creará un túnel. Te devolverá algo como:

URL pública: https://luna-chat-demo-xyz89.trycloudflare.com

El enlace es válido mientras mantengas esta sesión abierta.
Compártelo con el cliente para que pruebe el agente.

1. Entra al panel de WordPress
2. Crea una página nueva o edita la existente
3. Añade un bloque "HTML personalizado" (Custom HTML)
4. Copia y pega todo el contenido de widget.html
5. Publica o actualiza la página

El chat aparecerá inmediatamente en la esquina inferior derecha.

Una de las ventajas de este stack es su bajo coste operativo comparado con soluciones SaaS de chatbot que suelen costar cientos de euros mensuales. Y si no quieres mantenerlo tú, tienes el mismo tipo de agente, montado como servicio.