Pensamiento Extendido y el Parámetro de Esfuerzo Explicados
Cuando le haces una pregunta difícil a Claude, hay un trabajo que ocurre antes de que aparezca la respuesta final.
El pensamiento extendido es la característica que te permite ver ese trabajo.
En lugar de una única respuesta opaca, Claude puede emitir un bloque de contenido thinking separado que contiene su razonamiento, seguido del bloque de contenido de la respuesta final.
El parámetro de esfuerzo es un control relacionado pero distinto.
No decide si el razonamiento es visible.
Decide cuánto razonamiento realiza Claude en primer lugar, intercambiando exhaustividad contra costo y velocidad.
Comprender la diferencia entre estas dos perillas, y cómo interactúan con el modelo subyacente, es la base para todo lo demás en esta sección.
Resumen
- Idea Central: El pensamiento extendido expone el razonamiento de Claude como un bloque de contenido
thinking, y el parámetro de esfuerzo controla cuánto razonamiento gasta Claude antes de responder. - Por Qué Importa: Los problemas más difíciles (matemáticas de varios pasos, revisión de código, instrucciones ambiguas) se benefician de un razonamiento visible y más profundo, pero ese razonamiento cuesta tokens y tiempo, por lo que necesitas una forma de ajustarlo hacia arriba o hacia abajo por solicitud.
- Conceptos Clave: bloque de contenido de pensamiento, pensamiento adaptativo, niveles de esfuerzo, visualización del pensamiento, tokens de razonamiento.
- Cuándo Usar: Análisis de varios pasos, depuración, planificación de tareas, problemas de matemáticas o lógica, y cualquier carga de trabajo donde desees auditar o exponer la ruta de razonamiento de Claude.
- Limitaciones / Compensaciones: Más razonamiento significa más tokens, más latencia y más costo, y no todas las tareas se benefician de él, por lo que aplicarlo uniformemente a solicitudes simples desperdicia presupuesto.
- Temas Relacionados: configuración de pensamiento adaptativo, ajuste de esfuerzo, modos de visualización del pensamiento, entrada multimodal.
Fundamentos
El pensamiento extendido es un modo en el que Claude produce un bloque de contenido thinking antes de su respuesta normal.
Ese bloque contiene el razonamiento intermedio del modelo: los pasos que siguió para llegar a su conclusión.
Esto es diferente de un modelo que simplemente escribe una respuesta más larga.
El contenido del pensamiento está estructuralmente separado de la respuesta final, por lo que tu aplicación puede optar por mostrarlo, resumirlo u ocultarlo.
Activas el pensamiento extendido pasando un objeto de configuración thinking en tu solicitud.
La forma base para este sitio es {"type": "adaptive"}, que habilita el pensamiento adaptativo.
El pensamiento adaptativo significa que Claude decide cuánto razonamiento justifica una tarea dada, en lugar de que tú especifiques un presupuesto fijo de tokens por adelantado.
Una pregunta fáctica de una línea recibe poco o ningún razonamiento visible.
Un rompecabezas de lógica de varios pasos recibe mucho más.
Piensa en ello como una persona a la que se le hace una pregunta en una reunión.
Para "¿cuánto es 12 más 30?", responden instantáneamente, sin necesidad de cálculos.
Para "¿deberíamos migrar este servicio antes o después de la congelación de vacaciones?", hacen una pausa, sopesan los pros y los contras, y piensan en voz alta antes de responder.
El pensamiento adaptativo le da a Claude la misma libertad, automáticamente, por solicitud.
Claude Fable 5, el modelo de nivel superior en la línea actual, se ejecuta con pensamiento adaptativo siempre activo por defecto, lo que refleja cuán central es este comportamiento en su funcionamiento.
Mecánica e Interacciones
El pensamiento extendido y el parámetro de esfuerzo operan en diferentes capas de la solicitud.
La configuración thinking responde a la pregunta "¿debe ser visible el razonamiento y debe Claude decidir su propia profundidad?". El parámetro de esfuerzo, típicamente configurado en output_config.effort (o un campo equivalente según la versión del SDK), responde a una pregunta separada: "cuánto esfuerzo de razonamiento debe aplicar Claude en general, independientemente de si se muestra". El esfuerzo se gradúa en niveles, comúnmente low, medium, high y max.
En low, Claude favorece la velocidad y la economía, haciendo el mínimo razonamiento necesario para producir una respuesta razonable.
En max, Claude gasta significativamente más computación trabajando en casos extremos, interpretaciones alternativas y pasos de verificación antes de comprometerse con una respuesta final.
Estas dos configuraciones se componen.
Puedes tener el pensamiento adaptativo habilitado con un techo de esfuerzo low, en cuyo caso Claude aún decide por tarea si razonar o no, pero está limitado en cuán profundo llega incluso en tareas difíciles.
También puedes tener pensamiento adaptativo con esfuerzo max, lo que le da a Claude la mayor libertad para razonar extensamente en problemas que lo requieren.
response = client.messages.create(
model="claude-sonnet-5",
max_tokens=2048,
thinking={"type": "adaptive"},
output_config={"effort": "high"},
messages=[{"role": "user", "content": "Plan a phased rollback strategy."}],
)El modelo mental importante: thinking rige la presencia y adaptabilidad del razonamiento, effort rige su profundidad y techo de costo.
No son la misma palanca, y confundirlos lleva a decisiones de ajuste confusas, como asumir que necesitas esfuerzo max solo para ver un bloque thinking en absoluto.
Una preocupación relacionada pero separada es la visualización del pensamiento, que determina lo que tu aplicación realmente recibe de vuelta: una versión resumida del razonamiento, o nada en absoluto, incluso cuando el razonamiento ocurrió internamente.
La visualización es una configuración de presentación, no una configuración de profundidad de razonamiento, y se cubre en su totalidad en la página de referencia de niveles de esfuerzo y opciones de visualización del pensamiento.
Consideraciones Avanzadas y Aplicaciones
En sistemas de producción, el parámetro de esfuerzo es usualmente lo primero que ajustas una vez que tienes una integración funcional, porque es la palanca más directa sobre la economía unitaria.
Un punto final de triaje de tickets de soporte que responde miles de solicitudes de clasificación simples por día tiene necesidades muy diferentes a las de un asistente de revisión de código que trabaja en un diff grande.
El primero quiere esfuerzo low o medium para mantener la latencia y el costo predecibles a escala.
El segundo se beneficia de esfuerzo high o max, porque un caso extremo omitido en una revisión de código es más costoso que el razonamiento adicional gastado en encontrarlo.
El ajuste de esfuerzo también interactúa con la elección del modelo.
Claude Opus 4.8, el modelo insignia de razonamiento, y Claude Sonnet 5, el modelo general por defecto, ambos soportan el parámetro de esfuerzo, pero su capacidad de razonamiento base difiere, por lo que el mismo nivel de esfuerzo no produce una profundidad de razonamiento idéntica entre modelos.
Claude Haiku 4.5 está optimizado para velocidad y costo, y típicamente se empareja con niveles de esfuerzo más bajos para cargas de trabajo de alto rendimiento y sensibles a la latencia donde el razonamiento extensivo no es el cuello de botella.
| Enfoque | Fortaleza | Debilidad | Mejor Ajuste |
|---|---|---|---|
| Esfuerzo bajo, pensamiento adaptativo desactivado | Más rápido, más barato, latencia más predecible | Omite matices en entradas genuinamente difíciles | Clasificación simple de alto volumen, formato, extracción |
| Pensamiento adaptativo, esfuerzo bajo a medio | Claude decide cuándo el razonamiento vale la pena, costo limitado | Ocasional sub-razonamiento en tareas límite-difíciles | Cargas de trabajo generales de chat y asistente |
| Pensamiento adaptativo, esfuerzo alto a máximo | Razonamiento más profundo en problemas genuinamente difíciles | Mayor costo y latencia por solicitud | Revisión de código, planificación de varios pasos, tareas intensivas en matemáticas o de seguridad crítica |
Un patrón de arquitectura común es enrutar solicitudes a diferentes niveles de esfuerzo basándose en un clasificador externo económico, o permitir que el llamador pase el esfuerzo como un parámetro en tiempo de solicitud para que los equipos de producto puedan ajustarlo sin volver a desplegar.
Debido a que el contenido de pensamiento es un bloque de contenido distinto, las aplicaciones que registran o auditan el comportamiento del modelo pueden retenerlo por separado de la respuesta visible para el usuario, lo cual es útil para depurar por qué Claude llegó a una conclusión particular sin exponer ese razonamiento a los usuarios finales.
Conceptos Erróneos Comunes
- "El pensamiento extendido siempre mejora las respuestas." Más razonamiento ayuda en tareas genuinamente difíciles, de varios pasos o ambiguas, pero en solicitudes fácticas simples, principalmente agrega latencia y costo con poca ganancia de calidad, que es exactamente por qué existe el pensamiento adaptativo.
- "Esfuerzo y pensamiento son la misma configuración." Son controles independientes:
thinkingrige si y cómo se adapta el razonamiento de Claude,effortrige cuán profundo va ese razonamiento y cuánto cuesta. - "El pensamiento adaptativo significa que Claude siempre piensa mucho." El pensamiento adaptativo significa que Claude calibra la profundidad a la tarea, por lo que una pregunta trivial aún puede obtener poco o ningún razonamiento visible incluso con el pensamiento adaptativo habilitado.
- "Necesitas esfuerzo máximo para ver un bloque de pensamiento." La visibilidad del bloque de pensamiento se controla mediante la configuración
thinkingy las opciones de visualización, no por el nivel de esfuerzo; el esfuerzo bajo aún puede producir un rastro de razonamiento visible, aunque menos profundo. - "Mayor esfuerzo es calidad extra gratuita sin costo." El esfuerzo se intercambia directamente contra la latencia y el costo de tokens, y para muchas cargas de trabajo, la ganancia de calidad marginal en
maxno justifica el costo marginal sobrehigh.
Preguntas Frecuentes
¿Qué es exactamente un "bloque de contenido de pensamiento"?
- Una parte estructuralmente separada de la respuesta de Claude que contiene su razonamiento, distinta del bloque de contenido de la respuesta final.
- Se devuelve junto con la respuesta para que tu aplicación pueda optar por registrarlo, resumirlo u ocultarlo.
¿Es el pensamiento extendido lo mismo que una respuesta más larga?
No. Una respuesta más larga es solo más texto de respuesta final. El pensamiento extendido es un bloque de contenido separado que contiene el razonamiento intermedio del modelo, producido antes de que se escriba la respuesta final.
¿Qué hace exactamente `thinking: {"type": "adaptive"}`?
- Habilita el pensamiento adaptativo, donde Claude decide cuánto razonamiento necesita una solicitud dada.
- Las solicitudes simples obtienen poco o ningún razonamiento visible, las más difíciles obtienen más, sin que tú especifiques un presupuesto fijo.
¿Cómo se diferencia el parámetro de esfuerzo del pensamiento adaptativo?
- El pensamiento adaptativo (la configuración
thinking) controla si ocurre el razonamiento y cuán adaptativamente se elige su profundidad. - El parámetro de esfuerzo (
output_config.efforto similar) establece el techo de cuánta profundidad de razonamiento y costo se permite, independientemente de la adaptabilidad.
¿Cuáles son los niveles de esfuerzo típicos?
low, medium, high y max, ordenados desde el más rápido y económico hasta el más exhaustivo y costoso.
¿Claude Fable 5 necesita que la configuración de pensamiento esté habilitada manualmente?
No. Claude Fable 5 se ejecuta con pensamiento adaptativo siempre activo por defecto, por lo que razona de forma adaptativa sin que necesites configurar thinking tú mismo.
¿Siempre debo usar esfuerzo `max` para obtener la mejor calidad?
No necesariamente. El esfuerzo max aumenta la latencia y el costo, y para tareas que no requieren un razonamiento profundo, la ganancia de calidad sobre high o medium es a menudo marginal, por lo que se reserva mejor para problemas genuinamente difíciles.
¿Puedo usar un nivel de esfuerzo bajo y aún así obtener un bloque de pensamiento?
Sí. El esfuerzo controla la profundidad del razonamiento y el techo de costo, no si el bloque de pensamiento está presente. Una solicitud de bajo esfuerzo aún puede mostrar un rastro de razonamiento menos profundo.
¿Por qué querría ver el razonamiento de Claude?
- Para depurar por qué Claude llegó a una conclusión particular.
- Para auditar el razonamiento en flujos de trabajo críticos para la seguridad o sensibles al cumplimiento.
- Para generar confianza con los usuarios finales mostrando opcionalmente una justificación resumida.
¿Es la visualización del pensamiento lo mismo que el parámetro de esfuerzo?
No. La visualización del pensamiento controla si el razonamiento que tu solicitud produjo se te devuelve resumido u omitido, mientras que el esfuerzo controla cuánto razonamiento se realizó en primer lugar. Son configuraciones separadas que se pueden combinar.
¿Qué tipo de tareas se benefician más de un esfuerzo mayor?
- Problemas de matemáticas o lógica de varios pasos.
- Revisión y depuración de código no trivial.
- Tareas de planificación con muchas restricciones interconectadas.
- Instrucciones ambiguas que requieren sopesar compensaciones antes de responder.
¿Qué tipo de tareas deben usar esfuerzo bajo?
Tareas de alto volumen y sensibles a la latencia como clasificación simple, extracción corta o formato, donde el razonamiento profundo agrega costo sin mejorar significativamente el resultado.
¿Razonan los diferentes modelos de la misma manera con el mismo nivel de esfuerzo?
No. La capacidad de razonamiento base difiere según el modelo (Fable 5, Opus 4.8, Sonnet 5, Haiku 4.5), por lo que el mismo nivel de esfuerzo no produce una profundidad de razonamiento idéntica entre modelos.
Relacionados
- Conceptos Básicos de Pensamiento Extendido, Esfuerzo y Multimodal - un ejemplo mínimo de trabajo que habilita el pensamiento adaptativo de extremo a extremo.
- Habilitar Pensamiento Adaptativo con thinking: {type: 'adaptive'} - la configuración concreta para activar el pensamiento adaptativo.
- Ajuste del Parámetro de Esfuerzo para Costo y Velocidad - cómo elegir un nivel de esfuerzo para una carga de trabajo dada.
- Referencia de Niveles de Esfuerzo y Opciones de Visualización del Pensamiento - una tabla de referencia para cada nivel de esfuerzo y modo de visualización.
- Mejores Prácticas de Pensamiento Extendido, Esfuerzo y Multimodal - prácticas numeradas para ajustar estas configuraciones en producción.
Versiones de Stack: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado), y Claude Haiku 4.5 - y el SDK oficial de Python
anthropic(última versión 0.x). Los nombres de los modelos, las versiones del SDK y los precios cambian rápidamente; verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.