Esfuerzo

El parámetro "effort" (esfuerzo) te permite controlar cuántos tokens gasta Claude al responder a las solicitudes. Puedes equilibrar entre la exhaustividad de la respuesta y la eficiencia de tokens con un solo modelo. El parámetro effort de nivel superior está disponible en todos los modelos compatibles sin necesidad de un encabezado beta. El esfuerzo por mensaje está en beta.

Establece el nivel de esfuerzo

Establece output_config.effort en la solicitud. El siguiente ejemplo ejecuta una solicitud con esfuerzo medium e imprime el texto de la respuesta.

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    messages=[
        {
            "role": "user",
            "content": "Analyze the trade-offs between microservices and monolithic architectures",
        }
    ],
    output_config={"effort": "medium"},
)

for block in response.content:
    if block.type == "text":
        print(block.text)

Cómo funciona el esfuerzo

La mayoría de los modelos de Claude usan esfuerzo alto de forma predeterminada, gastando tantos tokens como sea necesario para obtener resultados excelentes; Claude Opus 5.5 y Claude Haiku 5.5 usan medio de forma predeterminada. Puedes subir el nivel de esfuerzo a max para obtener la máxima capacidad absoluta, o bajarlo para ser más conservador con el uso de tokens, optimizando la velocidad y el costo a cambio de cierta reducción en la capacidad.

El parámetro effort afecta a todos los tokens de la respuesta, incluidos:

• Respuestas de texto y explicaciones
• "Tool calls" (llamadas a herramientas) y argumentos de funciones
• Pensamiento (cuando está activo)

Como el esfuerzo se aplica a cada token de salida, funciona tanto si el pensamiento está habilitado como si no. Un esfuerzo menor también implica menos llamadas a herramientas y más concisas.

Niveles de esfuerzo

No todos los modelos que admiten max admiten xhigh.

Las recomendaciones por modelo que siguen prevalecen sobre esta tabla cuando difieren.

Niveles de esfuerzo recomendados para Claude Fable 5.1

Claude Fable 5.1 admite los cinco niveles de esfuerzo. Comienza con high, el valor predeterminado. Sube a xhigh o max para el trabajo agéntico y de programación más sensible a la capacidad, y baja a medium o low para trabajo rutinario o sensible a la latencia una vez que tus evaluaciones muestren que la calidad se mantiene. En high y superiores, establece un max_tokens grande. Es un límite estricto sobre la salida total (pensamiento más texto de respuesta). Las mismas recomendaciones se aplican a Claude Mythos 5.1. Consulta Prompting para Claude Fable 5.1.

Claude Fable 5.1 también admite cambiar el esfuerzo a mitad de conversación con un output_config por mensaje, lo que preserva la caché de prompts.

Niveles de esfuerzo recomendados para Claude Fable 5

El esfuerzo es el control principal para equilibrar inteligencia, latencia y costo en Claude Fable 5. Comienza con high, el valor predeterminado, para la mayoría de las tareas, usa xhigh para las cargas de trabajo más sensibles a la capacidad, y baja a medium o low para trabajo rutinario. Las configuraciones de esfuerzo más bajas en Claude Fable 5 siguen funcionando bien y a menudo superan el rendimiento de xhigh en modelos anteriores. En high y xhigh, establece un max_tokens grande. Es un límite estricto sobre la salida total (pensamiento más texto de respuesta). Consulta Control de costos.

Reduce el esfuerzo si una tarea se completa pero tarda más de lo necesario, o si quieres un estilo de trabajo más rápido e interactivo. Las mismas recomendaciones se aplican a Claude Mythos 5. Para una guía más completa, consulta Prompting para Claude Fable 5.

Niveles de esfuerzo recomendados para Claude Opus 5.5

Claude Opus 5.5 admite los cinco niveles de esfuerzo, y medium es el valor predeterminado (Claude Opus 5 y los modelos Opus anteriores usan high de forma predeterminada, por lo que una solicitud que omite effort se ejecuta un nivel más bajo que en Claude Opus 5). El pensamiento adaptativo siempre está activado y no se puede desactivar, por lo que el esfuerzo es el control principal de cuánto razona el modelo y cuánto cuesta una solicitud. Ejecuta un barrido de esfuerzo en tus propias evaluaciones en lugar de trasladar los ajustes de un modelo anterior, y establece un max_tokens grande en los niveles más altos: es un límite estricto sobre la salida total (pensamiento más texto de respuesta). Las solicitudes que establecen thinking: {"type": "disabled"} devuelven un error 400 en todos los niveles de esfuerzo. Claude Opus 5.5 también admite cambiar el esfuerzo a mitad de la conversación con un output_config por mensaje, lo que preserva la caché de prompts. Consulta Cómo escribir prompts para Claude Opus 5.5.

