Contenido
- 1. Qué es el «esfuerzo»
- 2. Los 5 niveles del control deslizante y sus etiquetas
- 3. Compatibilidad por modelo y degradación automática
- 4. Cómo configurarlo (/effort y más)
- 5. Referencia rápida: qué nivel y cuándo
- 6. Qué es Ultracode y en qué se diferencia del esfuerzo Max (en profundidad)
- 7. Funciones relacionadas y confusiones habituales
- Resumen
- Preguntas frecuentes
Ese control deslizante junto al nombre del modelo en Claude Code —el ajuste de «Esfuerzo» que va de «Más rápido» a «Más inteligente»— decide cuánto trabajo (razonamiento y tokens) dedica la IA a cada respuesta. Deslízalo a la izquierda para mayor rapidez y menor coste; a la derecha para más profundidad e inteligencia.
Veamos primero el panorama general. El propio ajuste de esfuerzo (los niveles de esfuerzo de la API) tiene 5 escalones: de low a max, y el control deslizante /effort de Claude Code elige entre ellos. Ultracode no es un sexto escalón: es un interruptor aparte, de activar y desactivar, que funciona en cualquier nivel (v2.1.284 y posteriores). Así que piensa en «un selector de 5 escalones + el interruptor de Ultracode». Tenlo presente y todo lo demás encaja.
Un único dial de «Más rápido» a «Más inteligente»
— desplaza a la vez la profundidad de razonamiento y las llamadas a herramientas
= los 5 niveles de esfuerzo de la API (low–max)
El control deslizante muestra Bajo · Medio · Alto · Extra · Max.
Por tanto, «Extra» = xhigh, y el esfuerzo máximo es «Max» (en la interfaz en español de España aparece como «Máximo»). Ultracode no es un escalón, sino un interruptor aparte que funciona en cualquier escalón.
1. Qué es el «esfuerzo»
El esfuerzo es el ajuste que controla cuántos tokens dedica Claude a una sola respuesta. Cuanto más bajo, más corto, rápido y barato; cuanto más alto, más profundo, exhaustivo e inteligente. Si has buscado «Claude Code effort» o te has preguntado qué hace el dial «Más rápido / Más inteligente», es esto.
Lo clave es que el esfuerzo afecta a toda tu respuesta, no solo al razonamiento. En concreto, incide en estos tres aspectos (fuente: la documentación oficial «Effort» de Anthropic: razonamiento extendido / llamadas a herramientas y argumentos de funciones / respuestas y explicaciones de texto).
Profundidad de razonamiento
Cuánto razona antes de responder. Un esfuerzo mayor permite análisis de varios pasos y dar marcha atrás.
Llamadas a herramientas
Cuántas veces lee, busca o edita. Un esfuerzo menor agrupa y reduce las llamadas.
Cantidad de texto de la respuesta
Explicaciones, resúmenes, comentarios. Un esfuerzo menor implica menos preámbulo y una salida más escueta.
💡 En pocas palabras: el esfuerzo es una señal de comportamiento, no un presupuesto fijo de tokens. Incluso con esfuerzo bajo, Claude seguirá razonando ante problemas realmente difíciles, solo que menos de lo que lo haría con un esfuerzo mayor para el mismo problema.
2. Los 5 niveles del control deslizante y sus etiquetas
Como ajuste de la API, el esfuerzo tiene 5 niveles: low → medium → high → xhigh → max. El valor por defecto depende del modelo: high en la mayoría y medium en Opus 5.5 y algunos más (consulta la sección 3). El control deslizante /effort de Claude Code es el selector que elige entre estos 5.
Hay algo que confunde a la gente: «Extra» no es el máximo. El control deslizante muestra Bajo · Medio · Alto · Extra · Max, donde «Extra» = xhigh y «Max» = max. Así que «Extra» es el segundo desde arriba, no el primero. Y Ultracode no es ningún escalón de esfuerzo: es un interruptor aparte con un comportamiento distinto (consulta la sección 6). Antes de la v2.1.284, Ultracode ocupaba el extremo derecho del control deslizante como sexta posición; ahora es un interruptor independiente que se cambia con la tecla Tab dentro de /effort (en la extensión de VS Code, un interruptor bajo el control deslizante).
Menos tokens, menor latencia
Tareas cortas y acotadas, formato, código repetitivo, subagentes. Prima la velocidad y el coste.
Punto intermedio con coste contenido
Calidad sólida manteniendo los tokens a raya en el trabajo del día a día.
El equilibrio ideal entre calidad y coste
El estándar para el razonamiento complejo y la programación difícil. «En su punto» para la mayoría del trabajo.
Trabajo agéntico de larga duración
Para programar con llamadas repetidas a herramientas y búsquedas profundas. Usa muchos más tokens que high.
Razonamiento máximo, sin límite
El razonamiento más profundo, sin límite de tokens. Solo para problemas realmente difíciles; puede sobrepensar.
Automatización multiagente
No es un «escalón» de esfuerzo, sino un ajuste de Claude Code que puedes activar con cualquier nivel de esfuerzo. Consulta la sección 6.
⚠️ Qué persiste y qué no: low, medium, high y xhigh se guardan por modelo cuando los confirmas con Enter en el control deslizante, y se mantienen en tu siguiente sesión (si confirmas con s, se aplican solo a esta sesión). «Max» es solo de sesión (solo persiste si se define mediante la variable de entorno CLAUDE_CODE_EFFORT_LEVEL). Ultracode activado con /effort ultracode dura lo que la sesión, pero si escribes "ultracode": true en un archivo de ajustes, todas las sesiones empiezan con él activado (consulta la sección 6).
3. Compatibilidad por modelo y degradación automática
Los niveles que puedes elegir dependen del modelo. xhigh («Extra») se limita a los modelos relativamente recientes. Los actuales Fable 5.1, Opus 5.5, Sonnet 5.5 y Haiku 5.5 ofrecen todos los niveles, mientras que el modelo legacy Haiku 4.5 no admite el esfuerzo en absoluto (en Haiku, el esfuerzo llegó con Haiku 5.5, publicado el 7 de octubre de 2026). Cómo elegir el nivel de esfuerzo en Haiku 5.5 se explica en el capítulo 6 de la guía de Claude Haiku 5.5.
Ojo con los valores por defecto. Opus 5.5, el modelo por defecto de Claude Code, empieza en medium: un nivel por debajo del high que usaba Opus 5 por defecto.
| Modelo | Niveles de esfuerzo (low–max) | Por defecto en Claude Code | Por defecto en la API |
|---|---|---|---|
| Fable 5.1 | low · medium · high · xhigh · max | high | high |
| Opus 5.5 | low · medium · high · xhigh · max | medium | medium |
| Sonnet 5.5 | low · medium · high · xhigh · max | medium | high |
| Haiku 5.5 | low · medium · high · xhigh · max | medium | medium |
| Legacy: Fable 5 / Opus 5 / Sonnet 5 / Opus 4.8 | low · medium · high · xhigh · max | high | high |
| Legacy: Opus 4.7 | low · medium · high · xhigh · max | xhigh | high |
| Legacy: Opus 4.6 / Sonnet 4.6 | low · medium · high · max (sin xhigh) | high | high |
| Legacy: Haiku 4.5 | No compatible (sin control de esfuerzo) | — | — |
* A 12 de octubre de 2026. «Legacy» son los modelos que Anthropic clasifica como legacy (siguen disponibles). Fuentes: configuración de modelos de Claude Code (niveles y valores por defecto de Claude Code), documentación de Effort de la API y lista de modelos (valores por defecto de la API).
* Sonnet 5.5 y Opus 4.7 tienen valores por defecto distintos en Claude Code y en la API. En Claude Code, si no fijas el esfuerzo, se usa la columna «Por defecto en Claude Code».
* Claude Code necesita la v2.1.293 o posterior para usar Haiku 5.5. El alias haiku apunta a Haiku 5.5 en la API de Anthropic; en Amazon Bedrock, Google Cloud, Microsoft Foundry y otros proveedores sigue apuntando a Haiku 4.5.
* Ultracode (un interruptor aparte del esfuerzo) solo está disponible en modelos compatibles con xhigh (Fable 5.1 / Opus 5.5 / Sonnet 5.5, etc.): en Opus 4.6 y Sonnet 4.6 el interruptor no aparece en /effort.
Si eliges un nivel que el modelo no admite, no da error: se degrada automáticamente al nivel compatible más cercano por debajo o igual. Por ejemplo, xhigh («Extra») en Opus 4.6 se ejecuta como high (esos dos modelos saltan de high directamente a max, sin xhigh en medio). Ten en cuenta también que un mismo nombre de nivel significa cantidades distintas en cada modelo: la escala de esfuerzo está calibrada por modelo.
4. Cómo configurarlo (/effort y más)
Empieza aquí: el comando /effort. Ejecútalo sin argumentos y se abre un control deslizante interactivo (el dial de la captura), que se maneja con las teclas de flecha. Esto por sí solo es todo lo que la mayoría necesita.
# Abrir el control deslizante (teclas de flecha y luego Intro)
/effort
# Definir un nivel directamente
/effort low
/effort xhigh
# Borrar el nivel guardado y volver al valor por defecto del modelo
/effort auto
# Activar / desactivar Ultracode (el esfuerzo no cambia)
/effort ultracode
/effort ultracode offOtras opciones, según tus necesidades (las últimas son para usuarios avanzados):
- El control deslizante dentro de
/model: en el selector de modelo, usa las teclas de flecha izquierda/derecha para ajustar el dial de esfuerzo. - Indicador
--effort: inicia conclaude --effort medium(solo para esa sesión). - Variable de entorno
CLAUDE_CODE_EFFORT_LEVEL: un nombre de nivel oauto. Tiene la máxima prioridad. modelSettings/effortLevelen los ajustes: el nivellow/medium/high/xhighque confirmas en/efforto/modelse guarda por modelo enmodelSettingsde tus ajustes de usuario (v2.1.251 y posteriores; antes se escribía un únicoeffortLevel). Para editarlo a mano, fija un nivel por modelo enmodelSettings, o usaeffortLevelcomo valor por defecto para los modelos sin nivel guardado (pero eleffortLevelde tus ajustes de usuario,~/.claude/settings.json, no se aplica a Opus 5.5 ni a los modelos posteriores).maxno se admite en ninguna de las dos claves, y Ultracode tiene su propia clave"ultracode": true.- Frontmatter de skill / subagente: anula el esfuerzo mientras se ejecuta esa skill o subagente.
Si quieres cambiar a la vez el esfuerzo y el modelo de varias sesiones abiertas en Claude Code Desktop, basta con pedírselo al asistente; el procedimiento y las comprobaciones están en Cambiar modelo y esfuerzo en bloque: Claude Code y Codex.
💡 Prioridad: variable de entorno ＞ frontmatter (solo mientras se ejecuta esa skill/subagente; nunca supera a la variable de entorno) ＞ tu valor configurado o de sesión ＞ el valor por defecto del modelo. El nivel actual se muestra junto al logo y al indicador de carga, por ejemplo «with low effort», para que confirmes cuál está activo.
5. Referencia rápida: qué nivel y cuándo
La recomendación oficial es sencilla. El valor por defecto del modelo basta para la mayoría de las tareas de programación (medium en Opus 5.5 y Sonnet 5.5, high en Fable 5.1). Sube a high cuando importe verificar, a xhigh («Extra») para trabajos largos y más profundos, baja a low para intercambios rápidos y reserva max para problemas realmente difíciles. Recurre a Ultracode solo cuando quieras abordar de una vez una tarea grande y de varios pasos.
| Elemento (visualización) | Cuándo usarlo |
|---|---|
| low | Tareas cortas, acotadas y sensibles a la latencia que no requieren mucha inteligencia |
| medium | Implementación cotidiana con un alcance claro (por defecto en Opus 5.5, Sonnet 5.5 y Haiku 5.5). En otros modelos, trabajo sensible al coste en el que puedes sacrificar algo de inteligencia |
| high | Trabajo en el que importa verificar o es probable que surjan casos límite, como corregir un error en código existente (por defecto en Fable 5.1 y otros) |
| xhigh (Extra) | Sesiones largas de programación/agénticas con llamadas repetidas a herramientas y búsquedas profundas |
| max (Max) | Solo los problemas más difíciles. Las mejoras se estancan y hay riesgo de sobrepensar; pruébalo antes |
| Ultracode | Tareas grandes y de varios pasos (refactorizaciones grandes, auditorías) que quieres repartir entre varios agentes. Se activa y desactiva aparte de los escalones de esfuerzo; no para el uso diario (→ §6) |
Cuando subas el esfuerzo para trabajo pesado, define un max_tokens generoso (en torno a 64k o más) para que el modelo tenga margen para razonar y actuar a través de las llamadas a herramientas.
6. Qué es Ultracode y en qué se diferencia del esfuerzo Max (en profundidad)
Ultracode es un ajuste de Claude Code: un interruptor de activar y desactivar que se cambia con la tecla Tab dentro de /effort. Lo fundamental: no es un nivel de esfuerzo de la API (low–max). Hay dos puntos que conviene conocer.
El esfuerzo no cambia
Activarlo no cambia el nivel de esfuerzo: funciona en el escalón en el que estés (de Bajo a Max). La única excepción es iniciar con claude --effort ultracode, que además fija xhigh («Extra»).
Lanza flujos de trabajo dinámicos de forma automática
Para cada tarea sustancial, Claude planifica y lanza por su cuenta un flujo de trabajo multiagente, ejecutando varios subagentes en paralelo.
Los «flujos de trabajo dinámicos» (punto 2) significan que Claude escribe sobre la marcha un script que ejecuta muchos subagentes en segundo plano, en paralelo. Los resultados intermedios quedan en el script; solo el resultado final vuelve al contexto de Claude. Una sola solicitud puede ramificarse en varios flujos de trabajo (p. ej., «entender el código → cambiarlo → verificarlo»). Por defecto se ejecutan hasta 16 agentes a la vez (menos en equipos con menos CPU; la variable de entorno CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS lo cambia), con hasta 1000 agentes por ejecución.
🔑 Ultracode frente a xhigh: xhigh = profundidad de razonamiento (un escalón de esfuerzo). Ultracode = un interruptor que lanza automáticamente flujos de trabajo multiagente por tarea, independiente del esfuerzo. Por eso funcionan combinaciones como «Medio + Ultracode». Antes de la v2.1.284, activar Ultracode fijaba la sesión en xhigh, elegir otro escalón lo desactivaba y un límite de esfuerzo por debajo de xhigh lo hacía no disponible.
Cómo activarlo
/effort ultracode: activado durante el resto de la sesión (cada tarea sustancial se convierte automáticamente en un flujo de trabajo)./effort ultracode offlo desactiva. Ninguno de los dos cambia tu nivel de esfuerzo.- En el control deslizante
/effort, pulsaTabpara cambiar el interruptor de Ultracode y luegoEnterpara aplicarlo (en la extensión de VS Code, usa el interruptor bajo el control deslizante). - Inicia con
claude --effort ultracode: empieza con Ultracode activado y el esfuerzo en xhigh («Extra»). - Para empezar todas las sesiones con él activado, escribe
"ultracode": trueen un archivo de ajustes (también puedes pasarlo mediante--settingso una solicitud de control del Agent SDK). - Para algo puntual, incluye la palabra clave
ultracodeen tu prompt (p. ej., «ultracode: audita todos los endpoints bajo src»). El esfuerzo de tu sesión no cambia.
⚠️ Compatibilidad de modelos y persistencia: Ultracode requiere un modelo compatible con xhigh (Fable 5.1 / Opus 5.5 / Sonnet 5.5, etc.); el interruptor no aparece en /effort en Opus 4.6, Sonnet 4.6 ni el legacy Haiku 4.5 (que no admite el esfuerzo). /effort ultracode es solo de sesión; la forma de que perdure es "ultracode": true en un archivo de ajustes (effortLevel y la variable de entorno CLAUDE_CODE_EFFORT_LEVEL no lo admiten). Para volver al trabajo habitual, ejecuta /effort ultracode off (antes de la v2.1.284, elegir otro escalón como /effort high lo desactivaba).
Cuándo usarlo
✅ Buen encaje
Refactorizaciones grandes, migraciones en cientos de archivos, auditorías de errores o autorizaciones en todo el código, comprobaciones cruzadas desde múltiples perspectivas: trabajo de varios pasos demasiado grande para dirigirlo en una sola conversación.
⛔ Mal encaje
Tareas pequeñas y acotadas, trabajo sensible a la latencia, ediciones rutinarias. Cada solicitud cuesta bastantes más tokens y tiempo, así que aquí es un derroche.
Nota sobre el coste: como cada solicitud sustancial se ramifica en flujos de trabajo, Ultracode consume muchos más tokens y tiempo de lo habitual y puede agotar rápidamente el uso de tu plan y tus límites de tasa. Pruébalo primero en una porción pequeña (un directorio) para calibrar la escala. La propia función de flujos de trabajo dinámicos puede desactivarse mediante /config, el ajuste "disableWorkflows": true o la variable de entorno CLAUDE_CODE_DISABLE_WORKFLOWS=1, lo que también elimina el interruptor de Ultracode de /effort.
* El comportamiento se basa en la documentación oficial de Anthropic (Effort / configuración de modelos / Workflows / referencia de ajustes); Ultracode como interruptor y el guardado por modelo, a 29 de septiembre de 2026 (v2.1.284). Las etiquetas del control deslizante se confirmaron en la interfaz de escritorio en vivo de Claude Code (a fecha de junio de 2026). El esfuerzo y Ultracode evolucionan deprisa: consulta la documentación oficial y tu aplicación para conocer lo más reciente.
7. Funciones relacionadas y confusiones habituales
Hay algunas funciones que es fácil confundir con el esfuerzo. Así se diferencian.
ultrathink
Una palabra clave que hace que Claude razone más a fondo solo en ese turno; el esfuerzo de tu sesión no cambia. Desde la v2.1.311, al usar Opus 5.5, Sonnet 5.5, Haiku 5.5 o Fable 5.1 con la API de Anthropic, ese turno se ejecuta con esfuerzo xhigh (si lo escribes a mitad de una tarea, sube el resto de ese turno; registro de cambios oficial). Desde la v2.1.316, la variable de entorno CLAUDE_CODE_DISABLE_ULTRATHINK desactiva esta palabra clave, y en la extensión de VS Code también funciona con xhigh (registro de cambios de v2.1.316). Frases como «think» o «think hard» se tratan como texto normal y no hacen nada.
/fast (modo rápido)
Un eje distinto. Ejecuta el mismo modelo más rápido (no baja a uno más pequeño), a un coste mayor. Combínalo con esfuerzo low para un trabajo rutinario ágil.
Ultracode
No es un escalón de esfuerzo, sino un interruptor de activar y desactivar con el que Claude monta por sí solo flujos de trabajo multiagente. Funciona con cualquier nivel de esfuerzo. Detalles en la sección 6.
La confusión habitual es «elige “Extra” y es lo más inteligente». En realidad, «Extra» = xhigh, y el esfuerzo máximo es «Max» a su derecha. Ni siquiera Max es siempre lo mejor: en salidas estructuradas o tareas ligeras puede sobrepensar y perjudicar la calidad. La recomendación oficial de empezar a programar en xhigh («Extra») se escribió para Opus 4.7 y 4.8; en el actual Opus 5.5, el punto de partida es su valor por defecto, medium. Ante la duda, el valor por defecto del modelo suele bastar. Si tu configuración se atasca, consulta los errores habituales de Claude Code y cómo solucionarlos.
Resumen
Tres ideas clave sobre el ajuste de esfuerzo de Claude Code.
- Qué es: el ajuste de tokens por respuesta, tu dial «Más rápido ↔ Más inteligente». Afecta por igual al razonamiento, a las llamadas a herramientas y al texto de la respuesta.
- Escalones y etiquetas: la API tiene 5 niveles de esfuerzo (low–max). El control deslizante muestra Bajo · Medio · Alto · Extra · Max, y Ultracode es un interruptor aparte, no un escalón. «Extra» = xhigh; el máximo es «Max». El valor por defecto depende del modelo (medium en Opus 5.5, Sonnet 5.5 y Haiku 5.5, high en Fable 5.1); xhigh requiere un modelo relativamente reciente; el legacy Haiku 4.5 no admite el esfuerzo (Haiku 5.5 admite todos los niveles); los niveles no compatibles se degradan automáticamente.
- Cuál y cuándo: parte del valor por defecto del modelo, high cuando importe verificar, xhigh («Extra») para trabajos largos y profundos, low para tareas rápidas, max solo para problemas difíciles. Trabajos grandes de varios pasos → Ultracode (automatización multiagente que puedes activar con cualquier nivel de esfuerzo;
/effort ultracode offla desactiva).
Un único dial te da el equilibrio entre velocidad e inteligencia. Léelo junto con el comando loop y nuestra comparativa de herramientas de programación con IA para sacarle el máximo partido a Claude Code.
El otro selector que se sitúa justo al lado del dial de esfuerzo son los modos de permisos de Claude Code. Mientras que el esfuerzo decide cuánto razona Claude, el modo de permisos decide hasta dónde puede ejecutar por su cuenta; combinar ambos elimina las dudas en el uso diario.
Preguntas frecuentes
P. ¿Elegir «Extra» en el control deslizante es el ajuste más inteligente?
R. No. «Extra» es xhigh (el segundo desde arriba), no el máximo. El esfuerzo máximo es «Max», justo a su derecha. Pero Max no siempre es lo mejor: en salidas estructuradas o tareas ligeras puede sobrepensar. En el actual Opus 5.5, la recomendación oficial es empezar en su valor por defecto, medium.
P. ¿Qué nivel de esfuerzo debería usar?
R. Si dudas, deja el valor por defecto del modelo (medium en Opus 5.5 y Sonnet 5.5, high en Fable 5.1). Súbelo a high para trabajo que requiere verificación, como corregir errores en código existente, o a xhigh («Extra») para trabajos largos y profundos. Para formato o trabajo ligero donde importa la velocidad, baja a low.
P. ¿En qué se diferencia Ultracode de Max?
R. Max es un nivel de esfuerzo (el razonamiento más profundo). Ultracode no es un escalón de esfuerzo: es un interruptor de Claude Code que lanza automáticamente flujos de trabajo multiagente. Como es independiente del esfuerzo, funcionan tanto «Max + Ultracode» como «Medio + Ultracode» (v2.1.284 y posteriores). Es para tareas grandes y de varios pasos, y está limitado a modelos compatibles con xhigh.
P. ¿Por qué no puedo elegir xhigh («Extra») ni Ultracode?
R. Ambos requieren un modelo compatible con xhigh (Fable 5.1, Opus 5.5, Sonnet 5.5, etc.). Los modelos legacy Opus 4.6 y Sonnet 4.6 no tienen xhigh (y el legacy Haiku 4.5 no admite el esfuerzo en absoluto, mientras que Haiku 5.5 sí ofrece xhigh), y Ultracode no aparece allí en el menú /effort (las solicitudes de xhigh se degradan automáticamente a high). Cambia de modelo para obtenerlos.
P. ¿Cómo hago que mi ajuste se mantenga entre sesiones?
R. Para low/medium/high/xhigh, basta con confirmar el nivel con Enter en el control deslizante /effort (o escribirlo, como en /effort high): se guarda por modelo en modelSettings de tus ajustes de usuario y se mantiene. Max normalmente es solo de sesión, pero persiste si se define mediante la variable de entorno CLAUDE_CODE_EFFORT_LEVEL. Para Ultracode, escribe "ultracode": true en un archivo de ajustes y todas las sesiones empezarán con él activado (effortLevel y la variable de entorno no lo admiten).
Relacionado: Guía de lanzamiento de Claude Opus 5, El pensamiento adaptativo de Claude.
