Cambiar de modelo y ajustar el effort en Claude Code, explicado a fondo - Cómo elegir entre Opus 5 / Sonnet 5 / Fable 5.1 🎛️

¡Hola! Soy Mojangcam 😎

En julio, cuando conté el lanzamiento de Claude Opus 5, presenté brevemente los comandos /model y /effort. Desde entonces, al revisar las búsquedas que traen gente a este blog, veo que no paran de llegar consultas como 'cambiar modelo de Claude Code' y 'diferencia de effort en Claude'. Pero no había un post dedicado solo a eso, así que hoy preparé una guía dedicada que se centra únicamente en estas dos cosas.

Esto es lo que vas a aprender en este post.

• Qué cambia el modelo y qué cambia el effort (dos diales que es fácil confundir)
• La gama de modelos a septiembre de 2026 (Fable 5.1 / Opus 5 / Sonnet 5 / Haiku 4.5) y el modelo por defecto de cada plan
• Cambiar con /model → ajustar con /effort → fijarlo en settings.json
• Qué elegir para tu trabajo — criterios de elección y combinaciones recomendadas por plan
• Errores frecuentes (como por qué tu cambio vuelve atrás en la siguiente sesión)

¿Por qué importa esto? En el plan Pro el modelo por defecto es Sonnet 5 y en el plan Max es Opus 5, así que aunque todos usan el mismo Claude Code, cada persona tiene un modelo distinto funcionando. Además, solo con el effort el consumo de tokens puede multiplicarse varias veces. Tanto si chocas una y otra vez con tu límite de uso como si sientes que "las respuestas son demasiado flojas", al final la solución suele estar en estos dos ajustes 🙌

📌 Qué necesitas

• Claude Code v2.1.278 (la última en npm a 2026-09-21) — versiones mínimas: Opus 5 → v2.1.219+, Sonnet 5 → v2.1.197+, Fable 5.1 → v2.1.257+
• Una suscripción de Claude (Pro, Max o Team) o una clave de la API de Anthropic
• Si usas una clave de API, ponla solo en la variable de entorno ANTHROPIC_API_KEY. ¡Nunca la escribas directamente en un archivo de configuración ni en tu código!

Empecemos por poner la versión al día.

claude update
claude --version

💬 Este post se basa en una conexión directa por la API de Anthropic o con una suscripción de claude.ai. En Amazon Bedrock, Google Cloud y Microsoft Foundry los alias apuntan a otras versiones, así que lo indico aparte en la tabla de abajo.

🧠 Modelo vs effort: ¿en qué se diferencian?

Claude Code tiene dos ajustes que "parecen mejorar las respuestas". Pero hacen cosas completamente distintas. Si resumimos en una tabla la explicación del blog oficial de Anthropic, queda así.

La clave es que el effort no es simplemente "tiempo de pensar". Si subes el effort, Claude lee más archivos, ejecuta más pruebas y llega más lejos por su cuenta antes de volver a preguntarte. Si lo bajas, ahorra tokens pero pregunta más a menudo "¿Cómo quieres que haga esto?".

Por eso, este es el criterio oficial para decidir qué dial girar cuando algo sale mal 💡

• Falló por no saber (le diste todo el contexto y aun así da una respuesta equivocada con total seguridad, bugs sutiles, dominios poco familiares) → sube el modelo
• Falló por esforzarse poco (se saltó archivos, no ejecutó las pruebas, dejó a medias una refactorización) → sube el effort
• Antes de eso: comprueba que el prompt no sea ambiguo y que CLAUDE.md y las herramientas estén bien configurados. Es mucho más frecuente que sea un problema de contexto que de diales.

🧩 La gama de modelos a septiembre de 2026

Según el Models overview oficial, ahora mismo puedes elegir entre 4 modelos.

Los precios de la tabla son de pago por uso en la API. Las suscripciones Pro y Max son de tarifa fija, pero igualmente, cuanto más caro es el modelo, antes consumes tu límite de uso, así que la intuición te sirve igual. Por cierto, Sonnet 5 en la API siempre funciona con 1M de contexto, y aunque pases de 200.000 tokens no hay recargo.

Y qué modelo aparece si no tocas nada (default) depende del plan. Aquí se confunde mucha gente.

O sea, Max arranca directamente con Opus 5 y Pro arranca directamente con Sonnet 5. Si estás en Pro y te preguntabas "¿por qué mi Claude Code no usa Opus?", es lo normal 😅

📌 Paso 1 - Cambiar de modelo con /model