Niveles de esfuerzo recomendados para Claude Opus 5

Claude Opus 5 admite los cinco niveles de esfuerzo. Empieza con high, el valor predeterminado, y ajusta según tus evaluaciones: sube a xhigh para trabajo exigente de programación y agéntico, o a max cuando una tarea justifique un gasto de tokens sin restricciones, y usa low y medium con libertad como tu control principal del costo de tokens y del tiempo de respuesta siempre que tus evaluaciones muestren que la calidad se mantiene. Si trasladaste ajustes de esfuerzo de un modelo anterior, ejecuta un nuevo barrido de esfuerzo en tus evaluaciones en lugar de reutilizarlos.

El esfuerzo controla el volumen de pensamiento, no la longitud visible de la respuesta: en Claude Opus 5, cambiar el esfuerzo no acorta las respuestas de forma fiable, así que indica la longitud en el prompt en su lugar.

El valor predeterminado de la API es high. Establece effort explícitamente para usar un nivel diferente. El valor que pases prevalece sobre el predeterminado.

En Claude Opus 5, el pensamiento no se puede desactivar con esfuerzo xhigh o max: las solicitudes que establecen thinking: {"type": "disabled"} en esos niveles devuelven un error 400. Consulta Esfuerzo con pensamiento.

Al ejecutar Claude Opus 5 con esfuerzo xhigh o max, establece un max_tokens grande para que el modelo tenga espacio para pensar y actuar a través de subagentes y llamadas a herramientas. Empezar con 64k tokens y ajustar a partir de ahí es un valor predeterminado razonable.

Claude Opus 5 también admite cambiar el esfuerzo a mitad de la conversación con un output_config por mensaje, lo que conserva la caché de prompts. El esfuerzo por mensaje no está disponible para Claude Opus 5 en Amazon Bedrock.

Niveles de esfuerzo recomendados para Claude Opus 4.8

La guía para Claude Opus 4.7 también se aplica a Claude Opus 4.8. Comienza con xhigh para casos de uso de programación y agénticos, usa high para la mayoría de las demás cargas de trabajo sensibles a la inteligencia, y baja a medium o low solo cuando hayas medido que el nivel inferior mantiene la calidad en tus evaluaciones.

El valor predeterminado de la API es high. Establece effort explícitamente para usar un nivel diferente. El valor que pases prevalece sobre el predeterminado.

Al ejecutar Claude Opus 4.8 con esfuerzo xhigh o max, establece un max_tokens grande para que el modelo tenga espacio para pensar y actuar a través de subagentes y llamadas a herramientas. Comenzar con 64k tokens y ajustar a partir de ahí es un valor predeterminado razonable.

Niveles de esfuerzo recomendados para Claude Opus 4.7

Empieza con xhigh para casos de uso de programación y agénticos, y usa high como mínimo para la mayoría de las cargas de trabajo sensibles a la inteligencia. Baja a medium para cargas de trabajo sensibles al costo, o sube a max solo cuando tus evaluaciones muestren un margen de mejora medible en xhigh.

El valor predeterminado de la API es high. Para usar xhigh, establece effort explícitamente. El valor que pases prevalece sobre el predeterminado.

Claude Opus 4.7 también respeta los niveles de esfuerzo de forma más estricta que Claude Opus 4.6, especialmente en low y medium. En niveles de esfuerzo más bajos, el modelo limita su trabajo a lo que se pidió en lugar de hacer más de lo solicitado. Si observas un razonamiento superficial en problemas complejos con Claude Opus 4.7, sube el esfuerzo en lugar de intentar compensarlo con el prompt. Si debes mantener el esfuerzo bajo por la latencia, añade una guía específica como "Esta tarea implica razonamiento de varios pasos. Piensa cuidadosamente antes de responder."

Al ejecutar Claude Opus 4.7 con esfuerzo xhigh o max, establece un max_tokens grande para que el modelo tenga espacio para pensar y actuar a través de subagentes y llamadas a herramientas. Empezar con 64k tokens y ajustar a partir de ahí es un valor predeterminado razonable.

Niveles de esfuerzo recomendados para Claude Sonnet 5.5

