≡En resumen
- El system prompt define quién es el asistente, qué debe hacer, con qué límites y con qué información de contexto.
- En la API de Claude va en el parámetro system y se aplica a toda la conversación, con más peso que un mensaje cualquiera.
- Los mejores system prompts explican el objetivo y el porqué de cada regla, en lugar de acumular prohibiciones en mayúsculas.
- Un system prompt estable y al principio de la petición abarata el coste gracias a la caché.
- No es una barrera de seguridad infalible: no guardes secretos en él y protege las herramientas con permisos reales.
01 ¿Qué es un system prompt?
Cuando usas Claude en una web de atención al cliente, en un asistente interno o en una herramienta de programación, el modelo no empieza en blanco. Antes de tu primer mensaje ha recibido un system prompt: un texto que le dice qué papel tiene, qué empresa representa, qué puede y no puede hacer y cómo debe responder.
Es la herramienta principal para convertir un modelo generalista en un asistente concreto. Forma parte del prompt engineering, pero con una diferencia: no se escribe para una pregunta, sino para todas las conversaciones que tendrá ese asistente.
02 System prompt frente al mensaje del usuario
| Elemento | Quién lo escribe | Para qué sirve | Ejemplo |
|---|---|---|---|
| System prompt (system) | Operador o desarrollador | Papel, reglas, tono, contexto estable | Política de devoluciones y estilo de respuesta |
| Mensaje de usuario (user) | Persona o sistema que usa la app | La petición concreta del turno | «¿Puedo devolver un pedido de hace 20 días?» |
| Respuesta (assistant) | Claude | La contestación del modelo | La explicación de la política aplicada al caso |
| Mensaje de sistema intermedio | Operador | Instrucciones nuevas a mitad de conversación sin rehacer el principio | «A partir de ahora, responde en modo breve» |
En la API de Claude el system prompt va en el campo system, no como un mensaje más. Los modelos recientes aceptan también mensajes de sistema dentro de la conversación, útiles para cambiar de modo sin invalidar la caché. En las apps de Claude, las instrucciones de los proyectos de Claude cumplen un papel parecido para el usuario.
03 Qué debe incluir un buen system prompt
- ✓Papel y objetivo: quién es el asistente, para quién trabaja y qué resultado se espera de él.
- ✓Contexto del negocio: productos, servicios, horarios, políticas y datos que necesita conocer.
- ✓Reglas con su motivo: qué no debe hacer y por qué, para que sepa aplicar el criterio en casos no previstos.
- ✓Tono y formato: idioma, registro, longitud y si usa listas, tablas o texto plano.
- ✓Qué hacer ante la duda: cuándo preguntar, cuándo derivar a una persona y qué decir si no sabe algo.
- ✓Uso de herramientas: cuándo usar cada una y qué hacer con sus resultados.
- ✓Ejemplos breves de buenas respuestas, si el formato es exigente.
04 Ejemplo de system prompt para un asistente de empresa
Papel: eres el asistente de atención al cliente de una tienda de bicicletas con taller en Valencia. Ayudas a elegir bici, resolver dudas de pedidos y pedir cita en el taller.
Contexto: a continuación tienes el catálogo, la política de envíos y devoluciones y los horarios del taller. Usa solo esta información para precios y plazos.
Reglas: si te preguntan por un pedido, usa la herramienta de consulta; no supongas estados. No des consejos médicos sobre lesiones: recomienda consultar a un profesional. Si el cliente se enfada o pide hablar con alguien, ofrece el contacto del equipo.
Formato: español de España, de tú, respuestas de 2 a 4 frases salvo que pidan detalle.
Este tipo de configuración es la base de cualquier chatbot para empresas y de un agente de voz con IA: el modelo es el mismo, lo que cambia el resultado es la calidad de las instrucciones, el contexto y las herramientas.
05 El system prompt en los productos de Claude
claude.ai y apps
Anthropic publica en las notas de versión de su documentación los system prompts de sus apps, con fecha, para que se pueda ver cómo configura a Claude.
Claude Code
Tiene su propio system prompt y permite sustituirlo o ampliarlo con opciones de línea de comandos; CLAUDE.md añade el contexto del proyecto.
Agent SDK
Deja elegir entre un system prompt propio o el de Claude Code como base, con añadidos.
API
Lo escribes tú desde cero; la API no añade instrucciones de producto por su cuenta.
Ojo a la diferencia: el archivo CLAUDE.md no es el system prompt de Claude Code, sino memoria del proyecto que se carga como contexto. Sirve para lo mismo en la práctica (reglas, comandos, convenciones), pero conviene saber que convive con las instrucciones base del producto.
06 Técnicas para sacar más partido al system prompt
Caché de prompts
Coloca el system prompt y los documentos fijos al principio y márcalos para caché: las siguientes peticiones salen mucho más baratas.
Etiquetas XML
Separa secciones con etiquetas XML (por ejemplo, una para documentos y otra para reglas) para que el modelo distinga instrucciones de datos.
Variables por petición
Mete los datos que cambian (nombre del cliente, fecha) al final o en el mensaje del usuario, no en medio del bloque fijo.
Formato garantizado
Si necesitas JSON, no lo pidas solo en el prompt: usa salidas estructuradas.
La caché de prompts solo funciona si el principio de la petición es idéntico byte a byte, así que evita meter la hora actual o identificadores aleatorios en el system prompt. Para respuestas que alimentan otros sistemas, combina las instrucciones con salidas estructuradas.
07 Seguridad y errores comunes
- ✓Instrucciones contradictorias entre secciones que se fueron añadiendo con el tiempo.
- ✓Prompts heredados de modelos antiguos, demasiado prescriptivos para los modelos actuales.
- ✓Listas interminables de prohibiciones sin explicar el objetivo.
- ✓Información del negocio desactualizada (precios, horarios) que el asistente repite con seguridad.
- ✓No probar el prompt con conversaciones reales y casos difíciles antes de publicarlo.
Revisa el system prompt cada vez que cambies de modelo: lo que compensaba una carencia de una versión anterior puede sobrar en la siguiente. Si buscas plantillas, evaluadores de prompts y utilidades de la comunidad, tienes una selección en nuestro directorio de herramientas para Claude.
Preguntas frecuentes sobre System prompt (prompt de sistema)
Es el conjunto de instrucciones que recibe un modelo de IA antes de la conversación y que define su papel, sus reglas, su tono y el contexto con el que trabaja.
En el parámetro system de la Messages API, separado de la lista de mensajes. Los modelos recientes también aceptan mensajes de sistema dentro de la conversación.
El prompt del usuario es la petición de cada turno. El system prompt lo escribe el operador una vez y se aplica a todas las conversaciones del asistente.
Anthropic publica los system prompts de sus apps de consumo en las notas de versión de su documentación. Los de las aplicaciones de terceros dependen de cada empresa.
Lo necesario para que el asistente tenga contexto y criterio. Puede ser un párrafo o varias páginas con documentación; lo importante es que sea claro, sin contradicciones y estable para aprovechar la caché.
Ayuda, pero no es infalible. Combínalo con permisos limitados en las herramientas, validaciones en tu código y revisión humana para acciones sensibles.
Conviene revisarlo. Los modelos nuevos siguen las instrucciones con más precisión, así que reglas pensadas para corregir defectos de versiones anteriores pueden sobrar o volver rígidas las respuestas. Pruébalo con conversaciones reales antes de migrar.
Fuentes consultadas
Sobre el autor
Development Manager en appyweb
Dirige el equipo de desarrollo de appyweb: aplicaciones web y móviles, SaaS, integraciones y arquitectura de software.
Ver perfil y artículos → Ver perfil en LinkedIn ↗