Configuración del modelo

Configure qué modelo utiliza Claude Code, niveles de esfuerzo, contexto extendido y la ventana de auto-compact

Modelos disponibles

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

Un alias de modelo
Un nombre de modelo
- API de Anthropic: un nombre de modelo completo
- Amazon Bedrock: un ARN de perfil de inferencia
- Microsoft Foundry: un nombre de implementación
- Agent Platform de Google Cloud: un nombre de versión

Para obtener orientación sobre qué modelo y nivel de esfuerzo se ajustan a diferentes tipos de trabajo, consulte Choosing a Claude model and effort level in Claude Code en el blog.

Alias de modelos

Use un alias de modelo para seleccionar configuraciones de modelo sin recordar números de versión exactos:

Alias de modelo	Comportamiento
`default`	Valor especial que borra cualquier anulación de modelo y revierte al valor predeterminado en tiempo de ejecución para su cuenta. No es en sí mismo un alias de modelo
`best`	Utiliza el último modelo Fable donde está disponible para usted; de lo contrario, el mismo modelo que `opus`
`fable`	Utiliza el último modelo Fable para sus tareas más difíciles y de mayor duración
`sonnet`	Utiliza el último modelo Sonnet para tareas de codificación diaria
`opus`	Utiliza el último modelo Opus para tareas de razonamiento complejo
`haiku`	Utiliza el modelo Haiku rápido y eficiente para tareas simples
`sonnet[1m]`	Utiliza Sonnet con una ventana de contexto de 1 millón de tokens para sesiones largas. Sin efecto cuando `sonnet` ya se resuelve a Sonnet 5 con su ventana nativa de 1M; detrás de una puerta de enlace LLM, selecciona la ventana de 1M para Sonnet 5
`opus[1m]`	Utiliza Opus 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

La versión a la que se resuelven los alias opus y sonnet depende del proveedor:

Proveedor	`opus`	`sonnet`
API de Anthropic	Opus 5	Sonnet 5
Claude Platform on AWS	Opus 5	Sonnet 4.6
Amazon Bedrock, Agent Platform de Google Cloud	Opus 5	Sonnet 4.5
Microsoft Foundry	Opus 4.6	Sonnet 4.5

A menos que establezca ANTHROPIC_DEFAULT_FABLE_MODEL, el alias fable se resuelve a Fable 5.1. Antes de v2.1.255, se resolvía a Fable 5.

Donde un alias se resuelve a un modelo más antiguo, los modelos más nuevos están disponibles seleccionando explícitamente el nombre de modelo completo o estableciendo ANTHROPIC_DEFAULT_OPUS_MODEL o ANTHROPIC_DEFAULT_SONNET_MODEL.

Antes de v2.1.219, opus se resolvía a Opus 4.8 en la API de Anthropic desde v2.1.154, y en Claude Platform on AWS, Amazon Bedrock y Agent Platform de Google Cloud desde v2.1.207. Antes de v2.1.207, opus se resolvía a Opus 4.7 en Claude Platform on AWS y a Opus 4.6 en Amazon Bedrock y Agent Platform de Google Cloud.

Los alias apuntan a la versión recomendada para su proveedor y se actualizan con el tiempo. Para fijar una versión específica, use el nombre de modelo completo, por ejemplo claude-opus-5, o establezca la variable de entorno correspondiente como ANTHROPIC_DEFAULT_OPUS_MODEL.

Trabajar con Fable

Claude Fable 5.1 y Claude Fable 5 son los modelos más capaces en Claude Code, adecuados para tareas más grandes que una sola sesión. Sostienen sesiones autónomas largas, investigan antes de actuar y verifican su trabajo más a menudo que los modelos más pequeños. Fable 5.1 es la versión más reciente.

Ninguno de los modelos Fable es el valor predeterminado de tipo de cuenta en ningún plan o proveedor. Seleccione uno explícitamente:

Fable 5.1: ejecute /model fable, o inicie con claude --model fable.
Fable 5: selecciónelo por ID de modelo. En la API de Anthropic, ejecute /model claude-fable-5 o inicie con claude --model claude-fable-5. En otros proveedores, use el ID de modelo Fable 5 de su proveedor o fíjelo con ANTHROPIC_DEFAULT_FABLE_MODEL.

Si su configuración de usuario contiene claude-fable-5 o claude-fable-5[1m] como modelo, por ejemplo porque seleccionó Fable en el selector /model antes de v2.1.255, y se conecta directamente a la API de Anthropic, Claude Code cambia ese valor guardado al alias fable o fable[1m] la primera vez que ejecuta v2.1.255 o posterior, y la línea del modelo de inicio muestra (auto-updated) una vez. Un valor claude-fable-5 en la configuración del proyecto, local o administrada se deja tal como está.

Las solicitudes que los clasificadores de seguridad de un modelo Fable marcan, más a menudo en dominios de ciberseguridad y biología, desencadenan alternancia automática de modelo.

Para aprovechar al máximo Fable:

Describa el resultado, no los pasos: entrégale el resultado que desea y déjelo planificar el camino. Para mantenerlo trabajando hacia ese resultado, establezca un objetivo.
Entrégale problemas ambiguos: investigaciones de causa raíz, depuración de interrupciones y decisiones de arquitectura son donde la investigación y verificación adicionales se pagan.
Omita los recordatorios de verificación: verifica su propio trabajo con menos indicaciones, por lo que los recordatorios para probar o verificar generalmente son innecesarios.
Dimensione tareas más grandes: entrégale trabajo que normalmente dividiría en piezas. Mantiene sesiones largas sin perder el hilo.

En la API de Anthropic, el selector /model enumera un modelo Fable solo después de que el servidor lo informe como disponible para su organización. Cuando escribe /model fable o un ID de modelo Fable, Claude Code verifica la disponibilidad directamente con el servidor, por lo que una selección escrita puede tener éxito incluso cuando el selector no enumera la entrada.

Fable y créditos de uso

Dependiendo de su plan y nivel de asiento, el uso de Fable puede facturarse a créditos de uso en lugar de extraer de los límites incluidos en su plan. Cuando lo hace, el selector /model muestra "Requires usage credits" en la fila Fable. Para administrar créditos de uso, consulte Add usage credits to your subscription.

En sesiones interactivas, Claude Code muestra un mensaje de consentimiento antes de que una solicitud de Fable facture créditos de uso. Los miembros de planes Enterprise con facturación de organización no ven el mensaje. Puede continuar en Fable usando créditos de uso o cambiar a su modelo predeterminado. También puede descartar el mensaje:

En el selector /model, mantiene su modelo actual.
A mitad de sesión, Claude Code continúa el turno en su modelo predeterminado.

Después de elegir continuar en Fable usando créditos de uso, Claude Code no muestra el mensaje nuevamente.

En una sesión con Remote Control conectado, una sesión en segundo plano, o una sesión de compañero de equipo de agentes, es posible que nadie esté en la terminal, por lo que Claude Code mantiene el mensaje de consentimiento a mitad de sesión para el plazo dialogExpiry, cinco minutos por defecto. Si nadie ha respondido antes del plazo, Claude Code finaliza el turno sin enviar la solicitud y agrega un aviso a la transcripción, que el cliente de Remote Control también muestra. Su selección de modelo no cambia, y Claude Code solicita consentimiento nuevamente en su próximo mensaje.

Lo que puede hacer mientras el mensaje está esperando depende de la sesión:

Con Remote Control conectado o en la sesión de un compañero, presione cualquier tecla en la terminal para cancelar el plazo, y Claude Code espera su respuesta.
En una sesión en segundo plano, responda antes del plazo.
Si envía un nuevo mensaje desde el cliente remoto antes de que alguien escriba en la terminal, Claude Code finaliza el turno de la misma manera, y su nuevo mensaje inicia el siguiente turno. Después de que alguien escriba en la terminal, Claude Code continúa esperando la respuesta y pone en cola su nuevo mensaje detrás de ella.

En modo no interactivo con la bandera -p y a través del Agent SDK, Claude Code nunca muestra el mensaje de consentimiento. Cuando una solicitud de Fable allí facturase a créditos de uso, Claude Code la factura sin preguntar.

Configurar su modelo

Puede configurar su modelo de varias formas, enumeradas en orden de prioridad:

Durante la sesión: use /model <alias|name> para cambiar inmediatamente, o ejecute /model sin argumento para abrir el selector. Consulte cuando Claude Code le pide que confirme el cambio
Al inicio: inicie con claude --model <alias|name>
Variable de entorno: establezca ANTHROPIC_MODEL=<alias|name>
Configuración: configure permanentemente en su archivo de configuración usando el campo model
Predeterminado para nuevas sesiones: establezca ANTHROPIC_DEFAULT_MODEL=<alias|name>

/model guarda su elección como predeterminada para nuevas sesiones escribiendo el campo model en su configuración de usuario. En el selector:

Enter: cambiar modelo y guardar como predeterminado
s: cambiar modelo solo para esta sesión

Escribir /model <name> directamente se comporta como Enter. Un modelo establecido con /model en modo no interactivo, con la bandera -p, se aplica solo a la sesión actual y no se guarda como predeterminado. La configuración del proyecto y administrada aún tienen precedencia y se reaplicarán en el próximo inicio. Un modelo predeterminado de organización que su administrador ha configurado para anular la selección del usuario también se reaplicará en el próximo inicio.

En v2.1.144 a v2.1.152, /model se aplicaba solo a la sesión actual y d en el selector guardaba un predeterminado.

La bandera --model y la variable de entorno ANTHROPIC_MODEL se aplican solo a la sesión que inicia con ellas. Para ejecutar diferentes modelos en diferentes terminales al mismo tiempo, inicie cada uno con su propia bandera --model en lugar de cambiar con /model.

Los precios en el selector /model aparecen cuando Claude Code habla con la API de Anthropic, directamente o a través de una puerta de enlace LLM que la proxifica, y el precio en una fila es el precio del modelo que esa fila selecciona. En proveedores de terceros como Amazon Bedrock y en la puerta de enlace de aplicaciones Claude, su proveedor o puerta de enlace determina lo que paga, por lo que las filas del selector no muestran precio. El precio es solo una etiqueta de visualización; no afecta qué modelo selecciona una fila o qué factura su proveedor. Antes de v2.1.206, Claude Platform on AWS y las sesiones de puerta de enlace mostraban precios de lista de Anthropic, y una fila podría mostrar el precio de un modelo diferente al que seleccionaba.

Las sesiones reanudadas iniciadas con claude --resume, --continue, o el selector /resume mantienen el modelo que estaban usando cuando se guardó la transcripción, independientemente de la configuración actual de model. Si el modelo restaurado se ha retirado o está excluido por availableModels, la sesión cae a través del orden de precedencia normal. Esto evita que la elección de /model de otra sesión cambie el modelo en la reanudación. En proveedores que usan ID de implementación específicos del proveedor en lugar de ID de modelo de Anthropic, como Amazon Bedrock, Agent Platform de Google Cloud y Microsoft Foundry, el modelo de transcripción no se restaura en absoluto y la sesión resuelve su modelo a través del orden de precedencia normal.

Un modelo que elige para el nuevo inicio con --model o ANTHROPIC_MODEL aún tiene precedencia sobre el modelo restaurado. A partir de v2.1.195, también lo hace una variable de familia ANTHROPIC_DEFAULT_OPUS_MODEL. ANTHROPIC_DEFAULT_MODEL también puede, bajo las condiciones enumeradas en su sección.

Cuando el modelo activo al inicio proviene de la configuración del proyecto o administrada en lugar de su propia selección, el encabezado de inicio muestra qué archivo de configuración lo estableció. Ejecute /model para anular; la configuración del proyecto o administrada se reaplicará en el próximo inicio. En plataformas que incrustan Claude Code y establecen CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, la configuración de modelo del host tiene precedencia sobre la configuración de modelo administrada, mientras que una lista de permitidos availableModels administrada permanece en vigor a menos que el host suministre la suya propia; Exceptions to managed settings precedence dice qué claves y variables anula el host.

Cuando se solicita un cambio de modelo a través del método setModel() del Agent SDK o por una aplicación como la aplicación de escritorio que ejecuta Claude Code CLI para usted, Claude Code verifica que la cadena sea una que reconozca antes de guardarla. Esta verificación requiere Claude Code v2.1.200 o posterior. En la API de Anthropic, Claude Code reconoce:

un alias de modelo
una entrada del selector /model
cualquier nombre que comience con claude-
un valor que configuró usted mismo como una opción de modelo personalizado o en modelOverrides

Claude Code rechaza una cadena no reconocida con Model "<name>" is not a recognized model id. y la sesión mantiene su modelo actual, en lugar de guardar la cadena y fallar en la próxima solicitud. Consulte la referencia de errores para pasos de recuperación.

La verificación se ejecuta solo en la API de Anthropic. En Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry, Claude Platform on AWS, y detrás de una puerta de enlace LLM o un ANTHROPIC_BASE_URL personalizado, su proveedor o puerta de enlace define los nombres de modelo, por lo que Claude Code pasa cualquier cadena sin verificarla. La verificación tampoco cubre la bandera --model, la variable de entorno ANTHROPIC_MODEL, o la configuración de model; un valor mal escrito allí produce There's an issue with the selected model en la primera solicitud en su lugar. Claude Code aún puede escribir la línea de diagnóstico de modelo no reconocido en el momento de la solicitud, en cada proveedor.

Cuando el modelo solicitado tiene una fecha de retiro programada o se remapea automáticamente a una versión más nueva, Claude Code muestra una advertencia que nombra el modelo solicitado. Las sesiones interactivas la muestran como un aviso de inicio. A partir de v2.1.182, la misma advertencia se escribe en stderr en modo no interactivo cuando se usa el formato de salida de texto predeterminado. La verificación también cubre un model establecido en frontmatter de subagente. La advertencia de stderr se suprime para --output-format json y stream-json; lea el modelo real del campo modelUsage del mensaje de resultado en su lugar.

Por ejemplo, inicie una sesión en Opus:

claude --model opus

Luego cambie modelos desde dentro de la sesión:

/model sonnet

Archivo de configuración de ejemplo:

{
    "permissions": {
        "allow": ["Bash(npm run lint)"]
    },
    "model": "opus"
}

Establecer un modelo predeterminado para nuevas sesiones

Establezca ANTHROPIC_DEFAULT_MODEL=<alias|name> para elegir el modelo en el que sus sesiones comienzan de forma predeterminada. Requiere Claude Code v2.1.236 o posterior.

Claude Code inicia una nueva sesión en el modelo de la variable solo cuando ninguno de estos selecciona un modelo:

La bandera --model
ANTHROPIC_MODEL
Un valor de model en cualquier archivo de configuración, incluida la elección que guarda con /model
Un modelo predeterminado de organización

Una elección que guarda con /model tiene precedencia sobre la variable en lanzamientos posteriores también. Con ANTHROPIC_MODEL establecido en su lugar, Claude Code vuelve al modelo de esa variable en el próximo lanzamiento, sea lo que sea que haya guardado con /model.

Claude Code también resuelve la opción Predeterminado al modelo de la variable, a menos que se aplique un modelo predeterminado de organización. Cuando la opción Predeterminado se resuelve al modelo de la variable, la fila Predeterminado en el selector /model muestra la etiqueta Set by ANTHROPIC_DEFAULT_MODEL.

Claude Code ignora la variable en estos casos, y la opción Predeterminado se resuelve como si no la hubiera establecido:

La establece en default, inherit, opusplan, o haiku
enforceAvailableModels está activado
availableModels o restricciones de modelo de organización excluyen el modelo
El modelo no está disponible para su cuenta

Cuando una nueva sesión comenzaría en el modelo de la variable, una sesión que reanuda con claude --resume, --continue, o el selector /resume también comienza en él. Claude Code no restaura el modelo guardado en la transcripción de esa sesión. De lo contrario, Claude Code no usa la variable cuando reanuda una sesión.

Una nueva sesión comienza en un modelo diferente al que eligió

Cuando elige un modelo con /model y su próxima sesión comienza en algo más, estas son las causas habituales:

Lo eligió para una sesión. Presionar s en el selector, iniciar con --model, y ejecutar /model en modo no interactivo se aplican solo a la sesión actual y dejan su predeterminado guardado solo.
Algo con mayor prioridad establece el modelo. Un valor de model en la configuración del proyecto o administrada, ANTHROPIC_MODEL en su shell, o un predeterminado de organización que su administrador estableció para anular las elecciones del usuario se aplica nuevamente en cada lanzamiento. Su elección de /model aún se guarda; está superada. Cuando la configuración del proyecto o administrada establece el modelo, el encabezado de inicio nombra el archivo.
Claude Code no pudo guardar su elección. /model escribe model en ~/.claude/settings.json. Si no puede escribir en ese archivo, por ejemplo porque otra herramienta lo genera o lo vincula a una copia de solo lectura, el modelo que eligió dura para la sesión y el próximo lanzamiento lee el valor anterior. Establezca model en la herramienta que genera el archivo, o haga que el archivo sea escribible. Consulte A change you made in Claude Code is lost in new sessions.
Reanudó una sesión. Una sesión que reanuda con claude --resume o --continue generalmente mantiene el modelo que estaba usando en lugar de su predeterminado actual.

Restringir la selección de modelos

Los administradores empresariales pueden usar availableModels en configuración administrada o de políticas para restringir qué modelos pueden seleccionar los usuarios. Las entradas coinciden con una familia de modelos como sonnet, un prefijo de versión como claude-sonnet-4-5, o un ID de modelo completo como claude-sonnet-4-5-20250929. Un prefijo de versión también coincide con IDs de modelo posteriores que lo extienden con otro segmento, por lo que claude-fable-5 permite tanto Fable 5 como Fable 5.1, mientras que claude-fable-5-1 permite solo Fable 5.1.

En plataformas que integran Claude Code y establecen CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, la configuración de modelo del host tiene precedencia sobre la configuración de modelos administrada, mientras que una lista de permitidos availableModels administrada permanece en vigor a menos que el host proporcione la suya propia; Excepciones a la precedencia de configuración administrada indica qué claves y variables anula el host.

Cuando se establece availableModels, la lista de permitidos se aplica en todas partes donde un usuario puede especificar un modelo:

Modelo de sesión principal: /model, la bandera --model, la variable de entorno ANTHROPIC_MODEL, la configuración model, ANTHROPIC_DEFAULT_MODEL, y el modelo restaurado cuando se reanuda una sesión
Resolución de alias: las variables de entorno ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, y ANTHROPIC_DEFAULT_FABLE_MODEL no pueden redirigir un alias permitido a un modelo fuera de la lista
Modo rápido: /fast se niega a alternar cuando implicaría cambiar implícitamente a un modelo Opus fuera de la lista, con el mensaje "is not in your organization's allowed models"
Modelos de subagente y compañero: el campo model en la frontmatter de subagente, el parámetro model de la herramienta Agent, modelos de compañero de equipo de agente, CLAUDE_CODE_SUBAGENT_MODEL, y, en v2.1.197 y anteriores, el selector de modelos en el asistente /agents
Modelos de skill y comando: la frontmatter model en skills y comandos
Modelo de asesor: la configuración advisorModel configurada y la bandera --advisor
Modelo de agente de fondo: el modelo seleccionado en el selector de envío

En la API de Anthropic y Claude Platform en AWS, un alias de familia de modelos, opus, sonnet, haiku, o fable, se resuelve a su modelo habitual cuando la lista de permitidos permite ese modelo. Cuando la lista de permitidos bloquea ese modelo, Claude Code sustituye la versión más nueva de la familia que la lista de permitidos permite y muestra un aviso que nombra tanto los modelos solicitados como los sustituidos. Con ["sonnet", "claude-opus-4-6"], por ejemplo, tanto /model opus como --model opus seleccionan Claude Opus 4.6, el Opus más nuevo permitido. Antes de v2.1.205, un alias cuya versión más nueva lanzada estaba fuera de la lista se rechazaba o reemplazaba como cualquier otra selección bloqueada, incluso cuando la lista permitía una versión anterior.

La sustitución necesita una versión permitida en la que aterrizar: cuando la lista de permitidos no permite ninguna versión de la familia del alias, el alias sigue el comportamiento de rechazo y reemplazo a continuación como cualquier otro valor bloqueado.

Claude Code maneja cualquier otra selección bloqueada según dónde se estableció el modelo:

/model: Claude Code rechaza el cambio con un error
Bandera --model, ANTHROPIC_MODEL, o la configuración model: Claude Code reemplaza el valor al inicio con una advertencia que nombra tanto los modelos solicitados como los sustituidos, y la sesión comienza en el modelo predeterminado
ANTHROPIC_DEFAULT_MODEL: Claude Code ignora la variable
Anulación de subagente o compañero: Claude Code ejecuta el subagente o compañero en un modelo de respaldo en lugar de fallar la solicitud. Consulte Elegir un modelo para el respaldo del subagente y Especificar compañeros y modelos para el respaldo del compañero.

En sesiones interactivas, Claude Code le advierte cuando sustituye el modelo de un subagente, por este respaldo o por la sustitución de versión más nueva permitida anterior, nombrando los modelos solicitados y sustituidos; no informa del respaldo de un compañero.

Donde opera la sustitución de versión más nueva permitida anterior, un alias de familia bloqueado la sigue en su lugar. Antes de v2.1.222, un alias retrocedía como cualquier otro valor bloqueado en cada proveedor
Anulación de skill o comando: Claude Code ignora la anulación, incluido un alias de familia bloqueado, y el skill o comando se ejecuta en el modelo de sesión. Un skill o comando que se ejecuta en un subagente sigue el comportamiento del subagente anterior en su lugar
Configuración advisorModel: el asesor se deshabilita para la sesión
Bandera --advisor: Claude Code sale con un error al inicio. En una sesión de fondo, inicia la sesión sin el asesor en lugar de salir

Claude Code oculta los modelos excluidos del selector /model. Un ID de modelo completo en la lista que no tiene una fila de selector integrada, como una versión anterior que la lista fija, aparece en el selector /model como su propia fila etiquetada, a menos que Claude Code reemplace las opciones integradas con una alineación modelPicker. Antes de v2.1.199, tal ID era seleccionable solo escribiendo /model <id>.

Los cambios de modelo que Claude Code realiza en su nombre se verifican de la misma manera:

Cadenas de modelo de respaldo: las entradas fuera de la lista de permitidos se descartan
Actualizaciones de modo de plan: en la API de Anthropic y Claude Platform en AWS, una actualización como opusplan a un modelo excluido usa la versión más nueva permitida de la familia de actualización. En proveedores con IDs de modelo específicos del proveedor, y cuando no se permite ninguna versión, la actualización se omite y la planificación continúa en el modelo de la sesión
Respaldo automático de modelo: un respaldo cuyo destino está excluido no se ejecuta, por lo que la solicitud marcada termina con un rechazo en su lugar
Clasificador de modo automático: el valor predeterminado de Claude Sonnet 5 del clasificador se aplica solo cuando la lista de permitidos permite Sonnet 5. Cuando está excluido, el clasificador se ejecuta en el modelo de la sesión, que la lista de permitidos ya rige, o en un modelo Opus cuando la sesión se ejecuta en un modelo Fable. En proveedores distintos de la API de Anthropic, ese respaldo de Opus se ejecuta en el modelo Opus predeterminado del proveedor sin consultar la lista de permitidos. Requiere Claude Code v2.1.210 o posterior
Modo rápido: habilitar el modo rápido se rechaza cuando el modelo en el que se ejecutaría la sesión después está fuera de la lista de permitidos

{
  "availableModels": ["sonnet", "haiku"]
}

Cobertura de superficie

Cada superficie aplica la lista de permitidos que recibe. El mecanismo de entrega que llega a cada superficie difiere:

Mecanismo de entrega	CLI e IDE	Sesiones locales de escritorio	Sesiones web, móviles y en la nube	Agent SDK y no interactivo	Cowork
Configuración administrada por servidor desde la consola de administración	Aplicada	Aplicada	Aplicada	Aplicada	No entregada
MDM o archivos de configuración administrada	Aplicada	Aplicada	No entregada en entornos alojados por Anthropic; en entornos autohospedados, aplicada desde la imagen del ejecutor según cómo Claude Code combina fuentes administradas	Aplicada	Aplicada donde se implementa

Las sesiones en la nube, en Claude Code en la web o en la aplicación de escritorio, se ejecutan en máquinas virtuales administradas por Anthropic de forma predeterminada: la configuración implementada en su dispositivo no las alcanza, por lo que entregue la lista de permitidos a través de configuración administrada por servidor. Las sesiones que su organización enruta a un entorno autohospedado se ejecutan en su propio cálculo y también leen el archivo de configuración administrada en la imagen del ejecutor. Cómo Claude Code combina fuentes administradas indica cuándo se aplica ese archivo. Un cambio de modelo a mitad de sesión en una sesión en la nube se rechaza cuando el modelo solicitado está excluido por la lista de permitidos. El rechazo del lado del servidor en la creación de sesión se aplica a restricciones de modelo de organización, no a la clave de configuración availableModels.
Cowork, la pestaña de trabajo agéntico en la aplicación de escritorio de Claude, ejecuta sus sesiones en Claude Code pero, por diseño, no recibe configuración administrada por servidor desde la consola de administración de claude.ai. Un archivo de configuración administrada se aplica a sesiones de Cowork cuando está presente donde se ejecuta la sesión; las sesiones remotas de Cowork se ejecutan en máquinas virtuales administradas por Anthropic, donde un archivo implementado en el dispositivo no está presente.
Las sesiones en proveedores de terceros como Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry, y Claude Platform en AWS no reciben configuración administrada por servidor, por lo que entregue la lista de permitidos a través de MDM o archivos de configuración administrada allí.
La entrega administrada por servidor también requiere que la sesión se autentique con un inicio de sesión o clave elegible. Las flotas que generan claves solo a través de un script apiKeyHelper deben entregar la lista de permitidos a través de MDM o archivos de configuración administrada.
La pestaña de código de escritorio también aloja sesiones SSH, que leen el archivo de configuración administrada del host remoto en el que se ejecutan. Consulte Configuración administrada de escritorio.
Los selectores de modelos en claude.ai y en la aplicación de escritorio ocultan o atenúan los modelos excluidos por la lista de permitidos de su organización. El estado del selector es una conveniencia para los usuarios; la aplicación ocurre en la sesión.

Comportamiento del modelo predeterminado

Por sí solo, availableModels deja la opción Predeterminado en el predeterminado de tiempo de ejecución del sistema para la cuenta hasta que también establezca enforceAvailableModels. Si ese predeterminado es un modelo que tiene la intención de restringir, establezca también enforceAvailableModels.

Una matriz availableModels vacía nunca activa la aplicación del modelo predeterminado: con availableModels: [], las selecciones de modelos nombrados se bloquean pero el modelo predeterminado para el tipo de cuenta sigue siendo utilizable independientemente de enforceAvailableModels.

Aplicar la lista de permitidos para el modelo predeterminado

Establezca enforceAvailableModels: true junto con un availableModels no vacío en la configuración administrada para extender la lista de permitidos a la opción Predeterminado. Esto requiere Claude Code v2.1.175 o posterior.

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

La opción Predeterminado se resuelve al predeterminado del tipo de cuenta, o al modelo predeterminado de organización cuando un administrador ha establecido uno. Cuando ese modelo no está en la lista de permitidos, la opción Predeterminado se resuelve en su lugar a la primera entrada availableModels que nombra un modelo permitido y disponible, y la fila Predeterminado del selector /model muestra ese modelo. Esto se aplica en todas partes donde se alcanza el predeterminado: inicio de sesión, seleccionar Predeterminado en /model, la palabra clave "default" en cadenas de modelo de respaldo, y el respaldo utilizado cuando se descarta una selección excluida.

enforceAvailableModels remapea la opción Predeterminado solo cuando availableModels no está vacío. Con availableModels: [], el modelo predeterminado para el tipo de cuenta sigue siendo utilizable, por lo que la configuración no puede bloquear a los usuarios de cada modelo. Cuando availableModels no está vacío pero ninguna entrada se resuelve a un modelo permitido y disponible, la aplicación se omite y Predeterminado se resuelve al predeterminado del tipo de cuenta, con una advertencia visible solo bajo --debug. Mantenga al menos una entrada garantizada disponible en la lista para evitar esto.

Implemente ambas claves juntas en la fuente administrada de mayor rango que entregue. De forma predeterminada, Claude Code lee solo esa fuente, por lo que un par colocado en un archivo de configuración administrada se ignora cuando la consola de administración entrega cualquier configuración; bajo la fusión de opción de participación en cómo Claude Code combina fuentes administradas, Claude Code aún ignora un mapa modelOverrides de una fuente clasificada por debajo de la que establece availableModels.

Controlar el modelo en el que se ejecutan los usuarios

La configuración model es una selección inicial, no una aplicación. Establece qué modelo está activo cuando comienza una sesión, pero los usuarios aún pueden abrir /model y seleccionar Predeterminado, que se resuelve al predeterminado de tiempo de ejecución del sistema independientemente de lo que se establezca model, a menos que enforceAvailableModels lo redirija.

Para controlar completamente la experiencia del modelo, combine estas configuraciones:

availableModels: restringe qué modelos nombrados pueden cambiar los usuarios
enforceAvailableModels: extiende la lista de permitidos availableModels a la opción Predeterminado, por lo que Predeterminado no puede resolverse a un modelo fuera de la lista
model: establece la selección de modelo inicial cuando comienza una sesión
ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL: controlan a qué se resuelven los alias sonnet, opus, haiku, y fable, y qué versión usa el predeterminado del tipo de cuenta

Este ejemplo inicia a los usuarios en Sonnet 4.5, limita el selector a Sonnet y Haiku, y asegura que Predeterminado se resuelva a un modelo en la lista de permitidos en lugar del predeterminado de nivel:

{
  "model": "claude-sonnet-4-5",
  "availableModels": ["claude-sonnet-4-5", "haiku"],
  "enforceAvailableModels": true,
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"
  }
}

Sin enforceAvailableModels o el bloque env, un usuario que selecciona Predeterminado en el selector obtiene el predeterminado de tiempo de ejecución en lugar de la versión fijada en model. Las dos configuraciones cubren diferentes alcances: enforceAvailableModels hace que Predeterminado obedezca la lista de permitidos, mientras que el bloque env fija qué versión se resuelve un alias permitido como sonnet. Use enforceAvailableModels solo cuando restringir familias de modelos sea suficiente; agregue el bloque env cuando también necesite fijar una versión específica.

Comportamiento de fusión

Cuando la configuración administrada que Claude Code aplica define availableModels, esa lista sola se aplica, aparte de una plataforma host que proporciona la suya propia: las entradas en la configuración de usuario, proyecto o local no pueden extenderla, y Claude Code nunca fusiona availableModels entre fuentes administradas tampoco; cómo Claude Code combina fuentes administradas indica qué lista de fuente se aplica. De lo contrario, las listas de la configuración de usuario, proyecto y local se concatenan y desduplican como otras configuraciones de matriz. Antes de Claude Code v2.1.175, las entradas de alcances de menor precedencia se fusionaban en la lista administrada en lugar de ser reemplazadas por ella.

Dentro de la lista efectiva, una entrada que nombra un modelo específico en una familia, ya sea un prefijo de versión o un ID de modelo completo, deshabilita la entrada de comodín de esa familia: ["sonnet", "claude-sonnet-4-5"] permite solo versiones de Sonnet 4.5, no cada modelo de Sonnet.

IDs de modelo de Mantle

Cuando el punto final de Amazon Bedrock Mantle está habilitado, las entradas en availableModels que comienzan con anthropic. se agregan al selector /model como opciones personalizadas y se enrutan al punto final de Mantle. Esta es una excepción a la coincidencia de alias descrita en Fijar modelos para implementaciones de terceros. La configuración aún restringe el selector a entradas enumeradas, y un ID de Mantle incrusta un nombre de familia, por lo que cuenta como una entrada específica y deshabilita el comodín de esa familia: junto con cualquier ID de Mantle, enumere los prefijos de versión o IDs completos que desea mantener seleccionables. Consulte Comportamiento de fusión.

Restricciones de modelo de organización

Los administradores de organización en planes Claude Enterprise restringen qué modelos pueden ejecutar los miembros deshabilitando modelos individuales en la consola de administración de claude.ai. Esta restricción se entrega con los derechos de la cuenta cuando Claude Code se autentica, separada de cualquier lista availableModels en la configuración, y el servidor aplica la misma restricción de forma independiente cuando se crea una sesión. Requiere Claude Code v2.1.187 o posterior.

La restricción se aplica cuando un miembro inicia sesión o usa su propia clave API. Las credenciales con alcance de organización, como las claves de servicio de organización, no están vinculadas a un usuario, por lo que la restricción no se aplica a ellas.

La consola de Claude no tiene control de restricción de modelo. Las organizaciones sin un plan Claude Enterprise, incluidas las cuyos miembros se autentican a través de la API de Anthropic, restringen modelos con availableModels en configuración administrada en su lugar, agregando enforceAvailableModels para cubrir la opción Predeterminado. Estas configuraciones se aplican por Claude Code mismo, no por el servidor.