Puedes cambiarlo en plena sesión. Si lo escribes sin argumentos, se abre el selector (picker).

/model

En el selector hay una tecla importante 💡

• Enter : cambia el modelo y lo guarda como predeterminado de ahora en adelante (escribe el valor model en tu archivo de configuración de usuario)
• s : lo cambia solo para esta sesión y deja intacto el predeterminado guardado
• Flechas ←/→ : ajustan el control deslizante de effort en la misma pantalla

También puedes escribir el nombre directamente. En ese caso equivale a pulsar Enter, así que también se guarda como predeterminado.

/model opus
/model sonnet
/model fable
/model claude-opus-5

Aquí tienes un resumen de los alias más usados.

opusplan es una joya poco conocida. El diseño (plan) lo hace el modelo listo y el código lo escribe el modelo rápido, así que el coste baja muchísimo.

Si quieres indicarlo desde el arranque, pásalo con un flag; esto se aplica solo a esa sesión y no toca el predeterminado. Es perfecto cuando quieres tener dos terminales con modelos distintos.

claude --model sonnet

Y cuando se combinan varios métodos, hay un orden de prioridad. Cuanto más arriba, más fuerza tiene.

1. /model durante la sesión
2. claude --model al arrancar
3. La variable de entorno ANTHROPIC_MODEL
4. La clave model del archivo de configuración (aquí va el valor que guardas con /model)
5. La variable de entorno ANTHROPIC_DEFAULT_MODEL (valor inicial que solo se usa si no se indicó nada, v2.1.236+)

Puedes ver qué está funcionando ahora con /status, y el nombre del modelo también aparece en la cabecera al iniciar la sesión. Si el modelo lo decidió la configuración del proyecto o una configuración administrada (managed), la cabecera muestra incluso qué archivo lo decidió, así que tenlo en cuenta.

📌 Paso 2 - ¿Qué modelo usar y cuándo? (criterios de elección)

Si pasamos la guía oficial a tipos de tarea, queda así.

La analogía del blog oficial es divertida, así que la traigo tal cual. Usar Opus con effort low es como tener una reunión de 5 minutos con un experto que conoce bien tu problema, y usar Sonnet con effort high es como darle toda la tarde a un generalista listo. El primero tiene mucha experiencia pero apenas hojea tu código; el segundo lee tu código a fondo pero tiene menos de "esto ya lo he visto". Y Fable es el especialista que con un simple vistazo detecta el problema en el que todos los demás se atascaron, así que la postura oficial es reservarlo para las tareas que de verdad lo necesitan.

💡 Un consejo sobre costes. Los modelos grandes tienen un precio por token más alto, pero en tareas difíciles hacen menos iteraciones, así que el coste total por tarea puede acabar siendo menor. Mientras un modelo pequeño quema tokens puliendo hasta su límite, el grande termina en unos pocos pasos. Al revés, en los tramos de trabajo rutinario bajar a un modelo pequeño es ganancia neta.

Y en breve, los consejos que da la documentación oficial para usar Fable 5.1.

• Describe el resultado, no los pasos. Él decide el camino
• Encárgale el problema ambiguo entero. Donde más rinde es investigando causas raíz, depurando incidencias y tomando decisiones de arquitectura
• Quita recordatorios como "ejecuta las pruebas sí o sí" o "verifícalo". Verifica por su cuenta aunque no se lo pidas, y si los pones acaba verificando de más
• No trocees el trabajo. Lo que normalmente encargarías por partes se lo puedes dar en un solo bloque

Los subagentes (encargados de explorar y buscar) no necesitan un modelo caro. Puedes asignarles otro con una variable de entorno, como CLAUDE_CODE_SUBAGENT_MODEL=haiku. Te lo muestro con un ejemplo en el paso 4.

📌 Paso 3 - Ajustar la profundidad de razonamiento con /effort

/effort
/effort medium
/effort auto

Veámoslos uno por uno 💡

• /effort : sin argumentos aparece un control deslizante. Dentro del selector de /model también puedes mover el mismo control con las flechas
• /effort medium : indica el nivel directamente. Puedes escribirlo incluso en mitad de una tarea y se aplica desde la siguiente petición
• /effort auto : borra el nivel guardado para el modelo actual (vuelve al valor por defecto del modelo)

Los niveles se eligen así.

