Cargando
Cargando

El pensamiento extendido es la función avanzada de Claude que le da al modelo tiempo para razonar a través de problemas complejos antes de generar una respuesta final. Piensa en ello como el monólogo interno de Claude: puedes ver cómo aborda tu problema paso a paso.

Chat de Claude sobre el cierre de delimitadores JSON, con anotaciones que etiquetan "Consulta del usuario", "Pensamiento / Razonamiento" y "Respuesta".

Cómo funciona el pensamiento extendido

Cuando habilitas el pensamiento extendido, la respuesta de Claude incluye dos partes en lugar de una:

  • Parte de contenido de razonamiento - el proceso de pensamiento interno de Claude
  • Parte de texto - la respuesta final que realmente querías

Con pensamiento habilitado, nuestro servidor envía "Escribe una guía breve sobre recursión" y Claude devuelve el razonamiento y luego el texto final.

El contenido de razonamiento te muestra exactamente cómo Claude descompone tu problema, qué considera y cómo llega a su respuesta final. Esta transparencia puede ser increíblemente valiosa para entender y depurar tareas complejas.

Compensaciones a considerar

El pensamiento extendido conlleva beneficios y costos claros:

  • Mejor precisión en tareas complejas
  • Mayor costo - pagas por todos los tokens de pensamiento
  • Mayor latencia - pensar toma tiempo

El punto de decisión clave es simple: usa tus evaluaciones. Si ya optimizaste tu indicación pero aún no obtienes la precisión que necesitas, es entonces cuando el pensamiento extendido vale la pena considerarlo.

El sistema de firmas

Un detalle importante que notarás de inmediato es la firma criptográfica adjunta al contenido de razonamiento:

JSON del mensaje del asistente: dentro de reasoningText, un campo "signature" resaltado junto al campo de texto "text" del pensamiento.

Esta firma garantiza que no puedas modificar el texto de pensamiento. Si quieres incluir el razonamiento previo de Claude en una conversación de seguimiento, la firma verifica que el contenido no haya sido manipulado. Esto previene posibles problemas de seguridad derivados de texto de razonamiento modificado.

Contenido redactado

A veces el pensamiento de Claude es marcado por los sistemas de seguridad. Cuando esto sucede, recibirás un campo redactedContent en lugar de texto de pensamiento legible:

Mensaje del asistente con redactedContent resaltado dentro de reasoningContent como una cadena de bytes cifrada, más una parte de texto.

El contenido redactado está cifrado pero sigue siendo funcional: puedes pasarlo de vuelta a Claude en conversaciones futuras sin perder contexto. Simplemente no es legible para ti como desarrollador.

Implementación

En los modelos actuales de Claude, como Claude Opus 5 y Claude Sonnet 5, el pensamiento funciona como pensamiento adaptativo y está activado por defecto: Claude decide cuánto razonamiento necesita cada solicitud, sin presupuesto de tokens que gestionar. Estos modelos omiten el texto de razonamiento a menos que lo solicites, así que establece display en summarized para verlo:

python
additional_model_fields["thinking"] = {
    "type": "adaptive",
    "display": "summarized"
}

Con el pensamiento adaptativo activado, las preguntas simples suelen responderse rápidamente, mientras que las más difíciles reciben más tiempo de razonamiento. Para guiar cuánto piensa Claude, puedes combinar el pensamiento adaptativo con el parámetro effort. El nivel de esfuerzo actúa como una guía suave para la asignación de pensamiento de Claude, y ocupa el lugar del presupuesto de tokens manual que de otro modo tendrías que gestionar.

Si has usado el pensamiento extendido antes, ten en cuenta que la configuración manual se está eliminando gradualmente: thinking.type: "enabled" con budget_tokens está obsoleto en Claude Opus 4.6 y Claude Sonnet 4.6, y Claude Opus 4.7 y modelos posteriores, incluyendo Claude Opus 5 y Claude Sonnet 5, no lo admiten y rechazan dichas solicitudes con un error 400. Usa thinking.type: "adaptive" con el parámetro effort en su lugar.

