¿Quieres desactivar el pensamiento? claude-haiku-5-5 da error cuando effort es superior a high

Nota del autor: claude-haiku-5-5 piensa por defecto, ¿y quieres desactivarlo y obtienes un error? Lo más probable es que effort esté por encima de high. Este artículo explica las reglas, la solución en tres pasos y los límites de los parámetros.

Hacer que claude-haiku-5-5 piense menos y reservar el presupuesto de salida para el texto principal es una necesidad muy común al ejecutar procesamiento por lotes y tareas estructuradas. Puede que ya hayas puesto thinking en disabled y, aun así, la API devuelva un error: justamente quieres desactivar el pensamiento, ¿por qué te bloquean? Este artículo presenta las reglas de combinación entre effort y disabled para ayudarte a dominar rápidamente la forma correcta de desactivar el pensamiento en claude-haiku-5-5.

No es un problema esotérico ni el modelo volviéndose loco. La documentación lo dice claramente: si no pasas thinking a claude-haiku-5-5, se usa el pensamiento adaptativo, activado por defecto; para desactivar el pensamiento se usa type: disabled dentro de thinking, pero esta forma solo se acepta cuando effort no es superior a high. Los parámetros de este artículo se basan en la documentación oficial de Anthropic del 2026-11-08 (UTC+8), con fecha de verificación 2026-11-13.

Valor principal: al terminar este artículo, entenderás la causa real del error, el método de corrección en tres pasos y la relación entre max_tokens y los tokens de pensamiento; después, no importa en qué entorno hagas la invocación, esta regla ya no te bloqueará.

Puntos clave de claude-haiku-5-5

Vamos directo al grano: si andas con prisa, con esta sección tienes más que suficiente.

Punto clave	Según la documentación	Impacto para ti
Pensamiento activado por defecto	Si no envías thinking, se aplica pensamiento adaptativo, activado por defecto	Si quieres ahorrar cuota, debes desactivarlo explícitamente
Interruptor de apagado	thinking con type: disabled	Es la única forma de desactivarlo
Requisito de effort	Solo acepta disabled cuando effort no supera high	Si lo combinas con xhigh o max, dará error
Valor por defecto de effort	medium por defecto, igual que en claude-opus-5-5	Mientras no lo subas tú, no caerás en la trampa
Límites de cuota	Salida máxima de 128000; los tokens de pensamiento cuentan dentro de max_tokens	El pensamiento le resta espacio al texto de respuesta

Detalle de los puntos importantes de claude-haiku-5-5

Primero: por defecto, piensa. claude-haiku-5-5 es un modelo que se ejecuta con capacidad de pensamiento activada de serie: cuando el campo thinking no aparece en la petición, funciona en modo de pensamiento adaptativo. La documentación no entra en los detalles concretos de cómo decide el modo adaptativo, pero lo que sí queda claro es que, en el estado por defecto, el pensamiento está encendido.

Si tu caso de uso es de pregunta corta y respuesta breve, etiquetado masivo, conversión de formatos o tareas similares que no necesitan mucha inferencia profunda, los tokens de pensamiento son puro gasto. La documentación también indica que los tokens de pensamiento se contabilizan dentro de max_tokens, con una salida máxima de 128000: cuanto más piense, menos cuota queda para el texto de la respuesta. De ahí viene justamente la necesidad de «desactivar el pensamiento y reservar la cuota para el cuerpo de la respuesta».

Segundo: desactivarlo tiene condiciones. El único interruptor para apagar el pensamiento es poner thinking en type: disabled. Pero la documentación también especifica que esta forma solo se acepta cuando effort no supera high: con effort en medium o high todo va bien, pero en cuanto lo configuras como xhigh o max, la petición devuelve error. La solución que da la propia documentación también es muy clara: baja effort a high o menos. Si llamas a claude-haiku-5-5 a través de APIYI apiyi.com, cuando depures este tipo de errores empieza igualmente por revisar esta combinación de parámetros.

Tercero: el valor por defecto es, curiosamente, el seguro. En claude-haiku-5-5 el effort por defecto es medium, igual que en claude-opus-5-5, mientras que en la mayoría de los demás modelos es high. La ruta típica por la que se cae en el error suele ser esta: migras código desde otro modelo, subes effort de forma maquinal a xhigh o max para ganar calidad, y al mismo tiempo añades disabled pensando en controlar costes; las dos intenciones chocan y aparece el error.

Al contrario, basta con no subir effort activamente: el medium por defecto cumple de forma natural la condición de «no superar high» y disabled funciona sin problema. Cuando necesites cambiar entre distintos modelos para compararlos, con APIYI apiyi.com puedes invocar varios modelos con una sola clave API, y te ahorras estar tocando una y otra vez la configuración de acceso.

El diagrama de arriba es la ruta de depuración estándar; el caso más habitual se atasca en el rombo de decisión del medio: effort fuera de rango. Después de corregirlo, conviene hacer primero una prueba con poca cuota en APIYI apiyi.com para verificar que la respuesta es normal, y solo entonces pasarlo al tráfico de producción.

