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.

Actualización, 1 de noviembre de 2026: Opus 5.5, Sonnet 5.5 y Haiku 5.5 arrancan en medium, no en high; corregido en el texto y en la tabla.

Actualización, 31 de octubre de 2026: el JSON que recibe el status line sí trae el effort level, en effort.level (junto a thinking.enabled), así que ya no hace falta adivinarlo desde la variable de entorno.

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; Opus 5 y Fable 5.1 volvieron a high, y Opus 5.5, Sonnet 5.5 y Haiku 5.5 arrancan en medium.

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. Y si vives en max, /usage ya lo señala entre lo que vacía tu límite.

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.

En Fable 5.1 el low trae una letra pequeña documentada: busca menos y responde más de memoria. Si te contesta con versiones viejas, sube el nivel en esos turnos o pon en tu CLAUDE.md la línea que le hace buscar antes de contestar.

Cómo monitorizarlo

El JSON que recibe el status line trae el effort level en effort.level, y al lado thinking.enabled. Léelo desde tu script:

input=$(cat)
EFFORT=$(echo "$input" | jq -r '.effort.level // empty')

Y añádelo a tu status line junto al modelo:

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

Con una salvedad: effort.level es el nivel puesto para la sesión, venga de la variable de entorno, del settings.json o de un /effort anterior, no el que fije una skill, un subagente o ultrathink para un turno, y no aparece si el modelo no admite effort. Para leer el nivel real dentro de un script 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.