Blog

Estilos de respuesta en Claude Code: cómo cambiar y crear uno propio

Markdown

Qué son los estilos de respuesta en Claude Code y en qué se diferencian de CLAUDE.md: cuatro estilos integrados, cómo cambiar mediante /config y cómo crear uno propio.

Leer el artículo completo

Si cada dos mensajes le pides a Claude Code que «responda de forma más breve», «explique con más detalle» o «actúe como editor, no como programador», puedes configurarlo una sola vez. Hay un ajuste específico para ello: los estilos de respuesta, llamados output styles en la interfaz. Un estilo cambia el rol, el tono y el formato de las respuestas a todos los mensajes posteriores hasta que lo cambies.

Un estilo cambia cómo responde Claude, no lo que sabe sobre tu proyecto. Puedes establecer el contexto del proyecto en el archivo CLAUDE.md; consulta la guía sobre cómo personalizar Claude.

Encontrarás información sobre cómo trabajar con Ailoot en la documentación.

¿Qué es un estilo de respuesta en Claude Code?

Puntos clave

Un estilo de respuesta (output style) es un conjunto de instrucciones que Claude Code añade a cada solicitud que haces. Define el rol, el tono y el formato de la respuesta, pero no cambia los conocimientos del modelo. Además del estilo habitual Default, hay cuatro estilos integrados: Proactive, Concise, Explanatory y Learning. Puedes cambiar entre ellos mediante /config → Output style.

Claude Code suele estar configurado como ingeniero: explica los pasos en detalle, planifica las modificaciones y comenta lo que está haciendo. Este es el estilo Default, un conjunto estándar de instrucciones para trabajar con código.

Un estilo de respuesta sustituye ese conjunto de instrucciones por el suyo. Con cada solicitud, Claude Code envía al modelo las instrucciones del estilo activo. Cuando se selecciona un estilo distinto de Default, también le recuerda a Claude qué estilo debe seguir a medida que avanza la conversación. Así que no tienes que repetir cómo quieres que responda.

Usa un estilo si quieres recibir habitualmente el mismo tipo de respuesta: respuestas más breves, explicaciones o el rol de corrector de textos o analista de datos en lugar de programador. Si necesitas que Claude recuerde las convenciones y la estructura de un proyecto específico, usa el archivo CLAUDE.md.

¿En qué se diferencia un estilo de respuesta de CLAUDE.md?

Puntos clave

Un estilo de respuesta sustituye las instrucciones predeterminadas de Claude Code y se aplica a todas las respuestas. CLAUDE.md añade un mensaje con el contexto del proyecto. Un estilo define cómo responder, mientras que CLAUDE.md establece qué debe tenerse en cuenta al trabajar en tu proyecto. Estas herramientas no interfieren entre sí.

Claude Code ofrece varias formas de influir en su comportamiento, y cada una cumple una función diferente.

HerramientaQué haceCuándo usarla
Estilo de respuestaSustituye las instrucciones predeterminadas y se aplica a todas las respuestasSi quieres un rol, tono o formato de respuesta diferente cada vez
CLAUDE.mdAñade contexto del proyecto después del mensaje del sistemaSi Claude debe conocer siempre las convenciones y la estructura del proyecto
--append-system-promptAñade contenido al mensaje del sistema al iniciarSi quieres añadir algo una sola vez mediante una opción de inicio
SubagentsInicia un asistente con su propio mensaje del sistema y sus propias herramientasSi necesitas un asistente independiente para una tarea especializada

Un estilo define la manera de responder, mientras que CLAUDE.md almacena el contexto del proyecto. No hace falta cambiar uno para que cumpla la función del otro.

¿Qué estilos integrados hay y cuándo conviene usar cada uno?

Puntos clave

Además de Default, hay cuatro estilos integrados. Proactive hace que Claude actúe de inmediato y formule menos preguntas de seguimiento. Concise ofrece respuestas breves y sin introducciones. Explanatory añade explicaciones mientras trabaja. Learning colabora contigo y te deja pequeños fragmentos de código para completar. Concise está disponible en Claude Code versión 2.1.237 y posteriores.

Proactive. Claude realiza la tarea de inmediato, hace suposiciones razonables cuando hay pequeñas incertidumbres y prefiere actuar a discutirlo. Este comportamiento es más autónomo que el modo automático y funciona sin cambiar el modo de acceso. El modo de acceso sigue determinando qué se puede ejecutar sin tu confirmación: el estilo hace que Claude sea más resolutivo, pero no elimina las protecciones frente a comandos peligrosos. Este estilo es adecuado si confías en la herramienta y no quieres que se detenga por cada pequeña aclaración.

