Output styles de Claude Code: los 5 integrados y estilos custom, ilustrado
Cuando el modelo se vuelve más listo pero las respuestas más difíciles de leer, no cambies de modelo — cambia el estilo. Este recorrido cubre los cinco output styles integrados, la carpeta ~/.claude/output-styles, keep-coding-instructions y estilos de equipo por rol, captura a captura.
TL;DR — output styles de un vistazo
- Un output style reconfigura cómo se comunica Claude Code en cada respuesta de una sesión — rol, tono y formato. Cambia el system prompt, no el modelo.
- Cinco integrados vienen con Claude Code: Default, Proactive, Concise, Explanatory y Learning. Cámbialos con /output-style o /config → Output style.
- Los estilos custom son archivos markdown en ~/.claude/output-styles (usuario) o .claude/output-styles (proyecto). Por defecto reemplazan las instrucciones de código integradas — pon keep-coding-instructions: true para conservarlas.
- El movimiento pro del video: diseña estilos por audiencia usando reglas de ASD-STE100 — una palabra, un significado; oraciones cortas — así PMs, traductores e ingenieros reciben respuestas que sí pueden leer.
Claude Code Output Styles Made Opus 5 Readable Again
Canal:Eric Tech15:40
Opus 5 Is Exhausting. Anthropic Reveals The Fix.
Canal:Ray Amjad5:56
You Think Claude Got Dumber? You Are Actually Just Missing This Setting
Canal:Gary Chen11:41
Output styles — Claude Code documentation
Docs:code.claude.com
Los cuadros vienen del deep dive de output styles de Eric Tech; el texto del recorrido se escribió de forma independiente y se verificó contra la documentación oficial de output styles, incluyendo la lista de estilos integrados y el comportamiento de keep-coding-instructions.
Las capturas siguen siendo propiedad de sus creadores y se usan con atribución como documentación visual. Cada paso enlaza directo al momento exacto del video original.
Cambia cómo habla Claude, paso a paso
1 · El problema y la solución
- 1
Reconoce el problema: inteligente pero ilegible
El video abre con la queja de la comunidad en un boceto: los modelos trabajan — la tarea se hace — pero las respuestas se volvieron muros de jerga. Matt Pocock lo marcó públicamente después de probar Opus 5 y no tener idea de qué le estaba diciendo. Si esa también es tu semana, la solución no es otro modelo.
“Funciona. No lo podemos leer.” — la razón por la que existen los output styles.Ver en 0:20 - 2
Toma la solución de una engineer de Anthropic
El post de Lydia Hallie es todo el mecanismo en dos líneas: mete las instrucciones de estilo en ~/.claude/output-styles, corre /config y elige el estilo. Comparte también su favorito para navegar después del trabajo — un estilo “explícamelo como si tuviera 5” que leemos completo en el siguiente paso.
El post original: instrucciones en ~/.claude/output-styles, luego /config → Output style.Ver en 2:00 - 3
Lee un archivo de estilo real de punta a punta
Un archivo de estilo es markdown: frontmatter con name, description y keep-coding-instructions: true — la flag que conserva las instrucciones de código de Claude en vez de reemplazarlas — seguido de instrucciones simples. Este fija el contrato para un lector agotado: palabras pequeñas, oraciones cortas, máximo dos opciones cuando hay que decidir, y rutas y comandos exactos porque “no me quedan neuronas para el resto”.
El estilo ELI5: frontmatter más reglas que un humano cansado puede seguir.Ver en 2:20
2 · Integrados y tu primer estilo custom
- 4
Conoce los cinco estilos integrados
Abre /config → Output style y Claude Code lista lo que trae por defecto, cada uno con su contrato: Default completa tareas de forma eficiente con respuestas concisas; Proactive ejecuta de inmediato y minimiza interrupciones; Concise responde con sequedad, poniendo el resultado primero; Explanatory explica decisiones de implementación y patrones del codebase; Learning hace pausas y te pide escribir pequeños pedazos de código para practicar.
El menú de preferred output style — cada integrado con su descripción de una línea.Ver en 5:20 - 5
Borra un estilo custom con ayuda de Claude
No tienes que escribir estilos desde cero. El workflow del video: cuando una salida te decepciona, pídele a Claude tres o cuatro variaciones de la misma respuesta, elige la que mejor lee, y haz que Claude convierta esa ganadora en un output style reutilizable guardado en tu máquina.
La receta: salida → 3–4 variaciones → guarda la mejor como estilo.Ver en 4:20 - 6
Mira dónde vive un estilo custom
Aquí uno real: “Map First”, un estilo que abre cada explicación con un diagrama de arquitectura. El archivo vive en la carpeta .claude/output-styles del proyecto y tiene un symlink hacia ~/.claude/output-styles para estar disponible en todos los proyectos — un patrón limpio para compartir estilos con el equipo vía el repo.
Map First: la carpeta del proyecto como fuente de verdad, con symlink al directorio de usuario.Ver en 5:00 - 7
Selecciónalo y hazlo pegajoso
En /config, filtra por “output” y el setting de Output style está ahí — cambiado a Map First. Seteado una vez, sobrevive reinicios: las sesiones nuevas abren ya hablando en ese estilo. También puedes cambiar al vuelo con /output-style <name>, o fijar un campo “outputStyle” en settings como default entre proyectos.
Output style: Map First — se setea una vez, queda para toda sesión siguiente.Ver en 5:48
3 · Diseña estilos como pro
- 8
Conoce la diferencia entre un estilo y un skill
El skill /wait-what de Matt Pocock hace que el agente repita su último mensaje en inglés claro — a demanda, cuando lo invocas. Un output style es el contrato opuesto: está activo desde el primer token de cada respuesta, moldeando tono y formato sin que lo pidas. Los skills son herramientas que agarras; los estilos son la voz con la que hablas.
/wait-what — un skill corre al invocarlo; un estilo está siempre activo.Ver en 6:09 - 9
Róbate un estándar de aviación de los 80 para tu estilo
El mejor consejo para escribir estilos del video viene de ASD-STE100, Simplified Technical English — escrito para que los mecánicos de aviación jamás malleyeran un paso de mantenimiento. Sus reglas: una palabra tiene exactamente un significado, nada de sinónimos (elige una palabra aprobada para “iniciar” y no la cambies), las oraciones de instrucción se quedan bajo 20 palabras, y una acción por oración. Justo el contrato que necesita un buen output style.
STE100: un significado por palabra, sin sinónimos, instrucciones ≤ 20 palabras.Ver en 6:20 - 10
Despliega estilos por rol
El equipo de la autora publica un estilo por persona, y aparecen directo en el menú: TPM para project managers técnicos que conocen APIs, frontend, backend y bases de datos pero no programan — supuestos declarados, cada decisión presentada como trade-off con recomendación; Technical Translator para lectores cero técnicos, una analogía cotidiana por respuesta y operaciones peligrosas detrás de un checkpoint; SDE para ingenieros que quieren el relleno recortado.
El menú crece: TPM, Technical Translator, SDE — una voz por rol.Ver en 6:00 - 11
Cambia estilos como cambias de modo
Output style: TPM — seleccionado en /config y activo desde el siguiente hola. El pago, según el video: empareja el estilo con el trabajo (Explanatory cuando estás aprendiendo un codebase, Proactive para corridas nocturnas, Concise cuando solo quieres el resultado) y recibes respuestas que todo el equipo puede leer — a menudo con menos tokens, porque el estilo prohíbe el relleno.
Output style: TPM — los no programadores del equipo tienen su propia voz.Ver en 11:04
Los cinco estilos integrados, con precisión
Según la documentación oficial, cinco estilos vienen con Claude Code — Default más cuatro extras:
- 1Default — sin instrucciones de estilo añadidas; Claude usa el system prompt estándar de ingeniería de software. Completar tareas con eficiencia, respuestas concisas.
- 2Proactive — arranca el trabajo de inmediato y hace supuestos razonables en vez de preguntar por decisiones rutinarias; sigue verificando antes de acciones destructivas o que afecten producción.
- 3Concise — las respuestas van directo al resultado y saltan preámbulos, narración y recaps. Requiere Claude Code v2.1.237 o más nuevo.
- 4Explanatory — agrega bloques cortos de Insight que explican decisiones de diseño mientras trabaja (se quedan en el chat, no se escriben en tus archivos).
- 5Learning — los mismos bloques de Insight, y además deja pequeños pedazos de código para que los escribas tú, marcados con un comentario TODO(human), y espera a que termines.
Cambia en cualquier momento con /output-style <name> (sin argumento los lista), vía /config → Output style, en el menú / de VS Code, o de forma permanente con un campo "outputStyle" en settings. Una advertencia de la documentación: los subagents corren con sus propios system prompts, así que tu estilo moldea la conversación principal, no la salida de los subagents.