Estilos de Salida en Claude Code: Guía Completa

Claude Code es mucho más que un asistente de programación tradicional. Una de sus características más recientes son los estilos de salida, que te permiten adaptar Claude Code para usos que van más allá de la ingeniería de software tradicional, manteniendo sus capacidades principales como ejecutar scripts locales, leer/escribir archivos y hacer seguimiento de tareas. ✅

En este artículo, exploraremos qué son los estilos de salida, cómo funcionan y cómo puedes aprovecharlos para mejorar tu flujo de trabajo.

¿Qué son los Estilos de Salida?

Los estilos de salida te permiten usar Claude Code como cualquier "tipo" de agente, mientras conserva sus capacidades principales. Esencialmente, modifican la forma en que Claude Code interactúa contigo, adaptándose a diferentes contextos de trabajo.

Estilos de Salida Integrados

Claude Code viene con tres estilos de salida predefinidos que cubren las necesidades más comunes:

Default (Por Defecto)

El estilo Default es el prompt del sistema existente, diseñado para ayudarte a completar tareas de ingeniería de software de manera eficiente. Este es el modo que probablemente ya conoces si has usado Claude Code.

Características:

• Respuestas concisas y directas
• Enfoque en la eficiencia
• Verificación de código con pruebas
• Optimizado para tareas de programación

Explanatory (Explicativo)

El estilo Explanatory proporciona "Insights" educativos entre las tareas de ingeniería de software. Es perfecto cuando quieres entender no solo el "qué" sino también el "por qué" detrás de las decisiones de implementación. 👨🏻‍🏫

Características:

• Explicaciones detalladas de decisiones de implementación
• Insights sobre patrones del código base
• Contexto educativo adicional
• Ideal para aprender mientras desarrollas ⬅️

Cuándo usarlo:

• Cuando trabajas con un código base nuevo
• Para entender patrones de arquitectura
• Durante sesiones de aprendizaje ⬅️
• Cuando necesitas documentar decisiones técnicas

Learning (Aprendizaje)

El estilo Learning es un modo colaborativo de aprender haciendo, donde Claude no solo comparte "Insights" mientras programa, sino que también te pide que contribuyas con pequeñas piezas estratégicas de código. Claude Code añadirá marcadores TODO(human) en tu código para que los implementes. 🤯

Características:

• Enfoque colaborativo e interactivo
• Marcadores TODO(human) para tu implementación
• Aprendizaje activo y participativo
• Feedback inmediato sobre tu código

Cuándo usarlo:

• Cuando estás aprendiendo una nueva tecnología
• Para mejorar tus habilidades de programación
• Durante sesiones de pair programming virtual
• Cuando quieres práctica guiada

Cómo Funcionan los Estilos de Salida

Los estilos de salida modifican directamente el prompt del sistema de Claude Code. Esto significa que:

• Los estilos no predeterminados excluyen instrucciones específicas de generación de código y salida eficiente normalmente integradas en Claude Code
• En su lugar, estos estilos tienen sus propias instrucciones personalizadas añadidas al prompt del sistema
• Cada estilo está optimizado para un tipo específico de interacción

Cambiar tu Estilo de Salida

Cambiar entre estilos de salida es muy sencillo. Tienes dos opciones:

Opción 1: Menú Interactivo

/output-style

Esto abre un menú donde puedes seleccionar tu estilo de salida. También puedes acceder a esto desde el menú /config.

Opción 2: Cambio Directo

/output-style [estilo]

Por ejemplo:

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

Importante: Estos cambios se aplican a nivel de proyecto local y se guardan en .claude/settings.local.json.

Crear un Estilo de Salida Personalizado

Una de las características más poderosas es la capacidad de crear tus propios estilos de salida personalizados.

Creación Asistida

Para configurar un nuevo estilo de salida con la ayuda de Claude, ejecuta:

/output-style:new Quiero un estilo de salida que...

Por ejemplo:

/output-style:new Quiero un estilo de salida que me ayude a escribir documentación técnica detallada

Estructura de Estilos Personalizados

Los estilos de salida personalizados se guardan como archivos Markdown con la siguiente estructura:

---
name: Mi Estilo Personalizado
description: Una breve descripción de lo que hace este estilo
---

# Instrucciones del Estilo Personalizado

Eres una herramienta CLI interactiva que ayuda a los usuarios con tareas de ingeniería de software.
[Tus instrucciones personalizadas aquí...]

## Comportamientos Específicos

[Define cómo debe comportarse el asistente en este estilo...]

Ubicaciones de Almacenamiento

• Nivel de usuario: ~/.claude/output-styles (disponible en todos los proyectos)
• Nivel de proyecto: .claude/output-styles (específico del proyecto actual)

Comparaciones con Características Relacionadas

Estilos de Salida vs. CLAUDE.md vs. --append-system-prompt

Estilos de Salida:

• Desactivan completamente las partes del prompt predeterminado específicas de ingeniería de software
• Reemplazan el comportamiento principal del sistema

CLAUDE.md:

• No edita el prompt predeterminado de Claude Code
• Añade contenido como mensaje de usuario después del prompt del sistema

--append-system-prompt:

• Añade contenido al prompt del sistema sin reemplazarlo
• Complementa el comportamiento existente

Estilos de Salida vs. Agentes

Estilos de Salida:

• Afectan directamente el bucle principal del agente
• Solo modifican el prompt del sistema

Agentes:

• Se invocan para manejar tareas específicas
• Pueden incluir configuraciones adicionales como el modelo a usar y herramientas disponibles

Estilos de Salida vs. Comandos Slash Personalizados

Estilos de Salida:

• "Prompts del sistema almacenados"
• Cambian el comportamiento global

Comandos Slash Personalizados:

• "Prompts almacenados"
• Ejecutan acciones específicas

Casos de Uso Prácticos

Para Principiantes

Recomendación: Comienza con el estilo Learning

• Te guía paso a paso
• Te involucra activamente en el proceso
• Proporciona feedback inmediato

Para Desarrolladores Experimentados

Recomendación: Alterna entre Default y Explanatory

• Default para trabajo eficiente
• Explanatory cuando necesites documentar o explicar decisiones

Para Equipos

Recomendación: Crea estilos personalizados

• Estilo para code reviews
• Estilo para documentación
• Estilo para onboarding de nuevos miembros

Mejores Prácticas

1. Experimenta con diferentes estilos para encontrar el que mejor se adapte a tu flujo de trabajo
2. Usa estilos específicos para tareas específicas - no hay necesidad de usar el mismo estilo para todo
3. Crea estilos personalizados para necesidades recurrentes de tu equipo o proyecto
4. Documenta tus estilos personalizados para que otros miembros del equipo puedan usarlos

Los estilos de salida en Claude Code representan una evolución significativa en cómo interactuamos con asistentes de IA para desarrollo.

Al permitirte adaptar el comportamiento de Claude Code a tus necesidades específicas, estos estilos transforman una herramienta de programación en un compañero de desarrollo verdaderamente personalizable.

Ya sea que estés aprendiendo una nueva tecnología, trabajando en un proyecto complejo, o necesites un enfoque específico para tu equipo, los estilos de salida te proporcionan la flexibilidad necesaria.

Próximos Pasos

1. Experimenta con los tres estilos integrados en tu próximo proyecto
2. Identifica patrones en tu flujo de trabajo que podrían beneficiarse de un estilo personalizado
3. Crea tu primer estilo personalizado usando /output-style:new
4. Comparte estilos útiles con tu equipo

---

Abrazo. Bliss. 🤓

¿Quieres convertirte en un Power User de Claude Code? Checa mi taller en vivo.