Modelo predeterminado de Claude Code: Cómo cambiar, alternar y elegir el adecuado

El modelo predeterminado de Claude Code es Sonnet — específicamente la versión más reciente de Sonnet para tu proveedor (Sonnet 5 en la API de Anthropic a mediados de 2026). Sonnet es rápido, maneja bien la mayoría de las cargas de trabajo de codificación y mantiene los costos razonables en sesiones largas. Si no has cambiado nada, eso es lo que estás usando.

Cambiar el modelo requiere un solo comando: /model opus dentro de una sesión, o claude --model opus al iniciar. El resto de esta guía cubre cuándo vale la pena cambiar a cada modelo, a qué resuelven los alias abreviados en diferentes proveedores y cómo usar el endpoint de Novita AI para acceder a un conjunto más amplio de modelos de peso abierto a un costo menor por token.

Cómo cambiar el modelo rápidamente

Si tu objetivo es simplemente cambiar el modelo de Claude Code, usa uno de estos:

• Ejecuta /model dentro de Claude Code y elige sonnet, opus, haiku u otro alias disponible.
• Inicia una sesión única con claude --model opus.
• Establece "model": "opus" en ~/.claude/settings.json si quieres que el nuevo modelo persista.

Para la mayoría de los usuarios, /model sonnet, /model opus y claude --model opus son los únicos comandos que necesitan. ANTHROPIC_MODEL sigue siendo útil para scripts y CI, pero las variables de entorno de alias específicas del proveedor no son necesarias para el cambio de modelo habitual.

¿Cuál es el modelo predeterminado en Claude Code?

Cuando inicias Claude Code sin especificar un modelo, comienza con el alias sonnet, que resuelve a la versión más reciente de Sonnet para tu proveedor. En la API de Anthropic (el endpoint predeterminado), eso significa Claude Sonnet 5 a mediados de 2026. Los usuarios de los planes Gratuito y Pro usan Sonnet 5 por defecto.

La lógica es directa: Sonnet ofrece el mejor equilibrio entre velocidad y capacidad para el trabajo de codificación diario. Maneja ediciones de archivos, refactorizaciones de varios pasos, generación de pruebas y la mayoría de las tareas a escala de repositorio sin la latencia adicional o el costo que conlleva Opus. Para la mayoría de las sesiones, cambiar a un modelo más pesado no produce resultados significativamente mejores.

Si tu organización ha establecido un modelo predeterminado a nivel organizativo en la consola de administración de Claude Code, ese anula el predeterminado del sistema y surte efecto la próxima vez que inicies una sesión. Aún puedes anularlo por sesión con /model o la bandera --model. Para las reglas de proyecto que afectan cómo se comportan los valores predeterminados, consulta reglas de proyecto en CLAUDE.md.

Modelos disponibles y alias

Claude Code usa alias en lugar de ID de modelo completos para la selección diaria de modelos. Un alias como sonnet siempre apunta a la versión recomendada para tu proveedor, por lo que no tienes que actualizar tu configuración cada vez que se lanza un nuevo modelo.

Alias	Qué selecciona	Mejor para
sonnet	Último Sonnet (Sonnet 5 en API de Anthropic)	Predeterminado — rápido, capaz y eficiente para la mayoría del trabajo de codificación
opus	Último Opus (Opus 4.8 en API de Anthropic)	Razonamiento arquitectónico complejo, análisis de bases de código grandes
haiku	Último Haiku (Haiku 4.5)	Tareas simples y rápidas donde la velocidad importa más que la profundidad
fable	Claude Fable 5	Sesiones autónomas largas, tareas ambiguas o abiertas
best	Fable 5 si está disponible, si no, el último Opus	La capacidad más alta disponible sin especificar manualmente
opusplan	Opus para planificar, Sonnet para ejecutar	Obtener el razonamiento de Opus sobre la arquitectura sin pagar tarifas de Opus en cada paso
sonnet[1m]	Sonnet con ventana de contexto de 1M de tokens	Sesiones muy largas o bases de código grandes que necesitan contexto extendido
opus[1m]	Opus con ventana de contexto de 1M de tokens	Tareas complejas de contexto largo que necesitan razonamiento de Opus
default	Limpia cualquier anulación; regresa al predeterminado de la cuenta	Restablecer al predeterminado del sistema después de probar otros modelos

