Effort

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 está disponible en todos los modelos compatibles sin necesidad de un encabezado beta.



Cómo funciona effort

De forma predeterminada, Claude usa effort alto, gastando tantos tokens como sea necesario para obtener resultados excelentes. Puedes aumentar el nivel de effort a max para obtener la máxima capacidad absoluta, o reducirlo para ser más conservador con el uso de tokens, optimizando la velocidad y el costo mientras aceptas cierta reducción en la capacidad.

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

• Respuestas de texto y explicaciones
• Llamadas a herramientas y argumentos de funciones
• Pensamiento (cuando está activo)

Este enfoque tiene dos ventajas principales:

1. No requiere que el pensamiento esté habilitado.
2. Puede afectar todo el gasto de tokens, incluidas las llamadas a herramientas. Por ejemplo, un effort más bajo significaría que Claude realiza menos llamadas a herramientas. Esto proporciona un grado mucho mayor de control sobre la eficiencia.



Niveles de effort

xhigh es un nivel más reciente; algunos modelos que admiten max no admiten xhigh.



Niveles de effort recomendados para Claude Sonnet 5

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

• Effort alto (predeterminado): Adecuado para razonamiento complejo, programación y tareas agénticas donde la calidad importa más que la velocidad o el costo.
• Effort xhigh: Para las tareas de programación y agénticas más difíciles. Consulta Prompting para Claude Sonnet 5.
• Effort medio: Reducción de costos respecto al valor predeterminado. Comparable a Claude Sonnet 4.6 con effort alto.
• Effort bajo: 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.
• Effort máximo: Para tareas que requieren la capacidad más alta absoluta sin restricciones en el gasto de tokens.



Niveles de effort recomendados para Claude Sonnet 4.6

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

• Effort medio (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.
• Effort bajo: 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.
• Effort alto: Para razonamiento complejo y tareas donde la calidad importa más que la velocidad o el costo.
• Effort máximo: Para tareas que requieren la capacidad más alta absoluta sin restricciones en el gasto de tokens.



Niveles de effort recomendados para Claude Opus 4.7

Comienza 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 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 anula el predeterminado.

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

Al ejecutar Claude Opus 4.7 con effort 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 desde ahí es un valor predeterminado razonable.



Niveles de effort recomendados para Claude Opus 4.8

La orientación para Claude Opus 4.7 también 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 más bajo 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 anula el predeterminado.

Al ejecutar Claude Opus 4.8 con effort 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 desde ahí es un valor predeterminado razonable.



Niveles de effort recomendados para Claude Opus 5

Claude Opus 5 admite los cinco niveles de effort. Comienza 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 libremente como tu control principal para el costo de tokens y el tiempo de respuesta siempre que tus evaluaciones muestren que la calidad se mantiene. Si trasladaste configuraciones de effort desde un modelo anterior, ejecuta un barrido de effort nuevo en tus evaluaciones en lugar de reutilizarlas.

Effort controla el volumen de pensamiento, no la longitud visible de la respuesta: en Claude Opus 5, cambiar el effort no acorta las respuestas de forma confiable, así que usa el prompt para controlar la longitud en su lugar.

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

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

Al ejecutar Claude Opus 5 con effort 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 desde ahí es un valor predeterminado razonable.



Niveles de effort recomendados para Claude Fable 5

Effort 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 effort 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 effort 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 aplican a Claude Mythos 5. Para una orientación más completa, consulta Prompting para Claude Fable 5.



Uso básico

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-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)



Cuándo ajustar el parámetro effort

• Usa effort máximo cuando necesites la capacidad más alta absoluta sin restricciones: el razonamiento más exhaustivo y el análisis más profundo. Disponible en modelos Claude 4.6 y posteriores y Claude Mythos Preview.
• Usa effort xhigh para programación avanzada y trabajo agéntico complejo que requiera exploración extendida, como llamadas repetidas a herramientas y búsqueda detallada. Disponible en Claude Fable 5, Claude Mythos 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7 y Claude Sonnet 5.
• Usa effort alto (el predeterminado) para razonamiento complejo, análisis matizado, problemas de programación difíciles o cualquier tarea donde la calidad importe más que la velocidad o el costo.
• Usa effort medio como una opción equilibrada cuando quieras un rendimiento sólido sin el gasto completo de tokens del effort alto.
• Usa effort bajo cuando estés optimizando para velocidad (porque Claude responde con menos tokens) o costo. Por ejemplo, tareas simples de clasificación, búsquedas rápidas o casos de uso de alto volumen donde las mejoras marginales de calidad no justifican latencia o gasto adicional.



Effort con uso de herramientas

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

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

Los niveles de effort más altos pueden:

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



Effort 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 toda la respuesta, lo que en el 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 effort más altos, Claude piensa en la mayoría de las solicitudes y con mayor extensión; en niveles más bajos, puede omitir el pensamiento por completo para problemas más simples. Consulta Pensamiento y effort para obtener orientación completa sobre cómo funcionan juntos los dos controles.

En Claude Opus 4.5, el único modelo exclusivo de pensamiento extendido que admite effort, funciona junto con budget_tokens: establece el nivel de effort para tu tarea, 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. Effort funciona con o sin pensamiento; consulta Cómo funciona effort.



Cambiar effort a mitad de conversación

output_config.effort es una configuración a nivel de solicitud: cada solicitud lleva su propio valor, así que para ejecutar una parte posterior de una conversación con un nivel de effort diferente, establece el nuevo valor en la siguiente solicitud. El nivel de effort se aplica a toda la solicitud. Debido a que effort 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, elige un nivel de effort al inicio y mantenlo constante.



Mejores prácticas

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



Próximos pasos