Claude Sonnet 5.5 admite los cinco niveles de esfuerzo, y high es el valor predeterminado en la Claude API. Sus niveles están recalibrados, por lo que un nivel no produce la misma cantidad de pensamiento que el mismo nivel en Claude Sonnet 5. Ejecuta un nuevo barrido de esfuerzo en tus evaluaciones en lugar de trasladar el ajuste que usabas en Claude Sonnet 5. Empieza con high a menos que tu carga de trabajo sea agéntica o sensible a la latencia. Para programación agéntica y uso de herramientas de varios pasos, empieza con medium para tareas bien especificadas y pasa a high para las más difíciles o largas. Para chat y otro trabajo sensible a la latencia, empieza con medium o low. Usa xhigh o max solo donde tus evaluaciones muestren una mejora de calidad. Establece max_tokens con espacio para el pensamiento y la respuesta. El pensamiento cuenta para max_tokens incluso cuando el contenido del pensamiento no se devuelve. Para programación agéntica, establece max_tokens en 128,000, el máximo del modelo, y usa streaming para la respuesta.

Para desactivar el pensamiento previo, envía thinking: {"type": "between_tools"} en lugar de "disabled". Es el ajuste de pensamiento más bajo en Claude Sonnet 5.5 y funciona con esfuerzo low, medium y high. En xhigh o max, una solicitud con este ajuste devuelve un error 400, así que usa pensamiento adaptativo en esos niveles: omite el campo thinking o envía thinking: {"type": "adaptive"}. Consulta Ejecutar sin pensamiento previo.

Claude Sonnet 5.5 también admite cambiar el esfuerzo a mitad de la conversación con un output_config por mensaje, lo que conserva la caché de prompts. Con between_tools, el esfuerzo no puede cambiar a mitad de la conversación: un output_config.effort por mensaje que difiera del nivel vigente devuelve un error 400. Para variar el esfuerzo por turno, usa pensamiento adaptativo. Consulta Cómo escribir prompts para Claude Sonnet 5.5.

Niveles de esfuerzo recomendados para Claude Sonnet 5

Claude Sonnet 5 usa esfuerzo high de forma predeterminada en la Claude API y Claude Code.

• Esfuerzo high (predeterminado): Adecuado para razonamiento complejo, programación y tareas agénticas donde la calidad importa más que la velocidad o el costo.
• Esfuerzo xhigh: Para las tareas de programación y agénticas más difíciles. Consulta Prompting para Claude Sonnet 5.
• Esfuerzo medium: Reducción respecto al predeterminado para ahorrar costos. Comparable a Claude Sonnet 4.6 con esfuerzo alto.
• Esfuerzo low: Para cargas de trabajo de alto volumen o sensibles a la latencia. Adecuado para chat y casos de uso no relacionados con programación donde se prioriza una respuesta más rápida.
• Esfuerzo max: Para tareas que requieren la capacidad absolutamente más alta sin restricciones en el gasto de tokens.

Niveles de esfuerzo recomendados para Claude Sonnet 4.6

Sonnet 4.6 usa esfuerzo high de forma predeterminada. Establece el esfuerzo explícitamente al usar Sonnet 4.6 para evitar una latencia inesperada:

• Esfuerzo medium (valor predeterminado recomendado): El mejor equilibrio entre velocidad, costo y rendimiento para la mayoría de las aplicaciones. Adecuado para programación agéntica, flujos de trabajo con uso intensivo de herramientas y generación de código.
• Esfuerzo low: Para cargas de trabajo de alto volumen o sensibles a la latencia. Adecuado para chat y casos de uso que no son de programación donde se prioriza una respuesta más rápida.
• Esfuerzo high: Para razonamiento complejo y tareas donde la calidad importa más que la velocidad o el costo.
• Esfuerzo max: Para tareas que requieren la máxima capacidad absoluta sin restricciones en el gasto de tokens.

Niveles de esfuerzo recomendados para Claude Haiku 5.5

Claude Haiku 5.5 admite los cinco niveles de esfuerzo, y medium es el valor predeterminado en la Claude API y en Claude Code. El esfuerzo es el control principal de cuánto piensa el modelo y, con ello, de la calidad, la latencia y el costo. Empieza con medium para la mayoría del trabajo, incluida la programación agéntica. Usa low, el nivel más barato y rápido, para chat, tareas cortas con herramientas y solicitudes simples de alto volumen. En prompts largos de agentes, es más probable que el modelo omita una búsqueda, se detenga antes de tiempo u omita una verificación en low. Usa high para trabajo de conocimiento, tareas de agente más largas y seguimiento estricto de instrucciones. Usa xhigh o max solo donde tus evaluaciones muestren una mejora de calidad, y compáralos con Claude Sonnet 5.5 en rendimiento, costo y velocidad. El pensamiento está activado de forma predeterminada y cuenta para max_tokens, así que deja espacio para él. Consulta Cómo escribir prompts para Claude Haiku 5.5.