Un modelo restringido se oculta del selector /model. Seleccionarlo por nombre con --model, la variable de entorno ANTHROPIC_MODEL, o la configuración model muestra el aviso Model "<name>" is restricted by your organization's settings. Using <model> instead. y la sesión comienza en un modelo permitido. Escribir /model <name> para un modelo restringido se rechaza con Model '<name>' is restricted by your organization's settings. Run /model to choose a different model. y la sesión mantiene su modelo actual.

Un alias de familia de modelos como opus se resuelve a su modelo habitual cuando la organización lo permite. Cuando la organización restringe ese modelo, Claude Code sustituye la versión más nueva de la familia que la organización permite, con el mismo aviso de sustitución. /model <alias> se rechaza solo cuando cada versión de su familia está restringida; un alias establecido con --model, ANTHROPIC_MODEL, o la configuración model aún se reemplaza al inicio en ese caso. Antes de v2.1.205, un alias de familia se sustituía o rechazaba basándose solo en su versión más nueva lanzada, incluso cuando se permitía una versión anterior.

Las restricciones se aplican en toda la organización o por rol:

Deshabilitar un modelo a nivel de organización lo elimina para cada miembro.
El acceso a nivel de rol otorga diferentes modelos a diferentes roles personalizados, y un miembro que tiene varios roles puede usar cualquier modelo que uno de sus roles otorgue.
Los modelos de Haiku siempre están disponibles y no se pueden deshabilitar, por lo que cada miembro mantiene al menos un modelo utilizable.
Un cambio de acceso entra en vigor en nuevas solicitudes dentro de aproximadamente un minuto; el selector /model lo refleja la próxima vez que comienza una sesión.

Ambas restricciones se aplican juntas: un modelo es seleccionable solo cuando está permitido por availableModels y no está restringido por la organización. Las restricciones de organización llegan a sesiones en la API de Anthropic y implementaciones de puerta de enlace LLM solo; en cualquier otro proveedor, use availableModels en su lugar.

Modelo predeterminado de la organización

Los administradores de la organización en planes Claude Enterprise pueden establecer un modelo predeterminado para los miembros de Claude Code desde la consola de administración de claude.ai, para toda la organización o por rol personalizado. Cuando se establece uno, la opción Predeterminado se resuelve a ese modelo. Requiere Claude Code v2.1.196 o posterior.

La fila Predeterminado en el selector /model muestra el nombre del modelo predeterminado de la organización con la etiqueta Predeterminado de org. La etiqueta dice Predeterminado de org tanto si el administrador estableció el predeterminado para toda la organización como para su rol. Un predeterminado de rol cubre a los miembros de ese rol personalizado y tiene prioridad sobre el predeterminado de toda la organización; cuando varios de sus roles establecen predeterminados diferentes, se aplica el modelo más capaz.

El modelo predeterminado de la organización es un punto de partida, no una restricción. Estas selecciones tienen prioridad sobre él:

la bandera --model y la variable de entorno ANTHROPIC_MODEL
un valor model en configuración administrada o suministrado a través de --settings
un valor model en su configuración de usuario, proyecto o local, incluido un modelo que guarde con /model

Los administradores también pueden configurar el modelo predeterminado de la organización para anular la selección del usuario. Con la anulación activada, tiene prioridad sobre el valor model en la configuración de usuario, proyecto y local, por lo que un modelo que guarde con /model se aplica para la sesión actual y el modelo predeterminado de la organización vuelve en el siguiente lanzamiento. Cuando su selección difiere, /model muestra Se aplica el predeterminado de su organización (<model>) al reiniciar. La bandera --model, ANTHROPIC_MODEL, la configuración administrada y --settings siguen teniendo prioridad incluso con la anulación activada. La anulación está disponible para un conjunto limitado de organizaciones; consulte con su equipo de cuenta de Anthropic sobre la disponibilidad.

Para limitar qué modelos pueden seleccionar los miembros, use restricciones de modelo de la organización o availableModels en su lugar.

Claude Code lee el modelo predeterminado de la organización una vez al inicio, por lo que un predeterminado que el administrador cambia a mitad de sesión entra en vigor en el siguiente lanzamiento.

Cuando el modelo predeterminado de la organización no anula la selección del usuario, el primer lanzamiento interactivo después de que el administrador lo cambie borra la clave model de su configuración de usuario una sola vez, por lo que se aplica el nuevo predeterminado. No cambia nada más en el archivo, y un modelo que guarde con /model después de ese lanzamiento se mantiene.

El modelo predeterminado de la organización pasa a través de estas comprobaciones de restricción antes de ser adoptado:

availableModels por sí solo no se aplica al modelo predeterminado de la organización, por lo que un modelo predeterminado de la organización fuera de la lista de permitidos sigue aplicándose. Cuando enforceAvailableModels también está establecido, un modelo predeterminado de la organización fuera de la lista de permitidos se remapea a la primera entrada de la lista de permitidos, como cualquier otro Predeterminado
un modelo predeterminado de la organización que restricciones de modelo de la organización deniegan para su cuenta se reemplaza por el modelo más reciente permitido en su familia, o una familia de menor costo cuando cada versión de ella está restringida
un modelo predeterminado de la organización que no está disponible para su cuenta en absoluto se omite, y la opción Predeterminado se resuelve como lo haría sin un modelo predeterminado de la organización

A partir de v2.1.199, cuando el modelo predeterminado de la organización es una familia de modelos diferente del predeterminado habitual del tipo de cuenta, el selector /model mantiene una fila separada para esa familia habitual, por lo que aún puede cambiar a ella para una sesión. En v2.1.196 a v2.1.198 esa fila falta en el selector.

El modelo predeterminado de la organización llega solo a sesiones autenticadas con la API de Anthropic. Para establecer un predeterminado en cualquier otro lugar, incluidas las implementaciones de puerta de enlace LLM, use la clave model en configuración administrada en su lugar.

Límites de esfuerzo de la organización

Los administradores de la organización en planes Claude Enterprise pueden establecer un nivel de esfuerzo máximo por modelo para cada rol personalizado, junto con restricciones de modelo de la organización a nivel de rol. Los niveles por encima del límite no se ofrecen en el selector /effort, y nombrar un nivel superior con --effort o /effort se ejecuta en el límite en su lugar. En sesiones interactivas y ejecuciones simples de texto --print, una advertencia nombra los niveles solicitados y aplicados; con salida json o stream-json o en agentes en segundo plano, el límite se aplica silenciosamente. Los límites son por modelo, por lo que cambiar de modelo puede cambiar qué niveles están disponibles. Cuando varios de sus roles otorgan el mismo modelo, se aplica el límite menos restrictivo. Requiere Claude Code v2.1.195 o posterior.

Los límites de esfuerzo se entregan junto con restricciones de modelo de la organización y llegan a las mismas sesiones.

Comportamiento especial del modelo

Configuración del modelo `default`

El comportamiento de default depende de tu tipo de cuenta:

Max, Team Premium, Enterprise y Anthropic API: por defecto Opus 5
Claude Platform en AWS, Amazon Bedrock y Agent Platform de Google Cloud: por defecto Opus 5
Pro y Team Standard: por defecto Sonnet 5
Microsoft Foundry: por defecto Sonnet 4.5

Antes de v2.1.219, default se resolvía a Opus 4.8 en Anthropic API, Max, Team Premium y Enterprise de pago por uso desde v2.1.154, y en Claude Platform en AWS, Amazon Bedrock y Agent Platform de Google Cloud desde v2.1.207. Antes de v2.1.207, default se resolvía a Opus 4.7 en Claude Platform en AWS y a Sonnet 4.5 en Amazon Bedrock y Agent Platform de Google Cloud.

Cuando un administrador ha establecido un modelo predeterminado de la organización, default se resuelve a ese modelo en lugar del predeterminado del tipo de cuenta anterior. Requiere Claude Code v2.1.196 o posterior. default también puede resolverse al modelo que estableces con ANTHROPIC_DEFAULT_MODEL, bajo las condiciones enumeradas en su sección.

Cuando la configuración administrada aplica la lista de permitidos para el modelo Default y el predeterminado del tipo de cuenta no está en availableModels, default se resuelve al Default aplicado en lugar del predeterminado del tipo de cuenta anterior. Cuando ambos se aplican, el modelo predeterminado de la organización reemplaza primero el predeterminado del tipo de cuenta y luego se aplica la aplicación: se mantiene un modelo predeterminado de la organización en la lista de permitidos, mientras que uno fuera de la lista se resuelve al Default aplicado.

Los modelos Fable no son el predeterminado del tipo de cuenta en ningún plan o proveedor. Elegir uno con /model lo guarda como el modelo seleccionado en la configuración del usuario, por lo que las sesiones posteriores comienzan en él. Para el cambio único que Claude Code realiza en una selección de Fable 5 guardada en v2.1.255, consulta Trabajar con Fable.

Configuración del modelo `opusplan`

El alias del modelo opusplan proporciona un enfoque híbrido automatizado:

En modo plan: utiliza opus para razonamiento complejo y decisiones de arquitectura
En modo ejecución: cambia automáticamente a sonnet para generación de código e implementación

Esto combina el razonamiento de Opus para la planificación con la eficiencia de Sonnet para la ejecución.

La fase Opus del modo plan utiliza la misma ventana de contexto que la configuración del modelo opus. En los niveles de suscripción donde Opus se actualiza automáticamente a contexto de 1M, opusplan recibe la actualización en modo plan también. Para forzar contexto de 1M para ambas fases cuando no estás en un nivel de actualización automática, establece el modelo a opusplan[1m].

Cuando availableModels excluye el Opus más nuevo pero permite una versión anterior, por ejemplo ["sonnet", "claude-opus-4-6"], opusplan utiliza el Opus más nuevo permitido para la planificación y se mantiene solo en Sonnet cuando se excluye cada Opus. Una sesión de Haiku que normalmente se actualizaría a Sonnet en modo plan utiliza asimismo el Sonnet más nuevo permitido, y se mantiene solo en Haiku cuando se excluye cada Sonnet. Antes de v2.1.205, el modo plan se mantenía en el modelo de la sesión siempre que se excluía la versión más nueva de la familia de actualización, incluso cuando la lista de permitidos permitía una anterior.

La sustitución de una versión anterior permitida se aplica en Anthropic API y Claude Platform en AWS. En Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry y Mantle, cuyas implementaciones utilizan ID de modelo específicos del proveedor, el modo plan se mantiene en el modelo de la sesión siempre que se excluya el modelo de actualización.

Para un enfoque híbrido donde Claude decide a mitad de la tarea cuándo consultar un segundo modelo en lugar de cambiar en el límite del plan, consulta la herramienta de asesor.

Cadenas de modelos de reserva

Cuando el modelo principal está sobrecargado, no disponible o devuelve otro error de servidor no reintentable, Claude Code puede cambiar a un modelo de reserva en lugar de fallar la solicitud. Los errores de autenticación, facturación, límite de velocidad, tamaño de solicitud y transporte, y una denegación por la verificación de política de tu organización, nunca desencadenan un cambio; esos siguen su manejo normal de reintentos y errores.

Configura uno o más modelos de reserva y Claude Code los intenta en orden, mostrando un aviso cuando cambia. El cambio dura solo el turno actual, por lo que tu siguiente mensaje intenta el modelo principal primero de nuevo. Claude Code limita las cadenas a tres modelos después de la eliminación de duplicados e ignora entradas adicionales.

Establece una cadena para una sesión con la bandera --fallback-model, que acepta una lista separada por comas:

claude --fallback-model sonnet,haiku

Para persistir una cadena entre sesiones, establece fallbackModel en configuración como un array:

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

La bandera --fallback-model tiene precedencia sobre la configuración fallbackModel. Cada entrada acepta un nombre de modelo o alias, y "default" se expande al modelo predeterminado.

Claude Code no confirma la cadena al inicio y /status no la muestra. El aviso mostrado cuando ocurre un cambio es el primer signo visible de que una reserva está configurada.

Cuando una solicitud falla, Claude Code intenta cada entrada en orden hasta que una la acepta. Una entrada que tampoco se puede alcanzar, como un modelo retirado fijado en la configuración, falla a la siguiente de la misma manera. Claude Code elimina dos tipos de entrada antes de ese recorrido:

Fuera de la lista de permitidos: Claude Code descarta cualquier entrada no permitida por availableModels cuando lee la cadena.
Ventana de contexto más pequeña durante la compactación: la cadena también cubre compactación, pero Claude Code no recurrirá a un modelo con una ventana de contexto más pequeña que la del principal, ya que resumir allí cortaría parte de la conversación primero. Si cada reserva es más pequeña, la compactación muestra el error original y puedes reintentar.

Claude Code también aplica la cadena a subagentes. Cuando la solicitud de un subagente falla, Claude Code intenta tus modelos de reserva configurados en orden, y el subagente continúa en el modelo que acepta la solicitud. El modelo de tu sesión no cambia. Antes de v2.1.247, un fallo que la cadena cubría terminaba el subagente.

Reserva automática de modelo

Esta sección cubre la reserva basada en contenido de modelos Fable y Opus 5. Para la reserva basada en disponibilidad cuando un modelo está sobrecargado o no disponible, consulta Cadenas de modelos de reserva.

Los modelos Fable y Opus 5 se ejecutan con clasificadores de seguridad, que con mayor frecuencia marcan contenido de ciberseguridad y biología. Cuando un clasificador marca una solicitud y la categoría marcada tiene un modelo de reserva, Claude Code vuelve a ejecutar la solicitud en ese modelo y muestra un aviso en la transcripción. Para esas dos categorías, el modelo de reserva depende de qué modelo rechazó:

Fable 5.1 y Fable 5: las solicitudes marcadas por biología se vuelven a ejecutar en Opus 5, y las solicitudes marcadas por ciberseguridad se vuelven a ejecutar en Opus 4.8.
Opus 5: las solicitudes marcadas por ciberseguridad se vuelven a ejecutar en Opus 4.8. Las solicitudes marcadas por biología terminan con un rechazo en su lugar, porque Opus 5 ejecuta sus propios clasificadores de biología sin modelo de reserva.

En Amazon Bedrock, Agent Platform de Google Cloud y Microsoft Foundry, Claude Code resuelve estos objetivos a través de tu implementación, y si estableces ANTHROPIC_DEFAULT_OPUS_MODEL, las categorías que tienen una reserva se vuelven a ejecutar en el modelo fijado; consulta Habilitar reserva en Bedrock, Agent Platform y Foundry.

Después de una reserva, la sesión continúa en el modelo de reserva. Para volver a tu modelo original, ejecuta /model.

La reserva basada en categoría requiere Claude Code v2.1.219 o posterior. Antes de v2.1.219, cada solicitud de Fable 5 marcada se volvía a ejecutar en el modelo Opus predeterminado de tu proveedor, y Opus 5 no era una fuente de reserva.

El modelo de reserva se verifica contra availableModels. Cuando está bloqueado, no ocurre reserva. El rechazo se muestra como un error normal y el modelo de la sesión no cambia.

Verificar qué desencadenó la reserva

La reserva puede desencadenarse en la primera solicitud de una sesión, antes de que envíes algo inusual, porque la primera solicitud lleva contexto del espacio de trabajo como tu contenido de CLAUDE.md y estado de git. Un repositorio que contiene material de seguridad o biología puede activar el clasificador solo en ese contexto.

Para verificar si las personalizaciones son el desencadenante, inicia una sesión con claude --safe-mode, que desactiva personalizaciones como CLAUDE.md, skills, servidores MCP y hooks. El estado de git y los nombres de directorios no son personalizaciones y aún se incluyen.

Preguntar antes de cambiar

Para decidir qué sucede cada vez que se marca una solicitud, en lugar de cambiar automáticamente, ejecuta /config y desactiva Cambiar modelos cuando se marca un mensaje, o establece switchModelsOnFlag a false en tu archivo de configuración. Una solicitud marcada pausa la sesión con dos opciones: cambiar al modelo de reserva, o editar el mensaje y reintentar en el modelo actual.

Algunos casos se comportan de manera diferente:

Cuando la categoría marcada no tiene modelo de reserva, como una marca de biología en Opus 5, Claude Code no muestra el mensaje y la solicitud termina con el rechazo.
Si ambos modelos marcan la misma solicitud, puedes editar el mensaje e intentar de nuevo, o iniciar una nueva sesión.
En sesiones móviles de Claude Code en la web, no se admite edición y reintento. Cambia modelos, o continúa la sesión desde un navegador de escritorio o la aplicación de escritorio.
En modo no interactivo e integraciones de SDK que no pueden mostrar el mensaje, una solicitud marcada termina el turno con un rechazo.
Cuando el objetivo de reserva está bloqueado por availableModels, Claude Code no muestra el mensaje. La solicitud marcada termina con el rechazo, igual que la reserva automática cuando el objetivo está bloqueado.

Habilitar reserva en Bedrock, Agent Platform y Foundry

En Amazon Bedrock, Agent Platform de Google Cloud y Microsoft Foundry, los ID de modelo son específicos del proveedor, por lo que la reserva automática solo funciona cuando Claude Code puede identificar ambos modelos involucrados:

Claude Code debe reconocer el modelo actual como una fuente de reserva. Fable 5.1 y Fable 5 se reconocen cuando el ID del modelo contiene claude-fable-5, coincide con el valor de ANTHROPIC_DEFAULT_FABLE_MODEL, o se asigna con modelOverrides. Opus 5 se reconoce por su ID de modelo del proveedor o una asignación de modelOverrides.
El modelo de reserva debe resolverse en tu implementación. Si estableces ANTHROPIC_DEFAULT_OPUS_MODEL, las solicitudes marcadas se vuelven a ejecutan en ese modelo para cada categoría que tiene una reserva; una marca de biología en Opus 5 aún termina con un rechazo. Si no lo estableces, las solicitudes marcadas por ciberseguridad se vuelven a ejecutan en una entrada de Opus 4.8 en la lista de modelos del proveedor, y las solicitudes marcadas por biología de un modelo Fable en una entrada de Opus 5.

Si alguno de los modelos no se puede identificar, Claude Code no cambia automáticamente. La solicitud marcada termina con un mensaje de rechazo, y puedes cambiar modelos con /model e intentar de nuevo. Establecer ANTHROPIC_DEFAULT_FABLE_MODEL a tu ID de modelo Fable habilita el reconocimiento de Fable. Establecer ANTHROPIC_DEFAULT_OPUS_MODEL a un ID de modelo Opus proporciona un objetivo de reserva para las categorías marcadas, a menos que el pin nombre un modelo fuera de la familia Opus o el modelo que rechazó; entonces Claude Code no cambia y el rechazo se mantiene.

Investigación de seguridad y cargas de trabajo de biología

Las cargas de trabajo en seguridad ofensiva o biología, incluidas pruebas de penetración, ejercicios Capture the Flag (CTF) y bases de código adyacentes a biología, desencadenan reserva frecuentemente, a menudo en la primera solicitud. Para trabajo sustancial de biología en Fable 5.1 o Fable 5, Claude Code mueve la sesión a Opus 5 en la primera solicitud marcada, y las solicitudes posteriores marcadas por biología terminan en rechazos allí, porque Opus 5 no tiene reserva de biología. En Opus 5, obtienes esos rechazos desde la primera solicitud marcada.

Este es el enrutamiento esperado para estos dominios, no una marca de cuenta. Si tu organización necesita capacidad de clase Fable para este trabajo, pregunta a tu equipo de cuenta de Anthropic sobre programas de acceso de confianza.

Ajustar el nivel de esfuerzo

Los niveles de esfuerzo controlan el razonamiento adaptativo, que permite al modelo decidir si y cuánto pensar en cada paso según la complejidad de la tarea. El esfuerzo menor es más rápido y económico para tareas sencillas, mientras que el esfuerzo mayor proporciona razonamiento más profundo para problemas complejos.

Los niveles de esfuerzo disponibles dependen del modelo. Los modelos no enumerados aquí no admiten esfuerzo:

Modelo	Niveles
Fable 5.1 y Fable 5	`low`, `medium`, `high`, `xhigh`, `max`
Opus 5, Sonnet 5, Opus 4.8 y Opus 4.7	`low`, `medium`, `high`, `xhigh`, `max`
Opus 4.6 y Sonnet 4.6	`low`, `medium`, `high`, `max`

Si estableces un nivel que el modelo activo no admite, Claude Code recurre al nivel más alto admitido en o por debajo del que estableces. Por ejemplo, xhigh se ejecuta como high en Opus 4.6. Tu organización también puede limitar qué niveles están disponibles para un modelo; consulta Límites de esfuerzo de la organización.

Con la configuración ultracode desactivada, Claude Code resuelve el nivel de esfuerzo de la sesión en este orden, tomando el primero que se aplique:

Una opción explícita: la variable de entorno CLAUDE_CODE_EFFORT_LEVEL, lanzar con --effort, o /effort en la sesión (un /effort no interactivo tiene efecto más estrecho)
El esfuerzo predeterminado del modelo, en Fable 5, Opus 4.8 u Opus 4.7: desde la primera vez que ejecutas uno de estos modelos, Claude Code mantiene el esfuerzo predeterminado de ese modelo entre sesiones, incluso cuando tu configuración resuelve un nivel diferente, hasta que cambies el esfuerzo una vez, por ejemplo con un /effort interactivo, el control deslizante de esfuerzo del selector /model, o --effort al lanzar. Opus 5 y Fable 5.1 no tienen tal retención
Tu configuración: el nivel que guardaste para el modelo o una clave effortLevel, con la precedencia entre ellos y entre archivos de configuración indicada en modelSettings
El esfuerzo predeterminado del modelo: high en cada modelo que admite esfuerzo, excepto que Opus 4.7 por defecto es xhigh y, cuando tu organización establece un nivel de esfuerzo predeterminado para su modelo predeterminado de la organización, ese nivel es el predeterminado cuando ejecutas ese modelo

Cuando estableces low, medium, high o xhigh en una sesión interactiva en tu máquina, Claude Code guarda el nivel y lo aplica en sesiones posteriores. Guarda el nivel por modelo, bajo la clave modelSettings en tu configuración de usuario, por lo que cada modelo mantiene su propio nivel guardado.

max es el nivel de razonamiento más profundo. A menos que lo establezas a través de la variable de entorno CLAUDE_CODE_EFFORT_LEVEL, Claude Code aplica max solo a la sesión actual.

Un nivel establecido con /effort en modo no interactivo, con la bandera -p, se aplica solo a la sesión actual y no se guarda como tu predeterminado. Tampoco cuenta como el cambio que termina el paso predeterminado del modelo anterior en Fable 5, Opus 4.8 u Opus 4.7: mientras ese paso esté en efecto, un /effort no interactivo reporta Not applied, así que pasa --effort al lanzar en su lugar.

El menú /effort también ofrece ultracode. Ultracode es una configuración de Claude Code en lugar de un nivel de esfuerzo del modelo: envía xhigh al modelo y además tiene Claude orquestar flujos de trabajo dinámicos para tareas sustanciales. Para dónde se puede establecer persistentemente, consulta la configuración ultracode.

Puedes activar ultracode a través de cualquiera de los siguientes:

/effort: ejecuta /effort ultracode, o selecciónalo del menú
Bandera --effort: lanza con claude --effort ultracode, que inicia la sesión con esfuerzo xhigh y ultracode activado
Configuración ultracode: establece "ultracode": true en un archivo de configuración, con --settings, o en una solicitud de control del Agent SDK. Una solicitud applyFlagSettings() también acepta effortLevel: "ultracode"
Selector /model: mueve el control deslizante de esfuerzo a ultracode con las teclas de flecha mientras eliges un modelo. Claude Code lo activa para la sesión actual, incluso cuando guardas ese modelo como tu predeterminado

Pasar ultracode a la bandera --effort o al valor effortLevel del Agent SDK requiere Claude Code v2.1.203 o posterior. Antes de v2.1.203, --effort ultracode imprimía Unknown --effort value 'ultracode' y la sesión comenzaba con el esfuerzo predeterminado.

La configuración effortLevel persistida y la variable de entorno CLAUDE_CODE_EFFORT_LEVEL no aceptan ultracode. Cuando CLAUDE_CODE_EFFORT_LEVEL se establece a un nivel distinto de xhigh, las solicitudes se ejecutan en ese nivel y la orquestación de flujo de trabajo de ultracode permanece inactiva. Seleccionar ultracode entonces muestra una advertencia de que la variable de entorno anula el esfuerzo para la sesión.

Cuando ultracode no está disponible, por ejemplo cuando los flujos de trabajo están desactivados, --effort ultracode establece solo esfuerzo xhigh.

Elegir un nivel de esfuerzo

Cada nivel intercambia gasto de tokens contra capacidad. El predeterminado se adapta a la mayoría de tareas de codificación; ajusta cuando quieras un equilibrio diferente.

Nivel	Cuándo usarlo
`low`	Reserva para tareas cortas, limitadas y sensibles a la latencia que no son sensibles a la inteligencia
`medium`	Reduce el uso de tokens para trabajo sensible a costos que puede sacrificar algo de inteligencia
`high`	Equilibra el uso de tokens e inteligencia. El predeterminado en cada modelo excepto Opus 4.7
`xhigh`	Razonamiento más profundo con mayor gasto de tokens. El predeterminado en Opus 4.7
`max`	Puede mejorar el rendimiento en tareas exigentes pero puede mostrar rendimientos decrecientes y es propenso al exceso de pensamiento. Prueba antes de adoptar ampliamente
`ultracode`	Una configuración de Claude Code que planifica un flujo de trabajo dinámico para cada tarea sustancial con razonamiento `xhigh` por mensaje

La escala de esfuerzo se calibra por modelo, por lo que el mismo nombre de nivel no representa el mismo valor subyacente entre modelos.

Usar ultrathink para razonamiento profundo único

Incluye ultrathink en cualquier lugar de tu mensaje para solicitar razonamiento más profundo en ese turno sin cambiar tu configuración de esfuerzo de sesión. Claude Code reconoce la palabra clave y agrega una instrucción en contexto. El nivel de esfuerzo enviado a la API no cambia. Claude Code pasa otras frases como "think", "think hard" y "think more" como texto de mensaje ordinario y no las reconoce como palabras clave.

Establecer el nivel de esfuerzo

Puedes cambiar el esfuerzo a través de cualquiera de los siguientes:

/effort: ejecuta /effort sin argumentos para abrir un control deslizante interactivo, /effort seguido de un nombre de nivel para establecerlo directamente, o /effort auto para borrar tu nivel guardado para el modelo activo. Puedes ejecutarlo mientras Claude está trabajando, y una vez que confirmes la advertencia de caché, si Claude Code muestra una, Claude Code aplica el nuevo nivel a la siguiente solicitud en el turno
En /model: usa las teclas de flecha izquierda/derecha para ajustar el control deslizante de esfuerzo cuando selecciones un modelo
Bandera --effort: pasa un nombre de nivel para establecerlo para una única sesión cuando lanzas Claude Code
Variable de entorno: establece CLAUDE_CODE_EFFORT_LEVEL a un nombre de nivel o auto
Configuración: establece un nivel por modelo en modelSettings, o establece effortLevel a low, medium, high o xhigh como el predeterminado para modelos sin uno. max no se acepta en ninguna clave, y ultracode tiene su propia clave ultracode
Desde un dispositivo conectado: en una sesión de Control Remoto, elige un nivel del control de esfuerzo en tu teléfono o en tu navegador. El nivel se aplica solo a la sesión actual. Requiere Claude Code v2.1.234 o posterior
Frontmatter de skill y subagente: establece effort en un archivo markdown de skill o subagente para anular el nivel de esfuerzo cuando ese skill o subagente se ejecuta

El esfuerzo de frontmatter se aplica cuando ese skill o subagente está activo, anulando el nivel de sesión pero no la variable de entorno.

La clave effortLevel en configuración administrada es un predeterminado inicial, no aplicación: los usuarios pueden cambiarlo para una sesión con /effort o --effort, y el valor administrado se reafirma como el predeterminado en nuevas sesiones.

El control deslizante de esfuerzo aparece en /model cuando se selecciona un modelo admitido. El nivel de esfuerzo actual también se muestra en el encabezado de la sesión junto al nombre del modelo, por ejemplo "with low effort", para que puedas confirmar qué configuración está activa sin abrir /model. El pie de página también muestra brevemente el nivel de esfuerzo al inicio y cuando cambia.

Razonamiento adaptativo y presupuestos de pensamiento fijo

El razonamiento adaptativo hace que el pensamiento sea opcional en cada paso, por lo que Claude puede responder más rápido a mensajes rutinarios y reservar pensamiento más profundo para pasos que se benefician de él. Si quieres que Claude piense más o menos a menudo de lo que el nivel actual produce, puedes decirlo directamente en tu mensaje o en CLAUDE.md; el modelo responde a esa orientación dentro de su configuración de esfuerzo.

Fable 5.1, Fable 5, Sonnet 5 y Opus 4.7 y posterior siempre utilizan razonamiento adaptativo. El modo de presupuesto de pensamiento fijo y CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING no se aplican a ellos.

En Opus 4.6 y Sonnet 4.6, puedes establecer CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 para revertir al modo de presupuesto de pensamiento fijo anterior controlado por MAX_THINKING_TOKENS. Consulta variables de entorno.

Pensamiento extendido

El pensamiento extendido es el razonamiento que Claude emite antes de responder. En modelos que admiten razonamiento adaptativo, el nivel de esfuerzo es el control principal de cuánto pensamiento ocurre; las configuraciones a continuación activan o desactivan el pensamiento y controlan cómo se muestra. Con el pensamiento desactivado en Anthropic API, Claude Code envía esfuerzo high en lugar de un nivel más alto a modelos que sabe que no aceptan esa combinación, como Opus 5.

Control	Cómo establecerlo
Alternar para la sesión actual	Presiona `Option+T` en macOS o `Alt+T` en Windows y Linux
Establecer el predeterminado global	Ejecuta `/config` y alterna el modo de pensamiento. Se guarda como `alwaysThinkingEnabled` en `~/.claude/settings.json`
Desactivar a través de una variable de entorno	Establece `MAX_THINKING_TOKENS=0`, que desactiva el pensamiento en Anthropic API excepto en Fable 5.1 y Fable 5. En proveedores de terceros esto omite el parámetro `thinking` en su lugar, y los modelos de razonamiento adaptativo aún pueden pensar. Otros valores se aplican solo con un presupuesto de pensamiento fijo

El pensamiento no se puede desactivar en Fable 5.1 o Fable 5. El alternador de sesión, alwaysThinkingEnabled y MAX_THINKING_TOKENS=0 no tienen efecto allí, y el modelo decide por paso cuánto pensar según el nivel de esfuerzo.

Claude Code colapsa la salida de pensamiento por defecto. Presiona Ctrl+O para alternar el modo detallado y ver el razonamiento como texto gris en cursiva. Las sesiones interactivas en Anthropic API reciben bloques de pensamiento redactados por defecto, así que establece showThinkingSummaries: true en configuración si quieres los resúmenes completos disponibles cuando expandes. Se te cobra por todos los tokens de pensamiento generados, incluso cuando están colapsados o redactados.

Contexto extendido

Fable 5.1, Fable 5, Sonnet 5, Opus 4.6 y posterior, y Sonnet 4.6 admiten una ventana de contexto de 1 millón de tokens para sesiones largas con bases de código grandes.

La disponibilidad varía según el modelo y el plan. En Anthropic API, Fable 5.1, Fable 5, Sonnet 5 y Opus 4.7 y posterior se ejecutan con la ventana de 1M por defecto.

En planes Max, Team y Enterprise, incluidos tanto asientos de Team Standard como Team Premium, Opus se actualiza automáticamente a contexto de 1M sin configuración adicional. Sonnet 4.6 con contexto de 1M no es parte de la actualización automática y requiere créditos de uso en cada plan de suscripción, incluido Max.

Plan	Opus con contexto de 1M	Sonnet 4.6 con contexto de 1M
Max, Team y Enterprise	Incluido con suscripción	Requiere créditos de uso
Pro	Requiere créditos de uso	Requiere créditos de uso
API y pago por uso	Acceso completo	Acceso completo

Claude Code verifica estos requisitos de plan solo cuando se conecta directamente a Anthropic API. Si apuntas ANTHROPIC_BASE_URL a una puerta de enlace LLM y tu inicio de sesión guardado de claude.ai permanece como la credencial activa, Claude Code no verifica tus créditos de uso del plan. Las opciones [1m] permanecen disponibles en /model, y la puerta de enlace decide si la solicitud tiene éxito. Antes de v2.1.229, Claude Code rechazaba /model sonnet[1m] en esa configuración cuando no podía confirmar créditos de uso en la cuenta.