El rango admitido cambia según el modelo. Fable 5.1, Fable 5, Opus 5, Sonnet 5, Opus 4.8 y 4.7 admiten todo de low a max; Opus 4.6 y Sonnet 4.6 no tienen xhigh; y Haiku 4.5 no admite effort en absoluto. Si indicas un nivel no admitido, baja automáticamente al nivel más alto disponible por debajo (p. ej., xhigh → high en Opus 4.6). Además, incluso high está calibrado de forma distinta en cada modelo, así que al cambiar de modelo, el mismo nombre de nivel no significa la misma intensidad.

También conviene saber cómo se guarda.

• Enter en el control deslizante o escribir directamente /effort 레벨 (con el nombre del nivel) → se guarda como predeterminado y se mantiene en la siguiente sesión
• s en el control deslizante → solo esta sesión (v2.1.257+)
• Se guarda por modelo. Aunque guardes medium en Opus 5, si cambias a Sonnet 5 se usa el valor guardado de Sonnet 5 (si no hay, el high por defecto). Se registra en la clave modelSettings del archivo de configuración
• max es solo para la sesión actual, a menos que lo pongas por variable de entorno

Si quieres que piense a fondo solo durante un turno, no hace falta tocar la configuración de la sesión: basta con poner ultrathink en cualquier parte del prompt. Claude Code reconoce esta palabra clave y añade una instrucción para razonar más a fondo solo en ese turno (el valor de effort que va a la API no cambia). En cambio, frases como "think hard" o "think more" se tratan como texto normal, tenlo en cuenta 😉

¿Y cuánta diferencia hay? En la figura de ejemplo del blog oficial, el mismo prompt con high usó unas 7 veces más tokens que con low y llegó a una respuesta más segura (son cifras ilustrativas). Pero el effort es "hasta dónde está dispuesto a llegar", no "siempre gasta eso", así que con una tarea sencilla termina rápido por su cuenta aunque esté en high. Por eso la guía oficial recomienda dejar la mayoría de las tareas en el valor por defecto (high) y ajustar una sola vez según tu estilo de trabajo (minuciosidad vs velocidad), no tarea por tarea.

El nivel aplicado se muestra en la cabecera de la sesión, por ejemplo "with low effort", y aparece un momento abajo al arrancar y al cambiarlo. Si tienes dudas, mira primero la cabecera.

📌 Paso 4 - Fijarlo en settings.json

Si te da pereza escribirlo cada vez, déjalo fijado en el archivo de configuración. Hay tres archivos de configuración.

~/.claude/settings.json              ← 사용자 설정 (내 PC 전체)
                                       윈도우는 C:\Users\<계정>\.claude\settings.json
<프로젝트>/.claude/settings.json        ← 프로젝트 공유 설정 (git에 커밋해서 팀 전체 적용)
<프로젝트>/.claude/settings.local.json  ← 프로젝트 로컬 설정 (나만, .gitignore 권장)

El orden de prioridad es configuración administrada (managed) > línea de comandos (--settings) > local del proyecto > compartida del proyecto > configuración de usuario. Los valores que guardas con /model y /effort van a la configuración de usuario, así que si la configuración del proyecto tiene fijado un model, la del proyecto vuelve a ganar la próxima vez que lo ejecutes. Esta es la causa típica de "lo cambié, ¿por qué vuelve atrás?".

Aquí tienes un ejemplo de configuración de usuario. Puedes copiarlo y pegarlo 👇

