Cómo cambiar el modelo predeterminado en Claude Code (y los nuevos hooks de cambio de modelo en 2.1.251)

Configura tu modelo predeterminado de Claude Code con /model

La distinción clave está entre guardar una preferencia y cambiar de modelo temporalmente. Para el 29 de agosto de 2026, /model ya admitía ambos flujos de trabajo.

La versión 2.1.153 cambió /model para que una selección se guarde como predeterminada para las sesiones nuevas. Ese comportamiento es anterior a 2.1.251: la versión de agosto introdujo hooks de cambio de modelo, no la capacidad de recordar una selección interactiva de modelo.

El registro de cambios de la versión específica es la referencia histórica para esta distinción. Documenta tanto el comportamiento de selección persistente como la acción del selector para un cambio temporal.

Guardar una preferencia para futuras sesiones

Usa el selector de modelos:

/model

Selecciona el modelo que quieras usar como predeterminado. El comportamiento de persistencia introducido en 2.1.153 hace que esta selección se guarde para las sesiones nuevas.

Esta es la respuesta con respaldo histórico más clara a «¿Cómo hago que mi modelo preferido persista?». No requiere tratar una función introducida en una versión anterior como una capacidad nueva de 2.1.251.

Cambiar solo para la sesión actual

Pulsa s en el selector para cambiar de modelo solo en la sesión actual. Usa esta acción cuando la selección deba ser temporal.

La distinción importa al seguir instrucciones antiguas o mantener atajos de teclado personalizados. La acción anterior del selector d pasó a ser s, y la asignación de teclas personalizada asociada cambió de modelPicker:setAsDefault a modelPicker:thisSessionOnly.

Para obtener más contexto sobre la selección de modelos, consulta la guía de modelos de Claude Code. El punto específico de esta versión es sencillo: una selección normal guarda un modelo predeterminado, mientras que la acción limitada a la sesión permite un cambio temporal.

Archivos de configuración, ANTHROPIC_MODEL y opciones de inicio que anulan la configuración

La configuración del modelo también puede realizarse mediante archivos de configuración, variables de entorno y opciones de inicio. Sin embargo, la investigación proporcionada establece una limitación histórica: su documentación exacta y su precedencia no se verificaron de forma independiente en una instantánea disponible hasta el 29 de agosto de 2026.

El documentación de configuración del modelo y documentación de ajustes describen estas vías, pero esas páginas contienen actualizaciones posteriores. No permiten establecer todos los detalles del comportamiento en la fecha de corte de este artículo.

La siguiente tabla separa las opciones documentadas de lo que respaldan las pruebas fechadas.

¿Qué ajuste tiene prioridad?

La investigación proporcionada informa de documentación que sitúa la opción de inicio por encima de ANTHROPIC_MODEL, y la variable de entorno por encima del valor del archivo de configuración model . También señala explícitamente que ese orden no está verificado para la fecha de corte de la publicación.

Por tanto, este artículo no presenta esa cadena de precedencia como un hecho establecido en agosto de 29. El cambio de persistencia de /model tiene una referencia fechada en el registro de cambios; la jerarquía exacta de configuración no.

¿Y un modelo predeterminado para un solo proyecto?

La investigación identifica en la documentación archivos de configuración de usuario, de proyecto y personales de proyecto. No establece su redacción histórica exacta ni el comportamiento de configuración del modelo mediante una instantánea anterior a la fecha de corte.

Eso permite dar una respuesta más limitada que un tutorial de configuración de proyectos: /model la persistencia está confirmada, mientras que las instrucciones sobre archivos específicos de proyecto requieren verificación histórica. La referencia de la CLI ofrece un complemento útil para la configuración desde la línea de comandos, pero no elimina el límite de las pruebas disponibles para este artículo.

Qué aportan los hooks de cambio de modelo en 2.1.251

Claude Code 2.1.251 se publicó el 28 de agosto de 2026. Sus notas de la versión oficiales introducen dos hooks con nombres exactos:

• PreModelSwitch
• PostModelSwitch

La versión describe sus capacidades como bloquear, confirmar o anotar un cambio de modelo. Estos hooks amplían el flujo de selección de modelos con controles en torno al cambio.