Para obtener menos pensamiento, baja el nivel de esfuerzo. También puedes enviar thinking: {"type": "disabled"} con esfuerzo high o inferior. En xhigh o max, una solicitud con ese ajuste devuelve un error 400, así que usa pensamiento adaptativo en esos niveles: omite el campo thinking o envía thinking: {"type": "adaptive"}.

En la Claude API y Google Cloud, Claude Haiku 5.5 también admite cambiar el esfuerzo a mitad de la conversación con un output_config por mensaje, lo que conserva la caché de prompts. Con thinking: {"type": "disabled"}, el esfuerzo no puede cambiar a mitad de la conversación: un output_config.effort por mensaje que difiera del nivel vigente devuelve un error 400. Para variar el esfuerzo por turno, usa pensamiento adaptativo.

Esfuerzo con uso de herramientas

Al usar herramientas, el parámetro effort afecta tanto a las explicaciones en torno a las llamadas a herramientas como a las propias llamadas a herramientas. Los niveles de esfuerzo más bajos tienden a:

• Combinar múltiples operaciones en menos llamadas a herramientas
• Hacer menos llamadas a herramientas
• Proceder directamente a la acción sin preámbulo
• Usar mensajes de confirmación concisos tras completar

Los niveles de esfuerzo más altos pueden:

• Hacer más llamadas a herramientas
• Explicar el plan antes de actuar
• Proporcionar resúmenes detallados de los cambios
• Incluir comentarios de código más completos

Esfuerzo con pensamiento

El parámetro thinking controla si Claude piensa en bloques de pensamiento antes de responder; el parámetro effort controla cuánto trabajo dedica Claude a la respuesta completa, lo que en modo adaptativo incluye con qué frecuencia y con qué profundidad piensa. No pases adaptive como valor de effort: adaptive es un modo de pensamiento, no un nivel de esfuerzo.

En niveles de esfuerzo más altos, Claude piensa con más facilidad y con mayor extensión. En un bucle de uso de herramientas, las solicitudes de seguimiento que solo procesan resultados de herramientas pueden omitir el pensamiento en cualquier nivel. En niveles más bajos, Claude puede omitir el pensamiento por completo en problemas más sencillos. Consulta Pensamiento y esfuerzo para obtener una guía completa sobre cómo funcionan juntos ambos controles.

En Claude Opus 4.5, el único modelo exclusivo de "extended thinking" (pensamiento extendido) que admite esfuerzo, funciona junto con budget_tokens: establece el nivel de esfuerzo para tu tarea y luego establece el presupuesto de tokens de pensamiento según cuánta profundidad de razonamiento necesite la tarea.

Para la disponibilidad de pensamiento por modelo, consulta la tabla de configuración por modelo. El esfuerzo funciona con o sin pensamiento. Consulta Cómo funciona el esfuerzo.

Cambiar el esfuerzo a mitad de la conversación

Puedes ejecutar turnos posteriores de una conversación con un nivel de esfuerzo diferente de dos maneras. En Claude Fable 5.1, Claude Mythos 5.1, Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5.5 y Claude Haiku 5.5, usa un cambio de esfuerzo por mensaje, que conserva la caché de prompts. En otros modelos, establece un nuevo valor de nivel superior en la siguiente solicitud, lo que reinicia la caché.

Esfuerzo por mensaje (beta)

El esfuerzo por mensaje está en beta. En la Claude API y Google Cloud, está disponible en Claude Fable 5.1, Claude Mythos 5.1, Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5.5 y Claude Haiku 5.5. En Amazon Bedrock, está disponible en Claude Fable 5.1, Claude Mythos 5.1 y Claude Opus 5.5. Requiere el encabezado beta mid-conversation-output-config-2026-07-01. Con la API InvokeModel de Amazon Bedrock, está disponible en Claude Fable 5.1 y Claude Opus 5.5, y en su lugar envías ese valor en el arreglo anthropic_beta del cuerpo de la solicitud.

