Configuración del modelo
Aprende sobre la configuración del modelo Claude Code, incluyendo alias de modelo 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 modelo
Los alias de modelo 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|name>
para cambiar modelos a mitad de sesión - Al inicio - Lanza con
claude --model <alias|name>
- Variable de entorno - Establece
ANTHROPIC_MODEL=<alias|name>
- 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 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 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
.