Nivel de esfuerzo (effort) en Claude

El nivel de esfuerzo (effort) es un parámetro de la API de Claude que le dice al modelo cuánto trabajo invertir en una petición: cuánto pensar, cuánto escribir y cuántas llamadas a herramientas hacer. En lugar de fijar un número exacto de tokens, eliges un nivel cualitativo (por ejemplo low, medium o high) y el modelo ajusta su comportamiento. Anthropic lo introdujo con Claude Opus 4.5 y lo ha ido extendiendo a modelos posteriores.

Cómo funciona

El esfuerzo actúa como una señal de comportamiento, no como un límite duro. Afecta a todo el gasto de tokens de la respuesta:

• Razonamiento: con esfuerzo alto, el modelo explora más alternativas y verifica más; con esfuerzo bajo, va más directo.
• Texto de salida: a menor esfuerzo, respuestas más concisas y menos explicación accesoria.
• Uso de herramientas: en flujos agénticos, un esfuerzo bajo reduce el número de llamadas y combina operaciones; uno alto permite investigar más antes de actuar.

Por defecto, si no lo indicas, el modelo trabaja en esfuerzo alto. Se envía dentro de la configuración de salida de la Messages API:

{
  "model": "claude-opus-...",
  "max_tokens": 4096,
  "output_config": { "effort": "medium" },
  "messages": [{"role": "user", "content": "..."}]
}

Los niveles disponibles, los modelos compatibles y si hace falta una cabecera beta dependen de la versión del modelo; algunas generaciones posteriores a Opus 4.5 añaden un nivel máximo por encima de high. Consulta siempre la documentación del modelo que uses.

Por qué importa

Antes, el único control fino sobre el razonamiento era el presupuesto de tokens de pensamiento extendido (budget_tokens), que solo regula la fase de pensamiento. El esfuerzo es más amplio y más práctico:

• Coste: los tokens de salida son los caros. Bajar el esfuerzo en tareas sencillas reduce la factura de forma notable sin cambiar de modelo.
• Latencia: menos tokens generados significa respuestas más rápidas, clave en chat en tiempo real o en subagentes que se ejecutan muchas veces.
• Un solo modelo, varios perfiles: puedes usar el modelo más capaz con esfuerzo medio en lugar de saltar a un modelo más pequeño, y reservar el esfuerzo alto para los casos difíciles.

Si quieres diseñar estos equilibrios en una aplicación real, conviene aprender a construir sobre la API de Claude midiendo calidad y coste con tus propios datos.

Cuándo usar cada nivel

• Bajo: clasificación, extracción de datos, respuestas cortas, subagentes de alto volumen.
• Medio: la mayoría de tareas de producción con buen equilibrio; en los anuncios de Opus 4.5, Anthropic indicó que con esfuerzo medio igualaba el rendimiento de Sonnet 4.5 en SWE-bench Verified usando bastantes menos tokens de salida.
• Alto o máximo: refactorizaciones complejas, análisis con muchos pasos, problemas donde un error cuesta más que los tokens.

La recomendación práctica es empezar en medio, evaluar con un conjunto de pruebas y subir o bajar según resultados.

Qué NO es

• No es max_tokens: max_tokens corta la respuesta al llegar al límite; el esfuerzo cambia cómo trabaja el modelo. Con esfuerzo alto y max_tokens bajo puedes obtener respuestas truncadas.
• No es la temperatura: la temperatura controla la aleatoriedad del muestreo, no la cantidad de trabajo.
• No sustituye al pensamiento extendido: pueden combinarse. El esfuerzo influye también en cuánto piensa el modelo cuando el pensamiento está activado.
• No garantiza un número fijo de tokens: es una indicación; el gasto real varía según la dificultad de la petición.