Esa es la función nueva que debe distinguirse de la persistencia del modelo predeterminado. Guardar una preferencia de modelo ya estaba disponible; los nuevos eventos de hook añaden formas de intervenir en un cambio de modelo.

¿Puede un hook bloquear o solicitar confirmación?

Sí, el bloqueo y la confirmación son capacidades mencionadas explícitamente en el anuncio de la versión. También se incluye la anotación.

El anuncio no proporciona los esquemas completos de entrada y salida, las reglas de coincidencia ni los JSON de decisión. Por tanto, permite describir estas capacidades, pero no publicar una configuración ejecutable basada únicamente en el anuncio.

El mismo límite se aplica a detalles como qué campos de la carga útil identifican los modelos anterior y nuevo o cómo debe estructurarse una respuesta de confirmación. Esos detalles no figuran en las pruebas proporcionadas anteriores a la fecha de corte.

¿Qué se necesita antes de implementar uno?

Una implementación funcional necesita más que los nombres de los eventos: necesita el formato de configuración aplicable y el contrato de respuesta admitido. Las notas de la versión no proporcionan esos elementos.

Consulta la guía de hooks de Claude Code para obtener más contexto sobre los hooks. Para esta versión, delimita con precisión el alcance confirmado: PreModelSwitch y PostModelSwitch existen, y el anuncio describe capacidades de bloqueo, confirmación y anotación.

Inspeccionar el comportamiento de la caché de prompts y los costes de reanudación

La versión 2.1.251 también añade diagnósticos que ayudan a explicar el comportamiento de la caché de prompts. Estas incorporaciones muestran la actividad de la caché y el coste estimado de reconstrucción; la versión no anuncia nuevos precios de tokens ni límites numéricos de caché.

Leer la nueva línea de caché en /cost

El comando existente incorpora una línea de caché de prompts por sesión:

/cost

Esa línea informa de cuatro elementos:

• Tasa de aciertos
• Fallos
• Tokens almacenados de nuevo en caché
• Estado de caché caliente o fría

En conjunto, estos elementos ofrecen una visión de la caché más detallada que una cifra de coste por sí sola. Distinguen los aciertos de los fallos de caché y muestran cuántos tokens se almacenaron de nuevo en caché.

Los scripts de la línea de estado también incorporan un objeto correspondiente prompt_cache . Esto permite acceder a los diagnósticos de caché tanto en la interfaz de la línea de estado como mediante /cost.

El anuncio no proporciona un esquema completo para ese objeto. Considera prompt_cache un nombre de objeto confirmado, sin dar por supuestos campos adicionales más allá de los diagnósticos descritos en la versión.

Inspeccionar la información de reanudación mediante SessionStart

Al reanudar, SessionStart los hooks ahora reciben información sobre la antigüedad de la sesión y el coste estimado de reconstruir la caché de prompts.

Esto es distinto de la visualización de /cost : la incorporación relativa a la reanudación proporciona información a los hooks, mientras que el comando muestra diagnósticos de caché por sesión. Ambas incorporaciones permiten conocer el estado de la caché, pero exponen esa información mediante interfaces diferentes.

Las notas de la versión no indican los nombres exactos de las claves de la carga útil para la antigüedad de la sesión ni para el coste estimado de reconstrucción. Un ejemplo de hook que diera por supuestos esos nombres iría más allá de la evidencia disponible.

También cambiaron otros valores predeterminados de los modelos y los diagnósticos

Varios cambios relacionados en 2.1.251 son relevantes al interpretar qué significa «modelo predeterminado». Afectan a los subagentes, los valores predeterminados de la cuenta, las preferencias de esfuerzo y la visibilidad del gasto de la pasarela.

Prioridad del modelo de los subagentes

CLAUDE_CODE_SUBAGENT_MODEL ahora proporciona un valor predeterminado. El valor de model: en la definición de un agente y un modelo seleccionado explícitamente al crear un agente tienen prioridad sobre esa variable.

Este es un cambio de prioridad confirmado en el registro de cambios etiquetado. Debe tratarse por separado del orden histórico no verificado entre la opción de inicio, la variable de entorno y el valor del archivo de configuración del modelo principal.

