Una sola sesión de Claude Code puede dejar tras de sí una pila de Markdown: un plan de implementación, un archivo de progreso, informes de investigación, un resumen de la sesión. Alguien tiene que leer todo eso, y leerlo como marcado en crudo en una terminal es un suplicio: cada tabla es una pared de barras verticales, cada lista de tareas son corchetes. Esta es la configuración que uso para leer la salida de la IA en un Mac.
Paso 1: Clasificar con Vista rápida
La mayor parte de lo que escribe un agente necesita un vistazo de diez segundos, no una sesión de lectura. Selecciona el archivo en el Finder, pulsa Espacio, échale un vistazo y sigue. De serie, macOS muestra el Markdown como texto plano, así que necesitarás una extensión que lo renderice: QLMarkdown lo hace gratis (código abierto, construido sobre cmark-gfm), o Peekdown (mi app) lo hace como parte de un visor de $4.99.
Si el archivo sigue en el historial de tu terminal, glow report.md lo renderiza ahí mismo, gratis (brew install glow). Cubrí todas las opciones de lectura en la guía de vista previa; el resto de este artículo es específico de la salida de IA.
Paso 2: Vigilar el archivo, no la terminal
Los agentes revisan sus documentos mientras trabajan: un plan se escribe, se revisa, se amplía. La terminal te muestra diffs y parloteo, no el estado actual del archivo.
Abre el plan en Peekdown y pon Ajustes > Comportamiento > Cuando un archivo cambia externamente en Recargar automáticamente. Ahora la vista previa se actualiza cada vez que el agente guarda. Una flecha verde parpadea en la barra de herramientas para que sepas que ha ocurrido. Y si tienes ediciones propias sin guardar cuando el archivo cambia por debajo, Peekdown muestra un diálogo de conflicto en lugar de machacar en silencio cualquiera de los dos lados.
Aquí ayudan dos trucos de ventanas. ⌘⇧L y ⌘⇧R ajustan las ventanas a la mitad izquierda o derecha de la pantalla. El agente a un lado, el documento al otro. Y fijar arriba (el icono de pin en la barra de herramientas, o el menú Ventana) mantiene el documento flotando por encima de lo que sea que estés haciendo. Se acabó ejecutar cat sobre el mismo archivo una y otra vez para ver si el agente ya lo ha tocado.
Paso 3: Marcarlo y devolverlo
Leer la salida de la IA es la mitad del trabajo; la otra mitad es decirle a la IA qué cambiar. Para eso están las anotaciones de Peekdown. Selecciona texto renderizado y aparece una barra flotante con cinco marcas:
- Tachar (S): borra esto
- Bloquear (L): no toques esto
- Comentario (C): cambia esto, y así es como
- Nota (⌘⇧N): instrucciones a nivel de documento, como "añade una sección de conclusiones"
- Nota de bloque (⌘⇧B): indicaciones para un párrafo, lista o bloque de código entero
Cuando termines, ⌘⌥⇧C copia todo como un prompt estructurado: un array JSON en el que cada anotación lleva contexto de antes y después, para que la IA pueda encontrar el texto exacto. Pégalo en Claude Code, Cursor, ChatGPT, el que uses; en una terminal, pbpaste | claude lo envía directamente. Peekdown entonces limpia las anotaciones para que las ediciones de la IA caigan sobre un documento limpio, guarda una instantánea por si quieres recuperarlas (⌘⌥⇧Z), y puede escribir el conjunto completo en un archivo .json junto al documento (⌘⌥⇧E).
Y como el archivo está vigilado, el documento que tienes delante se actualiza solo cuando el agente aplica tus correcciones.
Los archivos de configuración también
Abres CLAUDE.md, llms.txt y .cursorrules constantemente para comprobar qué se les está diciendo a tus herramientas. En realidad son prosa, y Peekdown abre y renderiza los tres, así que un CLAUDE.md se lee como el documento que es.
La configuración completa
Una extensión de Vista rápida para clasificar: QLMarkdown gratis, o la de Peekdown. glow si eres de terminal. Y para el ciclo completo, Peekdown como app predeterminada: recarga automática activada, el plan fijado junto al agente, anotaciones para las correcciones. Peekdown cuesta $4.99 en pago único y necesita macOS 15.0 o posterior; la mitad de clasificación no cuesta nada en absoluto. Si todavía estás eligiendo visor, la comparativa compara siete.