Estilos de salida de Claude Code: guía y configuración
Los estilos de salida modifican el prompt del sistema de Claude Code. Conoce los cinco incluidos, el cambio de v2.1.251 y cómo crear uno propio.
Qué es un estilo de salida en Claude Code
Un estilo de salida en Claude Code es un bloque de instrucciones que Claude Code añade a lo que envía a Claude con cada solicitud. Cambia la forma en que Claude te responde: el papel que adopta y la estructura de lo que muestra. No enseña nada a Claude sobre tu base de código ni puede darle permiso para ejecutar nada.
Claude Code incluye cinco estilos integrados. Tu elección se guarda en una sola clave de configuración, outputStyle. En Claude Code v2.1.251 o posterior, un estilo que cambias en mitad de una sesión se aplica a partir del siguiente mensaje. Desde v2.1.73 hasta v2.1.251, el cambio se guardaba y luego se ignoraba hasta que limpiabas la sesión; este hecho explica gran parte de la confusión que todavía encontrarás en las guías antiguas sobre esta función.
En un VPS, esto es más que una preferencia estética. La transcripción es lo que lees a través de una conexión SSH (secure shell), normalmente dentro de una ventana de tmux, por lo que cada línea que Claude narra es una línea que esperas y una línea en un búfer de desplazamiento de tamaño fijo.
Dónde se encuentra la configuración outputStyle
Seleccione un estilo en el menú /config, en Output style. Claude Code escribe la selección en .claude/settings.local.json, dentro del proyecto en el que está trabajando.
El comando /output-style hace lo mismo desde el prompt. Ejecute /output-style concise para cambiar de estilo, o /output-style sin argumentos para mostrar los estilos y ver cuál está seleccionado. Guarda la configuración en el mismo archivo .claude/settings.local.json, no distingue mayúsculas de minúsculas y también funciona en modo no interactivo. El comando descrito aquí llegó en Claude Code v2.1.269. Ya existía un comando /output-style en v2.0.30, pero quedó obsoleto en v2.1.73 en favor de /config. Por tanto, una compilación entre esas dos versiones puede no comportarse como se describe en esta página. Compruebe qué versión está ejecutando antes de seguir cualquier guía, incluida esta. Las versiones de esta página se comprobaron en octubre de 2026.
claude --versionTambién puede establecer la clave manualmente. Cuatro archivos de configuración pueden contenerla. El archivo más específico tiene prioridad sobre el más general.
~/.claude/settings.jsones el archivo de usuario. Se aplica a todos los proyectos de esa máquina..claude/settings.jsones el archivo del proyecto. Se confirma en git, por lo que se aplica a todas las personas que clonen el repositorio..claude/settings.local.jsones el archivo local del proyecto. No se confirma y tiene prioridad sobre los dos anteriores. Este es el archivo que escriben el menú/configy el comando/output-style.- La configuración administrada, desplegada por un equipo de TI desde una ruta del sistema como
/etc/claude-code/en Linux, tiene prioridad sobre todo lo demás.
El valor de la clave es el nombre del estilo:
{
"outputStyle": "Concise"
}El valor distingue mayúsculas de minúsculas. Escriba los nombres integrados como Proactive, Concise, Explanatory y Learning. Un valor que no coincida exactamente con un nombre de estilo, como concise, selecciona silenciosamente el estilo Default.
Para una sola sesión, pase la misma clave en la línea de comandos. El indicador --settings acepta una ruta o una cadena JSON insertada directamente. Sus valores tienen prioridad sobre las mismas claves de los archivos de configuración de usuario, del proyecto y locales durante esa ejecución. La configuración administrada sigue teniendo prioridad:
claude --settings '{"outputStyle": "Concise"}'La documentación enumera cuatro formas de seleccionar un estilo, pero sólo dos de ellas requieren una versión mínima. El menú /config del terminal no requiere ninguna. El comando /output-style, en su forma actual, requiere v2.1.269. El menú Output styles de la extensión de VS Code requiere v2.1.257. En la aplicación Desktop, establezca el campo outputStyle en un archivo de configuración. La clave outputStyle no tiene una versión mínima, por lo que es la opción más fiable. Si una captura de pantalla de cualquier guía deja de coincidir con lo que ve, establezca la clave directamente y confírmela con /status, que muestra las fuentes de configuración activas.
Cuándo entra en vigor un nuevo estilo de salida
En Claude Code v2.1.251 o posterior, un estilo que cambie durante la sesión, desde el comando, el menú o el archivo de configuración, se aplica a partir del mensaje siguiente. No necesita borrar la sesión. Desde v2.1.73 hasta v2.1.251, la sesión en ejecución conservaba el estilo con el que se inició y el nuevo sólo se cargaba con el siguiente /clear o en el siguiente inicio.
En el terminal, Claude Code lee los archivos de estilo al iniciarse. Por tanto, si crea o edita un archivo de estilo personalizado mientras una sesión está activa, reinicie Claude Code antes de seleccionarlo. En VS Code v2.1.261 o posterior, el asistente Build a custom style del menú Output styles crea el archivo y muestra el nuevo estilo inmediatamente. En una compilación de ese intervalo anterior, o después de reiniciar por una edición de un archivo de estilo del terminal, estos dos comandos permiten empezar desde cero y muestran lo que se ha cargado:
/clear
/context/context muestra qué ocupa actualmente la ventana de contexto, desglosado por categoría e incluido el mensaje del sistema. Ejecútelo en una sesión nueva con cada estilo. La línea del mensaje del sistema es el lado de entrada de la comparación. También es la forma más rápida de confirmar que se ha cargado un estilo personalizado. Para obtener una visión más amplia de lo que llena esa ventana, consulte cómo se llena el contexto en una sesión larga de Claude Code.
La caché explica este comportamiento. La API atiende las solicitudes repetidas desde una caché de mensajes que coincide con el inicio de cada solicitud, y el mensaje del sistema está justo al principio. Reescribirlo durante una conversación invalidaría todo lo que viene después, por lo que el turno siguiente tendría que procesar de nuevo todo el historial como entrada nueva. Las compilaciones desde v2.1.73 hasta v2.1.251 evitaban ese coste fijando el estilo al inicio de la sesión. Las compilaciones actuales entregan las instrucciones del nuevo estilo como un mensaje de la conversación. Así, la solicitud posterior al cambio sigue leyendo el mensaje del sistema y la conversación anterior desde la caché. Cambiar de estilo es barato en ambos casos.
Qué cambia cada estilo de salida integrado en el registro
- Default es el mensaje del sistema normal de Claude Code, escrito para tareas de ingeniería de software.
- Concise empieza por el resultado. Elimina la introducción y la narración paso a paso, y mantiene las respuestas breves hasta que solicite más detalles. El trabajo de ingeniería que hay detrás no cambia. Nunca acorta un informe de errores ni una advertencia de seguridad, y sigue solicitando confirmación completa antes de una acción destructiva. Este estilo requiere Claude Code v2.1.237 o posterior.
- Explanatory añade «Insights» educativos entre los pasos de una tarea. Explica por qué se tomó una decisión de implementación y qué patrón utiliza ya el código base. El registro se alarga de forma intencionada.
- Learning va más allá. Claude comparte esos análisis y después le pide que escriba pequeñas partes del código, marcando cada lugar con un comentario
TODO(human)en el archivo. - Proactive hace que Claude actúe en lugar de preguntar. Toma decisiones razonables en tareas rutinarias en vez de detenerse para solicitar confirmación.
Lea atentamente el último punto, porque es el que más se malinterpreta. Proactive es una directiva del mensaje del sistema. Cambia lo que Claude intenta hacer. El modo de permisos sigue determinando qué se ejecuta realmente sin preguntarle. Este es el ajuste importante en un servidor que permanece en ejecución sin supervisión. Esto se explica en el modo automático y los modos de permisos de Claude Code.
En qué se diferencia un estilo de salida de CLAUDE.md, un hook y un subagente
Todas estas opciones parecen indicarle a Claude cómo debe comportarse, pero actúan en capas diferentes.
- Un estilo de salida forma parte de las instrucciones que Claude Code envía con cada solicitud. Se aplica a todas las respuestas de la conversación principal.
- CLAUDE.md se añade como mensaje de usuario después del prompt del sistema. Aquí deben incluirse las convenciones del proyecto y los datos del código base.
--append-system-promptañade texto al prompt del sistema para una única ejecución, sin eliminar nada. Es la versión puntual de un estilo de salida.- Un hook es un comando de shell que Claude Code ejecuta cuando se activa un evento. El arnés lo aplica, por lo que se ejecuta independientemente de que Claude lo hubiera elegido. Consulte qué puede hacer un hook de Claude Code y qué no.
- Un subagente se ejecuta con su propio prompt del sistema y su propio conjunto de herramientas.
Una prueba breve permite decidir entre las dos primeras opciones. Los datos del proyecto deben incluirse en CLAUDE.md, porque Claude necesita conocerlos. La redacción debe incluirse en un estilo de salida, porque determina cómo se lee la respuesta. Todo lo que deba ocurrir siempre, independientemente de lo que decida el modelo, debe configurarse como hook. La capa en la que se encuentra cada opción depende de el programa que ejecuta el modelo y no del modelo en sí. Por eso, un estilo sólo puede influir, mientras que un hook puede imponer un comportamiento.
Los estilos de salida sólo se aplican a la conversación principal. Un subagente no hereda el estilo, porque inicia su propia conversación con su propio prompt del sistema. Una bifurcación de la conversación actual es la excepción, ya que hereda exactamente el prompt del sistema de la conversación principal. Si un subagente escribe de una forma que no le gusta, edite el archivo de ese agente en lugar de modificar su estilo. Una segunda sesión de Claude Code en el mismo equipo respeta el mismo límite: lee sus propios archivos de configuración al iniciarse. Por tanto, cuando asigna trabajo a otra sesión que se ejecuta en paralelo con la suya, sus respuestas utilizan el estilo que esa sesión cargó, no el suyo.
Cómo escribir tu propio estilo de salida
Un estilo de salida personalizado es un archivo Markdown con frontmatter. Guárdalo en tu directorio personal para usarlo en todos los proyectos, o dentro del repositorio para mantenerlo junto con el código. El directorio del usuario es ~/.claude/output-styles/ y el directorio del proyecto es .claude/output-styles/.
mkdir -p ~/.claude/output-styles
cat > ~/.claude/output-styles/terse-ops.md <<'EOF'
---
name: Terse ops
description: Command first, explanation after, for SSH sessions
keep-coding-instructions: true
---
Lead with the command or the file change. Put the explanation after it, in two sentences or fewer.
Do not narrate what you are about to do. Report what you did.
When a command can fail, print the one check that proves it worked and say what a healthy result looks like.
EOFInicia una sesión y abre /config. Tu estilo aparece en la lista Estilo de salida con la descripción que escribiste. Si no aparece, el archivo no se está leyendo: comprueba la ruta y reinicia Claude Code si la sesión ya estaba activa cuando guardaste el archivo. Si aparece con el nombre del archivo pero sin descripción, el frontmatter no se pudo analizar; claude --debug muestra el error de análisis. El nombre del archivo se convierte en el nombre del estilo, salvo que el frontmatter establezca name. Por eso este se llama Terse ops y no terse-ops.
Selecciónalo o establece la clave con ese nombre exacto y con las mismas mayúsculas:
{
"outputStyle": "Terse ops"
}Un campo determina si tu archivo es un ajuste o un reemplazo. keep-coding-instructions tiene el valor predeterminado false, lo que significa que un estilo personalizado descarta las instrucciones integradas de ingeniería de software de Claude Code y funciona sólo con tu texto. Esas instrucciones integradas indican a Claude cómo delimitar un cambio y cómo verificar su trabajo. Omite el campo para un asistente de escritura o un analista de datos, cuando nada de eso sea aplicable. Establécelo en true para cualquier caso que siga afectando al código; de lo contrario, te preguntarás por qué un ingeniero cuidadoso dejó de comprobar su propio trabajo. Sólo el system prompt completo de Claude Code contiene esa sección, por lo que el campo no tiene efecto con el system prompt más corto. Establecer la variable de entorno CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT en 0 selecciona el prompt completo en cualquier modelo. Si lo que realmente buscas no es una voz diferente, sino una definición más precisa de cuánto trabajo merece una tarea, eso corresponde a las instrucciones de ingeniería y no al archivo de estilo: la skill Ponytail es un ejemplo práctico, una sola regla que orienta al agente hacia el cambio funcional más pequeño.
description es la línea que el selector /config muestra junto al nombre. Escríbela pensando en el momento en que, dentro de seis meses, tengas que elegir entre dos de tus propios estilos.
Por qué el estilo conciso es diferente por SSH
En un VPS, lees la sesión a través de varias capas que no existen en un terminal local, y cada capa penaliza la verbosidad.
El desplazamiento es lo primero. En tmux, cada panel conserva un número fijo de líneas, definido por history-limit, cuyo valor predeterminado es 2000. Una sesión narrada llena ese búfer más rápido, por lo que la parte inicial de la sesión se elimina antes y desaparece la salida a la que querías volver. Auméntalo si necesitas más espacio:
echo 'set -g history-limit 20000' >> ~/.tmux.conf
tmux source-file ~/.tmux.confLos paneles creados después conservan 20000 líneas cada uno, a cambio de consumir más memoria por panel. En tmux 3.7 o posterior, cambiar history-limit también actualiza los paneles que ya están abiertos; las versiones anteriores sólo lo aplican a los paneles nuevos. Si todavía estás preparando la distribución de la sesión, ejecutar Claude Code dentro de tmux en un VPS explica cómo hacerlo.
La latencia es lo segundo. La respuesta se transmite a tu terminal mientras se genera. En una conexión con un tiempo de ida y vuelta elevado, un preámbulo largo es tiempo que pasas viendo aparecer texto antes de que se muestre la respuesta.
Los tokens de salida son lo tercero. Cada línea narrada se factura como salida. Explanatory y Learning son más largos por diseño. Concise es más corto por diseño, porque indica a Claude que mantenga las respuestas breves de forma predeterminada.
No confíes en un porcentaje de ninguna fuente, incluida esta página. El tamaño de la diferencia depende de tus prompts, tu modelo y el trabajo que le pidas, así que mide tus propios resultados antes y después. Ejecuta la misma tarea real en dos sesiones nuevas, una con Default y otra con Concise, y compáralas. Una statusline es el medidor más sencillo, porque Claude Code entrega a tu script un objeto JSON en stdin que ya contiene el nombre del estilo, los tokens de salida de la última respuesta y una estimación acumulada del coste de la sesión:
cat > ~/.claude/statusline.sh <<'EOF'
#!/bin/bash
input=$(cat)
style=$(echo "$input" | jq -r '.output_style.name // "default"')
out=$(echo "$input" | jq -r '.context_window.total_output_tokens // 0')
cost=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
echo "style=$style out=$out cost=$cost"
EOF
chmod +x ~/.claude/statusline.shIndica esa configuración statusLine:
{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh"
}
}La barra situada en la parte inferior de la sesión muestra ahora el estilo activo junto al tamaño de la respuesta más reciente y el coste estimado de la sesión hasta ese momento. out sólo cubre la última respuesta, por lo que muestra cuánto dura cada respuesta. cost acumula los valores, así que la cifra al final de cada ejecución es la comparación entre el antes y el después. Léela antes de borrar la sesión, porque el coste vuelve a $0 cuando /clear inicia una sesión nueva, y considérala una estimación, no tu factura. El script necesita jq, el analizador JSON de línea de comandos, así que instálalo primero con sudo apt install -y jq. Si la barra permanece vacía, ejecuta el script manualmente y pásale JSON mediante una tubería, porque una statusline que termina con un código distinto de cero no muestra ni informa de nada. Una statusline personalizada de Claude Code enumera el resto de los campos de ese objeto. Para la facturación, en lugar de la sesión, consulta a dónde van realmente los tokens de Claude Code y las herramientas que registran el gasto de Claude Code.
Cómo comprobar qué estilo de salida está cargado realmente
Use estas comprobaciones en lugar de hacer suposiciones.
/statusmuestra las fuentes de configuración activas para esta sesión, incluida la indicación de si se están aplicando ajustes administrados por una organización./contextmuestra el mensaje del sistema cargado como una categoría en el desglose de la ventana de contexto.claude doctor, ejecutado desde el shell sin iniciar una sesión, muestra diagnósticos de instalación y configuración, e informa de los archivos de configuración que no son válidos.
Cuando un estilo no se aplica, la causa casi siempre es una de estas dos. La primera es el momento del cambio: en una compilación de v2.1.73 hasta v2.1.251, un cambio durante la sesión espera a /clear, y en el terminal un archivo de estilo creado o editado durante la sesión espera a que se reinicie. La segunda es la precedencia: .claude/settings.local.json sustituye a .claude/settings.json, y ambos sustituyen a ~/.claude/settings.json. Como el selector /config y el comando /output-style escriben en el archivo local, un estilo que su equipo haya confirmado en .claude/settings.json queda anulado silenciosamente en cualquier máquina donde alguien haya usado alguna vez uno de los dos. /status indica qué archivos se han cargado, pero no cuál proporcionó la clave. Abra cada archivo que enumere y busque outputStyle.
Un error de sintaxis JSON produce el mismo síntoma, pero requiere una corrección distinta. claude doctor indica el nombre del archivo que no pudo analizar, por lo que conviene ejecutarlo antes de buscar una causa más compleja. Un valor con mayúsculas o minúsculas incorrectas, como explanatory, es JSON válido y aun así produce el estilo Default. Compruebe también las mayúsculas.
FAQ
¿Por qué dejó de funcionar el comando /output-style?
En una compilación actual no ha dejado de funcionar. /output-style muestra los estilos y /output-style concise cambia a uno de ellos. El comando tiene un periodo concreto en su historial: v2.1.73 lo declaró obsoleto en favor de /config, y v2.1.269 añadió la forma actual /output-style [name]. Por tanto, en una compilación entre esas dos versiones puede no funcionar como se describe aquí. Ejecute claude --version para comprobar qué versión tiene. En cualquier compilación puede seleccionar el estilo desde /config, en Output style, o establecer la clave outputStyle en un archivo de configuración. La documentación no indica una versión mínima para la clave, por lo que establecerla directamente es la instrucción que conviene anotar.
He cambiado el estilo de salida y no ha ocurrido nada. ¿Por qué?
Compruebe primero la versión. En Claude Code v2.1.251 o posterior, un estilo cambiado durante la sesión se aplica a partir del mensaje siguiente. Desde v2.1.73 hasta v2.1.251, el cambio se guardaba, pero sólo se aplicaba después de /clear o en una sesión nueva. En el terminal, un archivo de estilo personalizado creado o editado durante la sesión requiere un reinicio, porque Claude Code lee los archivos de estilo al iniciarse. Si aún no se aplica, compruebe que el valor coincida exactamente con el nombre del estilo, incluidas las mayúsculas, y ejecute /status para ver qué archivos de configuración se han cargado, ya que .claude/settings.local.json sustituye a .claude/settings.json y ambos sustituyen a ~/.claude/settings.json.
¿El estilo de salida Concise permite ahorrar dinero?
Reduce los tokens de salida en la dirección esperada, porque indica a Claude que mantenga las respuestas breves de forma predeterminada. La cantidad depende de sus instrucciones y del modelo, por lo que debe considerar cualquier porcentaje publicado como una medición del trabajo de otra persona. Mida sus propios resultados: ejecute /context en una sesión nueva con cada estilo para el lado de entrada. Después, ejecute la misma tarea con cada estilo y compare los tokens de salida y el coste estimado. Concise nunca acorta un informe de error ni una advertencia de seguridad, por lo que las partes que más necesita leer se mantienen completas.
¿Un estilo de salida cambia la forma en que escriben mis subagentes?
No. Los estilos de salida sólo se aplican a la conversación principal, porque un subagente inicia su propia conversación con su propio mensaje del sistema y su propio conjunto de herramientas. Una bifurcación de la conversación actual es la excepción, ya que hereda exactamente el mensaje del sistema de la conversación principal. Para cambiar la forma en que responde un subagente, edite su propio archivo.
¿Un estilo de salida permite que Claude ejecute comandos sin pedir confirmación?
No. Un estilo de salida es texto del mensaje del sistema, por lo que sólo puede influir en lo que Claude intenta hacer. El estilo Proactive hace que Claude dé por supuestas y ejecute las decisiones rutinarias en lugar de detenerse, pero aun así no puede aprobar un comando. El modo de permisos determina qué se ejecuta sin solicitar confirmación. Compruebe ese ajuste antes de dejar una sesión activa en un servidor.