Los alias se actualizan con el tiempo. Para fijar una versión específica — por reproducibilidad o para evitar comportamientos inesperados después de una actualización del modelo — usa el ID de modelo completo:

claude --model claude-sonnet-5
claude --model claude-opus-4-8

Modelos Claude actuales (API de Anthropic)

Modelo	ID de API	Contexto	Costo de entrada	Costo de salida
Claude Fable 5	claude-fable-5	1M de tokens	$10/MTok	$50/MTok
Claude Opus 4.8	claude-opus-4-8	1M de tokens	$5/MTok	$25/MTok
Claude Sonnet 5	claude-sonnet-5	1M de tokens	$2/MTok*	$10/MTok*
Claude Haiku 4.5	claude-haiku-4-5-20251001	200k tokens	$1/MTok	$5/MTok

*Precio introductorio de Sonnet 5 hasta el 31 de agosto de 2026; tarifa estándar es $3/$15 por MTok.

Todos los modelos tienen una ventana de contexto de 1 millón de tokens excepto Haiku 4.5, que alcanza un máximo de 200k. Para la mayoría del trabajo de codificación, el tamaño de la ventana de contexto solo se convierte en un factor decisivo cuando estás cargando repositorios completos o ejecutando sesiones agénticas muy largas.

Cómo cambiar el modelo en Claude Code

Hay cuatro formas de configurar el modelo, en orden de prioridad:

1. Durante una sesión: /model

Escribe /model sin argumentos para abrir el selector interactivo. Escribe /model <alias> para cambiar inmediatamente:

/model opus
/model sonnet
/model haiku
/model fable

A partir de Claude Code v2.1.153, `/model` guarda tu elección como predeterminada para sesiones futuras. Si solo quieres cambiar para la sesión actual, presiona `s` en el selector en lugar de `Enter`. Escribir `/model <alias>` directamente guarda la elección (equivalente a `Enter`).

### 2. Al iniciar: bandera `--model`

Pasa `--model` cuando inicies Claude Code para aplicar la selección solo para esa sesión:

```bash
claude --model opus
claude --model haiku
claude --model claude-sonnet-5   # ID de modelo completo, fija una versión específica

Esto no afecta el predeterminado guardado ni persiste hasta el próximo inicio.

3. Variable de entorno: ANTHROPIC_MODEL

Establece ANTHROPIC_MODEL para aplicar un modelo durante la duración de una sesión de shell o script:

export ANTHROPIC_MODEL="opus"

Al igual que --model, esto tiene alcance de sesión y no escribe en tu archivo de configuración.

4. Archivo de configuración (predeterminado permanente)

Para establecer un predeterminado permanente, agrega el campo model a tu archivo de configuración de Claude Code (generalmente ~/.claude/settings.json):

{
  "model": "opus"
}

Esto se aplica cada vez que inicies Claude Code desde esa máquina, a menos que sea anulado por una bandera --model o la variable de entorno ANTHROPIC_MODEL.

Cómo elegir el modelo adecuado para codificar

El nivel de modelo que necesitas depende más del tipo de tarea que de la complejidad únicamente.

Quédate con Sonnet (predeterminado) para:

• Tareas de codificación diarias — implementar funciones, escribir pruebas, refactorizar
• Sesiones iterativas donde revisas diferencias y haces preguntas de seguimiento
• La mayoría de las ediciones de varios archivos donde la base de código cabe en la ventana de contexto
• Casos donde la velocidad importa (Sonnet responde notablemente más rápido que Opus)

La principal limitación de Sonnet es la profundidad de razonamiento en preguntas arquitectónicas genuinamente ambiguas. Tiende a elegir el primer enfoque razonable en lugar de evaluar alternativas. Para decisiones donde equivocarse en la compensación cuesta un tiempo significativo de refactorización, vale la pena actualizar a Opus.

Cambia a Opus para:

• Depuración de causa raíz donde el problema no es obvio
• Decisiones arquitectónicas: elegir entre patrones de diseño, evaluar estrategias de refactorización, identificar dónde la deuda técnica te afectará
• Análisis de bases de código grandes donde necesitas que Opus retenga más contexto en la memoria de trabajo
• Sesiones autónomas de varias horas donde la degradación del contexto acumulado es un factor

Opus 4.8 cuesta 2.5 veces más que Sonnet 5 por token, y es más lento. Para tareas cortas, la diferencia en la calidad del razonamiento a menudo no justifica el costo. El alias opusplan es un término medio práctico: usa Opus durante la fase de planificación (donde el razonamiento más profundo vale la pena) y baja a Sonnet para la implementación (donde el rendimiento importa más).

Usa Haiku para:

• Formateo de código, limpieza de comentarios, cambios de nombre de variables simples
• Tareas donde quieres respuestas rápidas para cambios mínimos
• Casos de uso scripteados de alto volumen donde el costo del token importa más

Haiku 4.5 es el modelo más rápido y el más económico a $1/$5 por MTok, pero no igualará a Sonnet u Opus en razonamiento de varios pasos o bases de código complejas. Para el lado de la política del equipo de esa compensación, lee Modo automático de Claude Code para equipos sensibles al costo.

Usa Fable 5 para:

• Depuración de interrupciones e investigación de incidentes
• Ejecuciones agénticas largas y abiertas donde quieres que el modelo investigue antes de actuar
• Problemas ambiguos donde normalmente dividirías el trabajo en múltiples sesiones

Fable 5 no es el predeterminado porque la mayoría de las sesiones de codificación no lo necesitan. Es más lento y cuesta el doble que Opus. Donde realmente justifica su uso es en trabajos complejos y sostenidos: verifica sus propias salidas más a fondo, maneja secuencias de llamadas a herramientas sin perder el hilo y toma menos decisiones que requieren correcciones en las indicaciones. Para trabajo de funciones típico, es excesivo.

Selección de modelo en Bedrock, Vertex y otros proveedores

Los alias se resuelven de manera diferente según el proveedor de API que estés usando. Si estás enrutando Claude Code a través de Amazon Bedrock, Google Cloud Agent Platform o Microsoft Foundry, la resolución de alias es más antigua por defecto:

Proveedor	El alias opus resuelve a	El alias sonnet resuelve a
API de Anthropic (predeterminado)	Opus 4.8	Sonnet 5
Claude Platform en AWS	Opus 4.7	Sonnet 4.6
Amazon Bedrock	Opus 4.6	Sonnet 4.5
Google Cloud Agent Platform	Opus 4.6	Sonnet 4.5
Microsoft Foundry	Opus 4.6	Sonnet 4.5

Para obtener modelos más recientes en Bedrock, Vertex o Foundry, usa el ID de modelo completo explícitamente o establece las variables de entorno ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL con el ARN del modelo específico del proveedor o el nombre de implementación para la versión que desees.

Cómo acceder a más modelos a través de Novita AI

Claude Code lee ANTHROPIC_BASE_URL para determinar a qué endpoint de API enviar las solicitudes. Apúntalo al endpoint compatible con Anthropic de Novita AI para usar modelos de peso abierto — incluyendo variantes de DeepSeek, Qwen, GLM, Kimi y MiniMax — mientras mantienes intacto el flujo de trabajo agéntico de Claude Code.

Esto es útil cuando:

• Quieres probar un modelo específico de peso abierto (Qwen3-Coder, GLM-4.7, MiniMax M2.7) contra tu base de código real
• El costo por token es una restricción y estás ejecutando sesiones agénticas de alto volumen
• Estás comparando la calidad del modelo en tus propias tareas antes de comprometerte con el gasto de API

Configuración

1. Regístrate en novita.ai para obtener créditos de prueba gratuitos.
2. Ve a Gestión de claves, crea una nueva clave y cópiala.
3. Establece estas variables de entorno antes de iniciar Claude Code:

macOS / Linux:

export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<tu clave de API de Novita>"
export ANTHROPIC_MODEL="minimax/minimax-m2.7"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="minimax/minimax-m2.7"

Windows (Símbolo del sistema):

set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<tu clave de API de Novita>
set ANTHROPIC_MODEL=minimax/minimax-m2.7
set ANTHROPIC_DEFAULT_HAIKU_MODEL=minimax/minimax-m2.7

Windows (PowerShell):

$env:ANTHROPIC_BASE_URL = "https://api.novita.ai/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "<tu clave de API de Novita>"
$env:ANTHROPIC_MODEL = "minimax/minimax-m2.7"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "minimax/minimax-m2.7"

Inicia Claude Code normalmente después de establecer las variables. El selector /model reflejará los modelos alojados en Novita que hayas configurado en lugar de la lista de alias de Anthropic.

Una nota sobre ANTHROPIC_BASE_URL vs selección de modelo

ANTHROPIC_BASE_URL cambia dónde van las solicitudes, no qué modelo de Anthropic las responde. Al apuntar a Novita AI, el nombre del modelo que establezcas en ANTHROPIC_MODEL debe ser un ID de modelo alojado en Novita (como minimax/minimax-m2.7 o deepseek/deepseek-v4-flash), no un alias de Anthropic como sonnet o opus. Los alias de Anthropic solo se resuelven correctamente contra el propio endpoint de Anthropic.

Modelos representativos disponibles en Novita AI

Modelo	ID de modelo de Novita	Fortaleza
MiniMax M2.7	minimax/minimax-m2.7	Llamadas a herramientas agénticas, 97% de precisión en herramientas
DeepSeek V4 Flash	deepseek/deepseek-v4-flash	Rápido y eficiente en costos para tareas iterativas
Qwen3-Coder 480B	qwen/qwen3-coder-480b-a35b-instruct	Generación de código, contexto grande
GLM-4.7	zai-org/glm-4.7	Tareas de codificación y agénticas

Consulta novita.ai/llm-api para obtener la lista actual de modelos y los ID de modelo verificados antes de configurar; la disponibilidad y los nombres de los modelos pueden cambiar.

Preguntas frecuentes

¿Cuál es el modelo predeterminado en Claude Code?

Sonnet — específicamente la versión más reciente de Sonnet para tu proveedor de API. En la API de Anthropic, este es Claude Sonnet 5 a mediados de 2026. Si tu organización ha establecido un predeterminado a nivel organizativo, ese tiene prioridad.

¿Cómo cambio el modelo en Claude Code?

La forma más rápida es /model <alias> durante una sesión activa. Para establecerlo permanentemente, agrega "model": "opus" (o tu alias preferido) a tu archivo de configuración en ~/.claude/settings.json. Usa --model al inicio para anular una sesión única.

¿Qué hace el alias opusplan?

Usa Opus durante la fase de planificación de Claude Code y cambia a Sonnet para la ejecución. Esto te da el razonamiento más profundo de Opus en decisiones arquitectónicas sin pagar tarifas de Opus por cada edición de archivo durante la implementación. Es un buen predeterminado si te encuentras regularmente queriendo Opus para la parte de “descubrir qué hacer” pero no para la parte de “escribir el código”.

¿Puedo fijar una versión específica del modelo?

Sí. Pasa el ID de modelo completo en lugar de un alias: claude --model claude-sonnet-5 o claude --model claude-opus-4-8. Para una fijación permanente, agrega el ID completo a tu archivo de configuración o establece ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 en tu entorno.

¿El modelo afecta las herramientas y capacidades de Claude Code?

No. Todos los modelos tienen acceso al mismo conjunto de herramientas de Claude Code: lectura y edición de archivos, ejecución de bash, búsqueda web, MCP y el resto. El nivel del modelo afecta la calidad del razonamiento, no qué herramientas están disponibles.

¿Puedo usar diferents modelos para diferents proyects?

Sí. Agrega un campo model a un archivo de configuración a nivel de proyecto (.claude/settings.json en la raíz de tu proyecto). Eso anula tu predeterminado a nivel de usuario para las sesiones iniciadas en ese directorio. También puedes usar ANTHROPIC_MODEL en un archivo .env o script específico del proyecto.

¿Qué sucede si el modelo que seleccioné está obsoleto o no está disponible?

Claude Code muestra una advertencia al inicio indicando el modelo solicitado y el que se usó como sustituto. La sesión comienza con el predeterminado del sistema. Para evitar sustituciones inesperadas, cambia al alias recomendado actual o actualiza tu configuración a un ID de modelo no obsoleto.

Artículos recomendados

• Claude Code Router: Usar modelos y proveedores alternativos en Claude Code
• Claude Sonnet vs Opus: ¿Qué modelo tiene sentido en Claude Code?
• Documentación de la CLI de Claude Code: Configuración, comandos de barra diagonal e integración de API LLM

---

Fuentes consultadas el 10 de julio de 2026: Documentación de configuración de modelos de Claude Code, Resumen de modelos de Anthropic, API LLM de Novita AI.