Contenido
- 1. Qué es el «esfuerzo»
- 2. Los 6 elementos 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 (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. El control deslizante /effort de Claude Code muestra estos más su propio modo Ultracode, lo que da 6 elementos en total. Así que es «5 niveles + Ultracode = 6 elementos». 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, más Ultracode a la derecha.
Por tanto, «Extra» = xhigh, y el esfuerzo máximo es «Max». Ultracode no es un escalón, sino un modo adicional.
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 6 elementos 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 es high, que se comporta exactamente igual que dejar el esfuerzo sin definir. El control deslizante /effort de Claude Code añade su propio modo Ultracode, por lo que enumera 6 elementos.
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 modo adicional con un comportamiento distinto (consulta la sección 6).
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.
xhigh + multiagente
No es un «escalón» de esfuerzo, sino un modo exclusivo de Claude Code. Consulta la sección 6.
⚠️ Qué persiste y qué no: low, medium, high y xhigh se guardan y se mantienen en tu siguiente sesión. «Max» y «Ultracode» son solo de sesión (Max solo persiste si se define mediante la variable de entorno CLAUDE_CODE_EFFORT_LEVEL; Ultracode no puede guardarse ni siquiera de ese modo).
3. Compatibilidad por modelo y degradación automática
Los niveles que puedes elegir dependen del modelo. xhigh («Extra») se limita a los modelos de gama alta más recientes. En Opus 4.8 o Fable 5 dispones de todos los niveles.
| Modelo | Niveles de esfuerzo de la API (low–max) | Por defecto |
|---|---|---|
| Fable 5 / Opus 4.8 | low · medium · high · xhigh · max | high |
| Opus 4.7 | low · medium · high · xhigh · max | xhigh |
| Opus 4.6 / Sonnet 4.6 | low · medium · high · max (sin xhigh) | high |
※ Esta tabla recoge los niveles de esfuerzo de la API. El control deslizante de Claude Code añade Ultracode (el modo del extremo derecho) para sumar 6 elementos. Ultracode solo está disponible en modelos compatibles con xhigh (Fable 5 / Opus 4.8 / Opus 4.7, etc.): en Opus 4.6 y Sonnet 4.6 no aparece en el menú /effort.
※ «Por defecto» aquí es el valor por defecto de Claude Code (xhigh en Opus 4.7, high en el resto). El valor por defecto de la API es high para todos los modelos.
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
# Restablecer al valor por defecto del modelo
/effort autoOtras 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. effortLevelen los ajustes: guardalow/medium/high/xhigh(maxyultracodeson solo de sesión y no pueden guardarse aquí).- Frontmatter de skill / subagente: anula el esfuerzo mientras se ejecuta esa skill o subagente.
💡 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. Empieza en xhigh («Extra») para programar y para el trabajo agéntico, baja a high cuando dudes, reduce a medium/low para ahorrar coste 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 | Trabajo cotidiano sensible al coste en el que puedes sacrificar algo de inteligencia |
| high | Razonamiento complejo e implementaciones difíciles. El estándar equilibrado |
| 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. Solo de sesión; 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 (en profundidad)
Ultracode aparece en el extremo derecho del control deslizante /effort y es un modo exclusivo de Claude Code. Lo fundamental: no es un nivel de esfuerzo de la API (low–max). Internamente consta de dos capas.
Envía esfuerzo xhigh
Cada mensaje llega al modelo con razonamiento de nivel xhigh («Extra»): la base para un trabajo agéntico profundo y de larga duración.
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» (capa 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»). La concurrencia tiene un tope de 16 agentes a la vez, con hasta 1000 agentes por ejecución.
🔑 Ultracode frente a xhigh: xhigh = solo profundidad de razonamiento. Ultracode = xhigh MÁS el lanzamiento automático de flujos de trabajo multiagente por tarea. Ambos están a la derecha del control deslizante, pero xhigh es un escalón de esfuerzo y Ultracode es un modo superpuesto.
Cómo activarlo
/effort ultracode: activado durante toda la sesión (cada tarea sustancial se convierte automáticamente en un flujo de trabajo).- Selecciona «Ultracode» en el menú
/efforto en el control deslizante de/model. - 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. - Pasa
"ultracode": truemediante--settingso una solicitud de control del Agent SDK.
⚠️ Compatibilidad de modelos y solo de sesión: Ultracode requiere un modelo compatible con xhigh (Fable 5 / Opus 4.8 / Opus 4.7, etc.); no aparece en el menú /effort en Opus 4.6 ni en Sonnet 4.6. Es solo de sesión y no puede guardarse (ni siquiera mediante la variable de entorno). Para volver al trabajo habitual, ejecuta /effort high.
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 se ejecuta en xhigh y 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 Ultracode del menú /effort.
※ El comportamiento se basa en la documentación oficial de Anthropic (Effort / configuración de modelos / Workflows); las etiquetas del control deslizante se confirmaron en la interfaz de escritorio en vivo de Claude Code (todo 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. 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 modo que añade xhigh + automatización multiagente. 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 es empezar a programar en xhigh («Extra»), y el valor por defecto high basta de sobra en la mayoría de situaciones. 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 añade Ultracode para sumar 6 elementos, mostrados como Bajo · Medio · Alto · Extra · Max · Ultracode. «Extra» = xhigh; el máximo es «Max». El valor por defecto es high (xhigh en Opus 4.7); xhigh es solo para los modelos de gama alta; los niveles no compatibles se degradan automáticamente.
- Cuál y cuándo: la programación empieza en xhigh («Extra»), high cuando dudes, medium/low por coste, max solo para problemas difíciles. Trabajos grandes de varios pasos → Ultracode (xhigh + multiagente, solo de sesión).
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. Para programar, la recomendación oficial es empezar en xhigh («Extra»).
P. ¿Qué nivel de esfuerzo debería usar?
R. Si dudas, el valor por defecto high está bien. Para programación seria o trabajo agéntico, xhigh («Extra») es el punto de partida recomendado. Para formato o trabajo ligero donde importa la velocidad, baja a low/medium.
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: añade, sobre el razonamiento de nivel xhigh, el lanzamiento automático de flujos de trabajo multiagente. Es para tareas grandes y de varios pasos, y está limitado a modelos compatibles con xhigh y es solo de sesión.
P. ¿Por qué no puedo elegir xhigh («Extra») ni Ultracode?
R. Ambos requieren un modelo compatible con xhigh (Fable 5, Opus 4.8, Opus 4.7, etc.). Opus 4.6 y Sonnet 4.6 no tienen 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. low/medium/high/xhigh se guardan en el ajuste effortLevel y se mantienen. Max normalmente es solo de sesión, pero persiste si se define mediante la variable de entorno CLAUDE_CODE_EFFORT_LEVEL. Ultracode no puede guardarse ni siquiera así: siempre es solo de sesión.
