Configuración del modelo - Claude Code Docs

Modelos disponibles

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

Un alias de modelo
Un nombre de modelo completo
Para Bedrock, un ARN

Alias de modelo

Los alias de modelo proporcionan una forma conveniente de seleccionar configuraciones de modelo sin necesidad de recordar números de versión exactos:

Alias de modelo	Comportamiento
`default`	Configuración de modelo recomendada, dependiendo de tu tipo de cuenta
`sonnet`	Utiliza el último modelo Sonnet (actualmente Sonnet 4.5) para tareas de codificación diaria
`opus`	Utiliza el modelo Opus (actualmente Opus 4.1) para tareas especializadas de razonamiento complejo
`haiku`	Utiliza el modelo rápido y eficiente Haiku para tareas simples
`sonnet[1m]`	Utiliza Sonnet con una ventana de contexto de 1 millón de tokens para sesiones largas
`opusplan`	Modo especial que utiliza `opus` durante el modo de plan, luego cambia a `sonnet` para la ejecución

Configurar tu modelo

Puedes configurar tu modelo de varias formas, listadas en orden de prioridad:

Durante la sesión - Usa /model <alias|name> para cambiar modelos durante la sesión
Al iniciar - Inicia con claude --model <alias|name>
Variable de entorno - Establece ANTHROPIC_MODEL=<alias|name>
Configuración - Configura permanentemente en tu archivo de configuración usando el campo model.

Ejemplo de uso:

# Iniciar con Opus
claude --model opus

# Cambiar a Sonnet durante la sesión
/model sonnet

Archivo de configuración de ejemplo:

{
    "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 de Max, Claude Code automáticamente volverá 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 plan - Utiliza 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 añadirse a nombres de modelo completos para habilitar una ventana de contexto de 1 millón de tokens.

# Ejemplo de uso de 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.

Verificar tu modelo actual

Puedes ver qué modelo estás usando actualmente de varias formas:

En línea de estado (si está configurada)
En /status, que también muestra la información de tu 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 asignan los alias.

Variable de entorno	Descripción
`ANTHROPIC_DEFAULT_OPUS_MODEL`	El modelo a usar para `opus`, o para `opusplan` cuando el Modo de Plan está activo.
`ANTHROPIC_DEFAULT_SONNET_MODEL`	El modelo a usar para `sonnet`, o para `opusplan` cuando el Modo de Plan no está activo.
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	El modelo a usar para `haiku`, o funcionalidad de fondo
`CLAUDE_CODE_SUBAGENT_MODEL`	El modelo a usar para subagentes

Nota: ANTHROPIC_SMALL_FAST_MODEL está deprecado en favor de ANTHROPIC_DEFAULT_HAIKU_MODEL.

Configuración de almacenamiento en caché de indicaciones

Claude Code utiliza automáticamente almacenamiento en caché de indicaciones para optimizar el rendimiento y reducir costos. Puedes desactivar el almacenamiento en caché de indicaciones globalmente o para niveles de modelo específicos:

Variable de entorno	Descripción
`DISABLE_PROMPT_CACHING`	Establece en `1` para desactivar el almacenamiento en caché de indicaciones para todos los modelos (tiene precedencia sobre la configuración por modelo)
`DISABLE_PROMPT_CACHING_HAIKU`	Establece en `1` para desactivar el almacenamiento en caché de indicaciones solo para modelos Haiku
`DISABLE_PROMPT_CACHING_SONNET`	Establece en `1` para desactivar el almacenamiento en caché de indicaciones solo para modelos Sonnet
`DISABLE_PROMPT_CACHING_OPUS`	Establece en `1` para desactivar el almacenamiento en caché de indicaciones solo para modelos Opus

Estas variables de entorno te dan control granular sobre el comportamiento del almacenamiento en caché de indicaciones. La configuración global DISABLE_PROMPT_CACHING tiene precedencia sobre la configuración específica del modelo, permitiéndote desactivar rápidamente todo el almacenamiento en caché cuando sea necesario. La configuración por modelo es útil para control selectivo, como cuando depuras modelos específicos o trabajas con proveedores de nube que pueden tener diferentes implementaciones de almacenamiento en caché.

Configuración

​Modelos disponibles

​Alias de modelo

​Configurar tu modelo

​Comportamiento especial del modelo

​Configuración del modelo default

​Configuración del modelo opusplan

​Contexto extendido con [1m]

​Verificar tu modelo actual

​Variables de entorno

​Configuración de almacenamiento en caché de indicaciones