Estilos de salida de Claude Code

El estilo de salida (Output Style) te permite personalizar el estilo de interacción y la forma de respuesta de Claude Code, adaptándolo a más escenarios de uso más allá del desarrollo de software, mientras conserva las funciones principales como ejecutar scripts locales, leer y escribir archivos, y realizar un seguimiento de las tareas pendientes.

Su esencia es cambiar la lógica de interacción y el estilo de respuesta de Claude Code mediante la modificación del aviso del sistema (System Prompt).


Estilos de salida integrados

Claude Code ofrece 3 estilos de salida listos para usar:

Nombre del estilo Escenarios aplicables Características principales
Estilo predeterminado (default) Tareas diarias de ingeniería de software Se enfoca en completar de manera eficiente tareas como codificación, depuración y refactorización, con respuestas concisas y directas.
Estilo explicativo (explanatory) Escenarios de aprender haciendo Mientras completa las tareas, explica conocimientos como ideas de implementación y patrones de diseño, adecuado para desarrolladores que desean comprender el código en profundidad.
Estilo de aprendizaje (learning) Aprendizaje práctico activo Colabora contigo para completar tareas, añadiendo en posiciones claveTODO(human)marcas, guiándote para que implementes tú mismo los fragmentos de código centrales, en lugar de darte la respuesta directamente.

Cómo funciona

Al cambiar el estilo de salida, Claude Code ajusta el aviso del sistema según las siguientes reglas:

  1. Todos los estilos eliminan las instrucciones restrictivas predeterminadas como "respuesta concisa, salida eficiente".
  2. Los estilos personalizados eliminan por defecto instrucciones relacionadas con codificación como "verificar el código con pruebas" (si deseas conservarlas, puedes activarlas en el archivo de estilokeep-coding-instructions: true)
  3. Cada estilo añade reglas personalizadas al final del aviso del sistema, anulando el comportamiento predeterminado.
  4. Durante la conversación se activan verificaciones de cumplimiento para garantizar que Claude siempre siga las instrucciones del estilo actual.

Cambiar el estilo de salida

Hay dos formas de cambiar el estilo; la configuración se guarda en el directorio del proyecto en el archivo.claude/settings.local.json,Solo tiene efecto en el proyecto actual.:

Método 1: Selección mediante menú—Después de ingresar el comando, selecciona el estilo deseado en el menú interactivo:

/output-style

Método 2: Especificación directa—Agrega directamente el nombre del estilo después del comando, en un solo paso:

/output-style explanatory
/output-style learning
/output-style default

Además de usar comandos para cambiar, también puedes editar directamente.claude/settings.local.json(a nivel de proyecto) o~/.claude/settings.json(a nivel global), modificando el valor del campooutputStylepara cambiar el estilo.


Crear estilos de salida personalizados

Si los estilos integrados no satisfacen tus necesidades, puedes definir un estilo exclusivo mediante un archivo Markdown.

1. Ubicación de guardado del archivo

Nivel Ruta de guardado Alcance
Nivel de usuario ~/.claude/output-styles/ Disponible en todos los proyectos del usuario actual.
Nivel de proyecto .claude/output-styles/(En el directorio raíz del proyecto) Disponible solo en el proyecto actual; se puede enviar a git para compartirlo con el equipo.

2. Formato del archivo

El archivo de estilo personalizado consta de dos partes: el frontmatter superiorYAML frontmatter(configuración de metadatos) y elcuerpo de texto Markdowninferior (contenido específico de las instrucciones).

Ejemplo

---
name
: data-analyst               # Nombre del estilo, se muestra en el menú /output-style (si no se completa, se usa el nombre del archivo)
description
: Enfocado en transformar datos complejos en informes visuales y conclusiones analíticas.
                                 # Descripción del estilo, se muestra en el texto explicativo del menú (opcional)
keep-coding-instructions
: false  # Si se conservan las instrucciones predeterminadas relacionadas con codificación.
                                 # false (predeterminado): elimina las instrucciones de codificación, adecuado para escenarios no relacionados con desarrollo.
                                 # true: conserva las instrucciones de codificación y superpone reglas personalizadas.
---

# Definición del rol
Eres un asistente profesional de análisis de datos, experto en procesar diversos tipos de datos estructurados con Python,
y en transformar datos complejos en informes visuales claros y fáciles de entender.

## Reglas de respuesta
1. Todos los análisis deben incluir tres partes: «Conclusión + Soporte de datos + Sugerencias de optimización».
2. Al generar código, se deben incluir comentarios detallados, priorizando el uso de Pandas y Matplotlib.
3. Evita la acumulación de jerga técnica; explica conceptos complejos con un lenguaje sencillo.