Modelos sin pensamiento adaptativo

Los modelos Claude 4.5 (Claude Haiku 4.5, Claude Sonnet 4.5 y Claude Opus 4.5) y modelos anteriores no admiten el pensamiento adaptativo. En esos modelos habilitas el pensamiento extendido con un presupuesto de tokens manual:

python
additional_model_fields["thinking"] = {
    "type": "enabled",
    "budget_tokens": thinking_budget
}

El thinking_budget controla cuántos tokens puede gastar Claude en razonamiento. El mínimo es 1024 tokens, pero podrías necesitar más para problemas complejos. Como con todo lo demás en Claude, usa tus evaluaciones para encontrar el presupuesto adecuado para tu caso de uso.

Así se ve la función de chat actualizada:

python
def chat(
    messages,
    system=None,
    temperature=1.0,
    stop_sequences=[],
    tools=None,
    tool_choice="auto",
    text_editor=None,
    thinking=False,
    thinking_budget=1024
):

Prueba de tu implementación

Al construir aplicaciones que manejan el pensamiento extendido, querrás probar tanto el contenido de razonamiento normal como los escenarios de contenido redactado. De hecho, existe una cadena de prueba especial que obliga a Claude a devolver contenido redactado, útil para asegurarte de que tu código maneje ambos casos correctamente.

La conclusión más importante sobre el pensamiento extendido es que la decisión de usarlo siempre debe basarse en datos. Ejecuta primero tus evaluaciones, optimiza tus indicaciones y solo entonces considera el pensamiento extendido si necesitas ese impulso extra en precisión para tareas complejas. Esa disciplina se basa en un hábito simple: decide cómo se ve el éxito antes de recurrir a más capacidad. Cuando conoces la precisión que necesita tu tarea, puedes saber si el pensamiento extendido justifica su costo en lugar de adivinarlo.

Práctica: ejecuta tú mismo el pensamiento adaptativo

El pensamiento adaptativo se entiende mejor observando cómo toma decisiones. En el código donde has estado construyendo la función de chat, actívalo:

python
additional_model_fields["thinking"] = {
    "type": "adaptive",
    "display": "summarized"
}

Ahora envía dos solicitudes a través de esta misma configuración. Primero haz una pregunta fáctica rápida cuya respuesta ya conoces. Luego haz una genuinamente difícil, como un problema de análisis de varios pasos de tu propio trabajo. Si estás trabajando con un modelo que no admite el pensamiento adaptativo, habilita el pensamiento con la configuración manual de budget_tokens de la sección anterior y ejecuta las mismas dos solicitudes.

Verifica lo que hizo el pensamiento

Establecer el indicador solo demuestra que la solicitud fue aceptada. Estas comprobaciones te dicen lo que hizo el pensamiento:

  1. Confirma que el pensamiento se activó. Cada respuesta ahora debería contener dos partes, el contenido de razonamiento y el texto final, en lugar de solo texto. La única excepción es el contenido redactado, que viste antes: un campo redactedContent significa que el pensamiento se ejecutó pero el texto está cifrado.
  2. Lee el contenido de razonamiento. Comprueba que realmente razona sobre la pregunta que hiciste en lugar de limitarse a repetirla. Esta es la misma transparencia en la que confiarás al depurar tareas complejas más adelante.
  3. Compara las dos solicitudes. La pregunta simple normalmente volverá rápido con poco razonamiento, mientras que la difícil obtendrá notablemente más. Esa diferencia es el pensamiento adaptativo tomando la decisión de asignación por ti.
  4. Sopesa el costo. Pagas por cada token de pensamiento, así que verifica si la respuesta más difícil es mejor que la que obtienes sin pensamiento. Tus evaluaciones son las que deciden eso, y ver aparecer el texto de razonamiento no es un sustituto de ellas.

El comportamiento que vale la pena conservar de esta lección: siempre que habilites el pensamiento extendido en una tarea nueva, lee el contenido de razonamiento en algunas solicitudes representativas y vuelve a ejecutar tus evaluaciones antes de decidir si la configuración se mantiene.