Modelos, contexto y costes

Antes de instalar nada, conviene entender qué modelo usa Claude Code, cómo gestiona el contexto y cómo se factura. Esta es la pieza que separa al usuario que paga de más por mediocridad del que rinde con plan ajustado a su caso.

Objetivos

• Conocer la familia de modelos Claude 4.x y su rol específico.
• Entender la ventana de contexto y por qué importa.
• Calcular el coste real de un día / mes de uso.
• Saber cuándo cambiar de modelo y cuándo no merece la pena.
• Diseñar una estrategia coste/calidad para tu equipo.

2.1 Familia Claude 4.x

Anthropic mantiene tres tiers vivos en 2026, optimizados para tareas distintas:

Cuándo subir a Opus

Opus brilla cuando el problema requiere razonar bien antes de actuar: diseñar una migración mayor, decidir entre tres arquitecturas, depurar un bug de concurrencia, hacer code review profundo. Cuesta 5× más que Sonnet, pero vale la pena en tareas donde un error mecánico desplaza la solución correcta.

Cuándo bajar a Haiku

Haiku es óptimo para tareas con respuesta determinista o mecánica: rebautizar variables, traducir un schema, formatear un dataset, validar 5000 NIFs. Va 3× más rápido que Sonnet y cuesta 1/3.

2.2 La ventana de contexto

El contexto es lo que el modelo "tiene en mente" en una llamada. Cada cosa que el agente lee — un fichero, un commit message, un resultado de tests — se convierte en tokens dentro del contexto. Cuando el contexto se llena, el modelo empieza a olvidar lo viejo.

Tamaños de ventana

• 200K tokens (estándar en todos los planes y modelos): unas 500 páginas de prosa o 50.000 líneas de código.
• 1M tokens (Opus 4.7 en Team/Enterprise): el equivalente a un libro de 2.500 páginas — un repositorio mediano completo.

Por qué se "atasca" Claude Code

Cuando llevas 4 horas con la misma sesión y notas que las respuestas se vuelven menos certeras, lo que está pasando es que el contexto está saturado de información antigua. El modelo dispersa atención. Soluciones por orden de impacto:

1. /clear — borra el contexto. La práctica disciplinada: una sesión por tarea.
2. /compact — resume contexto antiguo conservando lo esencial.
3. Subagentes — delegan trabajo con contexto propio, no contaminan el principal.

Tokens vs caracteres

Aproximación útil: 1 token ≈ 0.75 palabras en español o 4 caracteres. Un fichero TypeScript medio (200 líneas) son ~1500 tokens. El system prompt por defecto de Claude Code son ~5000 tokens. Una sesión de 2h con uso intensivo gasta entre 100K y 500K tokens.

2.3 Modelo de costes

Tres formas de pagar Claude Code:

A · Tarifa plana (Pro / Team)

Tienen fair-use cap. Si tu uso es muy alto puede haber throttling después de un volumen diario.

B · Enterprise

Custom según volumen. Incluye SSO, DLP, contrato RGPD directo (DPA), garantía contractual de no-entrenamiento, audit, soporte SLA. Imprescindible para sectores regulados.

C · API por uso

Tarifas oficiales (octubre 2026):

El descuento de cache hit (−90%) es el ahorro más infrautilizado. Lo cubrimos en detalle en el Módulo 12 (Agent SDK).

2.4 Cuánto cuesta un día real

Tres ejemplos calculados en API con Sonnet 4.6 y caching activo:

Perfil ligero — 2h sesión / día

• ~80K tokens input + 20K tokens output
• Coste sin caching: $0,54
• Coste con caching (70% hit): $0,12 / día · ~$2,40 / mes

Perfil intensivo — 6h sesión / día

• ~500K tokens input + 100K tokens output
• Coste sin caching: $3,00
• Coste con caching (75% hit): $0,90 / día · ~$18 / mes

Perfil "pair-programming continuo" — 8h / día con Opus para decisiones

• ~1M tokens input + 200K tokens output (mezcla Opus + Sonnet)
• Coste sin caching: $20
• Coste con caching (75% hit): $5 / día · ~$100 / mes

2.5 Cambiar de modelo en caliente

Dentro de Claude Code, cambias de modelo sin salir de la sesión:

> /model opus
> /model sonnet
> /model haiku

El cambio aplica a partir del siguiente turno. Casos típicos:

• Vas con Sonnet, surge una decisión arquitectural compleja → /model opus para el debate, vuelves a Sonnet.
• Estás haciendo un refactor mecánico de 200 archivos → /model haiku mientras dura, después restaura.
• Tu plan pasa por defecto a Opus, pero quieres ahorrar → fija "model": "claude-sonnet-4-6" en settings.json.

Política recomendada para empresa

Documenta en CLAUDE.md cuándo usar qué modelo. Ejemplo:

## Política de modelos

- Por defecto: Sonnet 4.6.
- Opus 4.7: solo para arquitectura, code review profundo, debugging
  de bugs en producción que llevan más de 1h sin resolverse.
- Haiku 4.5: en sub-agentes que delegamos para tareas mecánicas.

Si dudas, usa Sonnet. Si Sonnet falla repetidamente la tarea,
sube a Opus antes de pasar 30 minutos peleando.

2.6 Estrategia coste/calidad para equipos

Tres patrones que escalan bien:

Patrón 1 · "Sonnet por defecto, Opus a demanda"

Default Sonnet en settings.json versionado. Cada miembro del equipo sabe que puede subir a Opus para casos concretos. Funciona en equipos donde la disciplina existe.

Patrón 2 · "Opus para senior, Sonnet para junior"

Senior abren sesión con Opus. Junior con Sonnet. Idea: el senior toma decisiones estratégicas; el junior ejecuta tareas dirigidas. Funciona en empresas con jerarquía técnica clara.

Patrón 3 · "Sonnet principal + Haiku en background"

Sesión principal en Sonnet. Hooks y subagentes lanzan tareas mecánicas con Haiku (testing automático, lint fix, format). Coste mínimo y throughput máximo. Es lo que más se acerca al uso "industrial" de un agente.

Práctica · 1.5 horas de trabajo guiado

Test de comprensión

Resumen del módulo

• Tres modelos vivos: Opus (razonamiento), Sonnet (default), Haiku (mecánico).
• Ventana 200K (estándar) o 1M (Opus en Team/Ent). Si saturas, /clear o /compact.
• Costes: tarifa plana o pago por uso. Caching reduce hasta el 90% en hits.
• Estrategia "Sonnet default + Opus a demanda + Haiku en sub-agentes" es la más eficiente.
• Documenta tu política de modelos en CLAUDE.md.

Siguiente módulo: instalamos Claude Code y configuramos un entorno profesional.