Estilos de salida

Adapte Claude Code para usos más allá de la ingeniería de software

Los estilos de salida cambian cómo responde Claude, no lo que Claude sabe. Establecen el rol, el tono y el formato de salida de Claude para cada respuesta. 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 le proporciona a Claude sus propias instrucciones 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 su conjunto estándar de instrucciones, diseñado para ayudarle a completar tareas de ingeniería de software de manera eficiente.

Hay cuatro 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 su modo de permisos aún decide qué se ejecuta sin preguntar.

• Concise: Claude comienza con el resultado, omite el preámbulo y la narración, y mantiene las respuestas breves por defecto, mientras realiza el trabajo de ingeniería de manera tan exhaustiva como en el estilo Default. Cuando le pide una explicación o más detalle, Claude responde completamente. Claude siempre mantiene el contenido completo de los informes de errores, advertencias de seguridad y confirmaciones de acciones destructivas. Requiere Claude Code v2.1.237 o posterior.

• 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

Elija un estilo de una de estas formas:

• 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. Claude Code guarda su selección en .claude/settings.local.json en el nivel de proyecto local.

  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.

• Terminal: ejecute /config y seleccione Output style para elegir un estilo de un menú. Claude Code guarda su selección en .claude/settings.local.json en el nivel de proyecto local.

• Extensión de VS Code: abra el menú de comandos con / y seleccione Output styles para elegir un estilo, incluidos sus estilos personalizados. Claude Code guarda su selección en .claude/settings.local.json, el mismo archivo que escribe el menú de terminal. Requiere Claude Code v2.1.257 o posterior.

• Aplicación de escritorio: establezca el campo outputStyle en un archivo de configuración, por ejemplo .claude/settings.local.json, el archivo que escribe el menú de terminal. Cuando ejecute /config allí, Claude Code abre Settings > Claude Code en lugar de un menú.

Para establecer un estilo sin el menú, edite el campo outputStyle directamente en un archivo de configuración:

{
  "outputStyle": "Explanatory"
}

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.

---
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.

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:

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.
• Cuando selecciona un estilo diferente al predeterminado, Claude Code también le recuerda a Claude el estilo 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.

Los estilos de salida se aplican a la conversación principal y a un fork, que hereda la conversación completa y el mensaje del sistema del padre. Otros subagentes ejecutan su propio mensaje del sistema, por lo que los estilos no cambian cómo responden.

El uso de tokens depende del estilo. Las instrucciones de un estilo agregan 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. El estilo Concise hace lo opuesto al instruir a Claude que mantenga las respuestas cortas por defecto. Para estilos personalizados, el uso de tokens de salida depende de lo que sus instrucciones le digan a Claude que produzca.

Comparaciones con características relacionadas

Varias características personalizan cómo se comporta Claude Code. Los estilos de salida cambian las instrucciones predeterminadas de Claude Code y se aplican a cada respuesta. Los otros agregan instrucciones sin cambiar los valores predeterminados, o los limitan a una tarea específica.

Recursos relacionados

• 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