Saltar al contenido principal
Los estilos de salida cambian cómo responde Claude, no lo que Claude sabe. Modifican el mensaje del sistema para establecer el rol, el tono y el formato de salida. Use uno cuando siga re-solicitando la misma voz o formato en cada turno, o cuando desee que Claude actúe como algo diferente a un ingeniero de software. Un estilo de salida personalizado agrega sus instrucciones al mensaje del sistema y le permite elegir si desea mantener las instrucciones integradas de ingeniería de software de Claude Code. Manténgalas cuando esté cambiando cómo Claude se comunica pero sigue codificando, como siempre respondiendo con un diagrama. Déjelas fuera cuando Claude no esté haciendo ingeniería de software en absoluto, como un asistente de escritura o analista de datos. Para instrucciones sobre su proyecto, convenciones o base de código, use CLAUDE.md en su lugar.

​
Estilos de salida integrados

El estilo de salida Default de Claude Code es el mensaje del sistema existente, diseñado para ayudarle a completar tareas de ingeniería de software de manera eficiente. Hay tres estilos de salida integrados adicionales:
  • Proactive: Claude se ejecuta inmediatamente, realiza suposiciones razonables en lugar de pausarse para decisiones rutinarias, y prefiere la acción sobre la planificación. Esta es una orientación de ejecución autónoma más fuerte que la que aplica el modo automático, y funciona sin cambiar su modo de permisos, por lo que aún ve mensajes de permisos antes de que se ejecuten las herramientas.
  • Explanatory: Proporciona “Insights” educativos entre ayudarle a completar tareas de ingeniería de software. Le ayuda a entender las opciones de implementación y los patrones de la base de código.
  • Learning: Modo colaborativo de aprendizaje práctico donde Claude no solo compartirá “Insights” mientras codifica, sino que también le pedirá que contribuya con pequeñas piezas de código estratégicas. Claude Code agregará marcadores TODO(human) en su código para que usted implemente.

​
Cambiar su estilo de salida

Ejecute /config y seleccione Output style para elegir un estilo de un menú. Su selección se guarda en .claude/settings.local.json en el nivel de proyecto local.
El comando independiente /output-style quedó obsoleto en v2.1.73 y se eliminó en v2.1.91. Utilice /config o edite la configuración outputStyle directamente.
Para establecer un estilo sin el menú, edite el campo outputStyle directamente en un archivo de configuración: 
{
  "outputStyle": "Explanatory"
}
El estilo de salida es parte del mensaje del sistema, que Claude Code lee una vez al inicio de la sesión. Los cambios surten efecto después de /clear o una nueva sesión. Consulte Cómo Claude Code utiliza el almacenamiento en caché de prompts para saber qué hace un cambio de estilo de salida en la caché.

​
Crear un estilo de salida personalizado

Un estilo de salida personalizado es un archivo Markdown: frontmatter para metadatos, luego las instrucciones a agregar al mensaje del sistema.
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.Los estilos de salida del proyecto se cargan desde cada .claude/output-styles/ entre el directorio de trabajo y la raíz del repositorio. A partir de v2.1.178, 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:
---
name: Diagrams first
description: Lead every explanation with a diagram
keep-coding-instructions: true
---

When explaining code, architecture, or data flow, start with a Mermaid diagram showing the structure, then explain in prose.

## Diagram conventions

Use `flowchart TD` for control flow and `sequenceDiagram` for request paths. Keep diagrams under 15 nodes.
3

Cambiar a su estilo

Ejecute /config y seleccione su estilo bajo Output style. Surte efecto después de /clear o la próxima vez que inicie una sesión.
Plugins también pueden enviar estilos de salida en un directorio output-styles/.

​
Frontmatter

Los archivos de estilo de salida admiten estos campos de frontmatter:
FrontmatterPropósitoPredeterminado
nameNombre del estilo de salida, si no es el nombre del archivoSe hereda del nombre del archivo
descriptionDescripción del estilo de salida, mostrada en el selector /configNinguno
keep-coding-instructionsMantener las instrucciones integradas de ingeniería de software de Claude Codefalse
force-for-pluginSolo estilos de salida de plugins: aplique este estilo automáticamente siempre que el plugin esté habilitado, sin requerir que los usuarios lo seleccionen. Anula la configuración outputStyle del usuario. Si varios plugins habilitados establecen esto, Claude Code usa el primero cargado.false

​
Cómo funcionan los estilos de salida

Los estilos de salida modifican directamente el mensaje del sistema de Claude Code.
  • Todos los estilos de salida tienen sus propias instrucciones personalizadas agregadas al final del mensaje del sistema.
  • Todos los estilos de salida activan recordatorios para que Claude se adhiera a las instrucciones del estilo de salida durante la conversación.
  • Los estilos de salida personalizados dejan fuera las instrucciones integradas de ingeniería de software de Claude Code, como cómo delimitar cambios, escribir comentarios y verificar el trabajo, a menos que keep-coding-instructions esté establecido en true.
El uso de tokens depende del estilo. Agregar instrucciones al mensaje del sistema aumenta los tokens de entrada, aunque el almacenamiento en caché de prompts reduce este costo después de la primera solicitud en una sesión. Los estilos integrados Explanatory y Learning producen respuestas más largas que Default por diseño, lo que aumenta los tokens de salida. Para estilos personalizados, el uso de tokens de salida depende de lo que sus instrucciones le digan a Claude que produzca. Varias características personalizan cómo se comporta Claude Code. Los estilos de salida modifican el mensaje del sistema directamente y se aplican a cada respuesta. Los otros agregan instrucciones sin cambiar el mensaje del sistema predeterminado, o los limitan a una tarea específica.
CaracterísticaCómo funcionaÚselo cuando
Estilos de salidaModifica el mensaje del sistemaDesea un rol, tono o formato de respuesta predeterminado diferente en cada turno
CLAUDE.mdAgrega un mensaje de usuario después del mensaje del sistemaClaude siempre debe conocer sus convenciones de proyecto y contexto de base de código
--append-system-promptSe agrega al mensaje del sistema sin eliminar nadaDesea una adición única para una única invocación
AgentsEjecuta un subagente con su propio mensaje del sistema, modelo y herramientasDesea un ayudante con alcance separado para una tarea enfocada
SkillsCarga instrucciones específicas de tareas cuando se invoca o es relevanteTiene un flujo de trabajo reutilizable
  • Settings: donde vive el campo outputStyle y 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