Concise. Claude empieza por el resultado, omite las introducciones y las descripciones de su proceso, y mantiene las respuestas breves. Hace el trabajo con el mismo rigor que en Default y, si le pides una explicación, responderá con detalle. Los informes de errores, las advertencias de seguridad y las confirmaciones previas a acciones peligrosas siguen siendo completos: el estilo no los acorta. Este estilo es adecuado si quieres una respuesta breve y directa.

Explanatory. Mientras trabaja, Claude explica por qué ha elegido una solución y cómo está estructurado el código del proyecto. Las respuestas son más largas que en Default. Este estilo es adecuado si, además de obtener el resultado, quieres entender qué está pasando.

Learning. Un modo colaborativo: Claude no solo explica sus decisiones, sino que también deja en el archivo pequeños fragmentos de código marcados con TODO(human) para que los escribas tú. Este estilo es adecuado si quieres aprender haciendo y escribir parte del código por tu cuenta.

Consejo

Si no sabes por dónde empezar, elige Concise para obtener respuestas breves o Explanatory para entender el razonamiento detrás de las decisiones. Ambos son útiles si no escribes código a mano.

¿Cómo se cambia de estilo de respuesta?

Puntos clave

Ejecuta el comando /config en Claude Code y selecciona Output style; después, elige el estilo que quieras. Tu elección se guarda en el archivo .claude/settings.local.json del proyecto. En la versión 2.1.251 y posteriores, el nuevo estilo se aplica a partir del siguiente mensaje. En la extensión de VS Code, los estilos se seleccionan en el menú Output styles, disponible desde la versión 2.1.257.

Es posible que encuentres en instrucciones antiguas un comando independiente para los estilos. La documentación proporcionada describe la ruta de /config.

  1. Abrir la configuración

    /config
    

    Introduce el comando en el chat de Claude Code. Se abrirá el menú de configuración.

  2. Seleccionar Output style

    Busca la fila Output style en el menú y ábrela. Aparecerá una lista con Default y los cuatro estilos integrados, además de los tuyos, si has creado alguno.

  3. Elegir un estilo y seguir trabajando

    Selecciona el estilo que quieras. Claude Code guardará tu elección en .claude/settings.local.json dentro del proyecto actual. En la versión 2.1.251 y posteriores, el nuevo estilo se aplicará a partir del siguiente mensaje.

Si trabajas con la extensión de VS Code, abre el menú con el comando / y elige Output styles. Tu elección se guardará en el mismo archivo. El menú de estilos de la extensión está disponible desde la versión 2.1.257.

También puedes configurar un estilo sin usar el menú, indicándolo en el archivo de configuración:

{
  "outputStyle": "Explanatory"
}

Atención

Si cambias de estilo a mitad de una sesión, el cambio se aplica a partir del siguiente mensaje. Esto funciona en Claude Code versión 2.1.251 y posteriores. En las versiones anteriores, el nuevo estilo solo se aplicaba después del comando /clear o en una sesión nueva. Si el estilo «no cambia», comprueba primero la versión.

¿Cómo se crea un estilo de respuesta propio?

Puntos clave

Tu propio estilo es un archivo Markdown normal con una cabecera breve e instrucciones. Colócalo en la carpeta .claude/output-styles, en tu carpeta personal para todos los proyectos o dentro de un proyecto. El nombre del archivo se convierte en el nombre del estilo, salvo que se especifique name en la cabecera. Si creas el archivo durante una sesión de terminal, reinicia Claude Code y selecciona tu estilo mediante /config.

No necesitas programar para hacerlo: escribe el estilo en lenguaje sencillo. El archivo consta de una cabecera entre tres guiones (metadatos) y el texto de las instrucciones debajo.

La ubicación del archivo depende de los proyectos en los que quieras usar el estilo:

  • ~/.claude/output-styles — el estilo está disponible en todos tus proyectos.
  • .claude/output-styles dentro de un proyecto — el estilo solo se aplica a ese proyecto.

Ejemplo de un estilo que pide a Claude que responda como editor de textos profesionales en lugar de como programador:

---
name: Editor de textos
description: Responder como editor de textos profesionales, no como programador
---

Eres editor de textos profesionales. Responde en el idioma preferido del usuario y con párrafos breves.
Primero proporciona la versión corregida y, después, una lista de cambios con sus motivos.
No sugieras código ni hables de detalles técnicos a menos que te lo pidan.

En la cabecera, name es el nombre del estilo que verás en el menú /config; si lo omites, se usará el nombre del archivo. description es una breve explicación que también aparece en el menú.

