Estilos de salida

Intermedio

What you'll learn

Qué es un estilo de salida — y en qué se diferencia de cambiar lo que Claude sabe
Los cuatro estilos integrados: Default, Proactive, Explanatory, Learning
Cómo cambiar de estilo con /config — y por qué el cambio necesita una sesión nueva
Cómo crear tu propio estilo personalizado como un archivo Markdown
Cuándo recurrir a un estilo de salida frente a CLAUDE.md frente a las instrucciones personalizadas de Claude.ai

Los estilos de salida cambian cómo se comunica Claude Code — su rol, tono, nivel de detalle y si explica su razonamiento — modificando directamente el system prompt. Cambian cómo responde Claude, no lo que sabe. Recurre a uno cuando te encuentres repitiendo el mismo prompt para obtener la misma voz o formato en cada turno.

Por qué usarlos

Adáptalo a tu flujo de trabajo. Conciso y orientado a la acción cuando vas rápido; explicativo cuando estás aprendiendo.
Modo didáctico. Algunos estilos añaden comentarios educativos — ideales mientras te familiarizas con una base de código o una técnica.
Consistencia. Define un estilo preferido una vez para que cada sesión se lea como te gusta.

Los estilos integrados

Claude Code incluye cuatro:

Estilo	Qué hace
Default	El system prompt estándar de ingeniería de software — eficiente, orientado a la acción.
Proactive	Ejecuta de inmediato y hace suposiciones razonables en lugar de pausar ante decisiones rutinarias. Ofrece una orientación de ejecución autónoma más fuerte que el modo automático, pero aún ves solicitudes de permiso antes de que se ejecuten las herramientas.
Explanatory	Añade "Insights" educativos entre pasos, explicando las decisiones de implementación y los patrones de la base de código.
Learning	Colaborativo, aprender haciendo: comparte Insights y te pide que escribas pequeños fragmentos tú mismo, dejando marcadores `[TODO(human)]` en tu código.

Watch out

Explanatory y Learning producen respuestas más largas por diseño, por lo que cuestan más tokens de salida que Default.

Pulsa Intro o Espacio para girar la tarjeta. Usa las flechas izquierda y derecha para moverte entre las tarjetas.Término mostrado.

1 / 4

Cómo cambiar

Ejecuta /config y elige un estilo en Output style. Tu elección se guarda en .claude/settings.local.json a nivel de proyecto. Para configurarlo sin el menú, edita el campo outputStyle en cualquier archivo de configuración.

Guided walkthrough1 of 4

Ejecuta /config en tu sesión y busca la opción Output style.

{
  "outputStyle": "Explanatory"
}

:::warning Los cambios requieren una sesión nueva El estilo de salida forma parte del system prompt, que Claude Code lee una vez al inicio de la sesión. Un cambio surte efecto solo después de /clear o de una nueva sesión. (El comando independiente /output-style se eliminó en v2.1.91 — usa /config o la configuración anterior.) :::

Crea un estilo personalizado

Un estilo personalizado es un archivo Markdown: frontmatter, luego las instrucciones que se añaden al system prompt. Guárdalo a nivel de usuario (~/.claude/output-styles/) o a nivel de proyecto (.claude/output-styles/); el nombre del archivo se convierte en el nombre del estilo a menos que definas name.

Estilo personalizado de ejemplo — Diagramas primero

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

Pro tip

Define keep-coding-instructions: true cuando solo estés cambiando CÓMO se comunica Claude pero aún quieras que programe normalmente.
Omítelo (el valor predeterminado) cuando Claude no esté haciendo ingeniería de software en absoluto — por ejemplo, un asistente de pura escritura o análisis de datos — para que se descarten las instrucciones de programación integradas.