Sin el valor beta, un output_config por mensaje devuelve un error 400: messages.N.output_config: Extra inputs are not permitted, donde N es el índice del mensaje system en messages. Con el valor beta, los modelos sin esfuerzo por mensaje, incluido Claude Fable 5, devuelven un error 400: output_config.effort requires a model that supports per-turn effort; this model does not. En Amazon Bedrock, esos modelos y Claude Opus 5 devuelven en su lugar el error Extra inputs are not permitted. En Claude Sonnet 5.5 con thinking: {"type": "between_tools"} y en Claude Haiku 5.5 con thinking: {"type": "disabled"}, el esfuerzo no puede cambiar a mitad de la conversación: un output_config.effort por mensaje que difiera del nivel vigente devuelve un error 400. Para variar el esfuerzo por turno, usa pensamiento adaptativo.

Añade un mensaje role: "system" con content vacío y el nuevo nivel en output_config.effort. El nuevo nivel entra en vigor a partir del siguiente turno user y se mantiene hasta que un mensaje posterior lo cambie. Todo lo anterior a ese mensaje permanece sin cambios, por lo que el prefijo en caché sigue coincidiendo.

El siguiente ejemplo empieza en high y luego baja a low para un seguimiento rutinario:

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-fable-5-1",
    max_tokens=4096,
    output_config={"effort": "high"},
    messages=[
        {
            "role": "user",
            "content": "Plan a migration from SQLite to PostgreSQL in three short steps.",
        },
        {
            "role": "assistant",
            "content": "1. Export the SQLite data. 2. Create the PostgreSQL schema. 3. Import the data and verify row counts.",
        },
        # Mensaje del sistema solo de esfuerzo: el nuevo nivel se aplica desde el siguiente turno del usuario.
        {"role": "system", "content": [], "output_config": {"effort": "low"}},
        {"role": "user", "content": "Summarize the plan in one sentence."},
    ],
    betas=["mid-conversation-output-config-2026-07-01"],
)

for block in response.content:
    if block.type == "text":
        print(block.text)

Un mensaje de sistema que solo contiene esfuerzo no lleva texto, por lo que las reglas de ubicación para mensajes de sistema a mitad de la conversación no se aplican. Puede aparecer en cualquier lugar de messages, incluso como la primera entrada o entre un turno assistant y el siguiente turno user. Los valores son los nombres de los niveles (low, medium, high, xhigh y max).

En Claude Fable 5.1, prefiere esta forma en lugar de cambiar el valor de nivel superior entre solicitudes. Un cambio de nivel superior reinicia la caché y además orienta al modelo de forma menos fiable: sus respuestas anteriores se escribieron con el nivel previo y tiende a mantenerse coherente con ellas.

Esfuerzo de nivel superior en la siguiente solicitud

El output_config.effort de nivel superior se aplica a toda la solicitud. Para ejecutar una parte posterior de una conversación con un nivel diferente, establece el nuevo valor en la siguiente solicitud. Dado que el esfuerzo de nivel superior da forma al prompt renderizado, cambiarlo entre solicitudes no preserva los prefijos en caché de turnos anteriores. Si dependes del almacenamiento en caché de prompts a lo largo de una sesión larga y tu modelo no admite esfuerzo por mensaje, elige un nivel de esfuerzo al inicio y mantenlo constante.

Mejores prácticas

1. Establece el esfuerzo explícitamente: La API usa high de forma predeterminada (medium en Claude Opus 5.5 y Claude Haiku 5.5), pero el punto de partida adecuado depende de tu modelo y tu carga de trabajo.
2. Usa low para tareas sensibles a la velocidad o sencillas: Cuando la latencia importa o las tareas son sencillas, el esfuerzo bajo puede reducir significativamente los tiempos de respuesta y los costos.
3. Prueba tu caso de uso: El impacto de los niveles de esfuerzo varía según el tipo de tarea. Evalúa el rendimiento en tus casos de uso específicos antes de implementar.
4. Considera un esfuerzo dinámico: Ajusta el esfuerzo según la complejidad de la tarea. Las consultas simples pueden justificar un esfuerzo bajo, mientras que la programación agéntica y el razonamiento complejo se benefician de un esfuerzo alto. Consulta el siguiente punto antes de variarlo dentro de una misma conversación.
5. Mantén constante el esfuerzo de nivel superior en conversaciones con caché: Cambiar el valor de esfuerzo de nivel superior entre solicitudes invalida el almacenamiento en caché de prompts, así que varíalo entre cargas de trabajo en lugar de dentro de una conversación que depende de aciertos de caché. En los modelos que lo admiten, usa en su lugar un cambio de esfuerzo por mensaje, que conserva la caché. Consulta Pensamiento y almacenamiento en caché de prompts.

Próximos pasos

Compatibility