Esfuerzo

El parámetro effort te permite controlar cuán dispuesto está Claude a gastar tokens al responder a solicitudes. Esto te da la capacidad de equilibrar entre la exhaustividad de la respuesta y la eficiencia de tokens, todo con un único modelo. El parámetro effort está generalmente disponible en todos los modelos compatibles sin requerir un encabezado beta.

Cómo funciona el esfuerzo

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

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

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

Este enfoque tiene dos ventajas principales:

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

Niveles de esfuerzo

Uso básico

import anthropic

client = anthropic.Anthropic()

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

print(response.content[0].text)

¿Cuándo debo ajustar el parámetro effort?

• Usa max effort cuando necesites la capacidad absoluta más alta sin restricciones — el razonamiento más exhaustivo y el análisis más profundo. Solo disponible en Opus 4.6; las solicitudes que usan max en otros modelos devolverán un error.
• Usa high effort (el predeterminado) cuando necesites el mejor trabajo de Claude — razonamiento complejo, análisis matizado, problemas de codificación difíciles, o cualquier tarea donde la calidad sea la prioridad principal.
• Usa medium effort como una opción equilibrada cuando quieras un rendimiento sólido sin el gasto de tokens completo del esfuerzo alto.
• Usa low effort cuando estés optimizando para velocidad (porque Claude responde con menos tokens) o costo — por ejemplo, tareas de clasificación simples, búsquedas rápidas, o casos de uso de alto volumen donde las mejoras de calidad marginales no justifican latencia adicional o gasto.

Esfuerzo con uso de herramientas

Cuando uses 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 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 después de la finalización

Los niveles de esfuerzo más altos pueden:

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

Esfuerzo con pensamiento extendido

El parámetro effort funciona junto con el pensamiento extendido. Su comportamiento depende del modelo:

• Claude Opus 4.6 utiliza adaptive thinking (thinking: {type: "adaptive"}), donde effort es el control recomendado para la profundidad del pensamiento. Aunque budget_tokens sigue siendo aceptado en Opus 4.6, está deprecado y será eliminado en un lanzamiento futuro. En effort high y max, Claude casi siempre piensa profundamente. En niveles más bajos, puede omitir el pensamiento para problemas más simples.
• Claude Opus 4.5 utiliza pensamiento manual (thinking: {type: "enabled", budget_tokens: N}), donde effort funciona junto con el presupuesto de tokens de pensamiento. Establece el nivel de esfuerzo para tu tarea, luego establece el presupuesto de tokens de pensamiento basado en la complejidad de la tarea.

El parámetro effort puede usarse con o sin pensamiento extendido habilitado. Cuando se usa sin pensamiento, sigue controlando el gasto total de tokens para respuestas de texto y llamadas a herramientas.

Mejores prácticas

1. Comienza con high: Usa niveles de esfuerzo más bajos para equilibrar el rendimiento con la eficiencia de tokens.
2. Usa low para tareas sensibles a la velocidad o simples: Cuando la latencia importa o las tareas son directas, 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 esfuerzo dinámico: Ajusta el esfuerzo basado en la complejidad de la tarea. Las consultas simples pueden justificar esfuerzo bajo mientras que la codificación agentiva y el razonamiento complejo se benefician del esfuerzo alto.