Guía de modelos
de Claude Code

SINOPSIS

claude --model <alias|nombre>
/model fable | opus | sonnet | haiku | opusplan
/effort low | medium | high | xhigh | max
/fast on

MODELOS

fable (claude-fable-5)

El más capaz. Pensado para tareas que superan una sola sesión: investigación de causa raíz, debugging de outages, decisiones de arquitectura. Investiga antes de actuar y verifica su propio trabajo, así que sobran los recordatorios de "prueba esto". Descríbele el resultado, no los pasos, y si quieres que no pare hasta cumplirlo, usa /goal. No es el modelo por defecto: actívalo con /model fable.

opus (claude-opus-4-8)

Razonamiento profundo. Para refactorizaciones multi-archivo, bugs sutiles y cualquier cosa donde acertar a la primera importa más que el coste. Con xhigh de effort rinde mejor en coding exigente. Si solo necesitas un empujón puntual de razonamiento, escribe ultrathink en el prompt y no toques el effort de la sesión.

sonnet (claude-sonnet-4-6)

El caballo de batalla. Resuelve en torno al 80% del trabajo diario (funciones nuevas, tests, revisión de código) a un quinto del coste de Opus. Empezar cada sesión aquí y escalar solo cuando hace falta recorta el gasto un 40% aproximadamente. Ese hábito vale más que cualquier otro truco de esta guía.

haiku (claude-haiku-4-5)

Rápido y barato. Consultas simples, boilerplate, "¿qué significa este error?". Es también el modelo del subagente Explore: búsquedas de solo lectura que no ensucian tu contexto principal.

ALIAS

No hace falta recordar versiones. /model acepta alias: best (Fable si tu cuenta lo tiene, si no el último Opus), sonnet[1m] y opus[1m] para la ventana de un millón de tokens, y el más interesante de todos:

opusplan

Híbrido automático: Opus razona en plan mode y Sonnet ejecuta la implementación. Lo mejor de cada casa cuando entender el alcance es crítico pero el código es rutina. Ojo: cada cambio de fase reinicia la caché, y la parte de Opus va con ventana de 200k.

EFFORT

El effort cambia inteligencia por latencia y coste dentro del mismo modelo. Ajustarlo suele ser mejor palanca que cambiar de modelo.

Cambiar el effort invalida la caché de prompts, así que Claude Code pide confirmación. Y si quieres velocidad bruta en Opus, /fast on da hasta 2,5 veces más velocidad de salida con precio premium: actívalo al principio de la sesión, no a mitad.

AHORRO DE TOKENS

Claude Code cachea automáticamente el CLAUDE.md, el system prompt y el inicio de la conversación: 90% de descuento en la entrada reutilizada, que en un día normal se traduce en un 40-50% de ahorro real. Tu trabajo es no romper esa caché:

• No cambies de modelo, effort ni fast mode a mitad de sesión sin motivo.
• Edita el CLAUDE.md entre sesiones, nunca durante.
• Mantén el CLAUDE.md por debajo de 50 líneas: índice, no enciclopedia.

La regla de los 5 minutos: /compact resume la conversación con descuento solo si la caché sigue caliente (menos de 5 minutos desde tu último mensaje). Si vuelves de un descanso, /clear sale más barato. Y al cambiar de tarea, siempre /clear: una conversación de 200k tokens re-envía todo ese contexto con cada prompt.

El truco menos conocido: los subagentes. Uno puede leerse 15 archivos en su propia ventana y devolverte un resumen de 500 tokens; hacerlo en la sesión principal te cuesta 150.000 permanentes. CLAUDE_CODE_SUBAGENT_MODEL=haiku fuerza el modelo barato en todos ellos. Para vigilar el gasto: /cost, /usage y /context.

CONFIGURACIÓN

De mayor a menor prioridad:

1. /model en sesión (Enter guarda como default, s solo para la sesión)
2. claude --model <alias> al arrancar
3. Variables de entorno: ANTHROPIC_MODEL, CLAUDE_CODE_SUBAGENT_MODEL
4. Campo model en settings.json

Si el modelo principal se satura, hay cadenas de respaldo: claude --fallback-model "fable,sonnet,haiku" acepta hasta tres.

EJEMPLOS

VÉASE TAMBIÉN

Destilado de la documentación oficial de Anthropic (model config, pricing, effort, prompt caching y costs) a través de mi cuaderno de NotebookLM. Si algo baila, la fuente manda: code.claude.com/docs.