Claude Code Ultracode y niveles de effort: la guía de /effort
El effort decide cuánto piensa Claude — y qué tan rápido quema tus límites. Esta guía explica los cinco niveles de effort, los valores por defecto de cada modelo, /effort auto y ultracode: el interruptor de orquestación que la v2.1.284 convirtió en un switch independiente que puedes apilar sobre cualquier nivel.
TL;DR — effort y ultracode en cuatro líneas
- Cinco niveles de effort: low, medium, high, xhigh, max — calibrados por modelo. El predeterminado es high en la mayoría de los modelos, pero Opus 5.5 y Sonnet 5.5 arrancan en medium, y Opus 4.7 en xhigh.
- Cámbialo con /effort (slider) o /effort <level>; /effort auto borra el nivel guardado y devuelve el modelo a su valor por defecto. Enter guarda como predeterminado; s lo deja solo para esta sesión.
- Ultracode es un ajuste de Claude Code, no un nivel de effort: hace que Claude orqueste dynamic workflows para tareas de peso. Desde la v2.1.284 es un interruptor propio — Tab dentro de /effort, o /effort ultracode on|off — y ya no fuerza xhigh.
- Ultracode vs max en una línea: max es el nivel de razonamiento crudo más profundo (propenso a pensar de más); ultracode añade orquestación de flujos de trabajo encima del nivel que hayas elegido. Responden preguntas distintas — profundidad vs. coordinación.
Model configuration & effort — Claude Code documentation
Docs:code.claude.com
Claude Code CHANGELOG — v2.1.284 (Ultracode becomes its own toggle)
Changelog:github.com/anthropics/claude-code
How to Use Claude Effort Levels (Full Guide)
Canal:Ryan & Matt Data Science13:24
Los datos de esta página vienen de la documentación oficial de effort y del changelog de la v2.1.284; el diagrama es una ilustración original de esta guía. El video listado prueba los mismos cinco niveles de effort en la app de co-work de Claude — datos reales de quema de tokens bien útiles, aunque su pantalla muestra una superficie distinta a Claude Code. No se usa ningún cuadro de él aquí.
Niveles de effort y ultracode, paso a paso
1 · Conoce la escala
- 1
Entiende qué controla realmente el effort
El effort es el dial de razonamiento de Claude Code: define cuánta cabeza mete el modelo en tus peticiones, lo que mueve directamente la calidad de respuesta, la latencia y la velocidad a la que quemas tu límite de uso. La documentación oficial es tajante: la escala se calibra por modelo — el mismo nombre de nivel no es el mismo valor de fondo en todos los modelos.
La escala de /effort de un vistazo: cinco niveles más el interruptor de ultracode (diagrama hecho para esta guía). - 2
Aprende los cinco niveles y cuándo cada uno justifica sus tokens
low va para intercambios rápidos que revisas tú — brainstorming, primeros bocetos, renombres. medium maneja el trabajo diario con alcance claro. high es para trabajo donde la verificación importa o acechan edge cases. xhigh compra razonamiento más profundo a cambio de más tokens, para tareas de agente largas. max es para problemas duros que quieres que Claude ataque solo — la documentación avisa que puede dar retornos decrecientes y pensar de más.
- 3
Revisa el default de tu modelo antes de culpar al modelo
Los defaults no son uniformes: high en todo modelo que soporta effort, salvo Opus 5.5 y Sonnet 5.5, que arrancan en medium, y Opus 4.7, que arranca en xhigh. Si las respuestas se sienten lentas o el límite se esfuma rápido, mira la línea de effort antes de culpar al modelo — y ojo: desde la v2.1.284 Sonnet 5.5 es el modelo Sonnet por defecto, con 1M de contexto a $2/$10 por millón de tokens.
2 · Cámbialo con intención
- 4
Cámbialo en vivo con /effort
Escribe /effort en una sesión y se abre un slider — las flechas se mueven entre niveles y Tab llega al interruptor de ultracode. Dentro del selector de /model, izquierda/derecha ajusta el mismo control. Para corridas puntuales, la flag --effort fija el nivel para esa sesión, y la variable de entorno CLAUDE_CODE_EFFORT_LEVEL sirve para automatización.
- 5
Fija un nivel directo — y entiende qué significa auto
/effort <level> fija el nivel sin abrir el slider. El comando discretamente útil es /effort auto: borra el nivel guardado del modelo activo, así Claude Code vuelve al default de ese modelo. La variable de entorno también acepta auto. Si una sesión se porta rara después de tus experimentos, auto es el botón de reset.
- 6
Haz permanente tu elección (como es debido)
En el slider de /effort, Enter guarda el nivel como tu default mientras que s lo aplica solo a esta sesión. En settings puedes fijar effort por modelo en modelSettings o usar un fallback global effortLevel — con una trampa: max no se acepta en ninguna de las dos claves, y si no viene de la variable de entorno, max aplica solo a la sesión actual. Skills y subagents pueden traer su propio effort en el frontmatter, con techo en maxEffortLevel.
3 · Ultracode, el nuevo interruptor
- 7
Entiende qué es ultracode
Ultracode es un ajuste de Claude Code, no un nivel de effort del modelo: según la documentación oficial, hace que Claude orqueste dynamic workflows para tareas de peso — dividir el trabajo grande en pasos coordinados en vez de una maratón de razonamiento en solitario. Por eso antes venía fusionado con xhigh: orquestación sobre razonamiento profundo.
- 8
Ponte al día con el cambio de la v2.1.284
Antes de la v2.1.284, ultracode era el tope del slider de /effort y activarlo forzaba xhigh. El changelog de septiembre de 2026 cambió eso: ultracode ahora es un interruptor propio — Tab en /effort, o /effort ultracode on|off — y ya no fuerza xhigh; queda encendido en cualquier nivel de effort. La extensión de VS Code reemplazó el tope de ultracode del slider por un switch de encendido/apagado (la píldora del modelo muestra “· Ultracode”), y nuevas acciones de keybinding de effortSlider cubren decreaseEffort, increaseEffort y toggleUltracode.
- 9
Decide entre ultracode y max
Son ejes distintos. max responde “piensa lo más fuerte posible en este problema” — el razonamiento crudo más profundo, sin límite de tokens, con riesgo documentado de sobrepensar. Ultracode responde “coordina el trabajo” — orquestación de flujos sobre el nivel que hayas elegido, ahora incluso max si quieres ambos. Regla práctica: debugging de un problema peludo → max; builds multi-paso donde importan la secuencia y la delegación → ultracode; ambos → max effort con ultracode activado.
- 10
Conoce las limitaciones antes de depender de él
La documentación lista ultracode como no disponible cuando los workflows están apagados, cuando el modelo no soporta xhigh, o cuando aplica un tope de effort por debajo de xhigh. Un maxEffortLevel administrado y los topes por rol de la organización pueden recortar la lista de niveles por modelo, y los niveles no soportados caen al nivel soportado más alto igual o inferior — xhigh corre como high en Opus 4.6. Si CLAUDE_CODE_EFFORT_LEVEL está clavado en un nivel distinto de xhigh, las peticiones corren en ese nivel con la orquestación inactiva. Para un impulso de una sola vuelta sin tocar ajustes, la palabra clave ultrathink añade razonamiento más profundo solo en esa vuelta.
Defaults por modelo y lista de niveles
Cuatro datos evitan la mayoría de los tickets de soporte:
- 1La mayoría de los modelos arranca en high; medium es la excepción, no la regla — solo es el default en Opus 5.5 y Sonnet 5.5.
- 2Opus 4.7 arranca en xhigh. Opus 4.6 y Sonnet 4.6 ni siquiera ofrecen xhigh — los niveles por encima de su techo caen al nivel soportado más alto.
- 3Los modelos que no están en la tabla de effort de la docs no soportan effort; Sonnet 5.5 entró a la tabla en la v2.1.284 como el nuevo Sonnet por defecto (1M de contexto, $2/$10 por Mtok, $0.20/Mtok en lecturas de caché).
- 4La escala se calibra por modelo: “el mismo nombre de nivel no representa el mismo valor de fondo entre modelos”. La guía de migración de la docs es directa — Opus 5.5 en medium iguala o supera a Opus 5 en high.
Orden de resolución cuando nada está guardado: gana la elección explícita (variable de entorno, flag --effort o /effort en sesión), luego los settings guardados (modelSettings por modelo, o un fallback global effortLevel), y al final el default del modelo.