## Requisitos de formato
1. La sección de conclusiones debe mostrarse en negrita.
2. Los bloques de código deben estar envueltos con la etiqueta ```python.
3. La sección de sugerencias debe presentarse con una lista ordenada.

## Escenarios especiales
1. Al encontrar datos faltantes, avisa proactivamente al usuario para que complete la información clave, en lugar de mostrar un error directamente.
2. Al generar gráficos visuales, usa por defecto etiquetas en chino y un tema de colores claros.

3. Descripción de los parámetros de frontmatter

Nombre del parámetro ¿Es obligatorio? Descripción Valor predeterminado
name no Nombre del estilo, se muestra en el menú/output-style. Si no se completa, se usa el nombre del archivo (sin la extensión .md). Nombre del archivo
description no Breve descripción de la función del estilo, se muestra en el texto explicativo del menú para ayudar a distinguir varios estilos personalizados. Ninguno
keep-coding-instructions no Si se conservan las instrucciones relacionadas con codificación del aviso del sistema predeterminado. Al establecerlo entrue, las instrucciones personalizadas se superponen a las instrucciones de codificación predeterminadas. false

4. Pasos de uso

  1. Crea un archivo.mdsegún el formato anterior (por ejemplo,data-analyst.md)
  2. Coloca el archivo en el directorio correspondiente:
    • Disponible para todos los proyectos:~/.claude/output-styles/data-analyst.md
    • Disponible solo para el proyecto actual:.claude/output-styles/data-analyst.md
  3. Ejecuta en Claude Code/output-styley podrás ver y seleccionar el estilo recién creado en el menú.

Diferencias con funciones relacionadas

El estilo de salida es similar a las siguientes funciones, pero actúa en un nivel diferente:

Elemento de comparación Diferencia principal
Estilo de salida vs CLAUDE.md El estilo de salidareemplazael aviso del sistema predeterminado de ingeniería de software, cambiando fundamentalmente el modo de trabajo de Claude; CLAUDE.md añade contexto del proyecto y convenciones en forma de mensajes de usuario, sin modificar el aviso del sistema en sí.
Estilo de salida vs --append-system-prompt El estilo de salida reemplaza y desactiva el aviso predeterminado;--append-system-promptañade contenido al final del aviso predeterminado; ambos conservan el aviso original.
Estilo de salida vs Subagente (Subagent) El estilo de salida modifica el aviso del sistema del agente principal, afectando el estilo de interacción global; el subagente es un módulo independiente de procesamiento de tareas que puede personalizar modelos, herramientas y condiciones de activación, y devuelve resultados después de procesar subtareas específicas.
Estilo de salida vs comandos de barra personalizados El estilo de salida es un "aviso del sistema almacenado" que determina el estilo de interacción general de Claude; los comandos de barra personalizados son un "aviso de usuario almacenado" que se utilizan para ejecutar rápidamente una instrucción o tarea específica.

Plantilla de estilo personalizado

A continuación se muestra una plantilla general de estilo de salida personalizado. Reemplaza el contenido de[ ]con tus necesidades reales y guárdalo como.mdarchivo para poder usarlo:

Ejemplo

---
name
: [Nombre del estilo, por ejemplo: Asistente de escritura.]
description
: [Describe su propósito en una frase, por ejemplo: enfocado en la redacción de documentación técnica, generando contenido con estructura clara y expresión precisa.]
keep-coding-instructions
: [true o false]
---

# 1. Posicionamiento principal
[Define el rol y la especialidad de Claude, por ejemplo:
Eres un asistente profesional de redacción de documentación técnica, experto en transformar conceptos técnicos complejos en textos claros y fáciles de entender.]

# 2. Reglas de respuesta
[Establece la lógica de respuesta de Claude, por ejemplo:
1. Cada respuesta debe incluir tres partes: «Idea principal + Explicación detallada + Ejemplo».
2. Usa voz activa, evita construcciones en voz pasiva.
3. Cuando aparezca un término técnico por primera vez, incluye una breve explicación.]

# 3. Requisitos de formato
[Especifica el formato de maquetación de la salida, por ejemplo:
1. Los títulos usan## Título de nivel 2.
2. Los ejemplos de código usan bloques de código e indican el tipo de lenguaje.
3. La información clave se marca en negrita.]

# 4. Manejo de escenarios especiales
[Reglas de manejo para situaciones específicas, por ejemplo:
1. Cuando se necesiten ejemplos, prioriza escenarios reales en lugar de ejemplos abstractos
2. Cuando te encuentres con requisitos poco claros, confirma la intención antes de comenzar a escribir]
Otras extensiones