Nota del autor: Este artículo se basa en la documentación oficial de Anthropic del 2026-11-08 (UTC+8) y en la guía de APIYI sobre los parámetros de pensamiento (thinking) de Claude, actualizada el 2026-11-09 a las 10:40. La fecha de verificación de criterios es 2026-11-13. Todo ello para ayudarte a evitar el error 400 en el parámetro thinking con claude-opus-5-5 y claude-sonnet-5-5.
Si en claude-opus-5-5 estableces el type de thinking en disabled, la API devuelve directamente un 400; así lo establece la documentación oficial de Anthropic del 2026-11-08 (UTC+8). APIYI (apiyi.com) actualizó el 2026-11-09 a las 10:40 la guía de parámetros de pensamiento de Claude y dejó claras las formas correctas de escribir los ID de ambos modelos. Este artículo explica rápidamente cómo este cambio afecta a quienes llaman a la API de Claude.
Esto no es un rumor: ambas conclusiones clave se basan en la documentación: claude-opus-5-5 no puede desactivar el pensamiento, solo reducir effort; en claude-sonnet-5-5, para desactivar el pensamiento previo hay que usar between_tools.
Valor clave: en 3 minutos conocerás la sintaxis correcta de los ID de ambos modelos, los límites del parámetro between_tools y cómo diagnosticar el error 400.
Resumen rápido de la información clave: los criterios de thinking para claude-opus-5-5 y claude-sonnet-5-5
Primero la tabla de conclusiones, luego el detalle punto por punto:
| Aspecto | Detalle |
|---|---|
| Criterio oficial | Documentación oficial de Anthropic, 2026-11-08 (UTC+8) |
| Actualización de la guía de APIYI | 2026-11-09 10:40, docs.apiyi.com ya sincronizado |
| claude-opus-5-5 | Si no se envía thinking, el razonamiento es adaptativo; enviar disabled devuelve 400 |
| claude-sonnet-5-5 | Si no se envía thinking, también es razonamiento adaptativo; para desactivar el razonamiento previo se usa between_tools |
Valor por defecto de effort |
medium para Opus 5.5, high para Sonnet 5.5 |
| Salida máxima | Ambos IDs de modelo son 128000, los tokens de razonamiento se cuentan dentro de ese límite |
Los criterios de claude-opus-5-5 son bastante directos. Cuando no se envía el campo thinking en la solicitud, el modelo entra en razonamiento adaptativo y decide por sí mismo si razona en esa ocasión y con qué profundidad; en cambio, si se establece el type de thinking en disabled, la interfaz no lo ignora silenciosamente, sino que devuelve directamente un 400. En otras palabras, este ID de modelo no tiene un interruptor para desactivar el razonamiento, y la única forma de ajustarlo que indica la documentación es reducir el effort, cuyo nivel por defecto es medium.
La situación de claude-sonnet-5-5 es algo diferente. También admite razonamiento adaptativo cuando no se envía thinking, pero tiene una vía adicional oficialmente reconocida para desactivarlo: establecer el type en between_tools, con lo que se desactiva el razonamiento previo y solo se conservan las actualizaciones de progreso entre llamadas de herramientas. Los límites de esta vía también están bien documentados, conviene consultar la siguiente tabla directamente:
| Restricción | Criterio documentado |
|---|---|
Valores de effort |
Solo acepta low, medium, high |
| Nivel máximo | No puede ser superior a high |
| Restricciones de combinación | No se puede usar junto con display o budget_tokens |
| Efecto real | Desactiva el razonamiento previo y solo conserva las actualizaciones de progreso entre llamadas de herramientas |
Hay otro detalle fácil de pasar por alto: los tokens de razonamiento cuentan dentro de max_tokens. La salida máxima de ambos IDs de modelo es 128000; si la solicitud establece max_tokens demasiado bajo, el razonamiento podría consumir primero la mayor parte del presupuesto y el texto principal quedaría truncado. Al diagnosticar el problema de «la respuesta se vuelve más corta sin motivo», vale la pena confirmar primero cuánto ocupa el razonamiento.
Nota de la figura: la cadena de llamadas del diagrama toma como ejemplo la puerta de enlace de formato nativo de Anthropic de APIYI apiyi.com. Al usar el formato de Anthropic, la dirección base es https://api.apiyi.com, ten en cuenta no escribirla con /v1.
Análisis de impacto: ¿a qué llamadores afecta el error 400 por disabled?
Los cambios en este criterio afectan a los llamadores principalmente en tres áreas: manejo de errores, combinación de parámetros y planificación de presupuesto. Si los desglosamos uno por uno, se ve mucho más claro.
Impacto en código existente: migración del uso de disabled
| Escenario | Uso anterior | Resultado actual | Forma correcta |
|---|---|---|---|
| claude-opus-5-5 quiere desactivar el pensamiento | type con disabled |
Devuelve 400 | No se puede desactivar; solo queda bajar effort |
| claude-sonnet-5-5 quiere desactivar el pensamiento previo | type con disabled |
Devuelve 400 | Cambiar a between_tools |
| Quiere controlar finamente el presupuesto de pensamiento | between_tools combinado con budget_tokens |
La combinación no se acepta | No se pueden enviar juntos; usar los tres niveles de effort |
| Le preocupa que el pensamiento desplace la salida | Poner max_tokens muy bajo |
El texto principal queda truncado | El pensamiento cuenta dentro de max_tokens, hay que reservar margen |
El primer impacto es que hay más restricciones en la combinación de parámetros. between_tools no puede aparecer junto con budget_tokens ni con display, lo que significa que la idea de controlar finamente el presupuesto de pensamiento deja de funcionar por esta vía; solo queda regularlo indirectamente con los tres niveles low, medium y high. Sumado a la regla de que «los tokens de pensamiento cuentan dentro de max_tokens«, los llamadores tienen que volver a encontrar el equilibrio entre effort y max_tokens.
El segundo impacto es que la lógica de ramificación debe actualizarse. Si el script decide si envía disabled según el ID del modelo, al encontrarse con estos dos ID habrá que ramificar: el primero asume la realidad de que «no se puede desactivar» y baja de nivel con effort; el segundo se cambia a between_tools. Conviene concentrar este tipo de ramificaciones en un único lugar de configuración, así, si el criterio vuelve a cambiar más adelante, la superficie de modificación será mínima.
Como dato adicional, la misma página también indica que Fable 5.1 y Fable 5 devuelven igualmente 400 al enviar disabled, o sea, tampoco se puede desactivar; en cambio, Haiku 5.5 y Opus 5 todavía pueden usar disabled siempre que effort no supere high. Si el código atiende varios ID de modelo a la vez, lo recomendable es mantener una matriz de interruptores por modelo, en lugar de aplicar globalmente la misma forma de escritura.
Impacto en la estructura de costos: thinking token y consumo
En la tabla general de precios de APIYI (apiyi.com), claude-sonnet-5-5 se factura a $2 de entrada, $10 de salida y $0.1 por lectura de caché. Como los tokens de pensamiento cuentan dentro de max_tokens, tanto si se desactiva el pensamiento previo como qué nivel de effort se elige se reflejan directamente en el consumo de tokens. En escenarios de llamadas de alta frecuencia, esta diferencia se amplifica, y vale la pena echar una cuenta rápida al modificar el código.
Nota de la imagen: los criterios se recopilaron de la documentación oficial del 2026-11-08 y se pueden verificar contra el texto original en el centro de documentación de APIYI apiyi.com.
| ID del modelo | Disponibilidad de disabled |
Criterio documentado |
|---|---|---|
| claude-opus-5-5 | No disponible, devuelve 400 | No se puede desactivar el pensamiento; solo bajar effort (por defecto medium) |
| claude-sonnet-5-5 | No disponible, devuelve 400 | Cambiar a between_tools (por defecto high) |
| Fable 5.1 / Fable 5 | No disponible, devuelve 400 | Tampoco se puede desactivar |
| Haiku 5.5 / Opus 5 | Disponible cuando effort no supera high |
La forma antigua solo funciona en estos dos ID |
Cómo verificar rápidamente between_tools de claude-sonnet-5-5
Antes de desplegar un cambio, conviene validar las diferencias de comportamiento con tráfico reducido. Regístrese en APIYI (apiyi.com) y obtenga una clave API; los nuevos usuarios disponen de crédito de prueba gratuito. Envíe la solicitud a https://api.apiyi.com, establezca type de thinking en between_tools, elija cualquiera de los tres niveles de effort y haga una primera ejecución. Después, compárela con el modo adaptativo sin thinking para observar cambios en la estructura de salida y en el uso de tokens.
🚀 Sugerencia para una validación rápida: obtenga crédito de prueba gratuito a través de APIYI apiyi.com y use la misma indicación para ejecutar por separado los modos
between_toolsy adaptativo. Confirme las diferencias antes de modificar el código existente. La plataforma permite invocar de forma unificada modelos populares como Claude, OpenAI y Gemini; su interfaz compatible con OpenAI se factura por consumo, lo que facilita comparar y cambiar entre modelos.
Preguntas frecuentes: disabled, between_tools y errores 400
P1: ¿Se puede desactivar realmente el pensamiento en claude-opus-5-5?
No. La posición oficial del 2026-11-08 indica claramente que enviar `disabled` devuelve un error 400: este ID de modelo no tiene una opción para desactivar el pensamiento, solo permite reducir la profundidad de pensamiento mediante `effort`, cuyo nivel predeterminado es `medium`. Si el caso de uso exige ausencia total de pensamiento, la única opción es cambiar de ID de modelo.
P2: ¿Se puede combinar between_tools con budget_tokens en claude-sonnet-5-5?
No. La documentación especifica claramente que `between_tools` no puede incluir `display` ni `budget_tokens` al mismo tiempo; el `effort` correspondiente solo acepta los tres niveles `low`, `medium` y `high`, y no puede ser superior a `high`. Si necesita controlar con precisión el presupuesto de pensamiento, solo puede volver al modo adaptativo o cambiar de ID de modelo.
P3: ¿Por qué mi solicitud a Claude de repente devuelve un error 400?
Primero revise si en el cuerpo de la solicitud estableció `type` de `thinking` como `disabled`; en claude-opus-5-5 y claude-sonnet-5-5, esta es la condición documentada que provoca el error. Una vez confirmado, aplique la tabla comparativa de este artículo: para el primero, reduzca `effort`; para el segundo, cambie a `between_tools`. La forma de uso aplicable se rige por la documentación oficial del 2026-11-08 (UTC+8); la página de APIYI se sincronizó el 2026-11-09 a las 10:40.
P4: ¿Cómo verificar rápidamente el efecto de between_tools en claude-sonnet-5-5?
Regístrese en APIYI (apiyi.com) y obtenga una clave API; los nuevos usuarios disponen de crédito de prueba gratuito. Envíe la solicitud a `https://api.apiyi.com`, establezca `type` de `thinking` en `between_tools` y elija cualquier nivel de `effort`. Con una sola ejecución podrá comparar las diferencias respecto al modo adaptativo.
P5: ¿Los tokens de pensamiento reducen el presupuesto de salida?
Sí. Los tokens de pensamiento cuentan dentro de `max_tokens`; la salida máxima de ambos ID de modelo es 128000. Si `max_tokens` se establece demasiado bajo en la solicitud, el pensamiento puede consumir primero el presupuesto y truncar el cuerpo de la respuesta. Se recomienda reservar espacio suficiente para el cuerpo.
claude-opus-5-5 y claude-sonnet-5-5: puntos clave
- En claude-opus-5-5 no se puede desactivar el razonamiento: si envías
disabled, recibes un 400 directo; lo único que puedes hacer es bajar de nivel coneffort, cuyo valor por defecto esmedium. - claude-sonnet-5-5 pasa a
between_tools: desactiva el razonamiento previo y deja únicamente las actualizaciones de progreso entre llamadas a herramientas. - Tres límites infranqueables en los parámetros:
effortsolo admitelow,mediumyhigh, no puede ir más allá dehigh, y queda prohibido combinarlo condisplayybudget_tokens. - Regla de presupuesto: los tokens de razonamiento se contabilizan dentro de
max_tokens, y el límite es de 128000 en ambos ID. - Punto de entrada para validar: APIYI apiyi.com. La base en formato Anthropic es
https://api.apiyi.com, sin añadir/v1.
Resumen: tres acciones para evitar el 400
El criterio para claude-opus-5-5 y claude-sonnet-5-5 se puede condensar en tres frases:
- claude-opus-5-5: enviar
disabledprovoca un 400, el razonamiento no se puede desactivar y la única vía es reducireffort. - claude-sonnet-5-5: desactiva el razonamiento previo y usa
between_tools, con tres niveles deefforty sin combinar condisplaynibudget_tokens. - Presupuesto: los tokens de razonamiento van dentro de
max_tokens, cuyo límite es 128000; deja margen para el cuerpo de la respuesta.
Si estás atascado con este 400, te recomiendo empezar en APIYI apiyi.com y lanzar una ronda de between_tools con la cuota de prueba gratuita; cuando confirmes el comportamiento, actualiza tu código existente. Con una sola clave API de la plataforma puedes invocar modelos populares como OpenAI, Claude y Gemini, con pago por consumo, ideal para comparar y cambiar rápido.
📚 Referencias
- Guía de parámetros de pensamiento de Claude de APIYI: uso adecuado de effort y thinking
- Enlace:
docs.apiyi.com/api-capabilities/claude-effort-thinking.md -
Descripción: versión actualizada el 2026-11-09 a las 10:40, principal fuente de datos de este artículo
-
Actualización de la guía de APIYI: comunicado oficial sobre la sincronización de criterios de esta ronda
- Enlace:
docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md -
Descripción: documenta el proceso de alineación con la documentación oficial del 2026-11-08
-
Documentación oficial de Anthropic: criterio original del parámetro thinking
- Enlace:
docs.anthropic.com - Descripción: se recomienda leer en paralelo para confirmar la redacción más reciente
Autor: Equipo técnico de APIYI
Contacto técnico: puedes contactarnos desde la página de inicio del sitio web de APIYI; para más material, visita el centro de documentación docs.apiyi.com