También existe el campo keep-coding-instructions. De forma predeterminada, un estilo personalizado elimina las instrucciones de ingeniería integradas de Claude Code, como las relativas a cómo escribir comentarios, verificar el trabajo y limitar las modificaciones. Si quieres que Claude siga actuando como ingeniero con tu estilo de respuesta (por ejemplo, que siempre empiece con un diagrama), establece keep-coding-instructions: true en la cabecera. Si Claude no va a trabajar con código en este estilo, como en el ejemplo del editor, no necesitas este campo.

  1. Crear la carpeta de estilos

    mkdir -p ~/.claude/output-styles
    

    Así, el estilo estará disponible en todos los proyectos. Para un solo proyecto, usa .claude/output-styles dentro de él.

  2. Guardar el archivo Markdown

    Coloca en la carpeta un archivo como redaktor.md y añade la cabecera y las instrucciones. Puedes usar el ejemplo anterior y adaptarlo a tu tarea.

  3. Seleccionar el estilo y comprobarlo

    Si creaste el archivo durante una sesión de terminal, reinicia Claude Code primero. Abre /config, busca tu estilo en la lista Output style y selecciónalo. Dale a Claude una tarea relacionada con el estilo y comprueba si responde como quieres.

Atención

En el terminal de Claude Code, los archivos de estilo se leen al iniciarse. Si creas o editas un estilo mientras una sesión está en marcha, reinicia Claude Code; de lo contrario, no detectará el archivo nuevo.

Tu propio estilo define la forma de responder de la herramienta. La describes una vez y, a partir de ahí, la herramienta la conserva.

¿Qué no cambia un estilo de respuesta?

Puntos clave

Un estilo cambia la manera de responder, pero no aporta conocimientos nuevos al modelo ni sustituye CLAUDE.md. Se aplica a la conversación principal y a su rama (fork), pero no modifica el comportamiento de los subagents, que tienen su propio mensaje del sistema. Los plugins también pueden añadir sus propios estilos.

Un estilo no añade datos al modelo. Si Claude no sabe algo sobre tu proyecto, cambiar de estilo no lo resolverá: puedes proporcionar el contexto del proyecto mediante CLAUDE.md.

Un estilo se aplica a la conversación principal y a su rama, que hereda toda la conversación. Los subagents —asistentes independientes para tareas especializadas— funcionan con su propio mensaje del sistema, y el estilo no afecta a sus respuestas.

Los estilos también pueden proceder de plugins: un plugin los coloca en su propia carpeta output-styles. Ese estilo aparece en la misma lista que los tuyos.

¿Cuántos tokens cuesta un estilo?

Puntos clave

Las instrucciones del estilo se añaden a cada solicitud, por lo que aumentan ligeramente los tokens de entrada. Explanatory y Learning generan respuestas más largas y aumentan los tokens de salida, mientras que Concise los reduce. La caché de solicitudes reduce este coste adicional después del primer mensaje de una sesión.

Las instrucciones del estilo añaden tokens de entrada, pero la caché de solicitudes reduce este coste después de la primera solicitud de una sesión. La diferencia es más notable en los tokens de salida: Explanatory y Learning están pensados para ofrecer respuestas más largas, mientras que Concise las mantiene breves. En un estilo personalizado, el uso de tokens de salida depende de lo que especifiques en las instrucciones.

No es posible prometer un ahorro exacto: depende de tus tareas y del modelo. Si quieres respuestas más breves y menos costosas, elige Concise; si quieres más detalles, elige Explanatory.

¿Qué deberías hacer primero?

Puntos clave

Cambia a uno de los estilos integrados mediante /config y úsalo durante un día para comparar las respuestas con las que sueles recibir. Después, describe en texto sencillo el estilo de respuesta que usas habitualmente, guárdalo en un archivo dentro de .claude/output-styles y pruébalo con una tarea real.

Abre /config, elige Concise o Explanatory y úsalo para una tarea habitual. Si te encuentras pidiendo lo mismo una y otra vez, crea tu propio estilo siguiendo los pasos anteriores.

Para seguir con este tema: cómo personalizar Claude mediante CLAUDE.md, para que Claude recuerde el contexto del proyecto, y qué elegir en Claude Code: Skills, Subagents, MCP o Plugins, si quieres conocer otras formas de ampliarlo. Si Claude no puede ver los archivos que necesita, consulta por qué Claude Code no puede ver los archivos del proyecto.

Conoce Ailoot.

Más detalles

Preguntas sobre Claude Code

¿Debo poner los datos del proyecto en un estilo de respuesta o en CLAUDE.md?

Guarda los datos, la estructura y las convenciones del proyecto en CLAUDE.md. Utiliza un estilo de respuesta para un rol, tono o formato recurrentes. El estilo cambia cómo responde Claude; no aporta los datos del proyecto que falten.

¿Por qué no aparece mi nuevo estilo de respuesta personalizado?

Guarda su archivo Markdown en la carpeta .claude/output-styles del proyecto o del usuario y reinicia la sesión de terminal para que se cargue. Selecciónalo en /config y prueba una tarea pertinente. Usa keep-coding-instructions: true si debe conservar las instrucciones de ingeniería.

Todos los artículos