Al examinar la selección del modelo de un subagente, ten en cuenta esas elecciones explícitas antes de considerar decisiva la variable de entorno. La guía de subagentes ofrece un contexto más amplio sobre la configuración de agentes.

Valores predeterminados de la cuenta y preferencias de esfuerzo

Las suscripciones Enterprise por usuario ahora usan Opus 5 de forma predeterminada, al igual que otros planes prémium.

Ese cambio a nivel de cuenta es independiente de una preferencia de modelo guardada mediante /model. La versión también cambia la persistencia de /effort : ahora guarda un nivel de esfuerzo predeterminado independiente para cada modelo.

La distinción práctica es que la selección del modelo y la persistencia del esfuerzo son ajustes independientes. El nuevo comportamiento del esfuerzo recuerda un valor predeterminado para cada modelo, en lugar de definir un único valor de esfuerzo predeterminado compartido.

Visibilidad del gasto de la pasarela

El /usage incorpora una barra de Límite de gasto para los desarrolladores que usan una pasarela de aplicaciones de Claude con límites de gasto:

/usage

Los scripts de la línea de estado incorporan el campo correspondiente rate_limits.spend_limit . Se trata de una incorporación a los diagnósticos para ese contexto de pasarela.

El registro de cambios no anuncia un tope universal en dólares. Por tanto, la presencia de una visualización del límite de gasto no debe interpretarse como un límite fijo aplicable a todos los usuarios de Claude Code.

Puntos clave

• /model ya guardaba un valor predeterminado para las sesiones nuevas antes de 2.1.251; ese comportamiento se remonta a 2.1.153.
• Pulsa s en el selector de modelos para cambiarlo solo durante la sesión actual. Las combinaciones de teclas personalizadas usan modelPicker:thisSessionOnly.
• Claude Code 2.1.251 incorpora PreModelSwitch y PostModelSwitch, con funciones de bloqueo, confirmación y anotación descritas en la versión.
• /cost, los datos de caché de la línea de estado y la información de SessionStart al reanudar permiten conocer la actividad de la caché de prompts y los costes estimados de reconstrucción.
• CLAUDE_CODE_SUBAGENT_MODEL proporciona un valor predeterminado que las elecciones explícitas del modelo del agente pueden sustituir. La prioridad histórica exacta de la configuración del modelo principal sigue sin verificarse en la investigación proporcionada.

Preguntas frecuentes

¿/model guarda el modelo predeterminado en Claude Code?

Sí. La versión 2.1.153 cambió /model para que una selección se guarde como valor predeterminado para las sesiones nuevas, y ese comportamiento ya existía antes de 2.1.251. Pulsa s en el selector cuando quieras cambiarlo solo durante la sesión actual.

¿Qué tiene prioridad: settings.json, ANTHROPIC_MODEL o --model?

La investigación proporcionada señala que la documentación sitúa la opción de inicio por encima de ANTHROPIC_MODEL, y esa variable por encima del valor del modelo en el archivo de configuración. Sin embargo, el orden exacto no se verificó de forma independiente en una instantánea de 2026 anterior a agosto de 29, por lo que este artículo no lo establece como un comportamiento específico de esa fecha de corte.

¿Puede un hook de cambio de modelo de Claude Code bloquear un cambio?

La versión 2.1.251 describe PreModelSwitch y PostModelSwitch como compatibles con el bloqueo, la confirmación y la anotación de cambios de modelo. No proporciona esquemas completos ni JSON de decisión, por lo que el anuncio por sí solo no basta para implementar un hook ejecutable.

¿Dónde puedo ver los fallos de caché y los costes estimados de reconstrucción?

En 2.1.251, /cost muestra la proporción de aciertos de caché por sesión, los fallos, los tokens almacenados de nuevo en caché y el estado caliente o frío; los scripts de la línea de estado incorporan un objeto prompt_cache correspondiente. Por separado, los hooks de SessionStart al reanudar reciben información sobre la antigüedad de la sesión y el coste estimado de reconstruir la caché de prompts, aunque las notas de la versión no especifican los nombres de esas claves de la carga útil.