Guía interna · Claude Code

Effort, ultrathink y ultracode

Qué hace cada perilla, cuándo usarla y cómo combinarlas sin quemar tokens de más.

1En una línea cada uno

Nivel de effort

/effort high

Cuánto razona el modelo en cada paso. Aplica a toda la sesión.

Palabra clave

ultrathink

Pedido de pensar más en un solo turno. No cambia el effort de la sesión.

Modo de trabajo

/effort ultracode

Claude orquesta subagentes en paralelo para tareas grandes. Se combina con cualquier nivel.

La idea clave: high es un nivel de effort; ultracode no lo es. Son perillas distintas: podés tener high + ultracode, o medium + ultracode.

2Niveles de effort

Controlan el razonamiento adaptativo: el modelo decide, paso a paso, si piensa y cuánto según la complejidad. Más effort implica más profundidad, más verificación y más tokens.

lowrápido
mediumdefault 5.5
highdefault resto
xhighprofundo
maxsolo sesión
NivelCuándo usarlo
lowIntercambios rápidos donde revisás cada resultado: brainstorming, primer borrador, un rename.
mediumDefault en Opus 5.5, Sonnet 5.5 y Haiku 5.5. Trabajo diario con alcance claro, como implementar una feature nueva.
highCuando importa verificar o hay edge cases probables, como arreglar un bug en un codebase existente. Es el default en los demás modelos.
xhighRazonamiento más profundo, con más gasto de tokens. Default en Opus 4.7.
maxProblemas duros que querés que resuelva sin vos, como buscar vulnerabilidades. Puede rendir menos de lo esperado y sobrepensar: probalo antes de adoptarlo.

Ojo al migrar de modelo: la escala está calibrada por modelo, así que el mismo nombre no equivale al mismo valor entre modelos. Al pasar de Opus 5 a Opus 5.5, empezá en medium en lugar de arrastrar el high que usabas.

Cómo se setea

/effort                # slider interactivo
/effort high           # setea el nivel y lo guarda como default del modelo
/effort auto           # vuelve al default del modelo
claude --effort high   # solo para esa sesión
export CLAUDE_CODE_EFFORT_LEVEL=high

En el slider, Enter guarda el nivel como default y s lo aplica solo a esta sesión. max siempre aplica solo a la sesión actual, salvo que lo setees por variable de entorno.

3ultrathink

Qué es

  • Una palabra clave que escribís en cualquier parte del prompt.
  • Claude Code agrega una instrucción en el contexto para que razone más en ese turno.
  • El effort que se manda a la API no cambia.

Lo que no es

  • No es un modo ni un nivel de effort.
  • Solo se reconoce la palabra exacta: "think", "think hard" o "think more" van como texto normal.
  • No dura más allá del mensaje donde lo usaste.

Ejemplo:

ultrathink: revisá por qué el CAEA no se informa cuando el WSFe
devuelve timeout en el lote nocturno

Cuándo conviene: estás en medium o high y aparece un problema puntual más difícil. Así no subís el effort de toda la sesión. Si vas a estar un rato largo con cosas complejas, conviene subir el effort con /effort.

4ultracode

Es un setting de Claude Code, no un nivel de effort del modelo. Cuando está activo, Claude orquesta dynamic workflows para las tareas sustantivas: decide solo cuándo partir el trabajo en subagentes en paralelo y después integra los resultados.

Sin ultracode

tarea→ 1 agente→ resultado

Todo ocurre en una sola conversación y un solo contexto.

Con ultracode

tarea→ plan→ subagente Asubagente Bsubagente C →integración

Claude decide por tarea si vale la pena armar el workflow.

Cómo se activa

/effort ultracode        # activa ultracode, NO cambia el nivel de effort
/effort ultracode off    # lo desactiva
claude --effort ultracode   # activa ultracode Y pone el effort en xhigh

// ~/.claude/settings.json (persistente)
{ "ultracode": true }

En el slider de /effort, Tab alterna el toggle Ultracode y Enter lo aplica. Elegir un nivel en el slider o en /model no toca el estado de ultracode.

No disponible cuando:

Cuidado con artículos viejos: antes de la v2.1.284, activar ultracode forzaba xhigh y elegir otro nivel lo apagaba. Muchos blogs todavía describen ese comportamiento. Corran claude update.

Costo: corren varios agentes, así que el consumo de tokens sube bastante. No lo dejen prendido para cambios chicos.

5Comparación lado a lado

effort (high, etc.)ultrathinkultracode
Qué cambiaEl nivel real que se manda al modeloAgrega una instrucción de pensar másHabilita orquestación con subagentes
AlcanceSesión (o default guardado)Un turnoSesión (o setting persistente)
Cómo se activa/effort <nivel>Escribir ultrathink en el prompt/effort ultracode
¿Toca el effort?SíNoNo (salvo --effort ultracode)
AgentesUnoUnoVarios en paralelo
CostoSube con el nivelExtra solo en ese turnoEl más alto

6¿Qué uso?

Rename, ajuste chico, borrador que vas a revisarlow
Feature nueva con alcance claro (en modelos 5.5)medium
Fix de bug en código existente, lógica fiscal, edge caseshigh
Un problema puntual difícil en medio de una sesión normalultrathink
Migración de varios módulos, auditoría de un repo entero, refactor transversalultracode
Lo mismo, pero con lógica crítica donde importa verificarhigh + ultracode