Para desactivar contexto de 1M, establece CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Claude Code elimina variantes de modelo de 1M del selector de modelo. En modelos con una ventana nativa de 1M, como Sonnet 5 y los modelos Fable, también trata el modelo como si tuviera una ventana de contexto de 200K:

Con auto-compactación activada, las sesiones se compactan en el límite de 200K a través de auto-compactación. Establecer la ventana de auto-compactación por encima de 200K no levanta la retención, porque Claude Code limita esa ventana a la ventana de contexto del modelo.
Con auto-compactación desactivada, las sesiones se detienen en el límite de 200K con el error de límite de contexto en lugar de compactarse.

Antes de v2.1.223, Claude Code mantenía solo sesiones de Sonnet 5, Opus 4.8 y Opus 5 a 200K. Consulta variables de entorno.

La ventana de contexto de 1M utiliza precios de modelo estándar sin prima para tokens más allá de 200K. Para planes donde el contexto extendido se incluye con tu suscripción, el uso permanece cubierto por tu suscripción. Para planes que acceden a contexto extendido a través de créditos de uso, los tokens se facturan a créditos de uso.

Si tu cuenta admite contexto de 1M, la opción aparece en el selector /model en las últimas versiones de Claude Code. Si no la ves, intenta reiniciar tu sesión.

También puedes usar el sufijo [1m] con alias de modelo o nombres de modelo completos:

# Usa el alias opus[1m] o sonnet[1m]
/model opus[1m]
/model sonnet[1m]

# O agrega [1m] a un nombre de modelo completo
/model claude-opus-4-8[1m]

Ventana de contexto de Sonnet 5

En Anthropic API, Sonnet 5 siempre se ejecuta con la ventana de contexto de 1M. No hay variante de 200K, no hay sufijo [1m] para seleccionar, y no se requieren créditos de uso en ningún plan. Las sesiones se auto-compactan antes de que la ventana se llene, a aproximadamente 967K tokens por defecto; establece CLAUDE_CODE_AUTO_COMPACT_WINDOW para elegir un umbral diferente.

Dos configuraciones presupuestan la ventana en 200K en su lugar:

Puerta de enlace LLM: cuando ANTHROPIC_BASE_URL apunta a una puerta de enlace, Claude Code no puede verificar soporte de 1M. Para usar la ventana completa, selecciona Sonnet 5 (1M context) en el selector de modelo, que se asigna a sonnet[1m].
CLAUDE_CODE_DISABLE_1M_CONTEXT=1: mantiene sesiones en cada modelo con una ventana nativa de 1M a una ventana de 200K; consulta Contexto extendido para cómo se aplica la retención. Útil para implementaciones que necesitan limitar el contexto.

Ventana de contexto y auto-compactación

La ventana de auto-compactación es qué tan llena puede estar la ventana de contexto antes de que Claude Code compacte la conversación. Para ver qué compactación conserva y descarta por mecanismo, consulte Lo que sobrevive a la compactación.

Establecer la ventana de auto-compactación

Puede establecer la ventana de auto-compactación en tres lugares:

Para esta sesión y las posteriores: ejecute /autocompact con un valor, como /autocompact 500k. Claude Code lo guarda en la configuración de usuario como autoCompactWindow y lo aplica a la sesión actual; si un ámbito de configuración de mayor prioridad, como la configuración administrada, establece la clave, el comando guarda su valor pero la sesión mantiene la ventana de ese ámbito, y el comando lo indica. Ejecute /autocompact auto para volver a la ventana ajustada para su modelo.
Para un lanzamiento: pase --autocompact al iniciar Claude Code. La bandera anula su configuración guardada para ese lanzamiento sin cambiarla, y claude --autocompact auto ejecuta la sesión en la ventana ajustada incluso si su configuración guardada tiene un valor. A diferencia de /autocompact, la bandera no es anulada por un ámbito de configuración de mayor prioridad, como la configuración administrada.
En scripts y entornos en la nube: establezca CLAUDE_CODE_AUTO_COMPACT_WINDOW. Mientras esté establecida, tiene precedencia sobre el comando, la bandera y la configuración, y /autocompact reporta la anulación en lugar de cambiar la ventana.

El comando y la bandera aceptan un tamaño de ventana de 100K a 1M de tokens, en cualquiera de estas formas:

Un recuento de tokens simple, como 200000
Un sufijo k o M, como 500k o 1M
Un número simple de 100 a 1000, que significa miles, por lo que 200 establece 200.000

La variable de entorno acepta solo el recuento de tokens simple. Claude Code limita la ventana al tamaño de la ventana de contexto del modelo.

Umbrales de auto-compactación predeterminados

Si no establece una ventana de auto-compactación, Claude Code compacta cuando la conversación alcanza el límite de contexto del modelo, excepto en estas sesiones:

Las sesiones en la nube se compactan cuando la conversación se acerca al límite del modelo
Sonnet 4.6 y Opus 4.6 sin contexto extendido se compactan en el límite de 200K, y también lo hacen Opus 4.8 y Opus 5 cuando se ejecutan con una ventana de contexto de 200K, como en Amazon Bedrock, Google Cloud's Agent Platform y Microsoft Foundry
Cuando establece CLAUDE_CODE_DISABLE_1M_CONTEXT=1, los modelos con una ventana nativa de 1M, como Sonnet 5 y los modelos Fable, se compactan en el límite de 200K
Sonnet 5 se compacta en el umbral para su configuración
Las sesiones en un ID de modelo que Claude Code no reconoce, como un alias de puerta de enlace LLM, se compactan en la ventana de contexto que Claude Code asume para el ID; consulte Corregir la ventana para una puerta de enlace o ID de modelo personalizado

Corregir la ventana para una puerta de enlace o ID de modelo personalizado

En una puerta de enlace LLM u otra implementación personalizada, Claude Code puede asumir una ventana de contexto para el ID del modelo que difiere de la ventana real del modelo, independientemente de si resuelve el ID a un modelo Claude. CLAUDE_CODE_MAX_CONTEXT_TOKENS declara la ventana que Claude Code debe asumir en su lugar. Cómo se aplica la variable depende del ID. Un ID no reconocido, un ID [1m] no reconocido y un ID que comienza con claude- o se resuelve a un modelo Claude son tres casos separados:

Si el ID no comienza con claude- ni contiene [1m], en cualquier caso, y Claude Code no puede resolverlo a un modelo Claude, la variable se aplica directamente y la compactación proactiva continúa en la ventana declarada.
Si el ID no comienza con claude- pero contiene [1m], en cualquier caso, y Claude Code no puede resolverlo a un modelo Claude, Claude Code asume una ventana de 1M para él y la variable no se aplica por sí sola. Para corregir la ventana mientras se mantiene la compactación proactiva, también establezca CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Con una ventana declarada superior a 200K, Claude Code muestra una advertencia de inicio de que el límite de 200K no se aplica. La advertencia es esperada en esta configuración.
Si el ID comienza con claude- en cualquier caso o se resuelve a un modelo Claude, la variable tiene efecto solo cuando DISABLE_COMPACT también está establecida, lo que desactiva toda compactación. Por ejemplo, Claude Code resuelve un ID que contiene un nombre de modelo Claude, como anthropic/claude-opus-4-8 o us.anthropic.claude-…-v1:0, a ese modelo. Esto incluye IDs que también contienen [1m]: Claude Code resuelve claude-opus-4-8[1m] a Opus 4.8 incluso con CLAUDE_CODE_DISABLE_1M_CONTEXT establecida.

Para un ID de modelo que Claude Code no reconoce, establezca CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 para que Claude Code compacte solo después de que la API rechace la conversación con un error demasiado largo que Claude Code reconoce. Claude Code no ejecuta esa recuperación cuando una puerta de enlace reescribe el error a una redacción que Claude Code no reconoce.

Verificar su modelo actual

Puede ver qué modelo está utilizando actualmente en dos lugares:

En la línea de estado, si tiene una configurada
En /status, que también muestra la información de su cuenta

Agregar una opción de modelo personalizado

Utilice ANTHROPIC_CUSTOM_MODEL_OPTION para agregar una única entrada personalizada al selector /model sin reemplazar los alias integrados. Esto es útil para probar IDs de modelo que Claude Code no enumera de forma predeterminada. Para implementaciones de puerta de enlace LLM, Claude Code puede completar automáticamente el selector desde el punto final /v1/models de la puerta de enlace cuando se establece CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1, por lo que esta variable solo es necesaria cuando el descubrimiento está deshabilitado o no devuelve el modelo que desea. Consulte descubrimiento de modelo de puerta de enlace.

Para enumerar varios modelos en su propio orden y bajo etiquetas que elija, establezca modelPicker. Su entrada indica qué filas mantiene el selector cuando esa alineación reemplaza la integrada.

Este ejemplo establece las tres variables para hacer que una implementación de Opus enrutada por puerta de enlace sea seleccionable. Claude Code lee variables de entorno al iniciarse, por lo que ejecute las exportaciones antes de lanzar claude, o reinicie una sesión existente para aplicarlas:

export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-5"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"

ANTHROPIC_CUSTOM_MODEL_OPTION_NAME y ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION son opcionales:

Si omite el nombre, la entrada muestra el nombre del modelo cuando Claude Code reconoce el ID, y el ID del modelo en caso contrario.
Si omite la descripción, Claude Code utiliza Custom model (<model-id>).

Claude Code enumera la entrada personalizada después de las entradas integradas, y cualquier fila de modelPicker que agregue viene después de ella.

Claude Code omite la validación para el ID de modelo establecido en ANTHROPIC_CUSTOM_MODEL_OPTION, por lo que puede utilizar cualquier cadena que su punto final de API acepte.

Cuando availableModels está establecido, incluya también el ID de modelo personalizado en la lista de permitidos. De lo contrario, Claude Code filtra la entrada personalizada del selector y rechaza una selección de --model de la misma como cualquier otro modelo excluido.

Un ID personalizado que incrusta un nombre de familia, como my-gateway/claude-opus-5, cuenta como una entrada específica para esa familia y deshabilita su comodín, por lo que también debe enumerar las versiones que desea mantener seleccionables. Consulte Comportamiento de fusión.

Variables de entorno

Utilice las siguientes variables de entorno para controlar los nombres de modelo a los que se asignan los alias. Cada valor debe ser un nombre de modelo completo, o el identificador equivalente para su proveedor de API. Para elegir el modelo en el que comienzan sus sesiones, establezca ANTHROPIC_DEFAULT_MODEL, que esta tabla omite.

Variable de entorno	Descripción
`ANTHROPIC_DEFAULT_FABLE_MODEL`	El modelo a utilizar para `fable`, y el ID de modelo que Claude Code reconoce como modelo Fable para alternancia automática de modelo en proveedores de terceros
`ANTHROPIC_DEFAULT_OPUS_MODEL`	El modelo a utilizar para `opus`, o para `opusplan` cuando Plan Mode está activo.
`ANTHROPIC_DEFAULT_SONNET_MODEL`	El modelo a utilizar para `sonnet`, o para `opusplan` cuando Plan Mode no está activo.
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	El modelo a utilizar para `haiku`, o funcionalidad de fondo
`CLAUDE_CODE_SUBAGENT_MODEL`	El modelo predeterminado para subagentes, compañeros de equipo de agentes y agentes de workflow que no tienen asignado un modelo de otra manera. Acepta un alias como `haiku` o un nombre de modelo completo. Un modelo por invocación o el campo `model` de una definición, incluido `inherit`, tiene precedencia. Para cambiar eso, establezca `CLAUDE_CODE_SUBAGENT_MODEL_FORCE`

Nota: ANTHROPIC_SMALL_FAST_MODEL está deprecado en favor de ANTHROPIC_DEFAULT_HAIKU_MODEL.

Fijar modelos para implementaciones de terceros

Cuando implemente Claude Code a través de Amazon Bedrock, Plataforma de Agentes de Google Cloud, Microsoft Foundry, o Claude Platform on AWS, fije versiones de modelo antes de implementar para usuarios.

Sin fijar, Claude Code utiliza alias de modelo como fable, opus, sonnet y haiku que se resuelven a un ID de modelo predeterminado integrado para cada proveedor. Ese predeterminado puede rezagarse con respecto a la versión más reciente de Anthropic, y el modelo al que apunta puede que aún no esté habilitado en la cuenta de un usuario. Cuando el predeterminado no está disponible, los usuarios de Amazon Bedrock y Plataforma de Agentes de Google Cloud ven un aviso y la sesión retrocede a una versión anterior del modelo predeterminado, o al modelo Sonnet predeterminado cuando el predeterminado es un modelo Opus y no hay versión de Opus disponible. Los usuarios de Microsoft Foundry ven errores en su lugar, porque Microsoft Foundry no tiene ninguna verificación de inicio equivalente.

En Amazon Bedrock y Plataforma de Agentes de Google Cloud, un usuario que inicia la sesión en una versión específica de Sonnet u Opus, por ejemplo con --model, ANTHROPIC_MODEL, o la configuración model, fija esa versión como el predeterminado de la sesión para el alias coincidente: la verificación de inicio omite el predeterminado integrado que reemplaza y no muestra ningún aviso de alternancia. Antes de v2.1.211, la verificación se ejecutaba y podía mostrar un aviso incluso cuando un modelo de sesión estaba configurado explícitamente.

Utilice las siguientes variables de entorno con IDs de modelo específicos de versión para su proveedor:

Proveedor	Ejemplo
Amazon Bedrock	`export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'`
Plataforma de Agentes de Google Cloud	`export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'`
Microsoft Foundry	`export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'`

Aplique el mismo patrón para ANTHROPIC_DEFAULT_FABLE_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL y ANTHROPIC_DEFAULT_HAIKU_MODEL. Para IDs de modelo actuales y heredados en todos los proveedores, consulte Descripción general de modelos. Para actualizar usuarios a una nueva versión de modelo, actualice estas variables de entorno e implemente nuevamente.

Para habilitar contexto extendido para un modelo fijo, añada [1m] al ID de modelo en ANTHROPIC_DEFAULT_OPUS_MODEL o ANTHROPIC_DEFAULT_SONNET_MODEL:

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8[1m]'

El sufijo [1m] aplica la ventana de contexto de 1M a todo el uso de los alias opus y sonnet, incluida la fase Opus de modo de plan de opusplan.

Claude Code elimina el sufijo antes de enviar el ID de modelo a su proveedor.
Solo añada [1m] cuando el modelo subyacente admita contexto de 1M.
El sufijo se lee por variable, no por modelo. En Amazon Bedrock, Plataforma de Agentes de Google Cloud y Microsoft Foundry, un ID de modelo sin [1m] en una variable utiliza contexto de 200K incluso si otra variable establece el mismo modelo con el sufijo. Sonnet 5 siempre se ejecuta con la ventana de 1M en estos proveedores y nunca necesita el sufijo.

Personalizar la visualización y capacidades del modelo fijo

Cuando fija un modelo en un proveedor de terceros, su fila en el selector /model muestra el nombre del modelo de forma predeterminada si Claude Code reconoce el ID fijo, y el ID sin procesar en caso contrario:

Reconocido: el ID exacto de un modelo que Claude Code conoce, como su ID de API de Anthropic o la forma de su proveedor o puerta de enlace, con o sin el sufijo [1m]. Fije us.anthropic.claude-sonnet-4-5-20250929-v1:0 y la fila lee Sonnet 4.5.
No reconocido: cualquier otro ID, como un ARN de perfil de inferencia de aplicación o una versión de modelo que Claude Code no conoce, a menos que una entrada de modelOverrides asigne un modelo a esa cadena exacta. En Microsoft Foundry, los nombres de implementación están definidos por el usuario, por lo que Claude Code nunca reconoce un ID fijo allí, asignado o no, y la fila muestra el nombre de implementación de forma predeterminada.

Cuando una fila muestra el nombre del modelo, su descripción predeterminada incluye el ID fijo para que aún pueda ver qué ID está fijo.

Claude Code también puede no reconocer qué características admite un modelo fijo. Puede establecer el nombre de visualización y la descripción usted mismo y declarar capacidades con variables de entorno complementarias para cada modelo fijo.

Estas variables tienen efecto en proveedores de terceros como Amazon Bedrock, Plataforma de Agentes de Google Cloud y Microsoft Foundry. Las variables _NAME y _DESCRIPTION también tienen efecto cuando ANTHROPIC_BASE_URL apunta a una puerta de enlace LLM. No tienen efecto cuando se conecta directamente a api.anthropic.com.

Variable de entorno	Descripción
`ANTHROPIC_DEFAULT_OPUS_MODEL_NAME`	Nombre de visualización para el modelo Opus fijo en el selector `/model`. Cuando no está configurado, la fila muestra el nombre del modelo si Claude Code reconoce el ID fijo, y el ID fijo en caso contrario
`ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION`	Descripción de visualización para el modelo Opus fijo en el selector `/model`. Cuando no está configurado, la fila muestra una descripción predeterminada que comienza con `Custom Opus model`
`ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES`	Lista separada por comas de capacidades que admite el modelo Opus fijo

Los mismos sufijos _NAME, _DESCRIPTION y _SUPPORTED_CAPABILITIES están disponibles para ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_FABLE_MODEL y ANTHROPIC_CUSTOM_MODEL_OPTION.

Claude Code habilita características como niveles de esfuerzo y pensamiento extendido haciendo coincidir el ID de modelo con patrones conocidos. Los IDs específicos del proveedor como ARNs de Amazon Bedrock o nombres de implementación personalizados a menudo no coinciden con estos patrones, dejando las características compatibles deshabilitadas. Establezca _SUPPORTED_CAPABILITIES para indicar a Claude Code qué características admite realmente el modelo:

Valor de capacidad	Habilita
`effort`	Niveles de esfuerzo y el comando `/effort`
`xhigh_effort`	El nivel de esfuerzo `xhigh`
`max_effort`	El nivel de esfuerzo `max`
`thinking`	Pensamiento extendido
`adaptive_thinking`	Razonamiento adaptativo que asigna dinámicamente el pensamiento basado en la complejidad de la tarea
`interleaved_thinking`	Pensamiento entre llamadas de herramientas

Cuando se establece _SUPPORTED_CAPABILITIES, las capacidades enumeradas se habilitan y las capacidades no enumeradas se deshabilitan para el modelo fijo coincidente. Cuando la variable no está configurada, Claude Code vuelve a la detección integrada basada en el ID de modelo.

Este ejemplo fija Opus a un ARN de modelo personalizado de Amazon Bedrock, establece un nombre amigable y declara sus capacidades:

export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'
export ANTHROPIC_DEFAULT_OPUS_MODEL_NAME='Opus via Bedrock'
export ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION='Opus 4.7 routed through a Bedrock custom endpoint'
export ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES='effort,xhigh_effort,max_effort,thinking,adaptive_thinking,interleaved_thinking'

Anular IDs de modelo por versión

En plataformas que integran Claude Code y establecen CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, la configuración de modelo del host tiene precedencia sobre la configuración de modelo administrada, mientras que una lista de permitidos availableModels administrada permanece en vigor a menos que el host proporcione la suya propia; Excepciones a la precedencia de configuración administrada dice qué claves y variables anula el host.

Las variables de entorno a nivel de familia anteriores configuran un ID de modelo por alias de familia. Si necesita asignar varias versiones dentro de la misma familia a IDs de proveedor distintos, utilice la configuración modelOverrides en su lugar.

modelOverrides asigna IDs de modelo individuales de Anthropic a las cadenas específicas del proveedor que Claude Code envía a la API de su proveedor. Cuando un usuario selecciona un modelo asignado en el selector /model, Claude Code utiliza su valor configurado en lugar del predeterminado integrado.

Esto permite a los administradores empresariales enrutar cada versión de modelo a un ARN de perfil de inferencia de Amazon Bedrock específico, nombre de versión de Plataforma de Agentes de Google Cloud o nombre de implementación de Microsoft Foundry para gobernanza, asignación de costos o enrutamiento regional.

Establezca modelOverrides en su archivo de configuración:

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-sonnet-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  }
}

Las claves deben ser IDs de modelo de Anthropic como se enumeran en la Descripción general de modelos. Para IDs de modelo con fecha, incluya el sufijo de fecha exactamente como aparece allí. Las claves desconocidas se ignoran.

Para detener la línea de diagnóstico [claude-code:unrecognized_model] para un ID como un alias de puerta de enlace, añada una entrada con ese ID como su valor.

Las anulaciones reemplazan los IDs de modelo integrados que respaldan cada entrada en el selector /model. En Amazon Bedrock, las entradas de modelOverrides tienen precedencia sobre cualquier perfil de inferencia que Claude Code descubra automáticamente al inicio. Claude Code pasa valores que ya son específicos del proveedor, como ARNs de perfil de inferencia de Amazon Bedrock o nombres de implementación de Microsoft Foundry, al proveedor tal como están.

Las anulaciones también se aplican cuando pasa un ID de modelo de Anthropic directamente a través de --model, la variable de entorno ANTHROPIC_MODEL, o una variable de entorno ANTHROPIC_DEFAULT_*_MODEL. En Amazon Bedrock, Plataforma de Agentes de Google Cloud y Mantle, un ID de modelo de Anthropic sin entrada de modelOverrides se resuelve al mismo ID específico del proveedor que la fila del selector /model para esa versión, cuando el proveedor admite esa versión. Mantle admite un subconjunto de versiones. Para un ID de modelo de Anthropic fuera de ese subconjunto, Claude Code envía el ID sin procesar a Mantle sin asignarlo, a menos que una entrada de modelOverrides lo cubra. Antes de v2.1.200, --model y los valores de variable de entorno llegaban al proveedor tal como estaban sin pasar por el mapa de anulación.

modelOverrides funciona junto con availableModels. La lista de permitidos se evalúa contra el ID de modelo de Anthropic, no el valor de anulación, por lo que una entrada como "opus" en availableModels continúa coincidiendo incluso cuando las versiones de Opus se asignan a ARNs. Cuando enforceAvailableModels se establece en configuración administrada, el Predeterminado aplicado se resuelve a través de modelOverrides desde configuración administrada únicamente. La asignación de un administrador, como una versión fijada a un ARN de perfil de inferencia, se respeta en el Predeterminado aplicado. Las anulaciones de configuración de usuario o proyecto no la afectan.

Cuando availableModels se establece en configuración administrada, solo modelOverrides de configuración administrada se aplican a un ID de modelo de Anthropic pasado directamente a través de --model o las variables de entorno anteriores. Claude Code ignora las anulaciones en configuración de usuario o proyecto para esos IDs, y nunca resuelve un ID que la lista administrada excluye a través de modelOverrides de ninguna fuente de configuración. Esta restricción de fuente administrada requiere Claude Code v2.1.200 o posterior. Consulte Restringir la selección de modelo para saber cómo se manejan los IDs bloqueados.

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. Puede desactivar el almacenamiento en caché de indicaciones globalmente o para niveles de modelo específicos:

