{ "id": 2252, "status": "publish", "lang": "es", "slug": "claude-code-headless-haiku-guard", "url": "https://soymarketingultra.com/claude-code-headless-haiku-guard/", "title": "Claude Code Headless: el Haiku Fantasma que Rompe Tu Guard", "excerpt": "Claude Code usa Haiku internamente para tareas auxiliares y tu guard de modelo no lo distingue del trabajo real. Tres heurísticas rotas y el fix que funciona.", "date_gmt": "2026-06-25T07:34:24Z", "modified_gmt": "2026-07-09T20:22:13Z", "categories": [ { "slug": "seo-es", "name": "SEO", "url": "https://soymarketingultra.com/category/seo-es/" } ], "tags": [ { "slug": "anthropic", "name": "Anthropic" }, { "slug": "automatizacion-ia", "name": "automatización IA" }, { "slug": "claude-code", "name": "claude-code" }, { "slug": "inteligencia-artificial-es", "name": "Inteligencia artificial" } ], "featured_image": { "url": "https://soymarketingultra.com/wp-content/uploads/cabecera-2252.png", "alt": "Cabecera del artículo: Claude Code Headless: el Haiku Fantasma que Rompe Tu Guard", "width": 1200, "height": 675 }, "translation": { "lang": "en", "url": "https://soymarketingultra.com/en/claude-code-headless-model-detection/", "id": 2254 }, "seo": { "title": "Claude Code Headless: el Haiku Fantasma que Rompe Tu Guard", "description": "Claude Code headless ejecuta llamadas internas a Haiku que contaminan .modelUsage. Tres heurísticas rotas y el fix para detectar qué modelo trabajó de verdad.", "focus_keyword": "claude code headless" }, "html": "

Montas un guardia de seguridad para tu pipeline de IA. La orden es clara: si un modelo barato genera el contenido, páralo antes de que se publique. Y el guardia cumple. Varias veces a lo largo de dos semanas, tira a la basura trabajo perfecto de tu modelo caro. ¿El motivo? Claude Code usa Haiku internamente para ponerle nombre a la sesión, y tu guardia no sabe distinguir esa llamada interna del trabajo real.

\n\n

El asesino llamando a la policía. Bienvenido a operar LLMs en producción.

\n\n
\n
\n \"Mascota\n

TL;DR: El resumen sin rodeos

\n
\n
\n \n
\n \n Veredicto: si operas LLMs en pipeline, no te fíes del log. Abre el transcript y verifica qué modelo trabajó de verdad.\n
\n
\n
\n\n

¿Qué hace Claude Code con Haiku cuando tú no miras?

\n\n

Claude Code en modo headless (claude -p) mezcla modelos internos con el modelo solicitado en la misma sesión: ejecuta llamadas a Haiku para tareas auxiliares (nombrar la sesión, routing) que tú ni pediste ni necesitas. Esos turnos aparecen en el campo .modelUsage y en el transcript JUNTO a tu trabajo real, sin nada que los distinga.

\n\n

¿Y sabéis qué significa eso? Que cualquier lógica que mire qué modelo respondió sin filtrar esas llamadas internas se va a equivocar. No a veces. SIEMPRE.

\n\n

Hay más. En claude -p, el flag --model se ignora. Solo funciona la variable de entorno ANTHROPIC_MODEL. Si no la fijas explícitamente, el CLI coge un default que puede estar obsoleto. Y si tu plan Max está cerca del límite de uso, Claude Code degrada a Haiku en silencio. Sin warning. Sin error. is_error: false.

\n\n

En Marketing Ultra descubrimos esto el 14 de junio depurando nuestro pipeline de contenido con IA. Lo que vino después fue peor.

\n\n

Tres heurísticas rotas, tres formas de morder

\n
\"Diagrama
\n\n

Probamos tres métodos para detectar qué modelo había respondido de verdad. Los tres nos mordieron.

\n\n

keys[0]: primer modelo en orden alfabético. \"Haiku\" va antes que \"Opus\" en el abecedario. Nuestro heartbeat usaba este método. Resultado: reportó Haiku 24/7 durante ~14 días. Todo el histórico de modelo en los logs, contaminado. Catorce días de datos falsos que tardamos en detectar porque el pipeline funcionaba bien. Solo el registro era mentira.

\n\n

sort_by(-outputTokens)[0]: el modelo con más tokens de salida. Parece el método inteligente, ¿verdad? El que más genera es el que hizo el curro. Hasta que Opus te devuelve una respuesta corta y el título generado por Haiku tiene más tokens que la respuesta real. El log dice Haiku. El trabajo es Opus.

\n\n

Exact key match contra un ID conocido. Los IDs de modelo llevan fecha embebida: claude-opus-4-6-20250401. Nuestro guard comparaba contra claude-opus-4-6 a secas. No coincidía. Exit 75: \"modelo degradado\". Trabajo perfecto de Opus desechado. Varias veces.

\n\n

Tres heurísticas \"obvias\". Tres formas de morder. Todas por el mismo fallo de fondo: asumir que .modelUsage refleja solo TU trabajo.

\n\n

El misdiagnóstico que nos costó 697 segundos de Opus

\n\n

19 de junio. El guard va por la versión 3. Lee el transcript directamente. Problema resuelto.

\n\n

¿Seguro?

\n\n

El guard cogía el ÚLTIMO turno de assistant con tail -1. Y el último turno era el título que genera Haiku. El SEO Strategist acababa de producir una estrategia completa con Opus. 697 segundos de cómputo. El guard mira el transcript, ve Haiku al final, marca model_downgraded.

\n\n

Once minutos de modelo caro. A la basura.

\n\n

Pero la parte que me jode de verdad es lo que vino después. Miro el log de errores buscando patrón. Encuentro entradas viejas con model_downgraded y un hint: \"Max usage limit\". Leo el texto del error. Asumo que es la cuota del plan Max cerca del tope. Tiene sentido, ¿no?

\n\n

No. Dani lo cazó revisando la cronología: las fechas no cuadraban. Esas entradas no eran degradaciones reales. Eran falsos positivos de heurísticas anteriores que habían dejado basura en el log. El hint \"Max usage limit\" estaba hardcodeado como mensaje por defecto cuando el guard no podía determinar la causa.

\n\n

Yo leí el texto del error en vez de verificar el transcript original. Y eso me llevó a \"arreglar\" algo que no estaba roto, ignorando lo que sí lo estaba.

\n\n

Y esto aplica a TODO, no solo a IA: un log que dice \"cuota agotada\" no significa que la cuota esté agotada. Significa que algo escribió \"cuota agotada\" en el log. Verifica el dato de origen, no el mensaje derivado. SIEMPRE.

\n\n

¿Cómo saber qué modelo trabajó de verdad en Claude Code?

\n
\"Guardia
\n\n

El fix robusto (v5) es simple una vez pillas la mecánica:

\n\n
    \n
  1. Lee .modelUsage del transcript.
    2. \n
  2. Excluye TODOS los modelos Haiku. Son llamadas internas, housekeeping.
    3. \n
  3. Del resto, coge el que tenga más outputTokens. Ese hizo tu trabajo.
    4. \n
  4. Solo si TODOS los modelos son Haiku: degradación real. Márcalo.
    5. \n
\n\n

Añadimos un test permanente que simula un transcript con Haiku + Opus y verifica que el guard reporta Opus. Si alguien toca la lógica y la rompe, el test lo caza antes de producción. Cero confianza, verificación automática.

\n\n

Esto aplica a cualquiera que opere agentes de IA en pipelines reales: para saber qué modelo trabajó, nunca cojas el primero, ni el último, ni el de más tokens a secas. Excluye las llamadas internas y mira solo el trabajo real.

\n\n

Si operas LLMs en producción, no basta con pedir Opus. Tienes que verificar que Opus respondió.

\n\n

La próxima vez que tu guard salte y el log te cuente una historia, abre el transcript. Lee lo que pasó de verdad. Esto no es un edge case. Esto es operar IA en serio.

\n\n
\n
\n

Preguntas frecuentes sobre Claude Code headless y detección de modelo

\n

¿Qué es el modo headless de Claude Code (claude -p)?

\n

Es el modo de Claude Code sin interfaz interactiva, pensado para pipelines y automatización. Le pasas un prompt por stdin o argumento, ejecuta y te devuelve el resultado por stdout en JSON. El flag --model no funciona en este modo: el modelo se controla exclusivamente con la variable de entorno ANTHROPIC_MODEL.

\n

¿Qué es .modelUsage en el transcript de Claude Code?

\n

Es un campo del JSON de salida que lista todos los modelos invocados durante la sesión con sus tokens consumidos. Incluye tanto el modelo que hizo tu trabajo como los que se usan internamente (Haiku para nombrar la sesión), así que no sirve para saber qué modelo trabajó de verdad si no filtras las llamadas internas.

\n
", "markdown_url": "https://soymarketingultra.com/claude-code-headless-haiku-guard.md" }