Primeros pasos con claude-haiku-5-5: solución en tres pasos

No hace falta revisar documentación extensa. Con estos tres pasos, este tipo de error debería quedar resuelto:

1. Confirma el ID del modelo: el model de la solicitud debe ser claude-haiku-5-5; descarta primero cualquier confusión causada por un nombre de modelo incorrecto.
2. Reduce el effort: establécelo en high o menos. medium es el valor predeterminado, así que también puedes omitirlo; lo importante es no enviar xhigh ni max.
3. Desactiva también el razonamiento: establece thinking en {"type": "disabled"}. En ese caso, con effort no superior a high, la solicitud se aceptará con normalidad.

Consulta rápida de parámetros de solicitud de claude-haiku-5-5

Parámetro	Valor recomendado	Descripción
model	claude-haiku-5-5	El modelo del que trata este artículo; asegúrate de no escribirlo como otra versión
thinking	{"type": "disabled"}	El único interruptor para desactivar el razonamiento
effort	medium (predeterminado) o high	No debe ser superior a high; de lo contrario, entra en conflicto con disabled
Valores deshabilitados de effort	xhigh, max	Combinados con disabled, provocan un error
max_tokens	Máximo 128000	Los tokens de razonamiento cuentan dentro de este valor; al desactivar el razonamiento, todo el espacio queda disponible para el contenido de la respuesta

La información del lado de la integración tampoco es compleja. Tomemos APIYI como ejemplo:

• Dirección de acceso: https://api.apiyi.com/v1
• Autenticación: basta una clave API
• Estilo de API: interfaz compatible con OpenAI
• Facturación: pago por uso, precios competitivos y crédito de prueba gratuito para nuevos usuarios
• Cobertura: OpenAI, Claude, Gemini y otros modelos populares

🚀 Inicio rápido: te recomendamos completar esta verificación en APIYI (apiyi.com). Regístrate, ejecuta una vez la solicitud corregida con el crédito de prueba gratuito, confirma que disabled funciona correctamente y que el error ha desaparecido; después intégrala en tu entorno real. En pocos minutos habrás cerrado el ciclo.

Compatibilidad de effort en claude-haiku-5-5

La siguiente tabla es la más importante de todo el artículo; te recomiendo guardarla directamente en las notas del equipo:

Valor de effort	Combinación con disabled	Resultado
medium (predeterminado)	Compatible	Desactiva el pensamiento con normalidad
high	Compatible	Desactiva el pensamiento con normalidad
xhigh	Conflicto	La solicitud devuelve error
max	Conflicto	La solicitud devuelve error

Si comparas tu propia solicitud con esta tabla, la dirección queda clara: siempre que el error aparezca en una solicitud que también envía disabled, lo primero que debes revisar es si el effort ha cruzado la línea de high. La única solución documentada es una sola frase: bajar effort a high o a un valor inferior; no existe ninguna otra forma de sortearlo.

Comparativa del effort predeterminado entre claude-haiku-5-5 y otros modelos

Modelo	effort predeterminado	Relación con desactivar el pensamiento
claude-haiku-5-5	medium	De forma predeterminada cumple «no superar high», por lo que disabled puede surtir efecto directamente
claude-opus-5-5	medium	El valor predeterminado coincide con haiku; las reglas de su interruptor de pensamiento no se detallan en este artículo
La mayoría de los demás modelos	high	El valor predeterminado también queda dentro del umbral; solo al subirlo manualmente se cruza el límite

Esta tabla explica «por qué justamente mi solicitud devuelve error»: el effort predeterminado varía según el modelo, y al migrar código arrastrando viejas costumbres de parámetros es fácil establecer effort explícitamente en xhigh o max. Comparar con los valores predeterminados antes de migrar es la medida preventiva de menor coste.

Lista de verificación para solucionar errores y autocomprobación de claude-haiku-5-5

Síntoma	Causa más probable	Cómo resolverlo
Pasaste disabled y aun así da error	effort está en xhigh o max	Baja effort a high o menos
No sabes cuánto vale effort	Si no lo pasas, por defecto es medium	El valor por defecto ya cumple el umbral, no hace falta hacer nada más
El cuerpo de la respuesta se acorta o se corta	Los tokens de pensamiento se cuentan dentro de max_tokens	Desactiva el pensamiento, o sube max_tokens dentro del límite de 128000
Quieres una calidad de razonamiento más profunda	Al desactivar el pensamiento te quedas sin proceso de razonamiento	Quita disabled y vuelve al pensamiento adaptativo por defecto

Una vez corregido, repasa esta lista de autocomprobación antes de enviar la solicitud:

• model está escrito correctamente como claude-haiku-5-5
• effort está omitido, o explícitamente en medium o high
• thinking es {"type": "disabled"}
• max_tokens no supera 128000

Si se cumplen las cuatro condiciones, este tipo de errores no volverá a aparecer. Y si fijas la combinación final de parámetros como plantilla de solicitud, también evitas que se modifiquen por error más adelante.

Preguntas frecuentes (FAQ) sobre claude-haiku-5-5