Variable de entorno	Descripción
`DISABLE_PROMPT_CACHING`	Establezca 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`	Establezca en `1` para desactivar el almacenamiento en caché de indicaciones solo para modelos Haiku
`DISABLE_PROMPT_CACHING_SONNET`	Establezca en `1` para desactivar el almacenamiento en caché de indicaciones solo para modelos Sonnet
`DISABLE_PROMPT_CACHING_OPUS`	Establezca en `1` para desactivar el almacenamiento en caché de indicaciones solo para modelos Opus
`DISABLE_PROMPT_CACHING_FABLE`	Establezca en `1` para desactivar el almacenamiento en caché de indicaciones solo para modelos Fable

Para elegir el TTL de caché para la conversación principal y para subagentes por separado, consulte elegir el TTL usted mismo. Para saber qué desencadena un error de caché, consulte Cómo Claude Code utiliza el almacenamiento en caché de indicaciones.

model-config.md +432 −239

4 4

5# Configuración del modelo5# Configuración del modelo

6 6

~~7> Aprenda sobre la configuración del modelo Claude Code, incluidos los alias de modelo como `opusplan`~~7> Configure qué modelo utiliza Claude Code, niveles de esfuerzo, contexto extendido y la ventana de auto-compact

8 8

9<h2 id="available-models">9<h2 id="available-models">

10 Modelos disponibles10 Modelos disponibles

14 14

15* Un **alias de modelo**15* Un **alias de modelo**

16* Un **nombre de modelo**16* Un **nombre de modelo**

~~17 * API de Anthropic: Un **[nombre de modelo](https://platform.claude.com/docs/es/about-claude/models/overview)** completo~~17 * API de Anthropic: un **[nombre de modelo](https://platform.claude.com/docs/en/about-claude/models/overview)** completo

18 * Amazon Bedrock: un ARN de perfil de inferencia18 * Amazon Bedrock: un ARN de perfil de inferencia

19 * Microsoft Foundry: un nombre de implementación19 * Microsoft Foundry: un nombre de implementación

~~20 * Plataforma de agentes de Google Cloud: un nombre de versión~~20 * Agent Platform de Google Cloud: un nombre de versión

21 21

22Para obtener orientación sobre qué modelo y nivel de esfuerzo se ajustan a diferentes tipos de trabajo, consulte [Choosing a Claude model and effort level in Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) en el blog.22Para obtener orientación sobre qué modelo y nivel de esfuerzo se ajustan a diferentes tipos de trabajo, consulte [Choosing a Claude model and effort level in Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) en el blog.

23 23

24<Note>24<Note>

25 `ANTHROPIC_BASE_URL` cambia dónde se envían las solicitudes, no qué modelo las responde. Para enrutar Claude a través de una puerta de enlace LLM, consulte [puertas de enlace LLM](/docs/es/llm-gateway).25 `ANTHROPIC_BASE_URL` cambia dónde se envían las solicitudes, no qué modelo las responde. Para enrutar Claude a través de una puerta de enlace LLM, consulte [LLM gateways](/docs/es/llm-gateway).

26</Note>26</Note>

27 27

28<h3 id="model-aliases">28<h3 id="model-aliases">

~~29 Alias de modelo~~29 Alias de modelos

30</h3>30</h3>

31 31

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

33 33

34| Alias de modelo | Comportamiento |34| Alias de modelo | Comportamiento |

35| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |35| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

36| **`default`** | Valor especial que borra cualquier anulación de modelo y revierte al modelo recomendado para su tipo de cuenta, o al [modelo predeterminado de la organización](#organization-default-model) cuando un administrador ha establecido uno. No es en sí mismo un alias de modelo |36| **`default`** | Valor especial que borra cualquier anulación de modelo y revierte al [valor predeterminado en tiempo de ejecución para su cuenta](#default-model-setting). No es en sí mismo un alias de modelo |

42| **`sonnet[1m]`** | Utiliza Sonnet con una [ventana de contexto de 1 millón de tokens](https://platform.claude.com/docs/es/build-with-claude/context-windows#context-window-sizes-by-model) para sesiones largas. Sin efecto cuando `sonnet` ya se resuelve a Sonnet 5 con su ventana nativa de 1M; detrás de una [puerta de enlace LLM](/docs/es/llm-gateway), selecciona la ventana de 1M para Sonnet 5 |42| **`sonnet[1m]`** | Utiliza Sonnet con una [ventana de contexto de 1 millón de tokens](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) para sesiones largas. Sin efecto cuando `sonnet` ya se resuelve a Sonnet 5 con su ventana nativa de 1M; detrás de una [puerta de enlace LLM](/docs/es/llm-gateway), selecciona la ventana de 1M para Sonnet 5 |

43| **`opus[1m]`** | Utiliza Opus con una [ventana de contexto de 1 millón de tokens](https://platform.claude.com/docs/es/build-with-claude/context-windows#context-window-sizes-by-model) para sesiones largas |43| **`opus[1m]`** | Utiliza Opus con una [ventana de contexto de 1 millón de tokens](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) para sesiones largas |

45 45

46La versión a la que se resuelven los alias `opus` y `sonnet` depende del proveedor:46La versión a la que se resuelven los alias `opus` y `sonnet` depende del proveedor:

47 47

~~49| :---------------------------------------------------- | :------- | :--------- |~~49| :--------------------------------------------------- | :------- | :--------- |

54 54

55Donde un alias se resuelve a un modelo más antiguo, hay modelos más nuevos disponibles seleccionando explícitamente el nombre de modelo completo o estableciendo `ANTHROPIC_DEFAULT_OPUS_MODEL` o `ANTHROPIC_DEFAULT_SONNET_MODEL`.55A menos que establezca `ANTHROPIC_DEFAULT_FABLE_MODEL`, el alias `fable` se resuelve a Fable 5.1. Antes de v2.1.255, se resolvía a Fable 5.

56 56

~~57Antes de v2.1.207, `opus` se resolvía a Opus 4.7 en Claude Platform on AWS y a Opus 4.6 en Amazon Bedrock y Plataforma de agentes de Google Cloud.~~57Donde un alias se resuelve a un modelo más antiguo, los modelos más nuevos están disponibles seleccionando explícitamente el nombre de modelo completo o estableciendo `ANTHROPIC_DEFAULT_OPUS_MODEL` o `ANTHROPIC_DEFAULT_SONNET_MODEL`.

58 58

59Los alias apuntan a la versión recomendada para su proveedor y se actualizan con el tiempo. Para fijar una versión específica, utilice el nombre de modelo completo, por ejemplo `claude-opus-4-8`, o establezca la variable de entorno correspondiente como `ANTHROPIC_DEFAULT_OPUS_MODEL`.59Antes de v2.1.219, `opus` se resolvía a Opus 4.8 en la API de Anthropic desde v2.1.154, y en Claude Platform on AWS, Amazon Bedrock y Agent Platform de Google Cloud desde v2.1.207. Antes de v2.1.207, `opus` se resolvía a Opus 4.7 en Claude Platform on AWS y a Opus 4.6 en Amazon Bedrock y Agent Platform de Google Cloud.

61Los alias apuntan a la versión recomendada para su proveedor y se actualizan con el tiempo. Para fijar una versión específica, use el nombre de modelo completo, por ejemplo `claude-opus-5`, o establezca la variable de entorno correspondiente como `ANTHROPIC_DEFAULT_OPUS_MODEL`.

60 62

61<Note>63<Note>

~~62 Sonnet 5 requiere Claude Code v2.1.197 o posterior. Opus 4.8 requiere v2.1.154 o posterior. Ejecute `claude update` para actualizar.~~64 Opus 5 requiere Claude Code v2.1.219 o posterior. Sonnet 5 requiere v2.1.197 o posterior. Opus 4.8 requiere v2.1.154 o posterior. Ejecute `claude update` para actualizar.

63</Note>65</Note>

64 66

~~65<h3 id="work-with-fable-5">~~67<h3 id="work-with-fable">

~~66 Trabajar con Fable 5~~68 Trabajar con Fable

67</h3>69</h3>

68 70

69[Claude Fable 5](https://platform.claude.com/docs/es/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5) es el modelo más capaz en Claude Code, adecuado para tareas más grandes que una sola sesión. Sustenta sesiones largas autónomas, investiga antes de actuar y verifica su trabajo más a menudo que los modelos más pequeños.71[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) y Claude Fable 5 son los modelos más capaces en Claude Code, adecuados para tareas más grandes que una sola sesión. Sostienen sesiones autónomas largas, investigan antes de actuar y verifican su trabajo más a menudo que los modelos más pequeños. Fable 5.1 es la versión más reciente.

73Ninguno de los modelos Fable es el valor predeterminado de tipo de cuenta en ningún plan o proveedor. Seleccione uno explícitamente:

75* **Fable 5.1**: ejecute `/model fable`, o inicie con `claude --model fable`.

76* **Fable 5**: selecciónelo por ID de modelo. En la API de Anthropic, ejecute `/model claude-fable-5` o inicie con `claude --model claude-fable-5`. En otros proveedores, use el ID de modelo Fable 5 de su proveedor o [fíjelo](#pin-models-for-third-party-deployments) con `ANTHROPIC_DEFAULT_FABLE_MODEL`.

70 77

71Fable 5 no es el modelo predeterminado. Selecciónelo con `/model fable`. Las solicitudes que sus clasificadores de seguridad marcan, más a menudo en dominios de ciberseguridad y biología, activan [alternancia automática de modelo](#automatic-model-fallback).78Si su configuración de usuario contiene `claude-fable-5` o `claude-fable-5[1m]` como modelo, por ejemplo porque seleccionó Fable en el selector `/model` antes de v2.1.255, y se conecta directamente a la API de Anthropic, Claude Code cambia ese valor guardado al alias `fable` o `fable[1m]` la primera vez que ejecuta v2.1.255 o posterior, y la línea del modelo de inicio muestra `(auto-updated)` una vez. Un valor `claude-fable-5` en la configuración del proyecto, local o administrada se deja tal como está.

72 79

~~73Para aprovechar al máximo Fable 5:~~80Las solicitudes que los clasificadores de seguridad de un modelo Fable marcan, más a menudo en dominios de ciberseguridad y biología, desencadenan [alternancia automática de modelo](#automatic-model-fallback).

74 81

75* **Describa el resultado, no los pasos**: entrégale el resultado que desea y déjelo planificar el camino. Para mantenerlo funcionando hasta que ese resultado se cumpla, [establezca un objetivo](/docs/es/goal).82Para aprovechar al máximo Fable:

76* **Entrégale problemas ambiguos**: las investigaciones de causa raíz, la depuración de interrupciones y las decisiones de arquitectura son donde la investigación y verificación adicionales se rentabilizan.83

84* **Describa el resultado, no los pasos**: entrégale el resultado que desea y déjelo planificar el camino. Para mantenerlo trabajando hacia ese resultado, [establezca un objetivo](/docs/es/goal).

85* **Entrégale problemas ambiguos**: investigaciones de causa raíz, depuración de interrupciones y decisiones de arquitectura son donde la investigación y verificación adicionales se pagan.

77* **Omita los recordatorios de verificación**: verifica su propio trabajo con menos indicaciones, por lo que los recordatorios para probar o verificar generalmente son innecesarios.86* **Omita los recordatorios de verificación**: verifica su propio trabajo con menos indicaciones, por lo que los recordatorios para probar o verificar generalmente son innecesarios.

~~78* **Dimensione tareas más grandes**: entrégale trabajo que normalmente dividiría en partes. Mantiene sesiones largas sin perder el hilo.~~87* **Dimensione tareas más grandes**: entrégale trabajo que normalmente dividiría en piezas. Mantiene sesiones largas sin perder el hilo.

79 88

80<Note>89<Note>

81 Fable 5 requiere Claude Code v2.1.170 o posterior. Las versiones anteriores no muestran Fable 5 en el selector de modelo y no pueden seleccionarlo. Ejecute `claude update` para actualizar. Fable 5 no está disponible bajo [retención de datos cero](/docs/es/zero-data-retention), donde el selector `/model` lo omite o lo muestra deshabilitado.90 Fable 5.1 requiere Claude Code v2.1.255 o posterior. Si una solicitud de una versión anterior falla, consulte [Claude Code does not support this model](/docs/es/errors#claude-code-does-not-support-this-model). Fable 5 requiere v2.1.170 o posterior. Ejecute `claude update` para actualizar. Para disponibilidad bajo retención de datos cero, consulte [Model availability under ZDR](/docs/es/zero-data-retention#model-availability-under-zdr).

82</Note>91</Note>

83 92

93En la API de Anthropic, el selector `/model` enumera un modelo Fable solo después de que el servidor lo informe como disponible para su organización. Cuando escribe `/model fable` o un ID de modelo Fable, Claude Code verifica la disponibilidad directamente con el servidor, por lo que una selección escrita puede tener éxito incluso cuando el selector no enumera la entrada.

95<h4 id="fable-and-usage-credits">

96 Fable y créditos de uso

97</h4>

99Dependiendo de su plan y nivel de asiento, el uso de Fable puede facturarse a [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) en lugar de extraer de los límites incluidos en su plan. Cuando lo hace, el selector `/model` muestra "Requires usage credits" en la fila Fable. Para administrar créditos de uso, consulte [Add usage credits to your subscription](/docs/es/costs#add-usage-credits-to-your-subscription).

100

101En sesiones interactivas, Claude Code muestra un mensaje de consentimiento antes de que una solicitud de Fable facture créditos de uso. Los miembros de planes Enterprise con facturación de organización no ven el mensaje. Puede continuar en Fable usando créditos de uso o cambiar a su modelo predeterminado. También puede descartar el mensaje:

102

103* En el selector `/model`, mantiene su modelo actual.

104* A mitad de sesión, Claude Code continúa el turno en su modelo predeterminado.

105

106Después de elegir continuar en Fable usando créditos de uso, Claude Code no muestra el mensaje nuevamente.

107

108En una sesión con [Remote Control](/docs/es/remote-control) conectado, una [sesión en segundo plano](/docs/es/agent-view), o una sesión de compañero de [equipo de agentes](/docs/es/agent-teams), es posible que nadie esté en la terminal, por lo que Claude Code mantiene el mensaje de consentimiento a mitad de sesión para el plazo [`dialogExpiry`](/docs/es/settings-reference#dialogexpiry), cinco minutos por defecto. Si nadie ha respondido antes del plazo, Claude Code finaliza el turno sin enviar la solicitud y agrega un aviso a la transcripción, que el cliente de Remote Control también muestra. Su selección de modelo no cambia, y Claude Code solicita consentimiento nuevamente en su próximo mensaje.

109

110Lo que puede hacer mientras el mensaje está esperando depende de la sesión:

111

112* Con Remote Control conectado o en la sesión de un compañero, presione cualquier tecla en la terminal para cancelar el plazo, y Claude Code espera su respuesta.

113* En una sesión en segundo plano, responda antes del plazo.

114* Si envía un nuevo mensaje desde el cliente remoto antes de que alguien escriba en la terminal, Claude Code finaliza el turno de la misma manera, y su nuevo mensaje inicia el siguiente turno. Después de que alguien escriba en la terminal, Claude Code continúa esperando la respuesta y pone en cola su nuevo mensaje detrás de ella.

115

116En [modo no interactivo](/docs/es/headless) con la bandera `-p` y a través del Agent SDK, Claude Code nunca muestra el mensaje de consentimiento. Cuando una solicitud de Fable allí facturase a créditos de uso, Claude Code la factura sin preguntar.

117

84<h3 id="setting-your-model">118<h3 id="setting-your-model">

85 Configurar su modelo119 Configurar su modelo

86</h3>120</h3>

87 121

88Puede configurar su modelo de varias formas, enumeradas en orden de prioridad:122Puede configurar su modelo de varias formas, enumeradas en orden de prioridad:

89 123

901. **Durante la sesión**: utilice `/model <alias|name>` para cambiar inmediatamente, o ejecute `/model` sin argumentos para abrir el selector. El selector solicita confirmación cuando la conversación tiene salida anterior, ya que la siguiente respuesta relee el historial completo sin contexto en caché1241. **Durante la sesión**: use `/model <alias|name>` para cambiar inmediatamente, o ejecute `/model` sin argumento para abrir el selector. Consulte [cuando Claude Code le pide que confirme el cambio](/docs/es/prompt-caching#switching-models)

912. **Al inicio**: inicie con `claude --model <alias|name>`1252. **Al inicio**: inicie con `claude --model <alias|name>`

923. **Variable de entorno**: establezca `ANTHROPIC_MODEL=<alias|name>`1263. **Variable de entorno**: establezca `ANTHROPIC_MODEL=<alias|name>`

~~934. **Configuración**: configure permanentemente en su archivo de configuración utilizando el campo `model`~~1274. **Configuración**: configure permanentemente en su archivo de configuración usando el campo `model`

1285. **[Predeterminado para nuevas sesiones](#set-a-default-model-for-new-sessions)**: establezca `ANTHROPIC_DEFAULT_MODEL=<alias|name>`

94 129

~~95A partir de v2.1.153, `/model` guarda su selección como predeterminada para nuevas sesiones escribiendo el campo `model` en su configuración de usuario. En el selector:~~130`/model` guarda su elección como predeterminada para nuevas sesiones escribiendo el campo `model` en su configuración de usuario. En el selector:

96 131

97* `Enter`: cambiar modelo y guardar como predeterminado132* `Enter`: cambiar modelo y guardar como predeterminado

98* `s`: cambiar modelo solo para esta sesión133* `s`: cambiar modelo solo para esta sesión

99 134

100Escribir `/model <name>` directamente se comporta como `Enter`. Un modelo establecido con `/model` en [modo no interactivo](/docs/es/headless), con la bandera `-p`, se aplica solo a la sesión actual y no se guarda como su predeterminado. La configuración del proyecto y administrada aún tiene prioridad y se reaplicará en el siguiente lanzamiento. Un [modelo predeterminado de la organización](#organization-default-model) que su administrador ha configurado para anular la selección del usuario también se reaplicará en el siguiente lanzamiento.135Escribir `/model <name>` directamente se comporta como `Enter`. Un modelo establecido con `/model` en [modo no interactivo](/docs/es/headless), con la bandera `-p`, se aplica solo a la sesión actual y no se guarda como predeterminado. La configuración del proyecto y administrada aún tienen precedencia y se reaplicarán en el próximo inicio. Un [modelo predeterminado de organización](#organization-default-model) que su administrador ha configurado para anular la selección del usuario también se reaplicará en el próximo inicio.

101 136

102En v2.1.144 a v2.1.152, `/model` se aplicaba solo a la sesión actual y `d` en el selector guardaba un predeterminado.137En v2.1.144 a v2.1.152, `/model` se aplicaba solo a la sesión actual y `d` en el selector guardaba un predeterminado.

103 138

104La bandera `--model` y la variable de entorno `ANTHROPIC_MODEL` se aplican solo a la sesión que inicia con ellas. Para ejecutar diferentes modelos en diferentes terminales al mismo tiempo, inicie cada uno con su propia bandera `--model` en lugar de cambiar con `/model`.139La bandera `--model` y la variable de entorno `ANTHROPIC_MODEL` se aplican solo a la sesión que inicia con ellas. Para ejecutar diferentes modelos en diferentes terminales al mismo tiempo, inicie cada uno con su propia bandera `--model` en lugar de cambiar con `/model`.

105 140

106Los precios en el selector `/model` aparecen cuando Claude Code se comunica con la API de Anthropic, directamente o a través de una [puerta de enlace LLM](/docs/es/llm-gateway) que la proxifica, y el precio en una fila es el precio del modelo que esa fila selecciona. En [proveedores de terceros](/docs/es/third-party-integrations) como Amazon Bedrock y en la [puerta de enlace de aplicaciones Claude](/docs/es/claude-apps-gateway), su proveedor o puerta de enlace determina lo que paga, por lo que las filas del selector no muestran precio. El precio es solo una etiqueta de visualización; no afecta qué modelo selecciona una fila o qué factura su proveedor. Antes de v2.1.206, [Claude Platform on AWS](/docs/es/claude-platform-on-aws) y las sesiones de puerta de enlace mostraban precios de lista de Anthropic, y una fila podría mostrar el precio de un modelo diferente al que seleccionaba.141Los precios en el selector `/model` aparecen cuando Claude Code habla con la API de Anthropic, directamente o a través de una [puerta de enlace LLM](/docs/es/llm-gateway) que la proxifica, y el precio en una fila es el precio del modelo que esa fila selecciona. En [proveedores de terceros](/docs/es/third-party-integrations) como Amazon Bedrock y en la [puerta de enlace de aplicaciones Claude](/docs/es/claude-apps-gateway), su proveedor o puerta de enlace determina lo que paga, por lo que las filas del selector no muestran precio. El precio es solo una etiqueta de visualización; no afecta qué modelo selecciona una fila o qué factura su proveedor. Antes de v2.1.206, [Claude Platform on AWS](/docs/es/claude-platform-on-aws) y las sesiones de puerta de enlace mostraban precios de lista de Anthropic, y una fila podría mostrar el precio de un modelo diferente al que seleccionaba.

107 142

108Las sesiones reanudadas iniciadas con `claude --resume`, `--continue`, o el selector `/resume` mantienen el modelo que estaban usando cuando se guardó la transcripción, independientemente de la configuración actual de `model`. Si ese modelo ha sido retirado o es excluido por [`availableModels`](#restrict-model-selection), la sesión cae en el orden de precedencia normal. Esto evita que la selección de `/model` de otra sesión cambie el modelo al reanudar.143Las sesiones reanudadas iniciadas con `claude --resume`, `--continue`, o el selector `/resume` mantienen el modelo que estaban usando cuando se guardó la transcripción, independientemente de la configuración actual de `model`. Si el modelo restaurado se ha retirado o está excluido por [`availableModels`](#restrict-model-selection), la sesión cae a través del orden de precedencia normal. Esto evita que la elección de `/model` de otra sesión cambie el modelo en la reanudación. En proveedores que usan ID de implementación específicos del proveedor en lugar de ID de modelo de Anthropic, como Amazon Bedrock, Agent Platform de Google Cloud y Microsoft Foundry, el modelo de transcripción no se restaura en absoluto y la sesión resuelve su modelo a través del orden de precedencia normal.

109 144

110Un modelo que elige para el nuevo lanzamiento con `--model` o `ANTHROPIC_MODEL` aún tiene prioridad sobre el modelo restaurado. A partir de v2.1.195, también lo hace una variable de familia [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables).145Un modelo que elige para el nuevo inicio con `--model` o `ANTHROPIC_MODEL` aún tiene precedencia sobre el modelo restaurado. A partir de v2.1.195, también lo hace una variable de familia [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables). [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) también puede, bajo las condiciones enumeradas en su sección.

111 146

112Cuando el modelo activo al inicio proviene de la configuración del proyecto o administrada en lugar de su propia selección, el encabezado de inicio muestra qué archivo de configuración lo estableció. Ejecute `/model` para anular; la configuración del proyecto o administrada se reaplicará en el siguiente lanzamiento.147Cuando el modelo activo al inicio proviene de la configuración del proyecto o administrada en lugar de su propia selección, el encabezado de inicio muestra qué archivo de configuración lo estableció. Ejecute `/model` para anular; la configuración del proyecto o administrada se reaplicará en el próximo inicio. En plataformas que incrustan Claude Code y establecen [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/es/env-vars), la configuración de modelo del host tiene precedencia sobre la configuración de modelo administrada, mientras que una lista de permitidos `availableModels` administrada permanece en vigor a menos que el host suministre la suya propia; [Exceptions to managed settings precedence](/docs/es/settings#exceptions-to-managed-settings-precedence) dice qué claves y variables anula el host.

113 148

114Cuando se solicita un cambio de modelo a través del método `setModel()` del [Agent SDK](/docs/es/agent-sdk/overview) o por una aplicación como la [aplicación de escritorio](/docs/es/desktop) que ejecuta Claude Code CLI para usted, Claude Code verifica que la cadena sea una que reconozca antes de guardarla. Esta verificación requiere Claude Code v2.1.200 o posterior. En la API de Anthropic, Claude Code reconoce:149Cuando se solicita un cambio de modelo a través del método `setModel()` del [Agent SDK](/docs/es/agent-sdk/overview) o por una aplicación como la [aplicación de escritorio](/docs/es/desktop) que ejecuta Claude Code CLI para usted, Claude Code verifica que la cadena sea una que reconozca antes de guardarla. Esta verificación requiere Claude Code v2.1.200 o posterior. En la API de Anthropic, Claude Code reconoce:

115 150

118* cualquier nombre que comience con `claude-`153* cualquier nombre que comience con `claude-`

119* un valor que configuró usted mismo como una [opción de modelo personalizado](#add-a-custom-model-option) o en [`modelOverrides`](#override-model-ids-per-version)154* un valor que configuró usted mismo como una [opción de modelo personalizado](#add-a-custom-model-option) o en [`modelOverrides`](#override-model-ids-per-version)

120 155

121Claude Code rechaza una cadena no reconocida con `Model "<name>" is not a recognized model id.` y la sesión mantiene su modelo actual, en lugar de guardar la cadena y fallar en la siguiente solicitud. Consulte [la referencia de errores](/docs/es/errors#model-is-not-a-recognized-model-id) para pasos de recuperación.156Claude Code rechaza una cadena no reconocida con `Model "<name>" is not a recognized model id.` y la sesión mantiene su modelo actual, en lugar de guardar la cadena y fallar en la próxima solicitud. Consulte [la referencia de errores](/docs/es/errors#model-is-not-a-recognized-model-id) para pasos de recuperación.

122 157

123La verificación se ejecuta solo en la API de Anthropic. En Amazon Bedrock, Plataforma de agentes de Google Cloud, Microsoft Foundry, [Claude Platform on AWS](/docs/es/claude-platform-on-aws), y detrás de una [puerta de enlace LLM](/docs/es/llm-gateway) o un `ANTHROPIC_BASE_URL` personalizado, su proveedor o puerta de enlace define los nombres de modelo, por lo que Claude Code pasa cualquier cadena sin verificarla. La verificación tampoco cubre la bandera `--model`, la variable de entorno `ANTHROPIC_MODEL`, o la configuración `model`; un valor mal escrito allí produce [There's an issue with the selected model](/docs/es/errors#theres-an-issue-with-the-selected-model) en la primera solicitud en su lugar.158La verificación se ejecuta solo en la API de Anthropic. En Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry, [Claude Platform on AWS](/docs/es/claude-platform-on-aws), y detrás de una [puerta de enlace LLM](/docs/es/llm-gateway) o un `ANTHROPIC_BASE_URL` personalizado, su proveedor o puerta de enlace define los nombres de modelo, por lo que Claude Code pasa cualquier cadena sin verificarla. La verificación tampoco cubre la bandera `--model`, la variable de entorno `ANTHROPIC_MODEL`, o la configuración de `model`; un valor mal escrito allí produce [There's an issue with the selected model](/docs/es/errors#theres-an-issue-with-the-selected-model) en la primera solicitud en su lugar. Claude Code aún puede escribir la [línea de diagnóstico de modelo no reconocido](/docs/es/errors#unrecognized-model-id-on-a-request) en el momento de la solicitud, en cada proveedor.

124 159

125Cuando el modelo solicitado tiene una fecha de retiro programada o se remapea automáticamente a una versión más nueva, Claude Code muestra una advertencia que nombra el modelo solicitado. Las sesiones interactivas la muestran como un aviso de inicio. A partir de v2.1.182, la misma advertencia se escribe en stderr en [modo no interactivo](/docs/es/headless) cuando se utiliza el formato de salida de texto predeterminado. La verificación también cubre un `model` establecido en [frontmatter de subagentos](/docs/es/sub-agents). La advertencia de stderr se suprime para `--output-format json` y `stream-json`; lea el modelo real desde el campo `modelUsage` del [mensaje de resultado](/docs/es/headless#get-structured-output) en su lugar.160Cuando el modelo solicitado tiene una fecha de retiro programada o se remapea automáticamente a una versión más nueva, Claude Code muestra una advertencia que nombra el modelo solicitado. Las sesiones interactivas la muestran como un aviso de inicio. A partir de v2.1.182, la misma advertencia se escribe en stderr en [modo no interactivo](/docs/es/headless) cuando se usa el formato de salida de texto predeterminado. La verificación también cubre un `model` establecido en [frontmatter de subagente](/docs/es/sub-agents). La advertencia de stderr se suprime para `--output-format json` y `stream-json`; lea el modelo real del campo `modelUsage` del [mensaje de resultado](/docs/es/headless#get-structured-output) en su lugar.

126 161

127Ejemplo de uso:162Por ejemplo, inicie una sesión en Opus:

128 163

129```bash theme={null}164```bash theme={null}

130# Iniciar con Opus

131claude --model opus165claude --model opus

166```

132 167

133# Cambiar a Sonnet durante la sesión168Luego cambie modelos desde dentro de la sesión:

169

170```text theme={null}

134/model sonnet171/model sonnet

135```172```

136 173

139```json theme={null}176```json theme={null}

140{177{

141 "permissions": {178 "permissions": {

142 ...179 "allow": ["Bash(npm run lint)"]

143 },180 },

144 "model": "opus"181 "model": "opus"

145}182}

146```183```

147 184

185<h4 id="set-a-default-model-for-new-sessions">

186 Establecer un modelo predeterminado para nuevas sesiones

187</h4>

188

189Establezca `ANTHROPIC_DEFAULT_MODEL=<alias|name>` para elegir el modelo en el que sus sesiones comienzan de forma predeterminada. Requiere Claude Code v2.1.236 o posterior.

190

191Claude Code inicia una nueva sesión en el modelo de la variable solo cuando ninguno de estos selecciona un modelo:

192

193* La bandera `--model`

194* `ANTHROPIC_MODEL`

195* Un valor de `model` en cualquier archivo de configuración, incluida la elección que guarda con `/model`

196* Un [modelo predeterminado de organización](#organization-default-model)

197

198Una elección que guarda con `/model` tiene precedencia sobre la variable en lanzamientos posteriores también. Con `ANTHROPIC_MODEL` establecido en su lugar, Claude Code vuelve al modelo de esa variable en el próximo lanzamiento, sea lo que sea que haya guardado con `/model`.

199

200Claude Code también resuelve la opción Predeterminado al modelo de la variable, a menos que se aplique un modelo predeterminado de organización. Cuando la opción Predeterminado se resuelve al modelo de la variable, la fila Predeterminado en el selector `/model` muestra la etiqueta Set by ANTHROPIC\_DEFAULT\_MODEL.

201

202Claude Code ignora la variable en estos casos, y la opción Predeterminado se resuelve como si no la hubiera establecido:

203

204* La establece en `default`, `inherit`, `opusplan`, o `haiku`

205* [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) está activado

206* [`availableModels`](#restrict-model-selection) o [restricciones de modelo de organización](#organization-model-restrictions) excluyen el modelo

207* El modelo no está disponible para su cuenta

208

209Cuando una nueva sesión comenzaría en el modelo de la variable, una sesión que reanuda con `claude --resume`, `--continue`, o el selector `/resume` también comienza en él. Claude Code no restaura el modelo guardado en la transcripción de esa sesión. De lo contrario, Claude Code no usa la variable cuando [reanuda una sesión](#setting-your-model).

210

211<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">

212 Una nueva sesión comienza en un modelo diferente al que eligió

213</h4>

214

215Cuando elige un modelo con `/model` y su próxima sesión comienza en algo más, estas son las causas habituales:

216

217* **Lo eligió para una sesión.** Presionar `s` en el selector, iniciar con `--model`, y ejecutar `/model` en modo no interactivo se aplican solo a la sesión actual y dejan su predeterminado guardado solo.

218* **Algo con mayor prioridad establece el modelo.** Un valor de `model` en la configuración del proyecto o administrada, `ANTHROPIC_MODEL` en su shell, o un [predeterminado de organización](#organization-default-model) que su administrador estableció para anular las elecciones del usuario se aplica nuevamente en cada lanzamiento. Su elección de `/model` aún se guarda; está superada. Cuando la configuración del proyecto o administrada establece el modelo, el encabezado de inicio nombra el archivo.

219* **Claude Code no pudo guardar su elección.** `/model` escribe `model` en `~/.claude/settings.json`. Si no puede escribir en ese archivo, por ejemplo porque otra herramienta lo genera o lo vincula a una copia de solo lectura, el modelo que eligió dura para la sesión y el próximo lanzamiento lee el valor anterior. Establezca `model` en la herramienta que genera el archivo, o haga que el archivo sea escribible. Consulte [A change you made in Claude Code is lost in new sessions](/docs/es/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).

220* **Reanudó una sesión.** Una sesión que reanuda con `claude --resume` o `--continue` generalmente [mantiene el modelo que estaba usando](#setting-your-model) en lugar de su predeterminado actual.

221

148<h2 id="restrict-model-selection">222<h2 id="restrict-model-selection">

149 Restringir la selección de modelo223 Restringir la selección de modelos

150</h2>224</h2>

151 225

152Los administradores empresariales pueden utilizar `availableModels` en [configuración administrada o de política](/docs/es/settings#settings-files) para restringir qué modelos pueden seleccionar los usuarios. Las entradas coinciden con una familia de modelos como `sonnet`, un prefijo de versión como `claude-sonnet-4-5`, o un ID de modelo completo como `claude-sonnet-4-5-20250929`.226Los administradores empresariales pueden usar `availableModels` en [configuración administrada o de políticas](/docs/es/managed-settings) para restringir qué modelos pueden seleccionar los usuarios. Las entradas coinciden con una familia de modelos como `sonnet`, un prefijo de versión como `claude-sonnet-4-5`, o un ID de modelo completo como `claude-sonnet-4-5-20250929`. Un prefijo de versión también coincide con IDs de modelo posteriores que lo extienden con otro segmento, por lo que `claude-fable-5` permite tanto Fable 5 como Fable 5.1, mientras que `claude-fable-5-1` permite solo Fable 5.1.

227

228En plataformas que integran Claude Code y establecen [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/es/env-vars), la configuración de modelo del host tiene precedencia sobre la configuración de modelos administrada, mientras que una lista de permitidos `availableModels` administrada permanece en vigor a menos que el host proporcione la suya propia; [Excepciones a la precedencia de configuración administrada](/docs/es/settings#exceptions-to-managed-settings-precedence) indica qué claves y variables anula el host.

153 229

154Cuando se establece `availableModels`, la lista de permitidos se aplica en todas partes donde un usuario puede especificar un modelo:230Cuando se establece `availableModels`, la lista de permitidos se aplica en todas partes donde un usuario puede especificar un modelo:

155 231

156* **Modelo de sesión principal**: `/model`, la bandera `--model`, la variable de entorno `ANTHROPIC_MODEL`, la configuración `model`, y el modelo restaurado cuando [se reanuda una sesión](#setting-your-model)232* **Modelo de sesión principal**: `/model`, la bandera `--model`, la variable de entorno `ANTHROPIC_MODEL`, la configuración `model`, [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), y el modelo restaurado cuando [se reanuda una sesión](#setting-your-model)

157* **Resolución de alias**: las variables de entorno `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, y `ANTHROPIC_DEFAULT_FABLE_MODEL` no pueden redirigir un alias permitido a un modelo fuera de la lista233* **Resolución de alias**: las variables de entorno `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, y `ANTHROPIC_DEFAULT_FABLE_MODEL` no pueden redirigir un alias permitido a un modelo fuera de la lista

158* **Modo rápido**: `/fast` se niega a cambiar cuando cambiaría implícitamente a un modelo Opus fuera de la lista, con el mensaje "no está en los modelos permitidos de su organización"234* **Modo rápido**: `/fast` se niega a alternar cuando implicaría cambiar implícitamente a un modelo Opus fuera de la lista, con el mensaje "is not in your organization's allowed models"

159* **Modelos de subagentes**: el campo `model` en [frontmatter de subagente](/docs/es/sub-agents#choose-a-model), el parámetro `model` de la herramienta Agent, `CLAUDE_CODE_SUBAGENT_MODEL`, y, en v2.1.197 y anterior, el selector de modelo en el asistente `/agents` 235* **Modelos de subagente y compañero**: el campo `model` en la [frontmatter de subagente](/docs/es/sub-agents#choose-a-model), el parámetro `model` de la herramienta Agent, [modelos de compañero de equipo de agente](/docs/es/agent-teams#specify-teammates-and-models), `CLAUDE_CODE_SUBAGENT_MODEL`, y, en v2.1.197 y anteriores, el selector de modelos en el asistente `/agents` 

160* **Modelo de habilidad y comando**: el frontmatter `model` en [habilidades y comandos](/docs/es/skills)236* **Modelos de skill y comando**: la frontmatter `model` en [skills y comandos](/docs/es/skills)

161* **Modelo de asesor**: la configuración [`advisorModel`](/docs/es/advisor) configurada y la bandera `--advisor`237* **Modelo de asesor**: la configuración [`advisorModel`](/docs/es/advisor) configurada y la bandera `--advisor`

162* **Modelo de agente de fondo**: el modelo seleccionado en el [selector de envío](/docs/es/agent-view)238* **Modelo de agente de fondo**: el modelo seleccionado en el [selector de envío](/docs/es/agent-view)

163 239

164En la API de Anthropic y [Claude Platform en AWS](/docs/es/claude-platform-on-aws), un alias de familia de modelos, `opus`, `sonnet`, `haiku`, o `fable`, se resuelve a la versión más reciente de su familia que la lista de permitidos permite. Cuando la lista de permitidos fija versiones específicas, por ejemplo `["sonnet", "claude-opus-4-6"]`, tanto `/model opus` como `--model opus` seleccionan Claude Opus 4.6, el Opus más reciente permitido, y muestran un aviso que nombra tanto los modelos solicitados como los sustituidos. Antes de v2.1.205, un alias cuya versión más reciente lanzada estaba fuera de la lista se rechazaba o reemplazaba como cualquier otra selección bloqueada, incluso cuando la lista permitía una versión anterior.240En la API de Anthropic y [Claude Platform en AWS](/docs/es/claude-platform-on-aws), un alias de familia de modelos, `opus`, `sonnet`, `haiku`, o `fable`, se resuelve a su modelo habitual cuando la lista de permitidos permite ese modelo. Cuando la lista de permitidos bloquea ese modelo, Claude Code sustituye la versión más nueva de la familia que la lista de permitidos permite y muestra un aviso que nombra tanto los modelos solicitados como los sustituidos. Con `["sonnet", "claude-opus-4-6"]`, por ejemplo, tanto `/model opus` como `--model opus` seleccionan Claude Opus 4.6, el Opus más nuevo permitido. Antes de v2.1.205, un alias cuya versión más nueva lanzada estaba fuera de la lista se rechazaba o reemplazaba como cualquier otra selección bloqueada, incluso cuando la lista permitía una versión anterior.

165 241

166Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, y [Mantle](/docs/es/amazon-bedrock#use-the-mantle-endpoint) utilizan IDs de implementación específicos del proveedor en lugar de IDs de modelo de Anthropic, por lo que un alias bloqueado allí sigue el comportamiento de rechazo y reemplazo a continuación.242La sustitución necesita una versión permitida en la que aterrizar: cuando la lista de permitidos no permite ninguna versión de la familia del alias, el alias sigue el comportamiento de rechazo y reemplazo a continuación como cualquier otro valor bloqueado.

167 243

168Claude Code maneja cualquier otra selección bloqueada según dónde se estableció el modelo:244Claude Code maneja cualquier otra selección bloqueada según dónde se estableció el modelo:

169 245

170* **`/model`**: el cambio se rechaza con un error246* **`/model`**: Claude Code rechaza el cambio con un error

171* **Bandera `--model`, `ANTHROPIC_MODEL`, o la configuración `model`**: el valor se reemplaza al inicio con una advertencia que nombra tanto los modelos solicitados como los sustituidos, y la sesión comienza en el modelo predeterminado247* **Bandera `--model`, `ANTHROPIC_MODEL`, o la configuración `model`**: Claude Code reemplaza el valor al inicio con una advertencia que nombra tanto los modelos solicitados como los sustituidos, y la sesión comienza en el modelo predeterminado

172* **Anulación de subagente, habilidad o comando**: la anulación vuelve al modelo heredado o predeterminado en lugar de fallar la solicitud248* **[`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions)**: Claude Code ignora la variable

