Prompt de sistema
Un prompt de sistema es el bloque de instrucciones que precede a la conversación en cada petición al modelo y establece su función y las reglas que debe seguir.
En la API de Claude es el parámetro system, separado de los mensajes. En un agente de código lo escriben los creadores de la herramienta antes de que el usuario teclee nada. Define su comportamiento, el uso de herramientas y el formato de las respuestas. Claude Code permite sustituirlo con --system-prompt o ampliarlo con --append-system-prompt.
Hay otras capas. La API de Anthropic añade instrucciones propias cuando se declaran herramientas o se activa el razonamiento; cada petición incluye las definiciones de herramientas que ofrece el cliente. CLAUDE.md no forma parte del prompt de sistema: Claude Code lo carga como mensaje de usuario después de este.
Al repetirse entre peticiones, la caché puede servirlo a precio reducido tras el primer envío. Cambiarlo, en cambio, sale caro. Anthropic guarda el prefijo en el orden herramientas, sistema y mensajes; editar el prompt de sistema invalida lo que viene después y la siguiente petición vuelve a procesar la conversación.
Las instrucciones de una sola tarea pertenecen a la conversación. El modo de planificación y las skills de Claude Code añaden sus instrucciones como mensajes, con lo que conservan el prefijo ya cacheado.