​
Modelos disponibles

Para la configuración model en Claude Code, puedes configurar:

​
Alias de modelos

Los alias de modelos proporcionan una forma conveniente de seleccionar configuraciones de modelo sin recordar números de versión exactos:
Alias de modeloComportamiento
defaultConfiguración de modelo recomendada, dependiendo de tu tipo de cuenta
sonnetUsa el último modelo Sonnet (actualmente Sonnet 4.5) para tareas de codificación diarias
opusUsa el modelo Opus (actualmente Opus 4.1) para tareas especializadas de razonamiento complejo
haikuUsa el modelo Haiku rápido y eficiente para tareas simples
sonnet[1m]Usa Sonnet con una ventana de contexto de 1 millón de tokens para sesiones largas
opusplanModo especial que usa opus durante el modo de planificación, luego cambia a sonnet para la ejecución

​
Configurando tu modelo

Puedes configurar tu modelo de varias maneras, listadas en orden de prioridad:
  1. Durante la sesión - Usa /model <alias|nombre> para cambiar modelos a mitad de sesión
  2. Al inicio - Lanza con claude --model <alias|nombre>
  3. Variable de entorno - Establece ANTHROPIC_MODEL=<alias|nombre>
  4. Configuraciones - Configura permanentemente en tu archivo de configuraciones usando el campo model.
Ejemplo de uso: 
# Iniciar con Opus
claude --model opus

# Cambiar a Sonnet durante la sesión
/model sonnet
Ejemplo de archivo de configuraciones: 
{
    "permissions": {
        ...
    },
    "model": "opus"
}

​
Comportamiento especial del modelo

​
Configuración del modelo default

El comportamiento de default depende de tu tipo de cuenta. Para ciertos usuarios Max, Claude Code automáticamente recurrirá a Sonnet si alcanzas un umbral de uso con Opus.

​
Configuración del modelo opusplan

El alias de modelo opusplan proporciona un enfoque híbrido automatizado:
  • En modo de planificación - Usa opus para razonamiento complejo y decisiones de arquitectura
  • En modo de ejecución - Cambia automáticamente a sonnet para generación de código e implementación
Esto te da lo mejor de ambos mundos: el razonamiento superior de Opus para la planificación, y la eficiencia de Sonnet para la ejecución.

​
Contexto extendido con [1m]

Para usuarios de Console/API, el sufijo [1m] puede agregarse a nombres de modelo completos para habilitar una ventana de contexto de 1 millón de tokens. 
# Ejemplo de usar un nombre de modelo completo con el sufijo [1m]
/model anthropic.claude-sonnet-4-5-20250929-v1:0[1m]
Nota: Los modelos de contexto extendido tienen precios diferentes.

​
Verificando tu modelo actual

Puedes ver qué modelo estás usando actualmente de varias maneras:
  1. En la línea de estado (si está configurada)
  2. En /status, que también muestra tu información de cuenta.

​
Variables de entorno

Puedes usar las siguientes variables de entorno, que deben ser nombres de modelo completos, para controlar los nombres de modelo a los que se mapean los alias.
Variable de entornoDescripción
ANTHROPIC_DEFAULT_OPUS_MODELEl modelo a usar para opus, o para opusplan cuando el Modo de Planificación está activo.
ANTHROPIC_DEFAULT_SONNET_MODELEl modelo a usar para sonnet, o para opusplan cuando el Modo de Planificación no está activo.
ANTHROPIC_DEFAULT_HAIKU_MODELEl modelo a usar para haiku, o funcionalidad en segundo plano
CLAUDE_CODE_SUBAGENT_MODELEl modelo a usar para subagentes
Nota: ANTHROPIC_SMALL_FAST_MODEL está obsoleto en favor de ANTHROPIC_DEFAULT_HAIKU_MODEL.

​
Configuración de caché de prompts

Claude Code automáticamente usa caché de prompts para optimizar el rendimiento y reducir costos. Puedes deshabilitar el caché de prompts globalmente o para niveles de modelo específicos:
Variable de entornoDescripción
DISABLE_PROMPT_CACHINGEstablece a 1 para deshabilitar el caché de prompts para todos los modelos (tiene precedencia sobre configuraciones por modelo)
DISABLE_PROMPT_CACHING_HAIKUEstablece a 1 para deshabilitar el caché de prompts solo para modelos Haiku
DISABLE_PROMPT_CACHING_SONNETEstablece a 1 para deshabilitar el caché de prompts solo para modelos Sonnet
DISABLE_PROMPT_CACHING_OPUSEstablece a 1 para deshabilitar el caché de prompts solo para modelos Opus
Estas variables de entorno te dan control granular sobre el comportamiento del caché de prompts. La configuración global DISABLE_PROMPT_CACHING tiene precedencia sobre las configuraciones específicas del modelo, permitiéndote deshabilitar rápidamente todo el caché cuando sea necesario. Las configuraciones por modelo son útiles para control selectivo, como cuando depuras modelos específicos o trabajas con proveedores de nube que pueden tener diferentes implementaciones de caché.