173* **Configuración `advisorModel`**: el asesor se desactiva para la sesión249* **Anulación de subagente o compañero**: Claude Code ejecuta el subagente o compañero en un modelo de respaldo en lugar de fallar la solicitud. Consulte [Elegir un modelo](/docs/es/sub-agents#choose-a-model) para el respaldo del subagente y [Especificar compañeros y modelos](/docs/es/agent-teams#specify-teammates-and-models) para el respaldo del compañero.

174* **Bandera `--advisor`**: Claude Code sale con un error al inicio

175 250

176Los modelos excluidos se ocultan del selector `/model`. Un ID de modelo completo en la lista que no tiene una fila de selector integrada, como una versión anterior que la lista fija, aparece en el selector `/model` como su propia fila etiquetada. Antes de v2.1.199, ese ID era seleccionable solo escribiendo `/model <id>`.251 En sesiones interactivas, Claude Code le advierte cuando sustituye el modelo de un subagente, por este respaldo o por la sustitución de versión más nueva permitida anterior, nombrando los modelos solicitados y sustituidos; no informa del respaldo de un compañero.

252

253 Donde opera la sustitución de versión más nueva permitida anterior, un alias de familia bloqueado la sigue en su lugar. Antes de v2.1.222, un alias retrocedía como cualquier otro valor bloqueado en cada proveedor

254* **Anulación de skill o comando**: Claude Code ignora la anulación, incluido un alias de familia bloqueado, y el skill o comando se ejecuta en el modelo de sesión. Un skill o comando que [se ejecuta en un subagente](/docs/es/skills#run-skills-in-a-subagent) sigue el comportamiento del subagente anterior en su lugar

255* **Configuración `advisorModel`**: el asesor se deshabilita para la sesión

256* **Bandera `--advisor`**: Claude Code sale con un error al inicio. En una [sesión de fondo](/docs/es/agent-view), inicia la sesión sin el asesor en lugar de salir

257

258Claude Code oculta los modelos excluidos del selector `/model`. Un ID de modelo completo en la lista que no tiene una fila de selector integrada, como una versión anterior que la lista fija, aparece en el selector `/model` como su propia fila etiquetada, a menos que Claude Code reemplace las opciones integradas con una alineación [`modelPicker`](/docs/es/settings-reference#modelpicker). Antes de v2.1.199, tal ID era seleccionable solo escribiendo `/model <id>`.

177 259

178Los cambios de modelo que Claude Code realiza en su nombre se verifican de la misma manera:260Los cambios de modelo que Claude Code realiza en su nombre se verifican de la misma manera:

179 261

180* **[Cadenas de modelo de reserva](#fallback-model-chains)**: los elementos fuera de la lista de permitidos se descartan262* **[Cadenas de modelo de respaldo](#fallback-model-chains)**: las entradas fuera de la lista de permitidos se descartan

181* **Actualizaciones de modo de plan**: en la API de Anthropic y Claude Platform en AWS, una actualización como [`opusplan`](#opusplan-model-setting) a un modelo excluido utiliza la versión más reciente permitida de la familia de actualización. En proveedores con IDs de modelo específicos del proveedor, y cuando no se permite ninguna versión, la actualización se omite y la planificación continúa en el modelo de la sesión263* **Actualizaciones de modo de plan**: en la API de Anthropic y Claude Platform en AWS, una actualización como [`opusplan`](#opusplan-model-setting) a un modelo excluido usa la versión más nueva permitida de la familia de actualización. En proveedores con IDs de modelo específicos del proveedor, y cuando no se permite ninguna versión, la actualización se omite y la planificación continúa en el modelo de la sesión

182* **[Fallback automático de modelo](#automatic-model-fallback)**: un fallback cuyo destino está excluido no se ejecuta, por lo que la solicitud marcada termina con un rechazo264* **[Respaldo automático de modelo](#automatic-model-fallback)**: un respaldo cuyo destino está excluido no se ejecuta, por lo que la solicitud marcada termina con un rechazo en su lugar

265* **[Clasificador de modo automático](/docs/es/permission-modes#eliminate-prompts-with-auto-mode)**: el valor predeterminado de Claude Sonnet 5 del clasificador se aplica solo cuando la lista de permitidos permite Sonnet 5. Cuando está excluido, el clasificador se ejecuta en el modelo de la sesión, que la lista de permitidos ya rige, o en un modelo Opus cuando la sesión se ejecuta en un [modelo Fable](#work-with-fable). En proveedores distintos de la API de Anthropic, ese respaldo de Opus se ejecuta en el modelo Opus predeterminado del proveedor sin consultar la lista de permitidos. Requiere Claude Code v2.1.210 o posterior

183* **[Modo rápido](/docs/es/fast-mode)**: habilitar el modo rápido se rechaza cuando el modelo en el que se ejecutaría la sesión después está fuera de la lista de permitidos266* **[Modo rápido](/docs/es/fast-mode)**: habilitar el modo rápido se rechaza cuando el modelo en el que se ejecutaría la sesión después está fuera de la lista de permitidos

184 267

185```json theme={null}268```json theme={null}

195Cada superficie aplica la lista de permitidos que recibe. El mecanismo de entrega que llega a cada superficie difiere:278Cada superficie aplica la lista de permitidos que recibe. El mecanismo de entrega que llega a cada superficie difiere:

196 279

198| :-------------------------------------------------------------------------------------------------------- | :-------- | :----------------------------- | :--------------------------------- | :------------------------- | :--------------------------- |281| :-------------------------------------------------------------------------------------------------------- | :-------- | :----------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------- | :--------------------------- |

201 284

202* Las sesiones en la nube, en [Claude Code en la web](/docs/es/claude-code-on-the-web) o en la aplicación de escritorio, se ejecutan en máquinas virtuales administradas por Anthropic: la configuración implementada en su dispositivo no las alcanza, por lo que entregue la lista de permitidos a través de configuración administrada por servidor. Un cambio de modelo a mitad de sesión en una sesión en la nube se rechaza cuando el modelo solicitado está excluido por la lista de permitidos. El rechazo del lado del servidor en la creación de sesión se aplica a [restricciones de modelo de organización](#organization-model-restrictions), no a la clave de configuración `availableModels`.285* Las sesiones en la nube, en [Claude Code en la web](/docs/es/claude-code-on-the-web) o en la aplicación de escritorio, se ejecutan en máquinas virtuales administradas por Anthropic de forma predeterminada: la configuración implementada en su dispositivo no las alcanza, por lo que entregue la lista de permitidos a través de configuración administrada por servidor. Las sesiones que su organización enruta a un [entorno autohospedado](/docs/es/self-hosted-environments) se ejecutan en su propio cálculo y también leen el archivo de configuración administrada en la imagen del ejecutor. [Cómo Claude Code combina fuentes administradas](/docs/es/managed-settings#how-claude-code-combines-managed-sources) indica cuándo se aplica ese archivo. Un cambio de modelo a mitad de sesión en una sesión en la nube se rechaza cuando el modelo solicitado está excluido por la lista de permitidos. El rechazo del lado del servidor en la creación de sesión se aplica a [restricciones de modelo de organización](#organization-model-restrictions), no a la clave de configuración `availableModels`.

203* Cowork, la pestaña de trabajo agéntico en la aplicación Claude Desktop, no es una superficie de Claude Code y no recibe configuración administrada por servidor por diseño. Un archivo de configuración administrada se aplica a sesiones de Cowork cuando está presente donde se ejecuta la sesión; las sesiones remotas de Cowork se ejecutan en máquinas virtuales administradas por Anthropic, donde un archivo implementado en el dispositivo no está presente.286* Cowork, la pestaña de trabajo agéntico en la aplicación de escritorio de Claude, ejecuta sus sesiones en Claude Code pero, por diseño, no recibe configuración administrada por servidor desde la consola de administración de claude.ai. Un archivo de configuración administrada se aplica a sesiones de Cowork cuando está presente donde se ejecuta la sesión; las sesiones remotas de Cowork se ejecutan en máquinas virtuales administradas por Anthropic, donde un archivo implementado en el dispositivo no está presente.

204* Las sesiones en [proveedores de terceros](/docs/es/server-managed-settings#platform-availability) como Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, y [Claude Platform en AWS](/docs/es/claude-platform-on-aws) no reciben configuración administrada por servidor, por lo que entregue la lista de permitidos a través de MDM o archivos de configuración administrada allí.287* Las sesiones en [proveedores de terceros](/docs/es/server-managed-settings#platform-availability) como Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry, y [Claude Platform en AWS](/docs/es/claude-platform-on-aws) no reciben configuración administrada por servidor, por lo que entregue la lista de permitidos a través de MDM o archivos de configuración administrada allí.

205* La entrega administrada por servidor también requiere que la sesión se autentique con un inicio de sesión de organización o una clave API configurada directamente. Las flotas que generan claves solo a través de un script [`apiKeyHelper`](/docs/es/settings#available-settings) deben entregar la lista de permitidos a través de MDM o archivos de configuración administrada.288* La entrega administrada por servidor también requiere que la sesión se autentique con un [inicio de sesión o clave elegible](/docs/es/server-managed-settings#platform-availability). Las flotas que generan claves solo a través de un script [`apiKeyHelper`](/docs/es/settings-reference#apikeyhelper) deben entregar la lista de permitidos a través de MDM o archivos de configuración administrada.

206* La pestaña Código de escritorio también aloja [sesiones SSH](/docs/es/desktop#ssh-sessions), que leen el archivo de configuración administrada del host remoto en el que se ejecutan. Consulte [Configuración administrada de escritorio](/docs/es/desktop#managed-settings).289* La pestaña de código de escritorio también aloja [sesiones SSH](/docs/es/desktop#ssh-sessions), que leen el archivo de configuración administrada del host remoto en el que se ejecutan. Consulte [Configuración administrada de escritorio](/docs/es/desktop#managed-settings).

207* Los selectores de modelo en claude.ai y en la aplicación de escritorio ocultan o atenúan los modelos excluidos por la lista de permitidos de su organización. El estado del selector es una conveniencia para los usuarios; la aplicación ocurre en la sesión.290* Los selectores de modelos en claude.ai y en la aplicación de escritorio ocultan o atenúan los modelos excluidos por la lista de permitidos de su organización. El estado del selector es una conveniencia para los usuarios; la aplicación ocurre en la sesión.

208 291

209<h3 id="default-model-behavior">292<h3 id="default-model-behavior">

210 Comportamiento del modelo predeterminado293 Comportamiento del modelo predeterminado

211</h3>294</h3>

212 295

213La opción Predeterminado en el selector de modelo no se ve afectada por `availableModels` a menos que [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) también esté establecido. Por sí solo, `availableModels` deja Predeterminado disponible, resolviéndose al [valor predeterminado de tiempo de ejecución del sistema](#default-model-setting) para la cuenta. Si ese valor predeterminado es un modelo que tiene la intención de restringir, establezca `enforceAvailableModels` también.296Por sí solo, `availableModels` deja la opción Predeterminado en el [predeterminado de tiempo de ejecución](#default-model-setting) del sistema para la cuenta hasta que también establezca [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model). Si ese predeterminado es un modelo que tiene la intención de restringir, establezca también `enforceAvailableModels`.

214 297

215Un array `availableModels` vacío nunca activa la aplicación del modelo Predeterminado: con `availableModels: []`, las selecciones de modelo nombrado se bloquean pero el modelo Predeterminado para el tipo de cuenta permanece utilizable independientemente de `enforceAvailableModels`.298Una matriz `availableModels` vacía nunca activa la aplicación del modelo predeterminado: con `availableModels: []`, las selecciones de modelos nombrados se bloquean pero el modelo predeterminado para el tipo de cuenta sigue siendo utilizable independientemente de `enforceAvailableModels`.

216 299

217<h3 id="enforce-the-allowlist-for-the-default-model">300<h3 id="enforce-the-allowlist-for-the-default-model">

218 Aplicar la lista de permitidos para el modelo Predeterminado301 Aplicar la lista de permitidos para el modelo predeterminado

219</h3>302</h3>

220 303

221Establezca `enforceAvailableModels: true` junto con una `availableModels` no vacía en configuración administrada para extender la lista de permitidos a la opción Predeterminado. Esto requiere Claude Code v2.1.175 o posterior.304Establezca `enforceAvailableModels: true` junto con un `availableModels` no vacío en la configuración administrada para extender la lista de permitidos a la opción Predeterminado. Esto requiere Claude Code v2.1.175 o posterior.

222 305

223```json theme={null}306```json theme={null}

224{307{

227}310}

228```311```

229 312

230La opción Predeterminado se resuelve a la cuenta-tipo predeterminado, o al [modelo predeterminado de la organización](#organization-default-model) cuando un administrador ha establecido uno. Cuando ese modelo no está en la lista de permitidos, la opción Predeterminado se resuelve a la primera entrada `availableModels` que nombra un modelo permitido y disponible, y la fila Predeterminado del selector `/model` muestra ese modelo. Esto se aplica en todas partes donde se alcanza el valor predeterminado: inicio de sesión, seleccionar Predeterminado en `/model`, la palabra clave `"default"` en [cadenas de modelo de reserva](#fallback-model-chains), y el fallback utilizado cuando se descarta una selección excluida.313La opción Predeterminado se resuelve al predeterminado del tipo de cuenta, o al [modelo predeterminado de organización](#organization-default-model) cuando un administrador ha establecido uno. Cuando ese modelo no está en la lista de permitidos, la opción Predeterminado se resuelve en su lugar a la primera entrada `availableModels` que nombra un modelo permitido y disponible, y la fila Predeterminado del selector `/model` muestra ese modelo. Esto se aplica en todas partes donde se alcanza el predeterminado: inicio de sesión, seleccionar Predeterminado en `/model`, la palabra clave `"default"` en [cadenas de modelo de respaldo](#fallback-model-chains), y el respaldo utilizado cuando se descarta una selección excluida.

231 314

232`enforceAvailableModels` no tiene efecto cuando `availableModels` no está establecido o está vacío: con `availableModels: []`, el modelo Predeterminado para el tipo de cuenta permanece utilizable, por lo que la configuración no puede bloquear a los usuarios de cada modelo. Cuando `availableModels` no está vacío pero ninguna entrada se resuelve a un modelo permitido y disponible, la aplicación se degrada y Predeterminado cae al valor predeterminado del tipo de cuenta, con una advertencia visible solo bajo `--debug`. Mantenga al menos una entrada garantizada disponible en la lista para evitar esto.315`enforceAvailableModels` remapea la opción Predeterminado solo cuando `availableModels` no está vacío. Con `availableModels: []`, el modelo predeterminado para el tipo de cuenta sigue siendo utilizable, por lo que la configuración no puede bloquear a los usuarios de cada modelo. Cuando `availableModels` no está vacío pero ninguna entrada se resuelve a un modelo permitido y disponible, la aplicación se omite y Predeterminado se resuelve al predeterminado del tipo de cuenta, con una advertencia visible solo bajo `--debug`. Mantenga al menos una entrada garantizada disponible en la lista para evitar esto.

233 316

234Implemente ambas claves en la [fuente administrada de mayor precedencia](/docs/es/settings#settings-precedence): las fuentes administradas implementadas por el administrador no se fusionan, por lo que un par colocado en un archivo de configuración administrada se ignora cuando la consola de administración entrega cualquier configuración.317Implemente ambas claves juntas en la fuente administrada de mayor rango que entregue. De forma predeterminada, Claude Code lee solo esa fuente, por lo que un par colocado en un archivo de configuración administrada se ignora cuando la consola de administración entrega cualquier configuración; bajo la fusión de opción de participación en [cómo Claude Code combina fuentes administradas](/docs/es/managed-settings#how-claude-code-combines-managed-sources), Claude Code aún ignora un mapa `modelOverrides` de una fuente clasificada por debajo de la que establece `availableModels`.

235 318

236<h3 id="control-the-model-users-run-on">319<h3 id="control-the-model-users-run-on">

237 Controlar el modelo en el que se ejecutan los usuarios320 Controlar el modelo en el que se ejecutan los usuarios

238</h3>321</h3>

239 322

240La configuración `model` es una selección inicial, no una aplicación. Establece qué modelo está activo cuando comienza una sesión, pero los usuarios aún pueden abrir `/model` y elegir Predeterminado, que se resuelve al [valor predeterminado de tiempo de ejecución del sistema](#default-model-setting) independientemente de lo que esté configurado en `model`, a menos que [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) lo redirija.323La configuración `model` es una selección inicial, no una aplicación. Establece qué modelo está activo cuando comienza una sesión, pero los usuarios aún pueden abrir `/model` y seleccionar Predeterminado, que se resuelve al [predeterminado de tiempo de ejecución](#default-model-setting) del sistema independientemente de lo que se establezca `model`, a menos que [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) lo redirija.

241 324

242Para controlar completamente la experiencia del modelo, combine estas configuraciones:325Para controlar completamente la experiencia del modelo, combine estas configuraciones:

243 326

244* **`availableModels`**: restringe a qué modelos nombrados pueden cambiar los usuarios327* **`availableModels`**: restringe qué modelos nombrados pueden cambiar los usuarios

245* **`enforceAvailableModels`**: extiende la lista de permitidos `availableModels` a la opción Predeterminado, de modo que Predeterminado no pueda resolverse a un modelo fuera de la lista328* **`enforceAvailableModels`**: extiende la lista de permitidos `availableModels` a la opción Predeterminado, por lo que Predeterminado no puede resolverse a un modelo fuera de la lista

246* **`model`**: establece la selección de modelo inicial cuando comienza una sesión329* **`model`**: establece la selección de modelo inicial cuando comienza una sesión

247* **`ANTHROPIC_DEFAULT_SONNET_MODEL`** / **`ANTHROPIC_DEFAULT_OPUS_MODEL`** / **`ANTHROPIC_DEFAULT_HAIKU_MODEL`** / **`ANTHROPIC_DEFAULT_FABLE_MODEL`**: controlan a qué se resuelven la opción Predeterminado y los alias `sonnet`, `opus`, `haiku` y `fable`330* **`ANTHROPIC_DEFAULT_SONNET_MODEL`** / **`ANTHROPIC_DEFAULT_OPUS_MODEL`** / **`ANTHROPIC_DEFAULT_HAIKU_MODEL`** / **`ANTHROPIC_DEFAULT_FABLE_MODEL`**: controlan a qué se resuelven los alias `sonnet`, `opus`, `haiku`, y `fable`, y qué versión usa el [predeterminado del tipo de cuenta](#default-model-setting)

248 331

249Este ejemplo inicia a los usuarios en Sonnet 4.5, limita el selector a Sonnet y Haiku, y asegura que Predeterminado se resuelva a un modelo en la lista de permitidos en lugar del valor predeterminado del nivel:332Este ejemplo inicia a los usuarios en Sonnet 4.5, limita el selector a Sonnet y Haiku, y asegura que Predeterminado se resuelva a un modelo en la lista de permitidos en lugar del predeterminado de nivel:

250 333

251```json theme={null}334```json theme={null}

252{335{

259}342}

260```343```

261 344

262Sin `enforceAvailableModels` o el bloque `env`, un usuario que seleccione Predeterminado en el selector obtendría la versión más reciente para su nivel, omitiendo la fijación de versión en `model` y `availableModels`. Las dos configuraciones cubren diferentes alcances: `enforceAvailableModels` hace que Predeterminado obedezca la lista de permitidos, mientras que el bloque `env` fija qué versión resuelve un alias permitido como `sonnet`. Use `enforceAvailableModels` solo cuando restringir familias de modelos sea suficiente; agregue el bloque `env` cuando también necesite fijar una versión específica.345Sin `enforceAvailableModels` o el bloque `env`, un usuario que selecciona Predeterminado en el selector obtiene el [predeterminado de tiempo de ejecución](#default-model-setting) en lugar de la versión fijada en `model`. Las dos configuraciones cubren diferentes alcances: `enforceAvailableModels` hace que Predeterminado obedezca la lista de permitidos, mientras que el bloque `env` fija qué versión se resuelve un alias permitido como `sonnet`. Use `enforceAvailableModels` solo cuando restringir familias de modelos sea suficiente; agregue el bloque `env` cuando también necesite fijar una versión específica.

263 346

264<h3 id="merge-behavior">347<h3 id="merge-behavior">

265 Comportamiento de fusión348 Comportamiento de fusión

266</h3>349</h3>

267 350

268Cuando la [fuente de configuración administrada de mayor precedencia](/docs/es/server-managed-settings#settings-precedence) define `availableModels`, esa lista sola se aplica: las entradas en configuración de usuario, proyecto o local no pueden extenderla, y las fuentes administradas implementadas por el administrador no se fusionan entre sí, por lo que una lista implementada en un archivo de configuración administrada se ignora cuando la configuración administrada por servidor entrega cualquier clave. De lo contrario, las listas de configuración de usuario, proyecto y local se [concatenan y desduplican](/docs/es/settings#settings-precedence) como otras configuraciones de array. A partir de Claude Code v2.1.175, la lista administrada reemplaza entradas de menor precedencia; las versiones anteriores las fusionan.351Cuando la configuración administrada que Claude Code aplica define `availableModels`, esa lista sola se aplica, aparte de una [plataforma host que proporciona la suya propia](/docs/es/settings#exceptions-to-managed-settings-precedence): las entradas en la configuración de usuario, proyecto o local no pueden extenderla, y Claude Code nunca fusiona `availableModels` entre fuentes administradas tampoco; [cómo Claude Code combina fuentes administradas](/docs/es/managed-settings#how-claude-code-combines-managed-sources) indica qué lista de fuente se aplica. De lo contrario, las listas de la configuración de usuario, proyecto y local se [concatenan y desduplican](/docs/es/settings#settings-precedence) como otras configuraciones de matriz. Antes de Claude Code v2.1.175, las entradas de alcances de menor precedencia se fusionaban en la lista administrada en lugar de ser reemplazadas por ella.

269 352

270Dentro de la lista efectiva, una entrada que nombra un modelo específico en una familia, ya sea un prefijo de versión o un ID de modelo completo, desactiva la entrada comodín de esa familia: `["sonnet", "claude-sonnet-4-5"]` permite solo versiones de Sonnet 4.5, no cada modelo de Sonnet.353Dentro de la lista efectiva, una entrada que nombra un modelo específico en una familia, ya sea un prefijo de versión o un ID de modelo completo, deshabilita la entrada de comodín de esa familia: `["sonnet", "claude-sonnet-4-5"]` permite solo versiones de Sonnet 4.5, no cada modelo de Sonnet.

271 354

272<h3 id="mantle-model-ids">355<h3 id="mantle-model-ids">

273 IDs de modelo Mantle356 IDs de modelo de Mantle

274</h3>357</h3>

275 358

276Cuando el [punto final Bedrock Mantle](/docs/es/amazon-bedrock#use-the-mantle-endpoint) está habilitado, las entradas en `availableModels` que comienzan con `anthropic.` se agregan al selector `/model` como opciones personalizadas y se enrutan al punto final Mantle. Esta es una excepción a la coincidencia de alias descrita en [Fijar modelos para implementaciones de terceros](#pin-models-for-third-party-deployments). La configuración aún restringe el selector a las entradas enumeradas, y un ID de Mantle incrusta un nombre de familia, por lo que cuenta como una entrada específica y desactiva el comodín de esa familia: junto con cualquier ID de Mantle, enumere los prefijos de versión o IDs completos que desea mantener seleccionables. Consulte [Comportamiento de fusión](#merge-behavior).359Cuando el [punto final de Amazon Bedrock Mantle](/docs/es/amazon-bedrock#use-the-mantle-endpoint) está habilitado, las entradas en `availableModels` que comienzan con `anthropic.` se agregan al selector `/model` como opciones personalizadas y se enrutan al punto final de Mantle. Esta es una excepción a la coincidencia de alias descrita en [Fijar modelos para implementaciones de terceros](#pin-models-for-third-party-deployments). La configuración aún restringe el selector a entradas enumeradas, y un ID de Mantle incrusta un nombre de familia, por lo que cuenta como una entrada específica y deshabilita el comodín de esa familia: junto con cualquier ID de Mantle, enumere los prefijos de versión o IDs completos que desea mantener seleccionables. Consulte [Comportamiento de fusión](#merge-behavior).

277 360

278<h3 id="organization-model-restrictions">361<h3 id="organization-model-restrictions">

279 Restricciones de modelo de organización362 Restricciones de modelo de organización

280</h3>363</h3>

281 364

282Los administradores de la organización en planes Claude Enterprise restringen qué modelos pueden ejecutar los miembros deshabilitando modelos individuales en la consola de administración de claude.ai. Esta restricción se entrega con los derechos de la cuenta cuando Claude Code se autentica, separada de cualquier lista `availableModels` en configuración, y el servidor aplica la misma restricción de forma independiente cuando se crea una sesión. Requiere Claude Code v2.1.187 o posterior.365Los administradores de organización en planes Claude Enterprise restringen qué modelos pueden ejecutar los miembros deshabilitando modelos individuales en la consola de administración de claude.ai. Esta restricción se entrega con los derechos de la cuenta cuando Claude Code se autentica, separada de cualquier lista `availableModels` en la configuración, y el servidor aplica la misma restricción de forma independiente cuando se crea una sesión. Requiere Claude Code v2.1.187 o posterior.

283 366

284La restricción se aplica cuando un miembro inicia sesión o utiliza su propia clave API. Las credenciales con alcance de organización, como las claves de servicio de la organización, no están vinculadas a un usuario, por lo que la restricción no se aplica a ellas.367La restricción se aplica cuando un miembro inicia sesión o usa su propia clave API. Las credenciales con alcance de organización, como las claves de servicio de organización, no están vinculadas a un usuario, por lo que la restricción no se aplica a ellas.

285 368

286La Consola de Claude no tiene control de restricción de modelo. Las organizaciones sin un plan Claude Enterprise, incluidas aquellas cuyos miembros se autentican a través de la API de Anthropic, restringen modelos con [`availableModels`](#restrict-model-selection) en [configuración administrada](/docs/es/settings#settings-files) en su lugar, agregando [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) para cubrir la opción Predeterminado. Estas configuraciones se aplican por Claude Code mismo, no por el servidor.369La consola de Claude no tiene control de restricción de modelo. Las organizaciones sin un plan Claude Enterprise, incluidas las cuyos miembros se autentican a través de la API de Anthropic, restringen modelos con [`availableModels`](#restrict-model-selection) en [configuración administrada](/docs/es/managed-settings) en su lugar, agregando [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) para cubrir la opción Predeterminado. Estas configuraciones se aplican por Claude Code mismo, no por el servidor.

287 370

288Un modelo restringido se oculta del selector `/model`. Seleccionarlo por nombre con `--model`, la variable de entorno `ANTHROPIC_MODEL`, o la configuración `model` muestra el aviso `Model "<name>" is restricted by your organization's settings. Using <model> instead.` y la sesión comienza en un modelo permitido. Escribir `/model <name>` para un modelo restringido se rechaza con `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` y la sesión mantiene su modelo actual.371Un modelo restringido se oculta del selector `/model`. Seleccionarlo por nombre con `--model`, la variable de entorno `ANTHROPIC_MODEL`, o la configuración `model` muestra el aviso `Model "<name>" is restricted by your organization's settings. Using <model> instead.` y la sesión comienza en un modelo permitido. Escribir `/model <name>` para un modelo restringido se rechaza con `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` y la sesión mantiene su modelo actual.

289 372

290Un [alias de familia de modelos](#restrict-model-selection) como `opus` se resuelve a la versión más reciente de su familia que la organización permite, con el mismo aviso de sustitución. `/model <alias>` se rechaza solo cuando cada versión de su familia está restringida; un alias establecido con `--model`, `ANTHROPIC_MODEL`, o la configuración `model` aún se reemplaza al inicio en ese caso. Antes de v2.1.205, un alias de familia se sustituía o rechazaba basándose únicamente en su versión más reciente lanzada, incluso cuando se permitía una versión anterior.373Un [alias de familia de modelos](#restrict-model-selection) como `opus` se resuelve a su modelo habitual cuando la organización lo permite. Cuando la organización restringe ese modelo, Claude Code sustituye la versión más nueva de la familia que la organización permite, con el mismo aviso de sustitución. `/model <alias>` se rechaza solo cuando cada versión de su familia está restringida; un alias establecido con `--model`, `ANTHROPIC_MODEL`, o la configuración `model` aún se reemplaza al inicio en ese caso. Antes de v2.1.205, un alias de familia se sustituía o rechazaba basándose solo en su versión más nueva lanzada, incluso cuando se permitía una versión anterior.

291 374

292Las restricciones se aplican org-wide o por rol:375Las restricciones se aplican en toda la organización o por rol:

293 376

294* Desactivar un modelo a nivel de organización lo elimina para cada miembro.377* Deshabilitar un modelo a nivel de organización lo elimina para cada miembro.

295* El acceso a nivel de rol otorga diferentes modelos a diferentes roles personalizados, y un miembro que tiene varios roles puede usar cualquier modelo que uno de sus roles otorgue.378* El acceso a nivel de rol otorga diferentes modelos a diferentes roles personalizados, y un miembro que tiene varios roles puede usar cualquier modelo que uno de sus roles otorgue.

296* Los modelos Haiku siempre están disponibles y no se pueden desactivar, por lo que cada miembro mantiene al menos un modelo utilizable.379* Los modelos de Haiku siempre están disponibles y no se pueden deshabilitar, por lo que cada miembro mantiene al menos un modelo utilizable.

297* Un cambio de acceso toma efecto en nuevas solicitudes dentro de aproximadamente un minuto; el selector `/model` lo refleja la próxima vez que comienza una sesión.380* Un cambio de acceso entra en vigor en nuevas solicitudes dentro de aproximadamente un minuto; el selector `/model` lo refleja la próxima vez que comienza una sesión.

298 381

299Ambas restricciones se aplican juntas: un modelo es seleccionable solo cuando está permitido por `availableModels` y no está restringido por la organización. Las restricciones de la organización se entregan a sesiones en la API de Anthropic e implementaciones de [puerta de enlace LLM](/docs/es/llm-gateway). Las sesiones en Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, y Claude Platform en AWS no las reciben, por lo que use `availableModels` en esos proveedores en su lugar.382Ambas restricciones se aplican juntas: un modelo es seleccionable solo cuando está permitido por `availableModels` y no está restringido por la organización. Las restricciones de organización llegan a sesiones en la API de Anthropic y implementaciones de [puerta de enlace LLM](/docs/es/llm-gateway) solo; en cualquier otro proveedor, use `availableModels` en su lugar.

300 383

301<h2 id="organization-default-model">384<h2 id="organization-default-model">

302 Modelo predeterminado de la organización385 Modelo predeterminado de la organización

303</h2>386</h2>

304 387

305Los administradores de la organización en planes Claude Enterprise pueden establecer un modelo predeterminado para los miembros de Claude Code desde la consola de administración de claude.ai, para toda la organización o por rol personalizado. Cuando se establece uno, la opción Predeterminado se resuelve a ese modelo en lugar del [predeterminado del tipo de cuenta](#default-model-setting). Requiere Claude Code v2.1.196 o posterior.388Los administradores de la organización en planes Claude Enterprise pueden establecer un modelo predeterminado para los miembros de Claude Code desde la consola de administración de claude.ai, para toda la organización o por rol personalizado. Cuando se establece uno, la opción Predeterminado se resuelve a ese modelo. Requiere Claude Code v2.1.196 o posterior.

306 389

307La fila Predeterminado en el selector `/model` muestra el nombre del modelo predeterminado de la organización con la etiqueta Predeterminado de org. La etiqueta lee Predeterminado de org ya sea que el administrador haya establecido el predeterminado para toda la organización o para su rol. Un predeterminado de rol cubre miembros de ese rol personalizado y tiene prioridad sobre el predeterminado de toda la organización; cuando varios de sus roles establecen diferentes predeterminados, se aplica el modelo más capaz.390La fila Predeterminado en el selector `/model` muestra el nombre del modelo predeterminado de la organización con la etiqueta Predeterminado de org. La etiqueta dice Predeterminado de org tanto si el administrador estableció el predeterminado para toda la organización como para su rol. Un predeterminado de rol cubre a los miembros de ese rol personalizado y tiene prioridad sobre el predeterminado de toda la organización; cuando varios de sus roles establecen predeterminados diferentes, se aplica el modelo más capaz.

308 391

309El modelo predeterminado de la organización es un punto de partida, no una restricción, y cualquier otra selección de modelo tiene prioridad sobre él:392El modelo predeterminado de la organización es un punto de partida, no una restricción. Estas selecciones tienen prioridad sobre él:

310 393

311* la bandera `--model` y la variable de entorno `ANTHROPIC_MODEL`394* la bandera `--model` y la variable de entorno `ANTHROPIC_MODEL`

312* un valor `model` en [configuración administrada](/docs/es/settings#settings-files) o suministrado a través de `--settings`395* un valor `model` en [configuración administrada](/docs/es/managed-settings) o suministrado a través de `--settings`

313* un valor `model` en su configuración de usuario, proyecto o local, incluido un modelo que guarda con `/model`396* un valor `model` en su configuración de usuario, proyecto o local, incluido un modelo que guarde con `/model`

314 397

315Los administradores también pueden configurar el modelo predeterminado de la organización para anular la selección del usuario. Con la anulación activada, tiene prioridad sobre el valor `model` en la configuración de usuario, proyecto y local, por lo que un modelo que guarda con `/model` se aplica para la sesión actual y el modelo predeterminado de la organización regresa en el siguiente lanzamiento. Cuando su selección difiere, `/model` muestra `Your organization's default (<model>) applies on restart`. La bandera `--model`, `ANTHROPIC_MODEL`, la configuración administrada y `--settings` aún tienen prioridad incluso con la anulación activada. La anulación está disponible para un conjunto limitado de organizaciones; pregunte a su equipo de cuenta de Anthropic sobre disponibilidad.398Los administradores también pueden configurar el modelo predeterminado de la organización para anular la selección del usuario. Con la anulación activada, tiene prioridad sobre el valor `model` en la configuración de usuario, proyecto y local, por lo que un modelo que guarde con `/model` se aplica para la sesión actual y el modelo predeterminado de la organización vuelve en el siguiente lanzamiento. Cuando su selección difiere, `/model` muestra `Se aplica el predeterminado de su organización (<model>) al reiniciar`. La bandera `--model`, `ANTHROPIC_MODEL`, la configuración administrada y `--settings` siguen teniendo prioridad incluso con la anulación activada. La anulación está disponible para un conjunto limitado de organizaciones; consulte con su equipo de cuenta de Anthropic sobre la disponibilidad.

316 399

317Para limitar qué modelos pueden seleccionar los miembros, use [restricciones de modelo de organización](#organization-model-restrictions) o [`availableModels`](#restrict-model-selection) en su lugar.400Para limitar qué modelos pueden seleccionar los miembros, use [restricciones de modelo de la organización](#organization-model-restrictions) o [`availableModels`](#restrict-model-selection) en su lugar.

318 401

319Claude Code lee el modelo predeterminado de la organización una vez al inicio, por lo que un predeterminado que el administrador cambia a mitad de sesión toma efecto en el siguiente lanzamiento.402Claude Code lee el modelo predeterminado de la organización una vez al inicio, por lo que un predeterminado que el administrador cambia a mitad de sesión entra en vigor en el siguiente lanzamiento.

320 403

321Cuando el modelo predeterminado de la organización no anula la selección del usuario, el primer lanzamiento interactivo después de que el administrador lo cambia borra la clave `model` de su configuración de usuario una vez, por lo que se aplica el nuevo predeterminado. No cambia nada más en el archivo, y un modelo que guarda con `/model` después de ese lanzamiento se mantiene.404Cuando el modelo predeterminado de la organización no anula la selección del usuario, el primer lanzamiento interactivo después de que el administrador lo cambie borra la clave `model` de su configuración de usuario una sola vez, por lo que se aplica el nuevo predeterminado. No cambia nada más en el archivo, y un modelo que guarde con `/model` después de ese lanzamiento se mantiene.

322 405

323El modelo predeterminado de la organización pasa a través de las mismas verificaciones de restricción que cualquier otro modelo Predeterminado antes de ser adoptado:406El modelo predeterminado de la organización pasa a través de estas comprobaciones de restricción antes de ser adoptado:

324 407

325* [`availableModels`](#restrict-model-selection) por sí solo nunca limita la opción Predeterminado, por lo que un modelo predeterminado de la organización fuera de la lista de permitidos aún se aplica. Cuando [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) también está establecido, un modelo predeterminado de la organización fuera de la lista de permitidos se remapea a la primera entrada de la lista de permitidos, como cualquier otro Predeterminado408* [`availableModels`](#restrict-model-selection) por sí solo no se aplica al modelo predeterminado de la organización, por lo que un modelo predeterminado de la organización fuera de la lista de permitidos sigue aplicándose. Cuando [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) también está establecido, un modelo predeterminado de la organización fuera de la lista de permitidos se remapea a la primera entrada de la lista de permitidos, como cualquier otro Predeterminado

326* un modelo predeterminado de la organización que [restricciones de modelo de organización](#organization-model-restrictions) niegan para su cuenta se reemplaza por el modelo más nuevo permitido en su familia, o una familia de menor costo cuando cada versión de ella está restringida409* un modelo predeterminado de la organización que [restricciones de modelo de la organización](#organization-model-restrictions) deniegan para su cuenta se reemplaza por el modelo más reciente permitido en su familia, o una familia de menor costo cuando cada versión de ella está restringida

327* un modelo predeterminado de la organización que no está disponible para su cuenta en absoluto, como Fable 5 bajo [retención de datos cero](/docs/es/zero-data-retention), se omite, y la opción Predeterminado se resuelve al predeterminado del tipo de cuenta410* un modelo predeterminado de la organización que no está disponible para su cuenta en absoluto se omite, y la opción Predeterminado se resuelve como lo haría [sin un modelo predeterminado de la organización](#default-model-setting)

328 411

329A partir de v2.1.199, cuando el modelo predeterminado de la organización es una familia de modelo diferente del predeterminado habitual del tipo de cuenta, el selector `/model` mantiene una fila separada para esa familia habitual, por lo que aún puede cambiar a ella para una sesión. En v2.1.196 a v2.1.198 esa fila falta del selector.412A partir de v2.1.199, cuando el modelo predeterminado de la organización es una familia de modelos diferente del predeterminado habitual del tipo de cuenta, el selector `/model` mantiene una fila separada para esa familia habitual, por lo que aún puede cambiar a ella para una sesión. En v2.1.196 a v2.1.198 esa fila falta en el selector.

330 413

331El modelo predeterminado de la organización se entrega a sesiones autenticadas con la API de Anthropic. Las sesiones en implementaciones de [puerta de enlace LLM](/docs/es/llm-gateway), Amazon Bedrock, Plataforma de Agentes de Google Cloud, Microsoft Foundry, y Claude Platform en AWS no lo reciben. Para establecer un predeterminado en esas implementaciones, use la clave `model` en [configuración administrada](/docs/es/settings#settings-files) en su lugar.414El modelo predeterminado de la organización llega solo a sesiones autenticadas con la API de Anthropic. Para establecer un predeterminado en cualquier otro lugar, incluidas las implementaciones de [puerta de enlace LLM](/docs/es/llm-gateway), use la clave `model` en [configuración administrada](/docs/es/managed-settings) en su lugar.

332 415

333<h2 id="organization-effort-limits">416<h2 id="organization-effort-limits">

334 Límites de esfuerzo de la organización417 Límites de esfuerzo de la organización

335</h2>418</h2>

336 419

337Los administradores de la organización en planes Claude Enterprise pueden establecer un [nivel de esfuerzo](#adjust-effort-level) máximo por modelo para cada rol personalizado, junto con [restricciones de modelo de organización](#organization-model-restrictions) a nivel de rol. Los niveles por encima del límite no se ofrecen en el selector `/effort`, y nombrar un nivel más alto con `--effort` o `/effort` se ejecuta en el límite en su lugar. En sesiones interactivas y ejecuciones de `--print` de texto sin formato, una advertencia nombra los niveles solicitados y aplicados; con salida `json` o `stream-json` o en agentes de fondo, el límite se aplica silenciosamente. Los límites son por modelo, por lo que cambiar de modelos puede cambiar qué niveles están disponibles. Cuando varios de sus roles otorgan el mismo modelo, se aplica el límite menos restrictivo. Requiere Claude Code v2.1.195 o posterior.420Los administradores de la organización en planes Claude Enterprise pueden establecer un [nivel de esfuerzo](#adjust-effort-level) máximo por modelo para cada rol personalizado, junto con [restricciones de modelo de la organización](#organization-model-restrictions) a nivel de rol. Los niveles por encima del límite no se ofrecen en el selector `/effort`, y nombrar un nivel superior con `--effort` o `/effort` se ejecuta en el límite en su lugar. En sesiones interactivas y ejecuciones simples de texto `--print`, una advertencia nombra los niveles solicitados y aplicados; con salida `json` o `stream-json` o en agentes en segundo plano, el límite se aplica silenciosamente. Los límites son por modelo, por lo que cambiar de modelo puede cambiar qué niveles están disponibles. Cuando varios de sus roles otorgan el mismo modelo, se aplica el límite menos restrictivo. Requiere Claude Code v2.1.195 o posterior.

338 421

339Los límites de esfuerzo se entregan junto con [restricciones de modelo de organización](#organization-model-restrictions) y siguen la misma disponibilidad de proveedor: las sesiones en Amazon Bedrock, Plataforma de Agentes de Google Cloud, Microsoft Foundry, y Claude Platform en AWS no los reciben.422Los límites de esfuerzo se entregan junto con [restricciones de modelo de la organización](#organization-model-restrictions) y llegan a las mismas sesiones.

340 423

341<h2 id="special-model-behavior">424<h2 id="special-model-behavior">

342 Comportamiento especial del modelo425 Comportamiento especial del modelo

346 Configuración del modelo `default`429 Configuración del modelo `default`

347</h3>430</h3>

348 431

349El comportamiento de `default` depende del tipo de cuenta:432El comportamiento de `default` depende de tu tipo de cuenta:

350 433

351* **Max, Team Premium, Enterprise de pago por uso y API de Anthropic**: por defecto Opus 4.8434* **Max, Team Premium, Enterprise y Anthropic API**: por defecto Opus 5

352* **Claude Platform en AWS, Amazon Bedrock y Google Cloud's Agent Platform**: por defecto Opus 4.8435* **Claude Platform en AWS, Amazon Bedrock y Agent Platform de Google Cloud**: por defecto Opus 5

353* **Pro, Team Standard y asientos de suscripción Enterprise**: por defecto Sonnet 5436* **Pro y Team Standard**: por defecto Sonnet 5

354* **Microsoft Foundry**: por defecto Sonnet 4.5437* **Microsoft Foundry**: por defecto Sonnet 4.5

355 438

356Enterprise de pago por uso significa una organización Enterprise facturada por uso en lugar de por asiento de suscripción.439Antes de v2.1.219, `default` se resolvía a Opus 4.8 en Anthropic API, Max, Team Premium y Enterprise de pago por uso desde v2.1.154, y en Claude Platform en AWS, Amazon Bedrock y Agent Platform de Google Cloud desde v2.1.207. Antes de v2.1.207, `default` se resolvía a Opus 4.7 en Claude Platform en AWS y a Sonnet 4.5 en Amazon Bedrock y Agent Platform de Google Cloud.

~~357~~

358Antes de v2.1.207, `default` se resolvía a Opus 4.7 en Claude Platform en AWS y a Sonnet 4.5 en Amazon Bedrock y Google Cloud's Agent Platform.

359 440

360Cuando un administrador ha establecido un [modelo predeterminado de la organización](#organization-default-model), `default` se resuelve a ese modelo en lugar del predeterminado del tipo de cuenta anterior. Requiere Claude Code v2.1.196 o posterior.441Cuando un administrador ha establecido un [modelo predeterminado de la organización](#organization-default-model), `default` se resuelve a ese modelo en lugar del predeterminado del tipo de cuenta anterior. Requiere Claude Code v2.1.196 o posterior. `default` también puede resolverse al modelo que estableces con [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), bajo las condiciones enumeradas en su sección.

361 442

362Cuando la configuración administrada [aplica la lista de permitidos para el modelo predeterminado](#enforce-the-allowlist-for-the-default-model) y el predeterminado del tipo de cuenta no está en `availableModels`, `default` se resuelve al predeterminado aplicado en lugar del predeterminado del tipo de cuenta anterior. Cuando ambos se aplican, el modelo predeterminado de la organización reemplaza el predeterminado del tipo de cuenta primero y la aplicación se aplica a él: un modelo predeterminado de la organización en la lista de permitidos se mantiene, mientras que uno fuera de la lista se resuelve al Predeterminado aplicado.443Cuando la configuración administrada [aplica la lista de permitidos para el modelo Default](#enforce-the-allowlist-for-the-default-model) y el predeterminado del tipo de cuenta no está en `availableModels`, `default` se resuelve al Default aplicado en lugar del predeterminado del tipo de cuenta anterior. Cuando ambos se aplican, el modelo predeterminado de la organización reemplaza primero el predeterminado del tipo de cuenta y luego se aplica la aplicación: se mantiene un modelo predeterminado de la organización en la lista de permitidos, mientras que uno fuera de la lista se resuelve al Default aplicado.

363 444

364Fable 5 no es el modelo predeterminado en ningún tipo de cuenta. Las sesiones utilizan Fable 5 solo después de que lo elija, con `/model fable`, una configuración de `model`, o el alias `best` donde Fable 5 está disponible. Elegirlo con `/model` lo guarda como el modelo seleccionado en su configuración de usuario, por lo que las sesiones posteriores comienzan en Fable 5 hasta que cambie de modelos.445Los modelos Fable no son el predeterminado del tipo de cuenta en ningún plan o proveedor. Elegir uno con `/model` lo guarda como el modelo seleccionado en la configuración del usuario, por lo que las sesiones posteriores comienzan en él. Para el cambio único que Claude Code realiza en una selección de Fable 5 guardada en v2.1.255, consulta [Trabajar con Fable](#work-with-fable).

365 446

366<h3 id="opusplan-model-setting">447<h3 id="opusplan-model-setting">

367 Configuración del modelo `opusplan`448 Configuración del modelo `opusplan`

368</h3>449</h3>

369 450

370El alias de modelo `opusplan` proporciona un enfoque híbrido automatizado:451El alias del modelo `opusplan` proporciona un enfoque híbrido automatizado:

371 452

372* **En Plan Mode**: utiliza `opus` para razonamiento complejo y decisiones de arquitectura453* **En modo plan**: utiliza `opus` para razonamiento complejo y decisiones de arquitectura

373* **En Execution Mode**: cambia automáticamente a `sonnet` para generación de código e implementación454* **En modo ejecución**: cambia automáticamente a `sonnet` para generación de código e implementación

374 455

375Esto empareja el razonamiento de Opus para la planificación con la eficiencia de Sonnet para la ejecución.456Esto combina el razonamiento de Opus para la planificación con la eficiencia de Sonnet para la ejecución.

376 457

377La fase Opus en Plan Mode utiliza la misma ventana de contexto que la configuración del modelo `opus`. En los niveles de suscripción donde Opus se [actualiza automáticamente a contexto de 1M](#extended-context), `opusplan` recibe la actualización en Plan Mode también. Para forzar contexto de 1M para ambas fases cuando no está en un nivel de actualización automática, establezca el modelo en `opusplan[1m]`.458La fase Opus del modo plan utiliza la misma ventana de contexto que la configuración del modelo `opus`. En los niveles de suscripción donde Opus se [actualiza automáticamente a contexto de 1M](#extended-context), `opusplan` recibe la actualización en modo plan también. Para forzar contexto de 1M para ambas fases cuando no estás en un nivel de actualización automática, establece el modelo a `opusplan[1m]`.

378 459

379Cuando [`availableModels`](#restrict-model-selection) excluye el Opus más nuevo pero permite una versión anterior, por ejemplo `["sonnet", "claude-opus-4-6"]`, `opusplan` utiliza el Opus más nuevo permitido para la planificación y se mantiene solo en Sonnet cuando se excluye cada Opus. Una sesión de Haiku que normalmente se actualizaría a Sonnet en Plan Mode de manera similar utiliza el Sonnet más nuevo permitido, y se mantiene en Haiku solo cuando se excluye cada Sonnet. Antes de v2.1.205, Plan Mode se mantenía en el modelo de la sesión siempre que se excluyera la versión más nueva de la familia de actualización, incluso cuando la lista de permitidos permitía una anterior.460Cuando [`availableModels`](#restrict-model-selection) excluye el Opus más nuevo pero permite una versión anterior, por ejemplo `["sonnet", "claude-opus-4-6"]`, `opusplan` utiliza el Opus más nuevo permitido para la planificación y se mantiene solo en Sonnet cuando se excluye cada Opus. Una sesión de Haiku que normalmente se actualizaría a Sonnet en modo plan utiliza asimismo el Sonnet más nuevo permitido, y se mantiene solo en Haiku cuando se excluye cada Sonnet. Antes de v2.1.205, el modo plan se mantenía en el modelo de la sesión siempre que se excluía la versión más nueva de la familia de actualización, incluso cuando la lista de permitidos permitía una anterior.

380 461

381La sustitución de una versión anterior permitida se aplica en la API de Anthropic y [Claude Platform en AWS](/docs/es/claude-platform-on-aws). En Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry y Mantle, cuyos despliegues utilizan ID de modelo específicos del proveedor, Plan Mode se mantiene en el modelo de la sesión siempre que se excluya el modelo de actualización.462La sustitución de una versión anterior permitida se aplica en Anthropic API y [Claude Platform en AWS](/docs/es/claude-platform-on-aws). En Amazon Bedrock, Agent Platform de Google Cloud, Microsoft Foundry y Mantle, cuyas implementaciones utilizan ID de modelo específicos del proveedor, el modo plan se mantiene en el modelo de la sesión siempre que se excluya el modelo de actualización.

382 463

383Para un enfoque híbrido donde Claude decide a mitad de la tarea cuándo consultar un segundo modelo en lugar de cambiar en el límite del plan, consulte la [herramienta advisor](/docs/es/advisor).464Para un enfoque híbrido donde Claude decide a mitad de la tarea cuándo consultar un segundo modelo en lugar de cambiar en el límite del plan, consulta la [herramienta de asesor](/docs/es/advisor).

384 465

385<h3 id="fallback-model-chains">466<h3 id="fallback-model-chains">

386 Cadenas de modelos de respaldo467 Cadenas de modelos de reserva

387</h3>468</h3>

388 469

389Cuando el modelo principal está sobrecargado, no disponible o devuelve otro error de servidor no reintentable, Claude Code puede cambiar a un modelo de respaldo en lugar de fallar la solicitud. Los errores de autenticación, facturación, límite de velocidad, tamaño de solicitud y transporte nunca desencadenan un cambio; esos siguen su reintento normal y manejo de errores.470Cuando el modelo principal está sobrecargado, no disponible o devuelve otro error de servidor no reintentable, Claude Code puede cambiar a un modelo de reserva en lugar de fallar la solicitud. Los errores de autenticación, facturación, límite de velocidad, tamaño de solicitud y transporte, y una [denegación por la verificación de política de tu organización](/docs/es/errors#automatic-retries), nunca desencadenan un cambio; esos siguen su manejo normal de reintentos y errores.

390 471

391Configure uno o más modelos de respaldo y Claude Code los intenta en orden, mostrando un aviso cuando cambia. El cambio dura solo para el turno actual, por lo que su próximo mensaje intenta el modelo principal primero nuevamente. Las cadenas están limitadas a tres modelos después de la eliminación de duplicados, y las entradas adicionales se ignoran.472Configura uno o más modelos de reserva y Claude Code los intenta en orden, mostrando un aviso cuando cambia. El cambio dura solo el turno actual, por lo que tu siguiente mensaje intenta el modelo principal primero de nuevo. Claude Code limita las cadenas a tres modelos después de la eliminación de duplicados e ignora entradas adicionales.

392 473

393Establezca una cadena para una sesión con la bandera `--fallback-model`, que acepta una lista separada por comas:474Establece una cadena para una sesión con la bandera `--fallback-model`, que acepta una lista separada por comas:

394 475

395```bash theme={null}476```bash theme={null}

396claude --fallback-model sonnet,haiku477claude --fallback-model sonnet,haiku

397```478```

398 479

399Para persistir una cadena entre sesiones, establezca `fallbackModel` en [configuración](/docs/es/settings) como una matriz:480Para persistir una cadena entre sesiones, establece `fallbackModel` en [configuración](/docs/es/settings) como un array:

400 481

401```json theme={null}482```json theme={null}

402{483{

404}485}

405```486```

406 487

407La bandera `--fallback-model` tiene precedencia sobre la configuración `fallbackModel`. Cada elemento acepta un nombre de modelo o alias, y `"default"` se expande al modelo predeterminado.488La bandera `--fallback-model` tiene precedencia sobre la configuración `fallbackModel`. Cada entrada acepta un nombre de modelo o alias, y `"default"` se expande al modelo predeterminado.

489

490Claude Code no confirma la cadena al inicio y `/status` no la muestra. El aviso mostrado cuando ocurre un cambio es el primer signo visible de que una reserva está configurada.

491

492Cuando una solicitud falla, Claude Code intenta cada entrada en orden hasta que una la acepta. Una entrada que tampoco se puede alcanzar, como un modelo retirado fijado en la configuración, falla a la siguiente de la misma manera. Claude Code elimina dos tipos de entrada antes de ese recorrido:

408 493

409Dos casos causan que un elemento se omita:494* **Fuera de la lista de permitidos**: Claude Code descarta cualquier entrada no permitida por [`availableModels`](#restrict-model-selection) cuando lee la cadena.

495* **Ventana de contexto más pequeña durante la compactación**: la cadena también cubre [compactación](/docs/es/context-window#what-survives-compaction), pero Claude Code no recurrirá a un modelo con una ventana de contexto más pequeña que la del principal, ya que resumir allí cortaría parte de la conversación primero. Si cada reserva es más pequeña, la compactación muestra el error original y puedes reintentar.

410 496

411* **Modelo no disponible**: un modelo que no se puede alcanzar, como un modelo retirado fijado en la configuración, se omite y Claude Code continúa con el siguiente elemento.497Claude Code también aplica la cadena a [subagentes](/docs/es/sub-agents). Cuando la solicitud de un subagente falla, Claude Code intenta tus modelos de reserva configurados en orden, y el subagente continúa en el modelo que acepta la solicitud. El modelo de tu sesión no cambia. Antes de v2.1.247, un fallo que la cadena cubría terminaba el subagente.

412* **Fuera de la lista de permitidos**: un elemento no permitido por [`availableModels`](#restrict-model-selection) se descarta cuando se lee la cadena y nunca se intenta.

413 498

414<h3 id="automatic-model-fallback">499<h3 id="automatic-model-fallback">

415 Respaldo automático del modelo500 Reserva automática de modelo

416</h3>501</h3>

417 502

418Esta sección cubre el respaldo basado en contenido de Fable 5. Para respaldo basado en disponibilidad cuando un modelo está sobrecargado o no disponible, consulte [Cadenas de modelos de respaldo](#fallback-model-chains).503Esta sección cubre la reserva basada en contenido de modelos Fable y Opus 5. Para la reserva basada en disponibilidad cuando un modelo está sobrecargado o no disponible, consulta [Cadenas de modelos de reserva](#fallback-model-chains).

419 504

420Fable 5 se ejecuta con clasificadores de seguridad para contenido de ciberseguridad y biología. Cuando un clasificador marca una solicitud, Claude Code vuelve a ejecutar esa solicitud en el modelo Opus predeterminado de su proveedor y muestra un aviso en la transcripción. En la API de Anthropic, despliegues de [puerta de enlace LLM](/docs/es/llm-gateway) y [Claude Platform en AWS](/docs/es/claude-platform-on-aws), ese modelo es Opus 4.8. En la [puerta de enlace de aplicaciones Claude](/docs/es/claude-apps-gateway), es Opus 4.7 a menos que apunte el alias [`opus`](#environment-variables) a otro modelo.505Los modelos Fable y Opus 5 se ejecutan con clasificadores de seguridad, que con mayor frecuencia marcan contenido de ciberseguridad y biología. Cuando un clasificador marca una solicitud y la categoría marcada tiene un modelo de reserva, Claude Code vuelve a ejecutar la solicitud en ese modelo y muestra un aviso en la transcripción. Para esas dos categorías, el modelo de reserva depende de qué modelo rechazó:

421 506

422La sesión continúa en ese modelo Opus. Para volver a Fable 5, ejecute `/model fable`.507* **Fable 5.1 y Fable 5**: las solicitudes marcadas por biología se vuelven a ejecutar en Opus 5, y las solicitudes marcadas por ciberseguridad se vuelven a ejecutar en Opus 4.8.

508* **Opus 5**: las solicitudes marcadas por ciberseguridad se vuelven a ejecutar en Opus 4.8. Las solicitudes marcadas por biología terminan con un rechazo en su lugar, porque Opus 5 ejecuta sus propios clasificadores de biología sin modelo de reserva.

423 509

424El destino de respaldo se verifica contra [`availableModels`](#restrict-model-selection). Cuando está bloqueado, no ocurre respaldo. El rechazo aparece como un error normal y el modelo de la sesión no cambia.510En Amazon Bedrock, Agent Platform de Google Cloud y Microsoft Foundry, Claude Code resuelve estos objetivos a través de tu implementación, y si estableces `ANTHROPIC_DEFAULT_OPUS_MODEL`, las categorías que tienen una reserva se vuelven a ejecutar en el modelo fijado; consulta [Habilitar reserva en Bedrock, Agent Platform y Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).

511

512Después de una reserva, la sesión continúa en el modelo de reserva. Para volver a tu modelo original, ejecuta [`/model`](#setting-your-model).

513

514La reserva basada en categoría requiere Claude Code v2.1.219 o posterior. Antes de v2.1.219, cada solicitud de Fable 5 marcada se volvía a ejecutar en el modelo Opus predeterminado de tu proveedor, y Opus 5 no era una fuente de reserva.

515

516El modelo de reserva se verifica contra [`availableModels`](#restrict-model-selection). Cuando está bloqueado, no ocurre reserva. El rechazo se muestra como un error normal y el modelo de la sesión no cambia.

425 517

426<h4 id="check-what-triggered-fallback">518<h4 id="check-what-triggered-fallback">

427 Verificar qué desencadenó el respaldo519 Verificar qué desencadenó la reserva

428</h4>520</h4>

429 521

430El respaldo puede desencadenarse en la primera solicitud de una sesión, antes de que envíe algo inusual, porque la primera solicitud lleva contexto del espacio de trabajo como su contenido de CLAUDE.md y estado de git. Un repositorio que contiene material de seguridad o biología puede activar el clasificador solo en ese contexto.522La reserva puede desencadenarse en la primera solicitud de una sesión, antes de que envíes algo inusual, porque la primera solicitud lleva contexto del espacio de trabajo como tu contenido de CLAUDE.md y estado de git. Un repositorio que contiene material de seguridad o biología puede activar el clasificador solo en ese contexto.

431 523

432Para verificar si las personalizaciones son el desencadenante, inicie una sesión con `claude --safe-mode`, que desactiva personalizaciones como CLAUDE.md, skills, servidores MCP y hooks. El estado de git y los nombres de directorios no son personalizaciones y aún se incluyen.524Para verificar si las personalizaciones son el desencadenante, inicia una sesión con `claude --safe-mode`, que desactiva personalizaciones como CLAUDE.md, skills, servidores MCP y hooks. El estado de git y los nombres de directorios no son personalizaciones y aún se incluyen.

433 525

434<h4 id="ask-before-switching">526<h4 id="ask-before-switching">

435 Preguntar antes de cambiar527 Preguntar antes de cambiar

436</h4>528</h4>

437 529

438Para decidir qué sucede cada vez que se marca una solicitud, en lugar de cambiar automáticamente, ejecute `/config` y desactive "cambiar modelos cuando se marca un mensaje". Una solicitud marcada pausa la sesión con dos opciones: cambiar al modelo Opus o editar el indicador e intentar nuevamente en Fable 5.530Para decidir qué sucede cada vez que se marca una solicitud, en lugar de cambiar automáticamente, ejecuta `/config` y desactiva **Cambiar modelos cuando se marca un mensaje**, o establece [`switchModelsOnFlag`](/docs/es/settings-reference#switchmodelsonflag) a `false` en tu archivo de configuración. Una solicitud marcada pausa la sesión con dos opciones: cambiar al modelo de reserva, o editar el mensaje y reintentar en el modelo actual.

439 531

440Algunos casos se comportan de manera diferente:532Algunos casos se comportan de manera diferente:

441 533

442* Si ambos modelos marcan la misma solicitud, puede editar el indicador e intentar nuevamente, o iniciar una nueva sesión.534* Cuando la categoría marcada no tiene modelo de reserva, como una marca de biología en Opus 5, Claude Code no muestra el mensaje y la solicitud termina con el rechazo.

443* En sesiones móviles de [Claude Code en la web](/docs/es/claude-code-on-the-web), no se admite edición y reintento. Cambie de modelos o continúe la sesión desde un navegador de escritorio o la aplicación de escritorio.535* Si ambos modelos marcan la misma solicitud, puedes editar el mensaje e intentar de nuevo, o iniciar una nueva sesión.

444* En [modo no interactivo](/docs/es/cli-reference#cli-flags) e integraciones de SDK que no pueden mostrar el indicador, una solicitud marcada termina el turno con un rechazo en su lugar.536* En sesiones móviles de [Claude Code en la web](/docs/es/claude-code-on-the-web), no se admite edición y reintento. Cambia modelos, o continúa la sesión desde un navegador de escritorio o la aplicación de escritorio.

445* Cuando el destino de respaldo está bloqueado por [`availableModels`](#restrict-model-selection), el indicador no se muestra. La solicitud marcada termina con el rechazo, igual que el respaldo automático cuando el destino está bloqueado.537* En [modo no interactivo](/docs/es/cli-reference#cli-flags) e integraciones de SDK que no pueden mostrar el mensaje, una solicitud marcada termina el turno con un rechazo.

538* Cuando el objetivo de reserva está bloqueado por [`availableModels`](#restrict-model-selection), Claude Code no muestra el mensaje. La solicitud marcada termina con el rechazo, igual que la reserva automática cuando el objetivo está bloqueado.

446 539

447<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">540<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">

448 Habilitar respaldo en Bedrock, Agent Platform y Foundry541 Habilitar reserva en Bedrock, Agent Platform y Foundry

449</h4>542</h4>

450 543

451En [Amazon Bedrock](/docs/es/amazon-bedrock), [Google Cloud's Agent Platform](/docs/es/google-vertex-ai) y [Microsoft Foundry](/docs/es/microsoft-foundry), los ID de modelo son específicos del proveedor, por lo que el respaldo automático solo funciona cuando Claude Code puede identificar ambos modelos involucrados:544En [Amazon Bedrock](/docs/es/amazon-bedrock), [Agent Platform de Google Cloud](/docs/es/google-vertex-ai) y [Microsoft Foundry](/docs/es/microsoft-foundry), los ID de modelo son específicos del proveedor, por lo que la reserva automática solo funciona cuando Claude Code puede identificar ambos modelos involucrados:

452 545

453* Claude Code debe reconocer el modelo actual como Fable 5: el ID del modelo contiene `claude-fable-5`, coincide con el valor de `ANTHROPIC_DEFAULT_FABLE_MODEL`, o se asigna con [`modelOverrides`](#override-model-ids-per-version).546* Claude Code debe reconocer el modelo actual como una fuente de reserva. Fable 5.1 y Fable 5 se reconocen cuando el ID del modelo contiene `claude-fable-5`, coincide con el valor de `ANTHROPIC_DEFAULT_FABLE_MODEL`, o se asigna con [`modelOverrides`](#override-model-ids-per-version). Opus 5 se reconoce por su ID de modelo del proveedor o una asignación de [`modelOverrides`](#override-model-ids-per-version).

454* El destino de respaldo debe resolverse en un modelo Opus: el valor de `ANTHROPIC_DEFAULT_OPUS_MODEL` si se establece, de lo contrario una entrada Opus 4.8 en la lista de modelos del proveedor.547* El modelo de reserva debe resolverse en tu implementación. Si estableces `ANTHROPIC_DEFAULT_OPUS_MODEL`, las solicitudes marcadas se vuelven a ejecutan en ese modelo para cada categoría que tiene una reserva; una marca de biología en Opus 5 aún termina con un rechazo. Si no lo estableces, las solicitudes marcadas por ciberseguridad se vuelven a ejecutan en una entrada de Opus 4.8 en la lista de modelos del proveedor, y las solicitudes marcadas por biología de un modelo Fable en una entrada de Opus 5.

455 548

456Si no se puede identificar ninguno de los modelos, Claude Code no cambia automáticamente. La solicitud marcada termina con un mensaje de rechazo, y puede cambiar de modelos con [`/model`](#setting-your-model) e intentar nuevamente. Para habilitar el respaldo automático en estos proveedores, establezca `ANTHROPIC_DEFAULT_FABLE_MODEL` en su ID de modelo Fable 5 y `ANTHROPIC_DEFAULT_OPUS_MODEL` en su ID de modelo Opus 4.8.549Si alguno de los modelos no se puede identificar, Claude Code no cambia automáticamente. La solicitud marcada termina con un mensaje de rechazo, y puedes cambiar modelos con [`/model`](#setting-your-model) e intentar de nuevo. Establecer `ANTHROPIC_DEFAULT_FABLE_MODEL` a tu ID de modelo Fable habilita el reconocimiento de Fable. Establecer `ANTHROPIC_DEFAULT_OPUS_MODEL` a un ID de modelo Opus proporciona un objetivo de reserva para las categorías marcadas, a menos que el pin nombre un modelo fuera de la familia Opus o el modelo que rechazó; entonces Claude Code no cambia y el rechazo se mantiene.

457 550

458<h4 id="security-research-and-biology-workloads">551<h4 id="security-research-and-biology-workloads">

459 Cargas de trabajo de investigación de seguridad y biología552 Investigación de seguridad y cargas de trabajo de biología

460</h4>553</h4>

461 554

462Las cargas de trabajo en seguridad ofensiva o biología, incluidas pruebas de penetración, ejercicios Capture the Flag (CTF) y bases de código adyacentes a la biología, desencadenan respaldo frecuentemente, a menudo en la primera solicitud. Para trabajo de biología sustancial, espere que casi todas las solicitudes se redirijan.555Las cargas de trabajo en seguridad ofensiva o biología, incluidas pruebas de penetración, ejercicios Capture the Flag (CTF) y bases de código adyacentes a biología, desencadenan reserva frecuentemente, a menudo en la primera solicitud. Para trabajo sustancial de biología en Fable 5.1 o Fable 5, Claude Code mueve la sesión a Opus 5 en la primera solicitud marcada, y las solicitudes posteriores marcadas por biología terminan en rechazos allí, porque Opus 5 no tiene reserva de biología. En Opus 5, obtienes esos rechazos desde la primera solicitud marcada.

463 556

464Este es el enrutamiento esperado para estos dominios, no una bandera de cuenta. Si su organización necesita capacidad de clase Fable para este trabajo, pregunte a su equipo de cuenta de Anthropic sobre programas de acceso de confianza.557Este es el enrutamiento esperado para estos dominios, no una marca de cuenta. Si tu organización necesita capacidad de clase Fable para este trabajo, pregunta a tu equipo de cuenta de Anthropic sobre programas de acceso de confianza.

465 558

466<h3 id="adjust-effort-level">559<h3 id="adjust-effort-level">

467 Ajustar el nivel de esfuerzo560 Ajustar el nivel de esfuerzo

468</h3>561</h3>

469 562

470[Los niveles de esfuerzo](https://platform.claude.com/docs/es/build-with-claude/effort) controlan el razonamiento adaptativo, que permite que el modelo decida si y cuánto pensar en cada paso basado en la complejidad de la tarea. El esfuerzo menor es más rápido y económico para tareas directas, mientras que el esfuerzo mayor proporciona un razonamiento más profundo para problemas complejos.563Los [niveles de esfuerzo](https://platform.claude.com/docs/en/build-with-claude/effort) controlan el razonamiento adaptativo, que permite al modelo decidir si y cuánto pensar en cada paso según la complejidad de la tarea. El esfuerzo menor es más rápido y económico para tareas sencillas, mientras que el esfuerzo mayor proporciona razonamiento más profundo para problemas complejos.

471 564

472Los niveles de esfuerzo disponibles dependen del modelo. Los modelos no listados aquí no admiten esfuerzo:565Los niveles de esfuerzo disponibles dependen del modelo. Los modelos no enumerados aquí no admiten esfuerzo:

473 566

474| Modelo | Niveles |567| Modelo | Niveles |

475| :---------------------------- | :-------------------------------------- |568| :------------------------------------ | :-------------------------------------- |

479 572

480Si establece un nivel que el modelo activo no admite, Claude Code retrocede al nivel más alto admitido en o por debajo del que estableció. Por ejemplo, `xhigh` se ejecuta como `high` en Opus 4.6. Su organización también puede limitar qué niveles están disponibles para un modelo; consulte [Límites de esfuerzo de la organización](#organization-effort-limits).573Si estableces un nivel que el modelo activo no admite, Claude Code recurre al nivel más alto admitido en o por debajo del que estableces. Por ejemplo, `xhigh` se ejecuta como `high` en Opus 4.6. Tu organización también puede limitar qué niveles están disponibles para un modelo; consulta [Límites de esfuerzo de la organización](#organization-effort-limits).

481 574

482El esfuerzo predeterminado es `high` en Fable 5, Sonnet 5, Opus 4.8, Opus 4.6 y Sonnet 4.6, y `xhigh` en Opus 4.7.575Con la configuración [`ultracode`](/docs/es/settings-reference#ultracode) desactivada, Claude Code resuelve el nivel de esfuerzo de la sesión en este orden, tomando el primero que se aplique:

483 576

484Cuando ejecuta Fable 5, Opus 4.8 u Opus 4.7 por primera vez, Claude Code aplica el esfuerzo predeterminado de ese modelo incluso si estableció anteriormente un nivel diferente para otro modelo: `high` en Fable 5 y Opus 4.8, y `xhigh` en Opus 4.7. Ejecute `/effort` nuevamente para elegir un nivel diferente después de cambiar. Ese predeterminado se mantiene entre sesiones hasta que realice una opción de esfuerzo explícita, como ejecutar `/effort` en una sesión interactiva o iniciar con `--effort`.5771. Una opción explícita: la variable de entorno [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/es/env-vars#variables), lanzar con `--effort`, o `/effort` en la sesión ([un `/effort` no interactivo tiene efecto más estrecho](#non-interactive-effort))

5782. El esfuerzo predeterminado del modelo, en Fable 5, Opus 4.8 u Opus 4.7: desde la primera vez que ejecutas uno de estos modelos, Claude Code mantiene el esfuerzo predeterminado de ese modelo entre sesiones, incluso cuando tu configuración resuelve un nivel diferente, hasta que cambies el esfuerzo una vez, por ejemplo con un `/effort` interactivo, el control deslizante de esfuerzo del selector `/model`, o `--effort` al lanzar. Opus 5 y Fable 5.1 no tienen tal retención

5793. Tu configuración: el nivel que guardaste para el modelo o una clave [`effortLevel`](/docs/es/settings-reference#effortlevel), con la precedencia entre ellos y entre archivos de configuración indicada en [`modelSettings`](/docs/es/settings-reference#modelsettings)

5804. El esfuerzo predeterminado del modelo: `high` en cada modelo que admite esfuerzo, excepto que Opus 4.7 por defecto es `xhigh` y, cuando tu organización establece un nivel de esfuerzo predeterminado para su [modelo predeterminado de la organización](#organization-default-model), ese nivel es el predeterminado cuando ejecutas ese modelo

485 581

486`low`, `medium`, `high` y `xhigh` persisten entre sesiones cuando los establece en una sesión interactiva. Un nivel establecido con `/effort` en [modo no interactivo](/docs/es/headless), con la bandera `-p`, se aplica solo a la sesión actual y no se guarda como su predeterminado. Un `/effort` no interactivo tampoco puede liberar la retención de predeterminado del modelo anterior: en Fable 5, Opus 4.8 y Opus 4.7 informa `Not applied` y la sesión permanece en el esfuerzo predeterminado del modelo, por lo que pase `--effort` en el lanzamiento en su lugar. `max` proporciona el razonamiento más profundo sin restricción en el gasto de tokens y se aplica solo a la sesión actual, excepto cuando se establece a través de la variable de entorno `CLAUDE_CODE_EFFORT_LEVEL`.582Cuando estableces `low`, `medium`, `high` o `xhigh` en una sesión interactiva en tu máquina, Claude Code guarda el nivel y lo aplica en sesiones posteriores. Guarda el nivel por modelo, bajo la clave [`modelSettings`](/docs/es/settings-reference#modelsettings) en tu configuración de usuario, por lo que cada modelo mantiene su propio nivel guardado.

487 583

488El menú `/effort` también ofrece `ultracode`. Ultracode es una configuración de Claude Code en lugar de un nivel de esfuerzo del modelo: envía `xhigh` al modelo y además tiene Claude orquestar [flujos de trabajo dinámicos](/docs/es/workflows) para tareas sustanciales. Se aplica solo a la sesión actual.584`max` es el nivel de razonamiento más profundo. A menos que lo establezas a través de la variable de entorno `CLAUDE_CODE_EFFORT_LEVEL`, Claude Code aplica `max` solo a la sesión actual.

489 585

490Puede activar ultracode a través de cualquiera de los siguientes:586<Note>

587 Un nivel que elijas del control de esfuerzo en un teléfono o navegador conectado a través de [Control Remoto](/docs/es/remote-control#what-connected-devices-see) se aplica solo a esa sesión.

588</Note>

491 589

492* **`/effort`**: ejecute `/effort ultracode`, o selecciónelo del menú590<span id="non-interactive-effort" />

493* **Bandera `--effort`**: inicie con `claude --effort ultracode`, que inicia la sesión con esfuerzo `xhigh` y ultracode activado

494* **`--settings` o una solicitud de control del SDK del Agente**: pase `"ultracode": true`. Una solicitud [`applyFlagSettings()`](/docs/es/agent-sdk/typescript#applyflagsettings) también acepta `effortLevel: "ultracode"`

495 591

496Pasar `ultracode` a la bandera `--effort` o al valor `effortLevel` del SDK del Agente requiere Claude Code v2.1.203 o posterior. Antes de v2.1.203, `--effort ultracode` imprimía `Unknown --effort value 'ultracode'` y la sesión comenzaba con el esfuerzo predeterminado.592Un nivel establecido con `/effort` en [modo no interactivo](/docs/es/headless), con la bandera `-p`, se aplica solo a la sesión actual y no se guarda como tu predeterminado. Tampoco cuenta como el cambio que termina el paso predeterminado del modelo anterior en Fable 5, Opus 4.8 u Opus 4.7: mientras ese paso esté en efecto, un `/effort` no interactivo reporta `Not applied`, así que pasa `--effort` al lanzar en su lugar.

497 593

498La configuración `effortLevel` persistida y la variable de entorno `CLAUDE_CODE_EFFORT_LEVEL` no aceptan `ultracode`.594El menú `/effort` también ofrece `ultracode`. Ultracode es una configuración de Claude Code en lugar de un nivel de esfuerzo del modelo: envía `xhigh` al modelo y además tiene Claude orquestar [flujos de trabajo dinámicos](/docs/es/workflows) para tareas sustanciales. Para dónde se puede establecer persistentemente, consulta la configuración [`ultracode`](/docs/es/settings-reference#ultracode).

595

596Puedes activar ultracode a través de cualquiera de los siguientes:

597

598* **`/effort`**: ejecuta `/effort ultracode`, o selecciónalo del menú

599* **Bandera `--effort`**: lanza con `claude --effort ultracode`, que inicia la sesión con esfuerzo `xhigh` y ultracode activado

600* **Configuración `ultracode`**: establece [`"ultracode": true`](/docs/es/settings-reference#ultracode) en un archivo de configuración, con `--settings`, o en una solicitud de control del Agent SDK. Una solicitud [`applyFlagSettings()`](/docs/es/agent-sdk/typescript#applyflagsettings) también acepta `effortLevel: "ultracode"`

601* **Selector `/model`**: mueve el control deslizante de esfuerzo a `ultracode` con las teclas de flecha mientras eliges un modelo. Claude Code lo activa para la sesión actual, incluso cuando guardas ese modelo como tu predeterminado

602

603Pasar `ultracode` a la bandera `--effort` o al valor `effortLevel` del Agent SDK requiere Claude Code v2.1.203 o posterior. Antes de v2.1.203, `--effort ultracode` imprimía `Unknown --effort value 'ultracode'` y la sesión comenzaba con el esfuerzo predeterminado.

604

605La configuración `effortLevel` persistida y la variable de entorno `CLAUDE_CODE_EFFORT_LEVEL` no aceptan `ultracode`. Cuando `CLAUDE_CODE_EFFORT_LEVEL` se establece a un nivel distinto de `xhigh`, las solicitudes se ejecutan en ese nivel y la orquestación de flujo de trabajo de ultracode permanece inactiva. Seleccionar ultracode entonces muestra una advertencia de que la variable de entorno anula el esfuerzo para la sesión.

499 606

500Cuando ultracode no está disponible, por ejemplo cuando [los flujos de trabajo están desactivados](/docs/es/workflows#turn-workflows-off), `--effort ultracode` establece solo esfuerzo `xhigh`.607Cuando ultracode no está disponible, por ejemplo cuando [los flujos de trabajo están desactivados](/docs/es/workflows#turn-workflows-off), `--effort ultracode` establece solo esfuerzo `xhigh`.

501 608

503 Elegir un nivel de esfuerzo610 Elegir un nivel de esfuerzo

504</h4>611</h4>

505 612

506Cada nivel intercambia gasto de tokens contra capacidad. El predeterminado es adecuado para la mayoría de tareas de codificación; ajuste cuando desee un equilibrio diferente.613Cada nivel intercambia gasto de tokens contra capacidad. El predeterminado se adapta a la mayoría de tareas de codificación; ajusta cuando quieras un equilibrio diferente.

507 614

508| Nivel | Cuándo usarlo |615| Nivel | Cuándo usarlo |

509| :---------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |616| :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

510| `low` | Reserve para tareas cortas, limitadas y sensibles a la latencia que no son sensibles a la inteligencia |617| `low` | Reserva para tareas cortas, limitadas y sensibles a la latencia que no son sensibles a la inteligencia |

514| `max` | Puede mejorar el rendimiento en tareas exigentes pero puede mostrar rendimientos decrecientes y es propenso a pensar demasiado. Pruebe antes de adoptar ampliamente |621| `max` | Puede mejorar el rendimiento en tareas exigentes pero puede mostrar rendimientos decrecientes y es propenso al exceso de pensamiento. Prueba antes de adoptar ampliamente |

515| `ultracode` | Una configuración de Claude Code que planifica un [flujo de trabajo dinámico](/docs/es/workflows) para cada tarea sustancial con razonamiento `xhigh` por mensaje. Solo de sesión |622| `ultracode` | Una configuración de Claude Code que planifica un [flujo de trabajo dinámico](/docs/es/workflows) para cada tarea sustancial con razonamiento `xhigh` por mensaje |

516 623

517La escala de esfuerzo se calibra por modelo, por lo que el mismo nombre de nivel no representa el mismo valor subyacente en todos los modelos.624La escala de esfuerzo se calibra por modelo, por lo que el mismo nombre de nivel no representa el mismo valor subyacente entre modelos.

518 625

519<h4 id="use-ultrathink-for-one-off-deep-reasoning">626<h4 id="use-ultrathink-for-one-off-deep-reasoning">

520 Utilizar ultrathink para razonamiento profundo único627 Usar ultrathink para razonamiento profundo único

521</h4>628</h4>

522 629

523Incluya `ultrathink` en cualquier lugar de su indicación para solicitar un razonamiento más profundo en ese turno sin cambiar su configuración de esfuerzo de sesión. Claude Code reconoce la palabra clave y añade una instrucción en contexto. El nivel de esfuerzo enviado a la API no cambia. Otras frases como "think", "think hard" y "think more" se pasan como texto de indicación ordinario y no se reconocen como palabras clave.630Incluye `ultrathink` en cualquier lugar de tu mensaje para solicitar razonamiento más profundo en ese turno sin cambiar tu configuración de esfuerzo de sesión. Claude Code reconoce la palabra clave y agrega una instrucción en contexto. El nivel de esfuerzo enviado a la API no cambia. Claude Code pasa otras frases como "think", "think hard" y "think more" como texto de mensaje ordinario y no las reconoce como palabras clave.

524 631

525<h4 id="set-the-effort-level">632<h4 id="set-the-effort-level">

526 Establecer el nivel de esfuerzo633 Establecer el nivel de esfuerzo

527</h4>634</h4>

528 635

529Puede cambiar el esfuerzo a través de cualquiera de los siguientes:636Puedes cambiar el esfuerzo a través de cualquiera de los siguientes:

637

638* **`/effort`**: ejecuta `/effort` sin argumentos para abrir un control deslizante interactivo, `/effort` seguido de un nombre de nivel para establecerlo directamente, o `/effort auto` para borrar tu nivel guardado para el modelo activo. Puedes ejecutarlo mientras Claude está trabajando, y una vez que confirmes la [advertencia de caché](/docs/es/prompt-caching#changing-effort-level), si Claude Code muestra una, Claude Code aplica el nuevo nivel a la siguiente solicitud en el turno

639* **En `/model`**: usa las teclas de flecha izquierda/derecha para ajustar el control deslizante de esfuerzo cuando selecciones un modelo

640* **Bandera `--effort`**: pasa un nombre de nivel para establecerlo para una única sesión cuando lanzas Claude Code

641* **Variable de entorno**: establece `CLAUDE_CODE_EFFORT_LEVEL` a un nombre de nivel o `auto`

642* **Configuración**: establece un nivel por modelo en [`modelSettings`](/docs/es/settings-reference#modelsettings), o establece [`effortLevel`](/docs/es/settings-reference#effortlevel) a `low`, `medium`, `high` o `xhigh` como el predeterminado para modelos sin uno. `max` no se acepta en ninguna clave, y `ultracode` tiene su propia clave [`ultracode`](/docs/es/settings-reference#ultracode)

643* **Desde un dispositivo conectado**: en una sesión de [Control Remoto](/docs/es/remote-control#what-connected-devices-see), elige un nivel del control de esfuerzo en tu teléfono o en tu navegador. El nivel se aplica solo a la sesión actual. Requiere Claude Code v2.1.234 o posterior

644* **Frontmatter de skill y subagente**: establece `effort` en un archivo markdown de [skill](/docs/es/skills#frontmatter-reference) o [subagente](/docs/es/sub-agents#supported-frontmatter-fields) para anular el nivel de esfuerzo cuando ese skill o subagente se ejecuta

530 645

531* **`/effort`**: ejecute `/effort` sin argumentos para abrir un control deslizante interactivo, `/effort` seguido de un nombre de nivel para establecerlo directamente, o `/effort auto` para restablecer el predeterminado del modelo646El esfuerzo de frontmatter se aplica cuando ese skill o subagente está activo, anulando el nivel de sesión pero no la variable de entorno.

532* **En `/model`**: utilice las teclas de flecha izquierda/derecha para ajustar el control deslizante de esfuerzo al seleccionar un modelo

533* **Bandera `--effort`**: pase un nombre de nivel para establecerlo para una única sesión al iniciar Claude Code

534* **Variable de entorno**: establezca `CLAUDE_CODE_EFFORT_LEVEL` en un nombre de nivel o `auto`

535* **Configuración**: establezca `effortLevel` en `low`, `medium`, `high` o `xhigh` en su archivo de configuración. `max` y `ultracode` son [solo de sesión](#adjust-effort-level) y no se aceptan aquí

536* **Frontmatter de skill y subagent**: establezca `effort` en un archivo markdown de [skill](/docs/es/skills#frontmatter-reference) o [subagent](/docs/es/sub-agents#supported-frontmatter-fields) para anular el nivel de esfuerzo cuando ese skill o subagent se ejecuta

537 647

538La variable de entorno tiene precedencia sobre todos los demás métodos, luego su nivel configurado, luego el predeterminado del modelo. El esfuerzo de frontmatter se aplica cuando ese skill o subagent está activo, anulando el nivel de sesión pero no la variable de entorno.648La clave `effortLevel` en [configuración administrada](/docs/es/managed-settings) es un predeterminado inicial, no aplicación: los usuarios pueden cambiarlo para una sesión con `/effort` o `--effort`, y el valor administrado se reafirma como el predeterminado en nuevas sesiones.

539 649

540El control deslizante de esfuerzo aparece en `/model` cuando se selecciona un modelo compatible. El nivel de esfuerzo actual también se muestra junto al logotipo y al indicador, por ejemplo "with low effort", para que pueda confirmar qué configuración está activa sin abrir `/model`.650El control deslizante de esfuerzo aparece en `/model` cuando se selecciona un modelo admitido. El nivel de esfuerzo actual también se muestra en el encabezado de la sesión junto al nombre del modelo, por ejemplo "with low effort", para que puedas confirmar qué configuración está activa sin abrir `/model`. El pie de página también muestra brevemente el nivel de esfuerzo al inicio y cuando cambia.

541 651

542<h4 id="adaptive-reasoning-and-fixed-thinking-budgets">652<h4 id="adaptive-reasoning-and-fixed-thinking-budgets">

543 Razonamiento adaptativo y presupuestos de pensamiento fijo653 Razonamiento adaptativo y presupuestos de pensamiento fijo

544</h4>654</h4>

545 655

546El razonamiento adaptativo hace que el pensamiento sea opcional en cada paso, por lo que Claude puede responder más rápido a indicaciones rutinarias y reservar un pensamiento más profundo para pasos que se benefician de él. Si desea que Claude piense más o menos a menudo de lo que produce el nivel actual, puede decirlo directamente en su indicación o en `CLAUDE.md`; el modelo responde a esa orientación dentro de su configuración de esfuerzo.656El razonamiento adaptativo hace que el pensamiento sea opcional en cada paso, por lo que Claude puede responder más rápido a mensajes rutinarios y reservar pensamiento más profundo para pasos que se benefician de él. Si quieres que Claude piense más o menos a menudo de lo que el nivel actual produce, puedes decirlo directamente en tu mensaje o en `CLAUDE.md`; el modelo responde a esa orientación dentro de su configuración de esfuerzo.

547 657

548Fable 5, Sonnet 5 y Opus 4.7 y posterior siempre utilizan razonamiento adaptativo. El modo de presupuesto de pensamiento fijo y `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` no se aplican a ellos.658Fable 5.1, Fable 5, Sonnet 5 y Opus 4.7 y posterior siempre utilizan razonamiento adaptativo. El modo de presupuesto de pensamiento fijo y `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` no se aplican a ellos.

549 659

550En Opus 4.6 y Sonnet 4.6, puede establecer `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` para revertir al presupuesto de pensamiento fijo anterior controlado por `MAX_THINKING_TOKENS`. Consulte [variables de entorno](/docs/es/env-vars).660En Opus 4.6 y Sonnet 4.6, puedes establecer `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` para revertir al modo de presupuesto de pensamiento fijo anterior controlado por `MAX_THINKING_TOKENS`. Consulta [variables de entorno](/docs/es/env-vars).

551 661

552<h3 id="extended-thinking">662<h3 id="extended-thinking">

553 Pensamiento extendido663 Pensamiento extendido

554</h3>664</h3>

555 665

556El pensamiento extendido es el razonamiento que Claude emite antes de responder. En modelos que admiten [razonamiento adaptativo](#adjust-effort-level), el nivel de esfuerzo es el control principal de cuánto pensamiento ocurre; la configuración a continuación activa o desactiva el pensamiento y controla cómo se muestra.666El pensamiento extendido es el razonamiento que Claude emite antes de responder. En modelos que admiten [razonamiento adaptativo](#adjust-effort-level), el nivel de esfuerzo es el control principal de cuánto pensamiento ocurre; las configuraciones a continuación activan o desactivan el pensamiento y controlan cómo se muestra. Con el pensamiento desactivado en Anthropic API, Claude Code envía esfuerzo `high` en lugar de un nivel más alto a modelos que sabe que [no aceptan esa combinación](/docs/es/errors#effort-isnt-available-with-thinking-turned-off), como Opus 5.

557 667

558| Control | Cómo configurarlo |668| Control | Cómo establecerlo |

559| :----------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |669| :--------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

561| Establecer el predeterminado global | Ejecute `/config` y alterne el modo de pensamiento. Se guarda como `alwaysThinkingEnabled` en `~/.claude/settings.json` |671| Establecer el predeterminado global | Ejecuta `/config` y alterna el modo de pensamiento. Se guarda como `alwaysThinkingEnabled` en `~/.claude/settings.json` |

562| Desactivar independientemente del esfuerzo | Establezca [`MAX_THINKING_TOKENS=0`](/docs/es/env-vars), que desactiva el pensamiento en la API de Anthropic excepto en Fable 5. En [proveedores de terceros](/docs/es/third-party-integrations) esto omite el parámetro `thinking` en su lugar, y los modelos de razonamiento adaptativo aún pueden pensar. Otros valores se aplican solo con un [presupuesto de pensamiento fijo](#adaptive-reasoning-and-fixed-thinking-budgets) |672| Desactivar a través de una variable de entorno | Establece [`MAX_THINKING_TOKENS=0`](/docs/es/env-vars), que desactiva el pensamiento en Anthropic API excepto en Fable 5.1 y Fable 5. En [proveedores de terceros](/docs/es/third-party-integrations) esto omite el parámetro `thinking` en su lugar, y los modelos de razonamiento adaptativo aún pueden pensar. Otros valores se aplican solo con un [presupuesto de pensamiento fijo](#adaptive-reasoning-and-fixed-thinking-budgets) |

563 673

564El pensamiento no se puede desactivar en Fable 5. El alternar de sesión, `alwaysThinkingEnabled` y `MAX_THINKING_TOKENS=0` no tienen efecto allí, y Fable 5 decide por paso cuánto pensar basado en el nivel de esfuerzo.674El pensamiento no se puede desactivar en Fable 5.1 o Fable 5. El alternador de sesión, `alwaysThinkingEnabled` y `MAX_THINKING_TOKENS=0` no tienen efecto allí, y el modelo decide por paso cuánto pensar según el nivel de esfuerzo.

565 675

566La salida de pensamiento se colapsa de forma predeterminada. Presione `Ctrl+O` para alternar el modo detallado y ver el razonamiento como texto gris en cursiva. Las sesiones interactivas en la API de Anthropic reciben bloques de pensamiento redactados de forma predeterminada, por lo que establezca `showThinkingSummaries: true` en [configuración](/docs/es/settings) si desea que los resúmenes completos estén disponibles cuando se expandan. Se le cobra por todos los tokens de pensamiento generados, incluso cuando se colapsan o se redactan.676Claude Code colapsa la salida de pensamiento por defecto. Presiona `Ctrl+O` para alternar el modo detallado y ver el razonamiento como texto gris en cursiva. Las sesiones interactivas en Anthropic API reciben bloques de pensamiento redactados por defecto, así que establece `showThinkingSummaries: true` en [configuración](/docs/es/settings) si quieres los resúmenes completos disponibles cuando expandes. Se te cobra por todos los tokens de pensamiento generados, incluso cuando están colapsados o redactados.

567 677

568<h3 id="extended-context">678<h3 id="extended-context">

569 Contexto extendido679 Contexto extendido

570</h3>680</h3>

571 681

572Fable 5, Sonnet 5, Opus 4.6 y posterior, y Sonnet 4.6 admiten una [ventana de contexto de 1 millón de tokens](https://platform.claude.com/docs/es/build-with-claude/context-windows#context-window-sizes-by-model) para sesiones largas con bases de código grandes.682Fable 5.1, Fable 5, Sonnet 5, Opus 4.6 y posterior, y Sonnet 4.6 admiten una [ventana de contexto de 1 millón de tokens](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) para sesiones largas con bases de código grandes.

683

684La disponibilidad varía según el modelo y el plan. En Anthropic API, Fable 5.1, Fable 5, Sonnet 5 y Opus 4.7 y posterior se ejecutan con la ventana de 1M por defecto.

573 685

574La disponibilidad varía según el modelo y el plan. En la API de Anthropic, Fable 5, Sonnet 5, Opus 4.8 y Opus 4.7 siempre se ejecutan con la ventana de 1M. En los planes Max, Team y Enterprise, Opus se actualiza automáticamente a contexto de 1M sin configuración adicional. Esto se aplica tanto a los asientos de Team Standard como de Team Premium. Sonnet 4.6 con contexto de 1M no es parte de la actualización automática y requiere [créditos de uso](https://support.claude.com/es/articles/12429409-extra-usage-for-paid-claude-plans) en todos los planes de suscripción, incluido Max.686En planes Max, Team y Enterprise, incluidos tanto asientos de Team Standard como Team Premium, Opus se actualiza automáticamente a contexto de 1M sin configuración adicional. Sonnet 4.6 con contexto de 1M no es parte de la actualización automática y requiere [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) en cada plan de suscripción, incluido Max.

575 687

577| ---------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |689| ---------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |

579| Pro | Requiere [créditos de uso](https://support.claude.com/es/articles/12429409-extra-usage-for-paid-claude-plans) | Requiere [créditos de uso](https://support.claude.com/es/articles/12429409-extra-usage-for-paid-claude-plans) |691| Pro | Requiere [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | Requiere [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

581 693

582Para desactivar completamente el contexto de 1M, establezca `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Esto elimina variantes de modelo de 1M del selector de modelo. Consulte [variables de entorno](/docs/es/env-vars).694Claude Code verifica estos requisitos de plan solo cuando se conecta directamente a Anthropic API. Si apuntas `ANTHROPIC_BASE_URL` a una [puerta de enlace LLM](/docs/es/llm-gateway#subscriptions-and-gateways) y tu inicio de sesión guardado de claude.ai permanece como la credencial activa, Claude Code no verifica tus créditos de uso del plan. Las opciones `[1m]` permanecen disponibles en `/model`, y la puerta de enlace decide si la solicitud tiene éxito. Antes de v2.1.229, Claude Code rechazaba `/model sonnet[1m]` en esa configuración cuando no podía confirmar créditos de uso en la cuenta.

583 695

584La ventana de contexto de 1M utiliza precios de modelo estándar sin prima para tokens más allá de 200K. Para planes donde el contexto extendido está incluido en su suscripción, el uso permanece cubierto por su suscripción. Para planes que acceden al contexto extendido a través de créditos de uso, los tokens se facturan a los créditos de uso.696Para desactivar contexto de 1M, establece `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Claude Code elimina variantes de modelo de 1M del selector de modelo. En modelos con una ventana nativa de 1M, como Sonnet 5 y los modelos Fable, también trata el modelo como si tuviera una ventana de contexto de 200K:

585 697

586Si su cuenta admite contexto de 1M, la opción aparece en el selector de modelo (`/model`) en las últimas versiones de Claude Code. Si no la ve, intente reiniciar su sesión.698* Con auto-compactación activada, las sesiones se compactan en el límite de 200K a través de [auto-compactación](#set-the-auto-compact-window). Establecer la ventana de auto-compactación por encima de 200K no levanta la retención, porque Claude Code limita esa ventana a la ventana de contexto del modelo.

699* Con auto-compactación desactivada, las sesiones se detienen en el límite de 200K con el [error de límite de contexto](/docs/es/errors#prompt-is-too-long) en lugar de compactarse.

587 700

588También puede utilizar el sufijo `[1m]` con alias de modelo o nombres de modelo completos:701Antes de v2.1.223, Claude Code mantenía solo sesiones de Sonnet 5, Opus 4.8 y Opus 5 a 200K. Consulta [variables de entorno](/docs/es/env-vars).

589 702

590```bash theme={null}703La ventana de contexto de 1M utiliza precios de modelo estándar sin prima para tokens más allá de 200K. Para planes donde el contexto extendido se incluye con tu suscripción, el uso permanece cubierto por tu suscripción. Para planes que acceden a contexto extendido a través de créditos de uso, los tokens se facturan a créditos de uso.

591# Utilizar el alias opus[1m] o sonnet[1m]704

705Si tu cuenta admite contexto de 1M, la opción aparece en el selector `/model` en las últimas versiones de Claude Code. Si no la ves, intenta reiniciar tu sesión.

706

707También puedes usar el sufijo `[1m]` con alias de modelo o nombres de modelo completos:

708

709```text theme={null}

710# Usa el alias opus[1m] o sonnet[1m]

592/model opus[1m]711/model opus[1m]

593/model sonnet[1m]712/model sonnet[1m]

594 713

595# O añadir [1m] a un nombre de modelo completo714# O agrega [1m] a un nombre de modelo completo

596/model claude-opus-4-8[1m]715/model claude-opus-4-8[1m]

597```716```

598 717

600 Ventana de contexto de Sonnet 5719 Ventana de contexto de Sonnet 5

601</h4>720</h4>

602 721

603En la API de Anthropic, Sonnet 5 siempre se ejecuta con la ventana de contexto de 1M. No hay variante de 200K, no hay sufijo `[1m]` que seleccionar y no se requieren créditos de uso en ningún plan. Las sesiones se compactan automáticamente antes de que la ventana se llene, aproximadamente a 967K tokens de forma predeterminada; establezca [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/es/env-vars) para elegir un umbral diferente.722En Anthropic API, Sonnet 5 siempre se ejecuta con la ventana de contexto de 1M. No hay variante de 200K, no hay sufijo `[1m]` para seleccionar, y no se requieren créditos de uso en ningún plan. Las sesiones se auto-compactan antes de que la ventana se llene, a aproximadamente 967K tokens por defecto; establece [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/es/env-vars) para elegir un umbral diferente.

604 723

605Dos configuraciones presupuestan la ventana en 200K en su lugar y se compactan automáticamente en ese límite:724Dos configuraciones presupuestan la ventana en 200K en su lugar:

606 725

607* **Puerta de enlace LLM**: cuando `ANTHROPIC_BASE_URL` apunta a una [puerta de enlace](/docs/es/llm-gateway), Claude Code no puede verificar la compatibilidad con 1M. Para utilizar la ventana completa, seleccione Sonnet 5 (1M context) en el selector de modelo, que se asigna a `sonnet[1m]`.726* **Puerta de enlace LLM**: cuando `ANTHROPIC_BASE_URL` apunta a una [puerta de enlace](/docs/es/llm-gateway), Claude Code no puede verificar soporte de 1M. Para usar la ventana completa, selecciona Sonnet 5 (1M context) en el selector de modelo, que se asigna a `sonnet[1m]`.

608* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: trata las sesiones de Sonnet 5 como si tuvieran una ventana de 200K, para implementaciones que necesitan limitar el contexto.727* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: mantiene sesiones en cada modelo con una ventana nativa de 1M a una ventana de 200K; consulta [Contexto extendido](#extended-context) para cómo se aplica la retención. Útil para implementaciones que necesitan limitar el contexto.

728

729<h2 id="context-window-and-auto-compaction">

730 Ventana de contexto y auto-compactación

731</h2>

732

733La ventana de auto-compactación es qué tan llena puede estar la ventana de contexto antes de que Claude Code compacte la conversación. Para ver qué compactación conserva y descarta por mecanismo, consulte [Lo que sobrevive a la compactación](/docs/es/context-window#what-survives-compaction).

734

735<h3 id="set-the-auto-compact-window">

736 Establecer la ventana de auto-compactación

737</h3>

738

739Puede establecer la ventana de auto-compactación en tres lugares:

740

741* **Para esta sesión y las posteriores**: ejecute `/autocompact` con un valor, como `/autocompact 500k`. Claude Code lo guarda en la configuración de usuario como [`autoCompactWindow`](/docs/es/settings-reference#autocompactwindow) y lo aplica a la sesión actual; si un [ámbito de configuración](/docs/es/settings#settings-precedence) de mayor prioridad, como la configuración administrada, establece la clave, el comando guarda su valor pero la sesión mantiene la ventana de ese ámbito, y el comando lo indica. Ejecute `/autocompact auto` para volver a la ventana ajustada para su modelo.

742* **Para un lanzamiento**: pase [`--autocompact`](/docs/es/cli-reference#cli-flags) al iniciar Claude Code. La bandera anula su configuración guardada para ese lanzamiento sin cambiarla, y `claude --autocompact auto` ejecuta la sesión en la ventana ajustada incluso si su configuración guardada tiene un valor. A diferencia de `/autocompact`, la bandera no es anulada por un ámbito de configuración de mayor prioridad, como la configuración administrada.

743* **En scripts y entornos en la nube**: establezca [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/es/env-vars). Mientras esté establecida, tiene precedencia sobre el comando, la bandera y la configuración, y `/autocompact` reporta la anulación en lugar de cambiar la ventana.

744

745El comando y la bandera aceptan un tamaño de ventana de 100K a 1M de tokens, en cualquiera de estas formas:

746

747* Un recuento de tokens simple, como `200000`

748* Un sufijo `k` o `M`, como `500k` o `1M`

749* Un número simple de 100 a 1000, que significa miles, por lo que `200` establece 200.000

750

751La variable de entorno acepta solo el recuento de tokens simple. Claude Code limita la ventana al tamaño de la ventana de contexto del modelo.

752

753<h3 id="default-auto-compact-thresholds">

754 Umbrales de auto-compactación predeterminados

755</h3>

756

757Si no establece una ventana de auto-compactación, Claude Code compacta cuando la conversación alcanza el límite de contexto del modelo, excepto en estas sesiones:

758

759* Las [sesiones en la nube](/docs/es/claude-code-on-the-web) se compactan cuando la conversación se acerca al límite del modelo

760* Sonnet 4.6 y Opus 4.6 sin [contexto extendido](#extended-context) se compactan en el límite de 200K, y también lo hacen Opus 4.8 y Opus 5 cuando se ejecutan con una ventana de contexto de 200K, como en Amazon Bedrock, Google Cloud's Agent Platform y Microsoft Foundry

761* Cuando establece [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/es/env-vars), los modelos con una ventana nativa de 1M, como Sonnet 5 y los modelos Fable, se compactan en el límite de 200K

762* Sonnet 5 se compacta en el [umbral para su configuración](#sonnet-5-context-window)

763* Las sesiones en un ID de modelo que Claude Code no reconoce, como un alias de [puerta de enlace LLM](/docs/es/llm-gateway), se compactan en la ventana de contexto que Claude Code asume para el ID; consulte [Corregir la ventana para una puerta de enlace o ID de modelo personalizado](#correct-the-window-for-a-gateway-or-custom-model-id)

764

765<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">

766 Corregir la ventana para una puerta de enlace o ID de modelo personalizado

767</h3>

768

769En una [puerta de enlace LLM](/docs/es/llm-gateway) u otra implementación personalizada, Claude Code puede asumir una ventana de contexto para el ID del modelo que difiere de la ventana real del modelo, independientemente de si resuelve el ID a un modelo Claude. [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](/docs/es/env-vars) declara la ventana que Claude Code debe asumir en su lugar. Cómo se aplica la variable depende del ID. Un ID no reconocido, un ID `[1m]` no reconocido y un ID que comienza con `claude-` o se resuelve a un modelo Claude son tres casos separados:

770

771* Si el ID no comienza con `claude-` ni contiene `[1m]`, en cualquier caso, y Claude Code no puede resolverlo a un modelo Claude, la variable se aplica directamente y la compactación proactiva continúa en la ventana declarada.

772* Si el ID no comienza con `claude-` pero contiene `[1m]`, en cualquier caso, y Claude Code no puede resolverlo a un modelo Claude, Claude Code asume una ventana de 1M para él y la variable no se aplica por sí sola. Para corregir la ventana mientras se mantiene la compactación proactiva, también establezca [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/es/env-vars). Con una ventana declarada superior a 200K, Claude Code muestra una [advertencia de inicio](/docs/es/errors#the-200k-limit-isnt-enforced) de que el límite de 200K no se aplica. La advertencia es esperada en esta configuración.

773* Si el ID comienza con `claude-` en cualquier caso o se resuelve a un modelo Claude, la variable tiene efecto solo cuando [`DISABLE_COMPACT`](/docs/es/env-vars) también está establecida, lo que desactiva toda compactación. Por ejemplo, Claude Code resuelve un ID que contiene un nombre de modelo Claude, como `anthropic/claude-opus-4-8` o `us.anthropic.claude-…-v1:0`, a ese modelo. Esto incluye IDs que también contienen `[1m]`: Claude Code resuelve `claude-opus-4-8[1m]` a Opus 4.8 incluso con `CLAUDE_CODE_DISABLE_1M_CONTEXT` establecida.

774

775Para un ID de modelo que Claude Code no reconoce, establezca [`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1`](/docs/es/env-vars) para que Claude Code compacte solo después de que la API rechace la conversación con un [error demasiado largo que Claude Code reconoce](/docs/es/errors#prompt-is-too-long). Claude Code no ejecuta esa recuperación cuando una puerta de enlace [reescribe el error](/docs/es/llm-gateway-connect#troubleshoot-gateway-errors) a una redacción que Claude Code no reconoce.

609 776

610<h2 id="checking-your-current-model">777<h2 id="checking-your-current-model">

611 Verificar su modelo actual778 Verificar su modelo actual

622 789

623Utilice `ANTHROPIC_CUSTOM_MODEL_OPTION` para agregar una única entrada personalizada al selector `/model` sin reemplazar los alias integrados. Esto es útil para probar IDs de modelo que Claude Code no enumera de forma predeterminada. Para implementaciones de puerta de enlace LLM, Claude Code puede completar automáticamente el selector desde el punto final `/v1/models` de la puerta de enlace cuando se establece `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`, por lo que esta variable solo es necesaria cuando el descubrimiento está deshabilitado o no devuelve el modelo que desea. Consulte [descubrimiento de modelo de puerta de enlace](/docs/es/llm-gateway-protocol#model-discovery).790Utilice `ANTHROPIC_CUSTOM_MODEL_OPTION` para agregar una única entrada personalizada al selector `/model` sin reemplazar los alias integrados. Esto es útil para probar IDs de modelo que Claude Code no enumera de forma predeterminada. Para implementaciones de puerta de enlace LLM, Claude Code puede completar automáticamente el selector desde el punto final `/v1/models` de la puerta de enlace cuando se establece `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`, por lo que esta variable solo es necesaria cuando el descubrimiento está deshabilitado o no devuelve el modelo que desea. Consulte [descubrimiento de modelo de puerta de enlace](/docs/es/llm-gateway-protocol#model-discovery).

624 791

625Este ejemplo establece las tres variables para hacer que una implementación de Opus enrutada por puerta de enlace sea seleccionable:792Para enumerar varios modelos en su propio orden y bajo etiquetas que elija, establezca [`modelPicker`](/docs/es/settings-reference#modelpicker). Su entrada indica qué filas mantiene el selector cuando esa alineación reemplaza la integrada.

793

794Este ejemplo establece las tres variables para hacer que una implementación de Opus enrutada por puerta de enlace sea seleccionable. Claude Code lee variables de entorno al iniciarse, por lo que ejecute las exportaciones antes de lanzar `claude`, o reinicie una sesión existente para aplicarlas:

626 795

627```bash theme={null}796```bash theme={null}

628export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-4-8"797export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-5"

629export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"798export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"

630export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"799export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"

631```800```

632 801

633La entrada personalizada aparece en la parte inferior del selector `/model`. `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` y `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` son opcionales. Si se omiten, el ID de modelo se utiliza como nombre y la descripción tiene como valor predeterminado `Custom model (<model-id>)`.802`ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` y `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` son opcionales:

803

804* Si omite el nombre, la entrada muestra el nombre del modelo cuando Claude Code [reconoce el ID](#customize-pinned-model-display-and-capabilities), y el ID del modelo en caso contrario.

805* Si omite la descripción, Claude Code utiliza `Custom model (<model-id>)`.

634 806

635Claude Code omite la validación para el ID de modelo establecido en `ANTHROPIC_CUSTOM_MODEL_OPTION`, por lo que puede utilizar cualquier cadena que su punto final de API acepte. Cuando [`availableModels`](#restrict-model-selection) está establecido, incluya también el ID de modelo personalizado en la lista de permitidos: la entrada personalizada se filtra del selector y una selección de `--model` de la misma se rechaza como cualquier otro modelo excluido. Un ID personalizado que incrusta un nombre de familia, como `my-gateway/claude-opus-4-8`, cuenta como una entrada específica para esa familia y deshabilita su comodín, por lo que también debe enumerar las versiones que desea mantener seleccionables. Consulte [Comportamiento de fusión](#merge-behavior).807Claude Code enumera la entrada personalizada después de las entradas integradas, y cualquier fila de [`modelPicker`](/docs/es/settings-reference#modelpicker) que agregue viene después de ella.

808

809Claude Code omite la validación para el ID de modelo establecido en `ANTHROPIC_CUSTOM_MODEL_OPTION`, por lo que puede utilizar cualquier cadena que su punto final de API acepte.

810

811Cuando [`availableModels`](#restrict-model-selection) está establecido, incluya también el ID de modelo personalizado en la lista de permitidos. De lo contrario, Claude Code filtra la entrada personalizada del selector y rechaza una selección de `--model` de la misma como cualquier otro modelo excluido.

812

813Un ID personalizado que incrusta un nombre de familia, como `my-gateway/claude-opus-5`, cuenta como una entrada específica para esa familia y deshabilita su comodín, por lo que también debe enumerar las versiones que desea mantener seleccionables. Consulte [Comportamiento de fusión](#merge-behavior).

636 814

637<h2 id="environment-variables">815<h2 id="environment-variables">

638 Variables de entorno816 Variables de entorno

639</h2>817</h2>

640 818

641Puede utilizar las siguientes variables de entorno para controlar los nombres de modelo a los que se asignan los alias. Cada valor debe ser un nombre de modelo completo, o el identificador equivalente para su proveedor de API.819Utilice las siguientes variables de entorno para controlar los nombres de modelo a los que se asignan los alias. Cada valor debe ser un nombre de modelo completo, o el identificador equivalente para su proveedor de API. Para elegir el modelo en el que comienzan sus sesiones, establezca [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), que esta tabla omite.

642 820

644| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |822| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

645| `ANTHROPIC_DEFAULT_FABLE_MODEL` | El modelo a utilizar para `fable`, y el ID de modelo que Claude Code reconoce como Fable 5 para [alternancia automática de modelo](#automatic-model-fallback) en proveedores de terceros |823| `ANTHROPIC_DEFAULT_FABLE_MODEL` | El modelo a utilizar para `fable`, y el ID de modelo que Claude Code reconoce como modelo Fable para [alternancia automática de modelo](#automatic-model-fallback) en proveedores de terceros |

647| `ANTHROPIC_DEFAULT_SONNET_MODEL` | El modelo a utilizar para `sonnet`, o para `opusplan` cuando Plan Mode no está activo. |825| `ANTHROPIC_DEFAULT_SONNET_MODEL` | El modelo a utilizar para `sonnet`, o para `opusplan` cuando Plan Mode no está activo. |

648| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | El modelo a utilizar para `haiku`, o [funcionalidad de fondo](/docs/es/costs#background-token-usage) |826| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | El modelo a utilizar para `haiku`, o [funcionalidad de fondo](/docs/es/costs#background-token-usage) |

649| `CLAUDE_CODE_SUBAGENT_MODEL` | El modelo a utilizar para todos los [subagents](/docs/es/sub-agents#choose-a-model), [agent teams](/docs/es/agent-teams), y los agentes que ejecuta un [workflow](/docs/es/workflows). Acepta un alias como `haiku` o un nombre de modelo completo, y anula tanto el parámetro `model` por invocación como el frontmatter `model` de la definición del subagent. Establezca en `inherit` para utilizar la resolución de modelo normal en su lugar |827| `CLAUDE_CODE_SUBAGENT_MODEL` | El modelo predeterminado para [subagentes](/docs/es/sub-agents#choose-a-model), compañeros de [equipo de agentes](/docs/es/agent-teams#specify-teammates-and-models) y agentes de [workflow](/docs/es/workflows) que no tienen asignado un modelo de otra manera. Acepta un alias como `haiku` o un nombre de modelo completo. Un modelo por invocación o el campo `model` de una definición, incluido `inherit`, tiene precedencia. Para cambiar eso, establezca [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/es/sub-agents#run-every-subagent-on-one-model) |

650 828

651Nota: `ANTHROPIC_SMALL_FAST_MODEL` está deprecado en favor de `ANTHROPIC_DEFAULT_HAIKU_MODEL`.829Nota: `ANTHROPIC_SMALL_FAST_MODEL` está deprecado en favor de `ANTHROPIC_DEFAULT_HAIKU_MODEL`.

652 830

658 836

659Sin fijar, Claude Code utiliza alias de modelo como `fable`, `opus`, `sonnet` y `haiku` que se resuelven a un ID de modelo predeterminado integrado para cada proveedor. Ese predeterminado puede rezagarse con respecto a la versión más reciente de Anthropic, y el modelo al que apunta puede que aún no esté habilitado en la cuenta de un usuario. Cuando el predeterminado no está disponible, los usuarios de Amazon Bedrock y Plataforma de Agentes de Google Cloud ven un aviso y la sesión retrocede a una versión anterior del modelo predeterminado, o al modelo Sonnet predeterminado cuando el predeterminado es un modelo Opus y no hay versión de Opus disponible. Los usuarios de Microsoft Foundry ven errores en su lugar, porque Microsoft Foundry no tiene ninguna verificación de inicio equivalente.837Sin fijar, Claude Code utiliza alias de modelo como `fable`, `opus`, `sonnet` y `haiku` que se resuelven a un ID de modelo predeterminado integrado para cada proveedor. Ese predeterminado puede rezagarse con respecto a la versión más reciente de Anthropic, y el modelo al que apunta puede que aún no esté habilitado en la cuenta de un usuario. Cuando el predeterminado no está disponible, los usuarios de Amazon Bedrock y Plataforma de Agentes de Google Cloud ven un aviso y la sesión retrocede a una versión anterior del modelo predeterminado, o al modelo Sonnet predeterminado cuando el predeterminado es un modelo Opus y no hay versión de Opus disponible. Los usuarios de Microsoft Foundry ven errores en su lugar, porque Microsoft Foundry no tiene ninguna verificación de inicio equivalente.

660 838

839En Amazon Bedrock y Plataforma de Agentes de Google Cloud, un usuario que inicia la sesión en una versión específica de Sonnet u Opus, por ejemplo con `--model`, `ANTHROPIC_MODEL`, o la configuración `model`, fija esa versión como el predeterminado de la sesión para el alias coincidente: la verificación de inicio omite el predeterminado integrado que reemplaza y no muestra ningún aviso de alternancia. Antes de v2.1.211, la verificación se ejecutaba y podía mostrar un aviso incluso cuando un modelo de sesión estaba configurado explícitamente.

840

661<Warning>841<Warning>

662 Establezca las variables de entorno de modelo en IDs de versión específicos como parte de su configuración inicial. Fijar le permite controlar cuándo sus usuarios se mueven a un nuevo modelo.842 Establezca las variables de entorno de modelo en IDs de versión específicos como parte de su configuración inicial. Fijar le permite controlar cuándo sus usuarios se mueven a un nuevo modelo.

663</Warning>843</Warning>

685* El sufijo se lee por variable, no por modelo. En Amazon Bedrock, Plataforma de Agentes de Google Cloud y Microsoft Foundry, un ID de modelo sin `[1m]` en una variable utiliza contexto de 200K incluso si otra variable establece el mismo modelo con el sufijo. Sonnet 5 siempre se ejecuta con la ventana de 1M en estos proveedores y nunca necesita el sufijo.865* El sufijo se lee por variable, no por modelo. En Amazon Bedrock, Plataforma de Agentes de Google Cloud y Microsoft Foundry, un ID de modelo sin `[1m]` en una variable utiliza contexto de 200K incluso si otra variable establece el mismo modelo con el sufijo. Sonnet 5 siempre se ejecuta con la ventana de 1M en estos proveedores y nunca necesita el sufijo.

686 866

687<Note>867<Note>

688 Una lista de permitidos `availableModels` entregada a través de [MDM o un archivo de configuración administrado](/docs/es/settings#settings-files) aún se aplica cuando se utilizan proveedores de terceros; [la configuración administrada por servidor no se entrega allí](/docs/es/server-managed-settings#platform-availability). El filtrado coincide con un alias de modelo como `opus`, un prefijo de versión como `claude-opus-4-8`, o el ID de modelo completo en forma de proveedor. Los prefijos específicos del proveedor como `us.anthropic.` no se eliminan, por lo que para permitir un modelo específico, enumere el mismo ID en forma de proveedor que muestra el selector, o asígnelo a través de [`modelOverrides`](#override-model-ids-per-version). Cualquier sufijo `[1m]` se elimina tanto de la entrada de la lista de permitidos como del modelo solicitado antes de coincidir.868 Una lista de permitidos `availableModels` entregada a través de [MDM o un archivo de configuración administrado](/docs/es/managed-settings#delivery-mechanisms) aún se aplica cuando se utilizan proveedores de terceros; [la configuración administrada por servidor no se entrega allí](/docs/es/server-managed-settings#platform-availability).

869

870 El filtrado coincide con un alias de modelo como `opus`, un prefijo de versión como `claude-opus-4-8`, o el ID de modelo completo en forma de proveedor. Los prefijos específicos del proveedor como `us.anthropic.` no se eliminan, por lo que para permitir un modelo específico, enumere su ID completo en forma de proveedor, o asígnelo a través de [`modelOverrides`](#override-model-ids-per-version). Cualquier sufijo `[1m]` se elimina tanto de la entrada de la lista de permitidos como del modelo solicitado antes de coincidir.

689</Note>871</Note>

690 872

691<h3 id="customize-pinned-model-display-and-capabilities">873<h3 id="customize-pinned-model-display-and-capabilities">

692 Personalizar la visualización y capacidades del modelo fijo874 Personalizar la visualización y capacidades del modelo fijo

693</h3>875</h3>

694 876

695Cuando fija un modelo en un proveedor de terceros, el ID específico del proveedor aparece tal cual en el selector `/model` y Claude Code puede no reconocer qué características admite el modelo. Puede anular el nombre de visualización y declarar capacidades con variables de entorno complementarias para cada modelo fijo.877Cuando fija un modelo en un proveedor de terceros, su fila en el selector `/model` muestra el nombre del modelo de forma predeterminada si Claude Code reconoce el ID fijo, y el ID sin procesar en caso contrario:

878

879* **Reconocido**: el ID exacto de un modelo que Claude Code conoce, como su ID de API de Anthropic o la forma de su proveedor o puerta de enlace, con o sin el sufijo `[1m]`. Fije `us.anthropic.claude-sonnet-4-5-20250929-v1:0` y la fila lee `Sonnet 4.5`.

880* **No reconocido**: cualquier otro ID, como un ARN de perfil de inferencia de aplicación o una versión de modelo que Claude Code no conoce, a menos que una entrada de [`modelOverrides`](#override-model-ids-per-version) asigne un modelo a esa cadena exacta. En Microsoft Foundry, los nombres de implementación están definidos por el usuario, por lo que Claude Code nunca reconoce un ID fijo allí, asignado o no, y la fila muestra el nombre de implementación de forma predeterminada.

881

882Cuando una fila muestra el nombre del modelo, su descripción predeterminada incluye el ID fijo para que aún pueda ver qué ID está fijo.

883

884Claude Code también puede no reconocer qué características admite un modelo fijo. Puede establecer el nombre de visualización y la descripción usted mismo y declarar capacidades con variables de entorno complementarias para cada modelo fijo.

696 885

697Estas variables tienen efecto en proveedores de terceros como Amazon Bedrock, Plataforma de Agentes de Google Cloud y Microsoft Foundry. Las variables `_NAME` y `_DESCRIPTION` también tienen efecto cuando `ANTHROPIC_BASE_URL` apunta a una [puerta de enlace LLM](/docs/es/llm-gateway). No tienen efecto cuando se conecta directamente a `api.anthropic.com`.886Estas variables tienen efecto en proveedores de terceros como Amazon Bedrock, Plataforma de Agentes de Google Cloud y Microsoft Foundry. Las variables `_NAME` y `_DESCRIPTION` también tienen efecto cuando `ANTHROPIC_BASE_URL` apunta a una [puerta de enlace LLM](/docs/es/llm-gateway). No tienen efecto cuando se conecta directamente a `api.anthropic.com`.

698 887

699| Variable de entorno | Descripción |888| Variable de entorno | Descripción |

700| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |889| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

701| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nombre de visualización para el modelo Opus fijo en el selector `/model`. Por defecto al ID de modelo cuando no está configurado |890| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nombre de visualización para el modelo Opus fijo en el selector `/model`. Cuando no está configurado, la fila muestra el nombre del modelo si Claude Code reconoce el ID fijo, y el ID fijo en caso contrario |

702| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Descripción de visualización para el modelo Opus fijo en el selector `/model`. Por defecto a `Custom Opus model` cuando no está configurado |891| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Descripción de visualización para el modelo Opus fijo en el selector `/model`. Cuando no está configurado, la fila muestra una descripción predeterminada que comienza con `Custom Opus model` |

703| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Lista separada por comas de capacidades que admite el modelo Opus fijo |892| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Lista separada por comas de capacidades que admite el modelo Opus fijo |

704 893

705Los mismos sufijos `_NAME`, `_DESCRIPTION` y `_SUPPORTED_CAPABILITIES` están disponibles para `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_FABLE_MODEL` y `ANTHROPIC_CUSTOM_MODEL_OPTION`.894Los mismos sufijos `_NAME`, `_DESCRIPTION` y `_SUPPORTED_CAPABILITIES` están disponibles para `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_FABLE_MODEL` y `ANTHROPIC_CUSTOM_MODEL_OPTION`.

730 Anular IDs de modelo por versión919 Anular IDs de modelo por versión

731</h3>920</h3>

732 921

922En plataformas que integran Claude Code y establecen [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/es/env-vars), la configuración de modelo del host tiene precedencia sobre la configuración de modelo administrada, mientras que una lista de permitidos `availableModels` administrada permanece en vigor a menos que el host proporcione la suya propia; [Excepciones a la precedencia de configuración administrada](/docs/es/settings#exceptions-to-managed-settings-precedence) dice qué claves y variables anula el host.

923

733Las variables de entorno a nivel de familia anteriores configuran un ID de modelo por alias de familia. Si necesita asignar varias versiones dentro de la misma familia a IDs de proveedor distintos, utilice la configuración `modelOverrides` en su lugar.924Las variables de entorno a nivel de familia anteriores configuran un ID de modelo por alias de familia. Si necesita asignar varias versiones dentro de la misma familia a IDs de proveedor distintos, utilice la configuración `modelOverrides` en su lugar.

734 925

735`modelOverrides` asigna IDs de modelo individuales de Anthropic a las cadenas específicas del proveedor que Claude Code envía a la API de su proveedor. Cuando un usuario selecciona un modelo asignado en el selector `/model`, Claude Code utiliza su valor configurado en lugar del predeterminado integrado.926`modelOverrides` asigna IDs de modelo individuales de Anthropic a las cadenas específicas del proveedor que Claude Code envía a la API de su proveedor. Cuando un usuario selecciona un modelo asignado en el selector `/model`, Claude Code utiliza su valor configurado en lugar del predeterminado integrado.

736 927

737Esto permite a los administradores empresariales enrutar cada versión de modelo a un ARN de perfil de inferencia de Amazon Bedrock específico, nombre de versión de Plataforma de Agentes de Google Cloud o nombre de implementación de Microsoft Foundry para gobernanza, asignación de costos o enrutamiento regional.928Esto permite a los administradores empresariales enrutar cada versión de modelo a un ARN de perfil de inferencia de Amazon Bedrock específico, nombre de versión de Plataforma de Agentes de Google Cloud o nombre de implementación de Microsoft Foundry para gobernanza, asignación de costos o enrutamiento regional.

738 929

739Establezca `modelOverrides` en su [archivo de configuración](/docs/es/settings#settings-files):930Establezca `modelOverrides` en su [archivo de configuración](/docs/es/settings#where-settings-live):

740 931

741```json theme={null}932```json theme={null}

742{933{

750 941

751Las claves deben ser IDs de modelo de Anthropic como se enumeran en la [Descripción general de modelos](https://platform.claude.com/docs/en/about-claude/models/overview). Para IDs de modelo con fecha, incluya el sufijo de fecha exactamente como aparece allí. Las claves desconocidas se ignoran.942Las claves deben ser IDs de modelo de Anthropic como se enumeran en la [Descripción general de modelos](https://platform.claude.com/docs/en/about-claude/models/overview). Para IDs de modelo con fecha, incluya el sufijo de fecha exactamente como aparece allí. Las claves desconocidas se ignoran.

752 943

944Para detener la [línea de diagnóstico](/docs/es/errors#unrecognized-model-id-on-a-request) `[claude-code:unrecognized_model]` para un ID como un alias de puerta de enlace, añada una entrada con ese ID como su valor.

945

753Las anulaciones reemplazan los IDs de modelo integrados que respaldan cada entrada en el selector `/model`. En Amazon Bedrock, las entradas de `modelOverrides` tienen precedencia sobre cualquier perfil de inferencia que Claude Code descubra automáticamente al inicio. Claude Code pasa valores que ya son específicos del proveedor, como ARNs de perfil de inferencia de Amazon Bedrock o nombres de implementación de Microsoft Foundry, al proveedor tal como están.946Las anulaciones reemplazan los IDs de modelo integrados que respaldan cada entrada en el selector `/model`. En Amazon Bedrock, las entradas de `modelOverrides` tienen precedencia sobre cualquier perfil de inferencia que Claude Code descubra automáticamente al inicio. Claude Code pasa valores que ya son específicos del proveedor, como ARNs de perfil de inferencia de Amazon Bedrock o nombres de implementación de Microsoft Foundry, al proveedor tal como están.

754 947

755Las anulaciones también se aplican cuando pasa un ID de modelo de Anthropic directamente a través de `--model`, la variable de entorno `ANTHROPIC_MODEL`, o una variable de entorno `ANTHROPIC_DEFAULT_*_MODEL`. En Amazon Bedrock, Plataforma de Agentes de Google Cloud y [Mantle](/docs/es/amazon-bedrock#use-the-mantle-endpoint), un ID de modelo de Anthropic sin entrada de `modelOverrides` se resuelve al mismo ID específico del proveedor que la fila del selector `/model` para esa versión, cuando el proveedor admite esa versión. Mantle admite un subconjunto de versiones. Para un ID de modelo de Anthropic fuera de ese subconjunto, Claude Code envía el ID sin procesar a Mantle sin asignarlo, a menos que una entrada de `modelOverrides` lo cubra. Antes de v2.1.200, `--model` y los valores de variable de entorno llegaban al proveedor tal como estaban sin pasar por el mapa de anulación.948Las anulaciones también se aplican cuando pasa un ID de modelo de Anthropic directamente a través de `--model`, la variable de entorno `ANTHROPIC_MODEL`, o una variable de entorno `ANTHROPIC_DEFAULT_*_MODEL`. En Amazon Bedrock, Plataforma de Agentes de Google Cloud y [Mantle](/docs/es/amazon-bedrock#use-the-mantle-endpoint), un ID de modelo de Anthropic sin entrada de `modelOverrides` se resuelve al mismo ID específico del proveedor que la fila del selector `/model` para esa versión, cuando el proveedor admite esa versión. Mantle admite un subconjunto de versiones. Para un ID de modelo de Anthropic fuera de ese subconjunto, Claude Code envía el ID sin procesar a Mantle sin asignarlo, a menos que una entrada de `modelOverrides` lo cubra. Antes de v2.1.200, `--model` y los valores de variable de entorno llegaban al proveedor tal como estaban sin pasar por el mapa de anulación.

756 949

757`modelOverrides` funciona junto con `availableModels`. La lista de permitidos se evalúa contra el ID de modelo de Anthropic, no el valor de anulación, por lo que una entrada como `"opus"` en `availableModels` continúa coincidiendo incluso cuando las versiones de Opus se asignan a ARNs. Cuando `enforceAvailableModels` se establece en configuración administrada, el Predeterminado aplicado se resuelve a través de `modelOverrides` desde la [fuente administrada de mayor precedencia](/docs/es/server-managed-settings#settings-precedence) únicamente. La asignación de un administrador, como una versión fijada a un ARN de perfil de inferencia, se respeta en el Predeterminado aplicado. Las anulaciones de configuración de usuario o proyecto no la afectan.950`modelOverrides` funciona junto con `availableModels`. La lista de permitidos se evalúa contra el ID de modelo de Anthropic, no el valor de anulación, por lo que una entrada como `"opus"` en `availableModels` continúa coincidiendo incluso cuando las versiones de Opus se asignan a ARNs. Cuando `enforceAvailableModels` se establece en configuración administrada, el Predeterminado aplicado se resuelve a través de `modelOverrides` desde [configuración administrada](/docs/es/managed-settings#how-claude-code-combines-managed-sources) únicamente. La asignación de un administrador, como una versión fijada a un ARN de perfil de inferencia, se respeta en el Predeterminado aplicado. Las anulaciones de configuración de usuario o proyecto no la afectan.

758 951

759Cuando `availableModels` se establece en [configuración administrada](/docs/es/settings#settings-files), solo `modelOverrides` de esa fuente administrada se aplican a un ID de modelo de Anthropic pasado directamente a través de `--model` o las variables de entorno anteriores. Claude Code ignora las anulaciones en configuración de usuario o proyecto para esos IDs, y nunca resuelve un ID que la lista administrada excluye a través de `modelOverrides` de ninguna fuente de configuración. Esta restricción de fuente administrada requiere Claude Code v2.1.200 o posterior. Consulte [Restringir la selección de modelo](#restrict-model-selection) para saber cómo se manejan los IDs bloqueados.952Cuando `availableModels` se establece en [configuración administrada](/docs/es/managed-settings), solo `modelOverrides` de configuración administrada se aplican a un ID de modelo de Anthropic pasado directamente a través de `--model` o las variables de entorno anteriores. Claude Code ignora las anulaciones en configuración de usuario o proyecto para esos IDs, y nunca resuelve un ID que la lista administrada excluye a través de `modelOverrides` de ninguna fuente de configuración. Esta restricción de fuente administrada requiere Claude Code v2.1.200 o posterior. Consulte [Restringir la selección de modelo](#restrict-model-selection) para saber cómo se manejan los IDs bloqueados.

760 953

761<h3 id="prompt-caching-configuration">954<h3 id="prompt-caching-configuration">

762 Configuración de almacenamiento en caché de indicaciones955 Configuración de almacenamiento en caché de indicaciones

772| `DISABLE_PROMPT_CACHING_OPUS` | Establezca en `1` para desactivar el almacenamiento en caché de indicaciones solo para modelos Opus |965| `DISABLE_PROMPT_CACHING_OPUS` | Establezca en `1` para desactivar el almacenamiento en caché de indicaciones solo para modelos Opus |

773| `DISABLE_PROMPT_CACHING_FABLE` | Establezca en `1` para desactivar el almacenamiento en caché de indicaciones solo para modelos Fable |966| `DISABLE_PROMPT_CACHING_FABLE` | Establezca en `1` para desactivar el almacenamiento en caché de indicaciones solo para modelos Fable |

774 967

775Para cambiar el TTL de caché u obtener más información sobre qué desencadena un error de caché, consulte [Cómo Claude Code utiliza el almacenamiento en caché de indicaciones](/docs/es/prompt-caching).968Para elegir el TTL de caché para la conversación principal y para subagentes por separado, consulte [elegir el TTL usted mismo](/docs/es/prompt-caching#choose-the-ttl-yourself). Para saber qué desencadena un error de caché, consulte [Cómo Claude Code utiliza el almacenamiento en caché de indicaciones](/docs/es/prompt-caching).

model-config.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

Configuración del modelo

Modelos disponibles

Alias de modelos

Trabajar con Fable

Fable y créditos de uso

Configurar su modelo

Establecer un modelo predeterminado para nuevas sesiones

Una nueva sesión comienza en un modelo diferente al que eligió

Restringir la selección de modelos

Cobertura de superficie

Comportamiento del modelo predeterminado

Aplicar la lista de permitidos para el modelo predeterminado

Controlar el modelo en el que se ejecutan los usuarios

Comportamiento de fusión

IDs de modelo de Mantle

Restricciones de modelo de organización

Modelo predeterminado de la organización

Límites de esfuerzo de la organización

Comportamiento especial del modelo

Configuración del modelo `default`

Configuración del modelo `opusplan`

Cadenas de modelos de reserva

Reserva automática de modelo

Verificar qué desencadenó la reserva

Preguntar antes de cambiar

Habilitar reserva en Bedrock, Agent Platform y Foundry

Investigación de seguridad y cargas de trabajo de biología

Ajustar el nivel de esfuerzo

Elegir un nivel de esfuerzo

Usar ultrathink para razonamiento profundo único

Establecer el nivel de esfuerzo

Razonamiento adaptativo y presupuestos de pensamiento fijo

Pensamiento extendido

Contexto extendido

Ventana de contexto de Sonnet 5

Ventana de contexto y auto-compactación

Establecer la ventana de auto-compactación

Umbrales de auto-compactación predeterminados

Corregir la ventana para una puerta de enlace o ID de modelo personalizado

Verificar su modelo actual

Agregar una opción de modelo personalizado

Variables de entorno

Fijar modelos para implementaciones de terceros

Personalizar la visualización y capacidades del modelo fijo

Anular IDs de modelo por versión

Configuración de almacenamiento en caché de indicaciones