Cómo elegir el nivel de esfuerzo adecuado en Claude Code

Los desarrolladores que trabajan con Claude Code eventualmente se encontrarán con una restricción de costo o de uso. Aun así, los desarrolladores quieren trabajar en la frontera de la inteligencia de los modelos y a menudo optan por defecto por el modelo más capaz disponible.

Sin importar qué modelo estés usando, otro control importante para el costo y el uso de tokens es el nivel de esfuerzo. Ajusta el esfuerzo a la complejidad de la tarea; el costo es lo que ocurre cuando no lo haces, en cualquiera de las dos direcciones.

El esfuerzo no cambia lo que el modelo sabe

El esfuerzo le indica a tu modelo cuántos recursos dedicar a la tarea de tu prompt. Si estableces el esfuerzo en el nivel más bajo, el modelo intentará lograr los objetivos del prompt con la menor cantidad de recursos posible: menos llamadas a herramientas, menos tokens y menos trabajo en general. Si estableces el esfuerzo al máximo, le estás indicando al modelo que puede y debe usar tantos recursos como necesite para completar los objetivos del prompt.

El esfuerzo establece cuánto se esfuerza el modelo, no cuánto sabe. El modelo que elijas determina el nivel de capacidad con el que estás trabajando. El esfuerzo es una señal de cuánto quieres que ese modelo se esfuerce.

Cuándo cambiar el esfuerzo

Cuando el esfuerzo es demasiado bajo para la tarea, es probable que el modelo se detenga antes de tiempo y vuelva a ti con trabajo sin terminar. Esa es una señal de que lo que pediste es más complejo que el esfuerzo que permitiste. Entonces tienes que averiguar dónde se quedó y volver a indicarle que continúe. Al final, eso puede costar más que si hubieras establecido el nivel de esfuerzo correctamente.

Cuando el esfuerzo es demasiado alto, es posible que no lo notes en cada prompt o tarea: el modelo usará más tokens de los necesarios, los tiempos de respuesta serán más largos, y notarás un patrón de sobreanálisis, o de identificar más tareas de las que realmente asignaste. Estás enviando la señal de "lo que te estoy describiendo es realmente complejo y difícil", y el modelo coincidirá con esa señal y tratará el trabajo como si fuera así de complejo.

El valor predeterminado se ubica en el medio, y no es arbitrario: está ajustado para cada modelo al nivel en el que la mayoría de las tareas se completan sin gastar de más. Por eso es el punto de partida correcto.

Ajustas hacia abajo para tareas que sabes que son simples y no deberían requerir un gran gasto de recursos: tiempo, turnos, llamadas a herramientas o lecturas de documentos. Si ya has ejecutado este tipo de tarea en el nivel predeterminado, intenta ejecutarla un nivel más abajo y observa si notas alguna diferencia en la calidad. Si no, sigue bajando un nivel a la vez hasta que la notes.

Subes desde el valor predeterminado cuando sabes que estás describiendo algo que debería tomar mucho tiempo y requerir muchos turnos y verificaciones dobles. El otro momento para subir el esfuerzo es cuando la tarea es algo que no puedes verificar rápidamente por ti mismo, y quieres más autoverificación por parte del modelo mientras trabaja. Se aplica la misma regla en esta dirección: sube un nivel, vuelve a ejecutar y detente cuando empiece a terminar las cosas que crees que debería terminar.

Qué control ajustar: ¿esfuerzo o modelo?

Cambia el modelo solo si aumentar el esfuerzo no solucionó el problema. ¿El modelo no sabía lo suficiente, o no se esforzó lo suficiente? Si sabía lo suficiente pero no se esforzó lo suficiente, cambia el esfuerzo. Si sabía lo suficiente pero trabajó demasiado, eso también es un problema de esfuerzo. Si cambiar el esfuerzo no lo soluciona y no estás usando el modelo más capaz, esa es una señal de que el modelo que elegiste no tiene el conocimiento, o no es lo suficientemente capaz, para la tarea.

Cuando cambies de modelo, empieza de nuevo en el valor predeterminado

Los nombres de los niveles son los mismos en todos los modelos, pero el mismo nivel no significa la misma cantidad de trabajo en un modelo diferente.

Cada vez que elijas un modelo, comienza el esfuerzo en el valor predeterminado y ajústalo hacia arriba o hacia abajo según lo necesites. Supongamos que intentas una tarea difícil con el modelo menos capaz disponible, para ver si puede hacer el trabajo por menos. Después de subir el esfuerzo lo más alto posible, el modelo aún no completa la tarea con el nivel de calidad que necesitas, así que subes a un modelo superior. No dejes el esfuerzo al máximo; vuelve a intentarlo en el valor predeterminado. El modelo más capaz puede completar la tarea con menos esfuerzo.

Cada vez que haya un modelo nuevo, incluida una versión más reciente del que ya usas, revisa las tareas que has estado haciendo. Comprueba si puedes obtener los mismos resultados con el modelo más capaz a un esfuerzo menor, lo que podría hacer que esas tareas sean más económicas.

Cómo establecer el nivel de esfuerzo

Puedes cambiar el esfuerzo mediante cualquiera de las siguientes opciones:

Solo para esta sesión:

• Indicador --effort: pasa el nombre de un nivel al iniciar Claude Code

Para esta sesión y las futuras:

• /effort: ejecuta /effort sin argumentos para abrir un control deslizante interactivo, /effort seguido del nombre de un nivel para establecerlo directamente, o /effort auto para restablecer el valor predeterminado del modelo
• En /model: mientras seleccionas un modelo, usa las teclas de flecha izquierda/derecha para ajustar el control deslizante de esfuerzo
• Configuración: establece effortLevel en low, medium, high o xhigh en tu archivo de configuración
• Variable de entorno: establece CLAUDE_CODE_EFFORT_LEVEL con el nombre de un nivel o auto

Para una skill o subagente:

• Frontmatter de skill y subagente: establece effort en un archivo markdown de skill o subagente para anular el nivel de esfuerzo mientras se ejecuta

Un nivel que establezcas con /effort persiste en tu próxima sesión, así que usa el indicador --effort cuando quieras un nivel solo para una ejecución. Max usa suficientes recursos como para que Claude Code lo haga exclusivo de la sesión a menos que lo establezcas mediante la variable de entorno, de modo que no puedas dejarlo activado por accidente.

Ultracode no es un nivel de esfuerzo. Es una configuración de Claude Code exclusiva de la sesión que ejecuta el modelo en xhigh y, para tareas sustanciales, también hace que Claude orqueste flujos de trabajo dinámicos, distribuyendo el trabajo entre múltiples agentes.

Cuando más de un método establece el esfuerzo, gana el que esté más cerca de la parte superior del siguiente orden.

Sea cual sea el que gane arriba, tu organización puede limitarlo. En los planes Enterprise, un administrador puede establecer un nivel de esfuerzo máximo por modelo. Los niveles por encima del límite no aparecen en el selector de /effort, y si solicitas uno con /effort o --effort, Claude Code se ejecuta en el límite y te lo indica.

Ejemplo práctico

El mismo prompt ejecutado tres veces en un modelo, en bajo, el predeterminado y máximo: reproduce cada nivel y observa cuánto trabajo se invierte en el mismo resultado. El prompt pide un pequeño script de CSV a JSON probado en un archivo de muestra, aburrido a propósito para que los niveles de esfuerzo tengan margen para diferir.

Pruébalo en tu propio entorno

Tres sesiones separadas. Realiza los mismos cuatro pasos en cada una. Tú mismo armas la comparación, porque /usage solo informa sobre la sesión en la que estás. Revísalo al final de cada ejecución, anota el recuento de tokens que informa para la sesión, luego sal e inicia la siguiente ejecución desde cero.

1. Inicia una sesión nueva en su propia carpeta vacía, en el nivel de esa ejecución

# desde una carpeta vacía fuera de cualquier repositorio
# ejecución 1 · baja
mkdir effort-low && cd effort-low && claude --effort low

# ejecución 2 · predeterminada
cd .. && mkdir effort-default && cd effort-default && claude
# luego ejecuta /effort auto

# ejecución 3 · máxima
cd .. && mkdir effort-max && cd effort-max && claude --effort max

El indicador (o /effort auto) hace que cada ejecución comience en su propio nivel, porque de low a xhigh persisten en tu próxima sesión una vez establecidos con /effort.

2. Pega el mismo prompt

name,team,start_date
Priya,Payments,2024-03-18
Marcus,Platform,2023-11-02
Lena,Support,2025-01-27

3. Cuando Claude te devuelva el trabajo, revisa lo que usó esta sesión

Busca el total de tokens de la sesión; el resto de la pantalla varía según el plan.

4. Sal, luego vuelve al paso 1 para el siguiente nivel

Los tres recuentos de tokens deberían aumentar de bajo a máximo, y las tres carpetas deberían contener un conversor funcional. Abre los tres scripts uno al lado del otro: la diferencia en cuánto se construyó es la diferencia que pagaste.

El hábito que debes mantener

Gestionar el esfuerzo se reduce a un hábito: comienza en el valor predeterminado, observa lo que obtienes y ajusta un nivel a la vez. Mantén ese ciclo en marcha y sabrás qué nivel necesita una tarea, y podrás explicárselo a un compañero de trabajo o a un administrador.

Aprende más

• Cómo elegir un modelo de Claude y un nivel de esfuerzo en Claude Code: los conceptos detrás de la elección de modelo y el esfuerzo, del equipo de Claude Code.
• Configuración del modelo: la referencia completa de /effort, la configuración, la precedencia y los límites de la organización.
• Maximizando el valor de Claude Code: un seminario web grabado sobre a dónde van los tokens de una sesión, cómo elegir el modelo y el nivel de esfuerzo correctos, y qué aportan CLAUDE.md y los servidores MCP a cada turno, del equipo de Claude Code.
• Optimización para costo e inteligencia: resultados medidos para el esfuerzo, el almacenamiento en caché de prompts y la elección de modelo, comparados por costo por tarea, de la documentación de Claude Platform.
• Optimización de costos en la API de Claude: palancas de costo aplicadas una a la vez a un agente en funcionamiento, para desarrolladores de Platform, del Claude Cookbook.