Claude Code Effort Level: Ajusta la Profundidad al Vuelo

TL;DR Usa /model + flechas para ajustar effort sobre la marcha. O configúralo permanentemente con effortLevel en settings o la variable de entorno CLAUDE_CODE_EFFORT_LEVEL.

Cuando usas /model para cambiar de modelo, es fácil pasar por alto el slider que aparece debajo: con las flechas izquierda/derecha puedes ajustar el effort level del modelo activo. Ese slider controla cuánto razonamiento invierte Claude antes de responder. No es un límite estricto de tokens, es una señal de comportamiento. En low, Claude piensa menos y responde más rápido. En high dedica más tokens de razonamiento a problemas complejos. En Opus 4.7 (abril 2026) el default subió a xhigh, un escalón entre high y max; en los modelos posteriores el default vuelve a ser high.

No confundas effort level con fast mode. Fast mode acelera la generación de tokens sin reducir la calidad del razonamiento. Bajar el effort sí reduce el razonamiento a cambio de velocidad y coste.

Y algo que ahorra tiempo perdido: de los tres mandos que existen para el thinking, el effort es el único que sigue conectado en los modelos actuales. El interruptor de encendido y MAX_THINKING_TOKENS no hacen lo que crees.

Result:

> /model

  ● opus
    sonnet
    haiku

  Effort: ◄ ██████░░░░ medium ►

3 formas de configurar el effort level

1. Desde /model (interactivo)

Escribe /model, selecciona un modelo compatible y usa las flechas izquierda/derecha para mover el slider de effort:

El cambio aplica inmediatamente a la sesión actual.

2. Variable de entorno

export CLAUDE_CODE_EFFORT_LEVEL=low

Útil para scripts, CI/CD o tareas batch donde sabes de antemano que las operaciones son simples.

3. Archivo de configuración

Añade effortLevel a tu settings.json (usuario o proyecto):

{
  "model": "opus",
  "effortLevel": "medium"
}

Referencia

Cuánto conviene tocarlo

Poco. La guía de Anthropic para Claude Code dice que "para la mayoría de tareas deberías usar el effort por defecto del modelo", y que lo trates como una preferencia general y no como una decisión tarea a tarea. Súbelo cuando tengas un motivo concreto: Claude se saltó un archivo, no ejecutó los tests o abandonó un refactor a medias. Ese criterio, y dónde encaja cada modelo, en Sonnet 5, Opus 5 y Fable 5.

Ojo al estrenar modelo

Hasta ahora, la primera vez que usabas Fable 5, Opus 4.8 u Opus 4.7, Claude Code imponía el effort por defecto de ese modelo aunque tú tuvieras otro puesto, y lo mantenía entre sesiones hasta que elegías explícitamente. Opus 5 no hace eso: arrastra el nivel que tuvieras. Si bajaste a low para gastar menos, tu Opus 5 arranca en low. Para volver al default del modelo, /effort auto. El detalle completo, en Opus 5 en Claude Code.

Y la recomendación de nivel también se movió con el modelo: en Opus 4.7 y 4.8 lo aconsejado era empezar en xhigh para código, y en Opus 5 se empieza en high y se usan low y medium con generosidad. Si arrastras un nivel de hace meses, ese es el primero que conviene revisar.

Cómo monitorizarlo

El effort level no aparece en el JSON que recibe el status line por defecto. Pero puedes leer la variable de entorno directamente desde tu script:

EFFORT=${CLAUDE_CODE_EFFORT_LEVEL:-high}

Y añadirlo a tu status line junto al modelo:

╸ my-project  main │ Opus (medium) │ ██░░░ 35%

Con una trampa: ese :-high es una suposición, no una lectura. Si tu nivel viene del settings.json o de un /effort anterior, la variable está vacía y tu status line dirá high aunque estés corriendo en low. Para leer el nivel real hay una cadena de precedencia entera por delante, y un chivato que sí funciona.

También puedes ver el modelo activo con /status, y el nivel de effort aparece en la cabecera de sesión junto al nombre del modelo.

Documentación oficial: Model configuration: Adjust effort level

Forma parte de los 10 hábitos para ahorrar tokens en Claude Code.