Q1: ¿claude-haiku-5-5 piensa por defecto?

Sí. Según la documentación, cuando no se pasa `thinking`, claude-haiku-5-5 funciona con pensamiento adaptativo, activado por defecto. Si quieres que todo el presupuesto de salida se destine al texto de la respuesta, tienes que pasar `disabled` de forma explícita para desactivarlo.

Q2: ¿Por qué sigue dando error aunque paso `disabled`?

La causa más habitual es que `effort` esté por encima de `high`. La documentación especifica que `disabled` solo se acepta cuando `effort` no supera `high`; combinarlo con `xhigh` o `max` provoca error, y la corrección consiste en bajar `effort` a `high` o menos.

Q3: ¿Qué pasa si no paso `effort`?

El valor por defecto es `medium`. claude-haiku-5-5 comparte el mismo valor por defecto que claude-opus-5-5, ambos `medium`, mientras que la mayoría de los demás modelos usan `high` por defecto. Esa configuración por defecto ya cumple la condición de «no superar high», así que se puede combinar directamente con `disabled`.

Q4: ¿Cómo cambia la longitud de salida al desactivar el pensamiento?

La documentación indica que los tokens de pensamiento se contabilizan dentro de `max_tokens`, con una salida máxima de 128000. Al desactivar el pensamiento, el mismo presupuesto de `max_tokens` puede destinarse por completo al texto de la respuesta, y también baja el riesgo de truncamiento.

Q5: ¿Qué hago si puntualmente quiero un razonamiento más profundo?

Quita `disabled` y deja que claude-haiku-5-5 vuelva al pensamiento adaptativo por defecto. Si además quieres subir `effort`, evita quedarte en la combinación «`xhigh` o `max` más `disabled`».

Q6: ¿Cómo verificar rápido si la corrección ha surtido efecto?

Regístrate en APIYI apiyi.com y obtén crédito de prueba gratuito; usa como endpoint `https://api.apiyi.com/v1` y ejecuta una vez los parámetros corregidos: si la petición deja de dar error y el texto se devuelve con normalidad, significa que `disabled` ya funciona. La plataforma cobra por uso, así que validar con un consumo pequeño cuesta muy poco.

Q7: ¿El error viene siempre de `effort`?

No necesariamente, pero es una de las causas que la documentación recoge de forma explícita. Primero comprueba que `model` esté escrito exactamente como `claude-haiku-5-5`; después revisa si la combinación de `thinking` y `effort` se sale de los límites permitidos; si nada de eso es el problema, mira otras causas. Cuando llamas a través de APIYI y te encuentras con un error, empieza también por este par de parámetros.

Q8: ¿Qué versión es la referencia para estos criterios de parámetros?

Este artículo se basa en la documentación oficial de Anthropic del 2026-11-08 (UTC+8), verificada el 2026-11-13. Si Anthropic ajusta más adelante las reglas de `effort` y `disabled`, prevalece la documentación más reciente.

Resumen

Desactivar el pensamiento (thinking) en claude-haiku-5-5 se reduce a cuatro puntos clave:

1. Piensa por defecto: si no envías thinking, se aplica el pensamiento adaptativo, que viene activado por defecto; si quieres ahorrar cuota, tienes que desactivarlo de forma explícita.
2. Desactivarlo tiene requisitos: cuando thinking se establece en disabled, effort no puede ser superior a high; combinarlo con xhigh o max devuelve error.
3. El valor por defecto es seguro: effort vale medium por defecto, igual que en claude-opus-5-5; mientras no lo subas manualmente, no se produce conflicto.
4. Límites de cuota: la salida máxima es 128000, los tokens de pensamiento cuentan dentro de max_tokens y, al desactivarlo, toda la cuota queda disponible para el texto de la respuesta.

La próxima vez que te topes con ese «quiero desactivar el pensamiento y me da error», lo primero es revisar si effort ha cruzado la línea de high; con ordenar bien la combinación de parámetros, el problema queda prácticamente resuelto. Te recomiendo usar la cuota de prueba gratuita de APIYI (apiyi.com) para verificar el resultado rápidamente: con una sola clave API puedes invocar claude-haiku-5-5 y otros modelos populares, y la interfaz compatible con OpenAI también facilita bastante cambiar de modelo.

📚 Referencias

1. Documentación de APIYI: descripción de los parámetros effort y thinking de Claude
2. Enlace: docs.apiyi.com/api-capabilities/claude-effort-thinking.md

3. Descripción: valores de effort, condiciones de aceptación de disabled y criterio de los mensajes de error

4. Documentación de APIYI: actualización de la guía de pensamiento de Claude (2026-11)

5. Enlace: docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md

6. Descripción: registro de cambios y contexto de las guías relacionadas con el pensamiento

7. Documentación oficial de Anthropic

8. Enlace: docs.anthropic.com
9. Descripción: los parámetros de este artículo siguen el criterio oficial de la versión del 2026-11-08 (UTC+8)

---

Autor: equipo técnico de APIYI
Contacto técnico: puedes escribirnos desde la página de inicio del sitio de APIYI; para más material, visita el centro de documentación