{
  "model": "opus",
  "effortLevel": "high",
  "modelSettings": {
    "claude-opus-5": { "effortLevel": "medium" }
  },
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

Veámoslo punto por punto 💡

• model : el modelo por defecto. Admite alias (opus, sonnet, fable, opusplan) o el ID completo (claude-opus-5). Si guardas con Enter en /model, cambia este valor
• effortLevel : el effort por defecto para los modelos que no tienen un nivel guardado aparte. Solo admite low, medium, high y xhigh — max y ultracode no se pueden poner en el archivo de configuración (ultracode usa su propia clave ultracode)
• modelSettings : niveles guardados por modelo. Si guardas con /effort, se registra aquí con el ID completo. El ejemplo de arriba significa "solo Opus 5 en medium, el resto con su propio valor por defecto". Dentro del mismo archivo, este valor tiene prioridad sobre effortLevel. Si solo quieres poner un tope a un modelo, añade maxEffortLevel a esa entrada
• fallbackModel : lista de modelos que se intentan en su lugar cuando el modelo principal está sobrecargado o caído (hasta 3). Solo sustituye ese turno; el siguiente mensaje vuelve a intentarlo primero con el modelo principal. No aplica a errores de autenticación, facturación o límites

Si quieres imponerlo a un proyecto, ponlo en <프로젝트>/.claude/settings.json (la carpeta de tu proyecto). Por ejemplo, si "este repo es una colección de scripts ligeros, así que solo Sonnet":

{
  "model": "sonnet"
}

También funciona con variables de entorno. Se aplican solo a esa sesión de terminal, así que son cómodas para usos de "solo por hoy".

# Windows PowerShell — válido solo en esta ventana de terminal
$env:ANTHROPIC_MODEL = "sonnet"
$env:CLAUDE_CODE_EFFORT_LEVEL = "medium"
$env:CLAUDE_CODE_SUBAGENT_MODEL = "haiku"
claude

# macOS / Linux
export ANTHROPIC_MODEL=sonnet
export CLAUDE_CODE_EFFORT_LEVEL=medium
export CLAUDE_CODE_SUBAGENT_MODEL=haiku
claude

• ANTHROPIC_MODEL : el modelo de esta sesión. Tiene prioridad sobre el valor guardado con /model
• CLAUDE_CODE_EFFORT_LEVEL : el effort. Está en el mismo grupo de máxima prioridad que --effort y /effort, así que gana a todos los archivos de configuración y valores por defecto del modelo. También tiene más fuerza que el effort del frontmatter de skills y subagentes. Admite un nombre de nivel o auto; ultracode no se puede poner
• CLAUDE_CODE_SUBAGENT_MODEL : modelo por defecto de subagentes y equipos de agentes. Si bajas las tareas de exploración a haiku, ahorras mucho límite
• ANTHROPIC_DEFAULT_MODEL : el "modelo inicial para sesiones nuevas" que solo se usa si no se indicó modelo en ningún sitio (v2.1.236+)
• ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL : fijan (pin) la versión exacta a la que apuntan los alias opus y sonnet. Para cuando no quieres que el alias pase a una versión nueva

💡 Combinaciones recomendadas por plan

Estas son mis recetas. No son la respuesta correcta; úsalas como punto de partida.

• Pro : deja el Sonnet 5 · high por defecto tal cual. Solo para los problemas en los que te atasques, activa Opus 5 para esa sesión con s en el selector de /model. Si el diseño pesa mucho, opusplan. El contexto de 1M de Opus necesita créditos de uso, así que usa opus[1m] con cuidado
• Max : por defecto Opus 5 · high. En tramos de erratas y repeticiones simples, baja a Sonnet 5 con s en el selector de /model (solo esa sesión) para ahorrar límite. Para trabajos grandes de un día entero, /model fable — si aparece el aviso para aceptar el cobro con créditos, revisa el contenido y continúa
• Pago por uso en la API : como ves el coste directamente, opus como principal, CLAUDE_CODE_SUBAGENT_MODEL=haiku para los subagentes y fallbackModel para prevenir sobrecargas
• Para todos : empieza sin tocar el effort → si se repite lo de "se saltó archivos" o "no ejecutó las pruebas", súbelo un nivel ↑. Al revés, si el proyecto solo tiene tareas sencillas, pon "effortLevel": "medium" en la configuración de ese proyecto

📌 Errores y fallos frecuentes

1. Lo cambié con /model, pero en una sesión nueva aparece otro modelo

• Causa : ① Pulsaste s en el selector o lo arrancaste con --model (solo esa sesión) ② El model de la configuración del proyecto o administrada, el ANTHROPIC_MODEL de la shell o el modelo por defecto de la organización tienen más prioridad ③ El settings.json de usuario es de solo lectura y no se pudo guardar ④ claude --resume/--continue restaura el modelo que usaba esa sesión
• Solución : mira en la cabecera de inicio "qué archivo de configuración lo decidió" → corrige la clave model de ese archivo, o vuelve a guardarlo con Enter en /model

2. Model "xxx" is not a recognized model id.

• Causa : una cadena que no es un alias ni un ID completo que empiece por claude- (casi siempre una errata)
• Solución : vuelve a escribir un alias como opus, sonnet o fable, o un ID completo como claude-opus-5. La sesión mantiene el modelo anterior, así que basta con volver a escribirlo

3. Al elegir Fable 5.1 sale "Claude Code does not support this model"

• Causa : tu Claude Code es anterior a v2.1.257
• Solución : claude update y reinicia

4. Puse /effort xhigh, pero la cabecera dice "with high effort"

• Causa : el modelo actual no admite xhigh (Opus 4.6, Sonnet 4.6), o hay un maxEffortLevel o un tope de effort de la organización
• Solución : comprueba el modelo con /status → cambia a Opus 5/Sonnet 5, y revisa maxEffortLevel en el archivo de configuración

5. Subo el effort con /effort y no se aplica (y al elegir ultracode incluso sale el aviso de que "la variable de entorno tiene prioridad")

• Causa : si CLAUDE_CODE_EFFORT_LEVEL está fijada a un nivel distinto de xhigh, las peticiones salen con ese nivel y ultracode funciona con su coordinación de flujos de trabajo desactivada. Si en ese momento eliges ultracode, aparece el aviso de que "la variable de entorno sobrescribe el effort de la sesión". También puede ser que te topes con maxEffortLevel o con un tope de effort de la organización
• Solución : borra la variable de entorno ($env:CLAUDE_CODE_EFFORT_LEVEL = $null / unset CLAUDE_CODE_EFFORT_LEVEL) y reinicia

6. En la fila de Fable aparece "Requires usage credits" y me pide aceptar el pago

• Causa : en tu plan o puesto, el uso de Fable no se descuenta del límite de la suscripción, sino que se cobra con créditos de uso
• Solución : si no lo quieres, cierra el aviso y se mantiene el modelo actual. Si decides usarlo, aceptas una sola vez y ya no vuelve a preguntar. En el plan Enterprise con facturación de la organización, este aviso ni siquiera aparece

7. En bases de código de seguridad o biología, el modelo cambia de repente

• Causa : Fable y Opus 5 tienen clasificadores de seguridad que vuelven a ejecutar en otro modelo las peticiones clasificadas principalmente como ciberseguridad o biología, y la sesión se queda en ese modelo. A dónde va depende de la categoría — Fable 5.1 y 5: biología → Opus 5, ciberseguridad → Opus 4.8 / Opus 5: ciberseguridad → Opus 4.8; para biología no hay modelo de respaldo, así que termina en un rechazo. Puede saltar desde la primera petición (porque también se envían CLAUDE.md y el estado de git). El respaldo por categoría es desde v2.1.219+
• Solución : vuelve al modelo original con /model. Para ver si la causa es tu personalización, arranca una vez con claude --safe-mode (inicia con CLAUDE.md, skills, MCP y hooks desactivados). Si quieres que te pregunte cada vez, desactiva Switch models when a message is flagged en /config (en el archivo de configuración, switchModelsOnFlag: false)

🙌 Para terminar

Resumiendo lo de hoy:

• Modelo = qué tan capaz es (qué cerebro), effort = cuánto se esfuerza (archivos, verificaciones, número de pasos). Si falla por no saber, modelo ↑; si falla por esforzarse poco, effort ↑
• La gama de septiembre de 2026 es Fable 5.1 ($10/$50) · Opus 5 ($5/$25) · Sonnet 5 ($2/$10) · Haiku 4.5 ($1/$5). Max usa Opus 5 por defecto, Pro usa Sonnet 5 por defecto y Fable siempre se elige a mano
• En /model, Enter (guardar) vs s (solo la sesión), y /effort sigue la misma regla. Los valores guardados van a model y modelSettings del settings.json de usuario
• La configuración del proyecto y las variables de entorno tienen más fuerza que la de usuario. Si "lo cambias y vuelve atrás", mira primero la cabecera de inicio
• En la mayoría de los casos, mantén el valor por defecto (high) y ajústalo una sola vez según tu estilo de trabajo, no tarea por tarea

El próximo post será la serie Crear un bot de Discord #31, y para el lanzamiento oficial de Python 3.15 el 1 de octubre también estoy preparando un resumen completo de las novedades de la versión final. ¡No te lo pierdas! 🙌

¿Y tú, qué combinación de modelo y effort usas? ¡Cuéntamelo en los comentarios y lo tendré en cuenta para el próximo post!

📚 Posts relacionados

• ¡Sale Claude Opus 5! Cambia el modelo por defecto de Claude Code - Guía completa de /model y /effort
• Introducción a Claude Code - ¡De la instalación a la primera ejecución! Guía completa del agente de programación con IA para la terminal
• Cómo escribir buenos prompts para programar con IA - Guía práctica de vibe coding
• Portátiles recomendados para desarrolladores, segundo semestre de 2026 - En la era de la IA y el vibe coding, los criterios han cambiado
• Sale Claude Sonnet 5 - Cambia el modelo por defecto de Claude Code: qué cambia y cómo aprovecharlo