Configuración del modelo
Aprende sobre la configuración del modelo Claude Code, incluyendo alias de modelos como opusplan
Modelos disponibles
Para la configuración model
en Claude Code, puedes configurar:
- Un alias de modelo
- Un nombre de modelo completo
- Para Bedrock, un ARN
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 modelo | Comportamiento |
---|---|
default | Configuración de modelo recomendada, dependiendo de tu tipo de cuenta |
sonnet | Usa el modelo Sonnet más reciente (actualmente Sonnet 4) para tareas de codificación diarias |
opus | Usa el modelo Opus más capaz (actualmente Opus 4.1) para razonamiento complejo |
haiku | Usa 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 |
opusplan | Modo 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:
- Durante la sesión - Usa
/model <alias|nombre>
para cambiar modelos a mitad de sesión - Al inicio - Lanza con
claude --model <alias|nombre>
- Variable de entorno - Establece
ANTHROPIC_MODEL=<alias|nombre>
- Configuraciones - Configura permanentemente en tu archivo de configuraciones usando el campo
model
.
Ejemplo de uso:
Ejemplo de archivo de configuraciones:
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.
Nota: Los modelos de contexto extendido tienen precios diferentes.
Verificando tu modelo actual
Puedes ver qué modelo estás usando actualmente de varias maneras:
- En la 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 Planificación está activo. |
ANTHROPIC_DEFAULT_SONNET_MODEL | El modelo a usar para sonnet , o para opusplan cuando el Modo de Planificación no está activo. |
ANTHROPIC_DEFAULT_HAIKU_MODEL | El modelo a usar para haiku , o funcionalidad en segundo plano |
CLAUDE_CODE_SUBAGENT_MODEL | El modelo a usar para subagentes |
Nota: ANTHROPIC_SMALL_FAST_MODEL
está obsoleto en favor de ANTHROPIC_DEFAULT_HAIKU_MODEL
.