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

El modelo predeterminado de Claude Code es Sonnet — específicamente la versión más reciente de Sonnet para su 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 durante sesiones largas. Si no ha cambiado nada, eso es lo que está ejecutando.

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é equivalen 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.

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

Cuando inicia Claude Code sin especificar un modelo, comienza con el alias sonnet, que se resuelve a la versión más reciente de Sonnet para su 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 también usan Sonnet 5 de forma predeterminada.

La lógica es sencilla: 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 su organización ha establecido un modelo predeterminado a nivel organizativo en la consola de administración de Claude Code, esto anula el valor predeterminado del sistema y entra en vigor la próxima vez que inicie una sesión. Aún puede anularlo por sesión con /model o la bandera --model.

Modelos disponibles y alias

Claude Code utiliza alias en lugar de IDs de modelo completos para la selección diaria de modelos. Un alias como sonnet siempre apunta a la versión recomendada para su proveedor, por lo que no necesita actualizar su 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 de larga duración, tareas ambiguas o abiertas
best	Fable 5 si está disponible, de lo contrario el último Opus	La capacidad más alta disponible sin especificar manualmente
opusplan	Opus para planificar, Sonnet para ejecutar	Obtener el razonamiento de Opus en arquitectura sin pagar tarifas de Opus por 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; vuelve al valor predeterminado de la cuenta	Restablecer el valor 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 — use el ID de modelo completo en su lugar:

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 tokens	$10/MTok	$50/MTok
Claude Opus 4.8	claude-opus-4-8	1M tokens	$5/MTok	$25/MTok
Claude Sonnet 5	claude-sonnet-5	1M 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 de $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 el factor decisivo cuando está 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

Escriba /model sin argumentos para abrir el selector interactivo. Escriba /model <alias> para cambiar de inmediato:

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

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

2. Al iniciar: bandera --model

Pase --model cuando inicie Claude Code para aplicar la selección solo para esa sesión:

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 valor predeterminado guardado ni persiste en el próximo inicio.

3. Variable de entorno: ANTHROPIC_MODEL

Establezca 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 su archivo de configuración.

4. Archivo de configuración (predeterminado permanente)

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

{
  "model": "opus"
}

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

Variables de entorno por alias

Si desea que el alias opus se resuelva a una versión específica en cualquier entorno, establezca ANTHROPIC_DEFAULT_OPUS_MODEL. El mismo patrón aplica para otras familias:

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-8"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5-20251001"
export ANTHROPIC_DEFAULT_FABLE_MODEL="claude-fable-5"

Esto es útil en configuraciones de CI/CD o de equipo donde desea una resolución de modelo reproducible sin fijar IDs de modelo completos en todas partes.

Cómo elegir el modelo adecuado para codificar

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

Quédese con Sonnet (predeterminado) para:

• Tareas diarias de codificación: implementar funciones, escribir pruebas, refactorizar
• Sesiones iterativas donde revisa diferencias y hace 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 de refactorización significativo, vale la pena actualizar a Opus.

Cambie a Opus para:

• Depuración de causa raíz donde el problema no es obvio
• Decisiones de arquitectura: elegir entre patrones de diseño, evaluar estrategias de refactorización, identificar dónde la deuda técnica le afectará
• Análisis de bases de código grandes donde necesita que Opus mantenga 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 un razonamiento más profundo vale la pena) y vuelve a Sonnet para la implementación (donde el rendimiento importa más).

Use Haiku para:

• Formateo de código, limpieza de comentarios, cambios simples de nombres de variables
• Tareas donde desea respuestas rápidas para cambios mínimos
• Casos de uso scripteados de alto volumen donde el costo por 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 múltiples pasos o bases de código complejas.

Use Fable 5 para:

• Depuración de interrupciones e investigación de incidentes
• Ejecuciones agénticas largas y abiertas donde desea que el modelo investigue antes de actuar
• Problemas ambiguos donde normalmente dividiría 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 vale la pena es en trabajos sostenidos genuinamente complejos: verifica sus propias salidas más a fondo, maneja secuencias de llamadas a herramientas sin perder el hilo y toma menos decisiones que requieren corrección mediante indicaciones. Para el trabajo de funciones típico, es excesivo.

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

Los alias se resuelven de manera diferente según el proveedor de API que esté utilizando. Si está 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 se resuelve a	El alias sonnet se resuelve a
API de Anthropic (predeterminada)	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 nuevos en Bedrock, Vertex o Foundry, use el ID de modelo completo explícitamente o establezca las variables de entorno ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL con el ARN de modelo específico del proveedor o el nombre de implementación para la versión que desee.

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úntelo al endpoint compatible con Anthropic de Novita AI para usar modelos de peso abierto — incluyendo variantes de DeepSeek, Qwen, GLM, Kimi y MiniMax — mientras mantiene intacto el flujo de trabajo agéntico de Claude Code.

Esto es útil cuando:

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

Configuración

1. Regístrese en novita.ai para obtener créditos de prueba gratuitos.
2. Vaya a Key Management, cree una nueva clave y cópiela.
3. Establezca estas variables de entorno antes de iniciar Claude Code:

macOS / Linux:

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

Windows (Command Prompt):

set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<su clave 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 = "<su clave API de Novita>"
$env:ANTHROPIC_MODEL = "minimax/minimax-m2.7"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "minimax/minimax-m2.7"

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

Nota sobre ANTHROPIC_BASE_URL y la selección de modelos

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 establezca 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 u 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 en Novita	Fortaleza
MiniMax M2.7	minimax/minimax-m2.7	Llamada a herramientas agéntica, 97% de precisión en herramientas
DeepSeek V4 Flash	deepseek/deepseek-v4-flash	Rápido y rentable 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

Consulte novita.ai/llm-api para obtener la lista actual de modelos y los IDs 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 su proveedor de API. En la API de Anthropic, este es Claude Sonnet 5 a mediados de 2026. Si su organización ha establecido un valor 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, agregue "model": "opus" (o su alias preferido) a su archivo de configuración en ~/.claude/settings.json. Use --model al iniciar para una anulación de sesión única.

¿Qué hace el alias opusplan?

Utiliza Opus durante la fase de planificación de Claude Code y cambia a Sonnet para la ejecución. Esto le brinda 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 valor predeterminado si se encuentra queriendo regularmente 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í. Pase 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, agregue el ID completo a su archivo de configuración o establezca ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 en su 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 diferentes modelos para diferentes proyectos?

Sí. Agregue un campo model a un archivo de configuración a nivel de proyecto (.claude/settings.json en la raíz de su proyecto). Esto anula su valor predeterminado a nivel de usuario para las sesiones iniciadas en ese directorio. También puede 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 iniciar indicando el modelo solicitado y el que se sustituyó. La sesión comienza con el valor predeterminado del sistema. Para evitar sustituciones inesperadas, cambie al alias recomendado actual o actualice su configuración a un ID de modelo no obsoleto.

Artículos recomendados

• Use MiniMax M2.7 en Claude Code a través de Novita AI
• Documentación de la CLI de Claude Code: Configuración, comandos de barra e integración con API de LLM
• Use Qwen3-Coder-480B-A35B-Instruct en Claude Code: Una guía práctica

---

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