- Para usar un estilo integrado, elija uno de los estilos de salida integrados y cambie a él.
- Para escribir sus propias instrucciones, cree un estilo de salida personalizado.
Un estilo de salida proporciona instrucciones a Claude para que las siga. No garantiza que algo siempre suceda o nunca suceda. Algunas necesidades se ajustan mejor a una característica diferente:
- Para lo que Claude debe saber sobre su proyecto, use CLAUDE.md.
- Para algo que tiene que suceder cada vez, como formatear después de cada edición o bloquear un comando, use un hook.
- Para skills, subagentes y las otras opciones, consulte Elegir entre un estilo de salida y otras características.
Estilos de salida integrados
Claude Code comienza en el estilo Default, sus instrucciones estándar para completar tareas de ingeniería de software. Cada uno de los otros cuatro estilos integrados mantiene esas instrucciones y añade las suyas propias. Esta tabla muestra qué cambia cada estilo en una sesión y cuándo es apropiado:Default
Default significa que no se selecciona ningún estilo de salida. Claude Code no añade instrucciones de estilo, y Claude trabaja desde el símbolo del sistema estándar de Claude Code, que está escrito para tareas de ingeniería de software.default aparece en la lista /output-style con los otros estilos, por lo que lo selecciona de la misma manera.
Proactive
En el estilo Proactive, Claude comienza a implementar tan pronto como envía una tarea. Realiza suposiciones razonables sobre decisiones rutinarias en lugar de detenerse para preguntar, y no cambia al modo de plan a menos que solicite un plan. Puede redirigirlo en cualquier momento. Las instrucciones del estilo también le dicen a Claude que se comunique con usted en la conversación antes de una acción que elimine datos o cambie un sistema compartido o de producción. Esa verificación es una instrucción que Claude sigue y es separada de los mensajes de permiso. Cambiar al estilo Proactive no cambia su modo de permiso. Su modo de permiso aún decide qué llamadas de herramienta se ejecutan sin preguntarle, por lo que los mensajes de permiso aparecen de la misma manera que antes de cambiar.Concise
En el estilo Concise, la primera oración de una respuesta indica qué sucedió o cuál es la respuesta. Claude omite la introducción, la narración paso a paso y el resumen de cierre, y responde una pregunta simple en una a tres oraciones. Realiza el trabajo de ingeniería de manera tan exhaustiva como en el estilo Default. Requiere Claude Code v2.1.237 o posterior. Claude aún escribe a toda extensión en estos casos:- Cualquier cosa que solicite: cuando solicita una explicación o más detalle, Claude responde completamente.
- Cualquier cosa que necesite para actuar de manera segura: los informes de errores, la salida de pruebas fallidas, las advertencias de seguridad y las confirmaciones de acciones destructivas mantienen su contenido completo.
Explanatory
En el estilo Explanatory, Claude realiza la tarea de la manera que lo hace en el estilo Default y añade explicaciones breves de por qué hizo las opciones que hizo. Cada explicación aparece en la conversación, antes o después del código sobre el que trata, en un bloque etiquetado comoInsight. Las explicaciones no se escriben en sus archivos como comentarios.
Un bloque Insight contiene dos o tres puntos sobre su base de código o el código que escribió Claude, como este después de añadir un punto final de API:
Learning
En el estilo Learning, Claude añade los mismos bloquesInsight que el estilo Explanatory y también le pide que escriba parte del código. Claude maneja la implementación rutinaria por sí mismo. Cuando llega a una pieza con una decisión de diseño real, como manejo de errores, una estructura de datos o lógica empresarial con más de un enfoque válido, deja algunas líneas para usted.
Claude marca el lugar con un comentario TODO(human) en el archivo, luego envía una solicitud que dice qué ya está construido, qué escribir y qué considerar:
TODO(human) y dígale a Claude cuándo haya terminado. Claude responde con un Insight sobre su código y continúa la tarea.
Cambiar su estilo de salida
Elija un estilo con el comando, un menú o un archivo de configuración. El comando y ambos menús guardan su selección en.claude/settings.local.json en el nivel de proyecto local.
-
Comando
/output-style: ejecute/output-style <style>para cambiar, por ejemplo/output-style concise. Sin argumentos, el comando enumera los estilos que puede elegir y marca el actual. El comando también funciona en modo no interactivo y sesiones de Agent SDK, y desde la aplicación móvil o web a través de Control Remoto, donde puede enumerar y seleccionar solo estilos integrados. Requiere Claude Code v2.1.269 o posterior. -
Menú de terminal: ejecute
/configy seleccione Output style para elegir un estilo de un menú. -
Extensión de VS Code: abra el menú de comandos con
/y seleccione Output styles para elegir un estilo, incluidos sus estilos personalizados. Requiere Claude Code v2.1.257 o posterior. -
Aplicación de escritorio: establezca el campo
outputStyleen un archivo de configuración, por ejemplo.claude/settings.local.json, el archivo que escribe el menú de terminal. Cuando ejecute/configallí, Claude Code abre Settings > Claude Code en lugar de un menú.
outputStyle directamente en un archivo de configuración:
Proactive, Concise, Explanatory y Learning. Un valor que no coincida exactamente con un nombre de estilo, como explanatory, le proporciona el estilo Predeterminado. El comando /output-style ignora mayúsculas y minúsculas.
Para hacer que un estilo sea su predeterminado en todos los proyectos, establezca outputStyle en ~/.claude/settings.json. Los archivos de configuración propios de un proyecto tienen precedencia sobre ese valor.
Cuando cambia de estilos a mitad de sesión, Claude utiliza el nuevo estilo a partir de su siguiente mensaje. Para lo que cuesta ese primer mensaje en almacenamiento en caché de prompts, consulte Cambiar el estilo de salida. Antes de v2.1.251, el nuevo estilo se aplicaba solo después de ejecutar /clear o iniciar una nueva sesión.
Crear un estilo de salida personalizado
Un estilo de salida personalizado es un archivo Markdown: frontmatter para metadatos, luego las instrucciones para Claude. En la extensión de VS Code, también puede crear el archivo desde el menú Output styles en lugar de escribirlo manualmente. Esto requiere Claude Code v2.1.261 o posterior.1
Crear un archivo Markdown
Guárdelo en uno de tres niveles. El nombre del archivo se convierte en el nombre del estilo a menos que establezca
name en el frontmatter.- Usuario:
~/.claude/output-styles - Proyecto:
.claude/output-styles - Política administrada:
.claude/output-stylesdentro del directorio de configuración administrada
.claude/output-styles/ entre el directorio de trabajo y la raíz del repositorio. Cuando más de uno de estos directorios anidados define un estilo con el mismo nombre, Claude Code utiliza el más cercano al directorio de trabajo.2
Agregar frontmatter e instrucciones
Decida si desea mantener las instrucciones de ingeniería de software de Claude Code. Establezca
keep-coding-instructions: true si está cambiando cómo Claude se comunica pero aún desea que codifique de la misma manera. Déjelo fuera si Claude no estará haciendo ingeniería de software.Este ejemplo encabeza cada explicación con un diagrama mientras mantiene el comportamiento de codificación de Claude:3
Cambiar a su estilo
Ejecute
/output-style <style> en la terminal, o ejecute /config y seleccione su estilo bajo Output style. Claude utiliza el nuevo estilo a partir de su próximo mensaje. En la terminal, Claude Code lee archivos de estilo cuando se inicia, por lo que si crea o edita uno durante una sesión en ejecución, reinicie Claude Code para aplicar el cambio.output-styles/.
Referencia de frontmatter
Configure un estilo de salida con frontmatter YAML entre marcadores--- en la parte superior del archivo. Todos los campos son opcionales, y los nombres de los campos utilizan palabras en minúsculas separadas por guiones. Un campo mal escrito se ignora sin un error. Si el YAML no se analiza, el estilo aún se carga bajo su nombre de archivo sin campos establecidos; ejecute claude --debug para ver el error de análisis.
Elige entre un estilo de salida y otras características
Un estilo de salida se aplica a cada respuesta en una sesión. Es una instrucción que Claude sigue, por lo que nada la impone. Cuando lo que desea es más específico que cada respuesta, u tiene que suceder sin falta, otra característica se ajusta mejor. Esta tabla hace coincidir lo que desea con la característica que lo hace:
Estas características se combinan. Por ejemplo, puede usar CLAUDE.md para lo que Claude debe saber, un estilo de salida para cómo responde, y un hook para cualquier cosa que tenga que ser garantizada. Extienda Claude Code compara el resto de las características de la extensión.
Cómo funcionan los estilos de salida
Un estilo de salida cambia las instrucciones que Claude Code le da a Claude.- Claude Code envía las instrucciones del estilo activo con cada solicitud.
- Los estilos de salida personalizados omiten las instrucciones de ingeniería de software integradas de Claude Code, como cómo delimitar cambios, escribir comentarios y verificar el trabajo, a menos que
keep-coding-instructionsesté configurado entrue.
Recursos relacionados
- Settings: donde vive el campo
outputStyley cómo funciona la precedencia de configuración - Permission modes: cómo el estilo Proactive se compara con el modo automático
- Plugins: empaquete y distribuya estilos de salida junto con skills, hooks y agents
- Debug your configuration: diagnostique por qué un estilo de salida no está surtiendo efecto