90 90
91La 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`.91La 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`.
92 92
93Las 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, 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.93Las 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.
94 94
95Cuando 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.95Cuando 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.
96 96
121 Restringir la selección de modelo121 Restringir la selección de modelo
122</h2>122</h2>
123 123
124Los administradores empresariales pueden utilizar `availableModels` en [configuración administrada o de política](/es/settings#settings-files) para restringir qué modelos pueden seleccionar los usuarios.124Los administradores empresariales pueden utilizar `availableModels` en [configuración administrada o de política](/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`.
125 125
126Cuando se establece `availableModels`, la lista de permitidos se aplica en todas partes donde un usuario puede especificar un modelo:126Cuando se establece `availableModels`, la lista de permitidos se aplica en todas partes donde un usuario puede especificar un modelo:
127 127
128* **Modelo de sesión principal**: `/model`, la bandera `--model`, y la variable de entorno `ANTHROPIC_MODEL`128* **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)
129* **Resolución de alias**: {/* min-version: 2.1.176 */}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 lista129* **Resolución de alias**: {/* min-version: 2.1.176 */}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
130* **Modo rápido**: {/* min-version: 2.1.176 */}`/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"130* **Modo rápido**: {/* min-version: 2.1.176 */}`/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"
131* **Modelos de subagentes**: el campo `model` en [frontmatter de subagente](/es/sub-agents#choose-a-model), el parámetro `model` de la herramienta Agent, el selector de modelo en `/agents`, y `CLAUDE_CODE_SUBAGENT_MODEL`131* **Modelos de subagentes**: el campo `model` en [frontmatter de subagente](/es/sub-agents#choose-a-model), el parámetro `model` de la herramienta Agent, el selector de modelo en `/agents`, y `CLAUDE_CODE_SUBAGENT_MODEL`
132* **Modelo de asesor**: la configuración [`advisorModel`](/es/advisor) configurada132* **Modelo de habilidad y comando**: el frontmatter `model` en [habilidades y comandos](/es/skills)
133* **Cadenas de reserva**: los elementos de una [cadena de modelo de reserva](#fallback-model-chains) fuera de la lista se descartan133* **Modelo de asesor**: la configuración [`advisorModel`](/es/advisor) configurada y la bandera `--advisor`
134* **Modelo de agente de fondo**: el modelo seleccionado en el [selector de envío](/es/agent-view)
134 135
135Cambiar a un modelo bloqueado con `/model` se rechaza con un error, mientras que una bandera `--model` bloqueada o un valor `ANTHROPIC_MODEL` se reemplaza al inicio con una advertencia que nombra tanto los modelos solicitados como los sustituidos, y la sesión comienza en el modelo predeterminado. Una anulación de subagente o asesor bloqueada vuelve al modelo heredado o predeterminado en lugar de fallar la solicitud.136Cambiar a un modelo bloqueado con `/model` se rechaza con un error, mientras que una bandera `--model` bloqueada, `ANTHROPIC_MODEL`, o un valor de configuración `model` se reemplaza al inicio con una advertencia que nombra tanto los modelos solicitados como los sustituidos, y la sesión comienza en el modelo predeterminado. Una anulación de subagente, habilidad o comando bloqueada vuelve al modelo heredado o predeterminado en lugar de fallar la solicitud; una configuración `advisorModel` bloqueada desactiva el asesor para la sesión, mientras que una bandera `--advisor` bloqueada sale con un error al inicio. Los modelos excluidos se ocultan del selector `/model`.
137
138Los cambios automáticos de modelo se verifican de la misma manera: los elementos de una [cadena de modelo de reserva](#fallback-model-chains) fuera de la lista de permitidos se descartan, una actualización de modo de plan como [`opusplan`](#opusplan-model-setting) a un modelo excluido se omite para que la planificación continúe en el modelo de la sesión, y un [fallback automático de modelo](#automatic-model-fallback) cuyo destino está excluido no se ejecuta, por lo que la solicitud marcada termina con un rechazo. Habilitar [modo rápido](/es/fast-mode) se rechaza cuando el modelo en el que se ejecutaría la sesión después está fuera de la lista de permitidos.
136 139
137```json theme={null}140```json theme={null}
138{141{
140}143}
141```144```
142 145
146<h3 id="surface-coverage">
147 Cobertura de superficie
148</h3>
149
150Cada superficie aplica la lista de permitidos que recibe. El mecanismo de entrega que llega a cada superficie difiere:
151
152| Mecanismo de entrega | CLI e IDE | Sesiones locales de escritorio | Sesiones web, móviles y en la nube | Agent SDK y no interactivo | Cowork |
153| :-------------------------------------------------------------------------------------------------------- | :-------- | :----------------------------- | :--------------------------------- | :------------------------- | :--------------------------- |
154| [Configuración administrada por servidor](/es/server-managed-settings) desde la consola de administración | Aplicada | Aplicada | Aplicada | Aplicada | No entregada |
155| [MDM o archivos de configuración administrada](/es/settings#settings-files) | Aplicada | Aplicada | No entregada | Aplicada | Aplicada donde se implementa |
156
157* Las sesiones en la nube, en [Claude Code en la web](/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`.
158* 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.
159* Las sesiones en [proveedores de terceros](/es/server-managed-settings#platform-availability) como Bedrock, Vertex AI, Foundry, y [Claude Platform en AWS](/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í.
160* 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`](/es/settings#available-settings) deben entregar la lista de permitidos a través de MDM o archivos de configuración administrada.
161* La pestaña Código de escritorio también aloja [sesiones SSH](/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](/es/desktop#managed-settings).
162* 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.
163
143<h3 id="default-model-behavior">164<h3 id="default-model-behavior">
144 Comportamiento del modelo predeterminado165 Comportamiento del modelo predeterminado
145</h3>166</h3>
146 167
147Por defecto, la opción Predeterminado en el selector de modelo no se ve afectada por `availableModels`. Siempre permanece disponible y representa el valor predeterminado de tiempo de ejecución del sistema [basado en el nivel de suscripción del usuario](#default-model-setting).168La 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 [basado en el nivel de suscripción del usuario](#default-model-setting). Si el valor predeterminado del nivel es un modelo que tiene la intención de restringir, establezca `enforceAvailableModels` también.
148 169
149Para extender la lista de permitidos a la opción Predeterminado, establezca `enforceAvailableModels` en `true` en configuración administrada o de política junto con una lista `availableModels` no vacía. Cuando el valor predeterminado del nivel no está en la lista de permitidos, Predeterminado se resuelve a la primera entrada permitida en lugar del valor predeterminado del nivel. Esto requiere Claude Code v2.1.175 o posterior.170Un 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`.
150 171
151Un array `availableModels` vacío nunca activa la aplicación. Incluso con `availableModels: []`, los usuarios aún pueden usar Claude Code con el modelo Predeterminado para su nivel independientemente de `enforceAvailableModels`.172<h3 id="enforce-the-allowlist-for-the-default-model">
173 Aplicar la lista de permitidos para el modelo Predeterminado
174</h3>
175
176Establezca `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.
177
178```json theme={null}
179{
180 "availableModels": ["sonnet", "haiku"],
181 "enforceAvailableModels": true
182}
183```
184
185Cuando el modelo predeterminado para el tipo de cuenta del usuario 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.
186
187`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.
188
189Implemente ambas claves en la [fuente administrada de mayor precedencia](/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.
152 190
153<h3 id="control-the-model-users-run-on">191<h3 id="control-the-model-users-run-on">
154 Controlar el modelo en el que se ejecutan los usuarios192 Controlar el modelo en el que se ejecutan los usuarios
155</h3>193</h3>
156 194
157La configuración de `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 del sistema para su nivel independientemente de lo que esté configurado en `model`.195La 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 del sistema para su nivel independientemente de lo que esté configurado en `model`, a menos que [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) lo redirija.
158 196
159Para controlar completamente la experiencia del modelo, combine estas configuraciones:197Para controlar completamente la experiencia del modelo, combine estas configuraciones:
160 198
182 Comportamiento de fusión220 Comportamiento de fusión
183</h3>221</h3>
184 222
185Cuando `availableModels` se establece en configuración de usuario, proyecto y local solamente, los arrays se fusionan y se desduplican en esos niveles.223Cuando la [fuente de configuración administrada de mayor precedencia](/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](/es/settings#settings-precedence) como otras configuraciones de array. {/* min-version: 2.1.175 */}A partir de Claude Code v2.1.175, la lista administrada reemplaza entradas de menor precedencia; las versiones anteriores las fusionan.
186 224
187Cuando `availableModels` se establece en configuración administrada o de política, el valor administrado o de política reemplaza completamente el resultado fusionado: las entradas agregadas en configuración de usuario o proyecto no pueden ampliarlo. La configuración administrada y de política reemplaza los valores de menor precedencia para `enforceAvailableModels` de la misma manera. A partir de Claude Code v2.1.175, esta es la única forma de aplicar una lista de permitidos estricta; las versiones anteriores fusionan la lista administrada con entradas de menor precedencia.225Dentro 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.
188 226
189<h3 id="mantle-model-ids">227<h3 id="mantle-model-ids">
190 IDs de modelo Mantle228 IDs de modelo Mantle
191</h3>229</h3>
192 230
193Cuando el [punto final Bedrock Mantle](/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. La configuración aún restringe el selector a las entradas enumeradas, así que incluya los alias estándar junto con cualquier ID de Mantle.231Cuando el [punto final Bedrock Mantle](/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).
232
233<h3 id="organization-model-restrictions">
234 Restricciones de modelo de organización
235</h3>
236
237Utilice el botón de la consola en lugar de `availableModels` cuando sus miembros se autentiquen a través de la API de Anthropic y desee un único cambio en toda la organización sin implementar archivos de configuración. Los administradores de la organización restringen qué modelos pueden ejecutar los miembros deshabilitando modelos individuales en la consola de Claude. 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.
238
239Un 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.
240
241Los dos mecanismos se componen: 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 y implementaciones de [puerta de enlace LLM](/es/llm-gateway). Las sesiones en Bedrock, Vertex AI, Foundry, y Claude Platform en AWS no las reciben, por lo que use `availableModels` en esos proveedores en su lugar.
194 242
195<h2 id="special-model-behavior">243<h2 id="special-model-behavior">
196 Comportamiento especial del modelo244 Comportamiento especial del modelo
209 257
210Enterprise de pago por uso significa una organización Enterprise facturada por uso en lugar de por asiento de suscripción.258Enterprise de pago por uso significa una organización Enterprise facturada por uso en lugar de por asiento de suscripción.
211 259
260Cuando 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.
261
212Fable 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.262Fable 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.
213 263
214<h3 id="opusplan-model-setting">264<h3 id="opusplan-model-setting">
267 317
268La sesión continúa en ese modelo Opus. Para volver a Fable 5, ejecute `/model fable`.318La sesión continúa en ese modelo Opus. Para volver a Fable 5, ejecute `/model fable`.
269 319
320El 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.
321
270<h4 id="check-what-triggered-fallback">322<h4 id="check-what-triggered-fallback">
271 Verificar qué desencadenó el respaldo323 Verificar qué desencadenó el respaldo
272</h4>324</h4>
286* Si ambos modelos marcan la misma solicitud, puede editar el indicador e intentar nuevamente, o iniciar una nueva sesión.338* Si ambos modelos marcan la misma solicitud, puede editar el indicador e intentar nuevamente, o iniciar una nueva sesión.
287* En sesiones móviles de [Claude Code en la web](/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.339* En sesiones móviles de [Claude Code en la web](/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.
288* En [modo no interactivo](/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.340* En [modo no interactivo](/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.
341* 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.
289 342
290<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">343<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">
291 Habilitar respaldo en Bedrock, Vertex AI y Foundry344 Habilitar respaldo en Bedrock, Vertex AI y Foundry
452 505
453La 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>)`.506La 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>)`.
454 507
455Claude 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.508Claude 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-7`, 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).
456 509
457<h2 id="environment-variables">510<h2 id="environment-variables">
458 Variables de entorno511 Variables de entorno
505* El sufijo se lee por variable, no por modelo. En Bedrock, Vertex y 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.558* El sufijo se lee por variable, no por modelo. En Bedrock, Vertex y 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.
506 559
507<Note>560<Note>
508 La lista de permitidos `settings.availableModels` aún se aplica cuando se utilizan proveedores de terceros. El filtrado coincide con el alias de modelo como `opus`, el prefijo de versión como `claude-opus-4-8`, o el ID de modelo completo. Cualquier sufijo `[1m]` se elimina tanto de la entrada de la lista de permitidos como del modelo solicitado antes de coincidir, por lo que una entrada de `claude-opus-4-8` permite tanto las filas Opus estándar como las de contexto de 1M. Los prefijos específicos del proveedor como `us.anthropic.` no se eliminan: enumere la misma forma en `availableModels` que muestra el selector, o asígnela a través de [`modelOverrides`](#override-model-ids-per-version).561 Una lista de permitidos `availableModels` entregada a través de [MDM o un archivo de configuración administrado](/es/settings#settings-files) aún se aplica cuando se utilizan proveedores de terceros; [la configuración administrada por servidor no se entrega allí](/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.
509</Note>562</Note>
510 563
511<h3 id="customize-pinned-model-display-and-capabilities">564<h3 id="customize-pinned-model-display-and-capabilities">
572 625
573Las anulaciones reemplazan los IDs de modelo integrados que respaldan cada entrada en el selector `/model`. En Bedrock, las anulaciones tienen precedencia sobre cualquier perfil de inferencia que Claude Code descubra automáticamente al inicio. Los valores que proporciona directamente a través de `ANTHROPIC_MODEL`, `--model`, o las variables de entorno `ANTHROPIC_DEFAULT_*_MODEL` se pasan al proveedor tal como están y no se transforman por `modelOverrides`.626Las anulaciones reemplazan los IDs de modelo integrados que respaldan cada entrada en el selector `/model`. En Bedrock, las anulaciones tienen precedencia sobre cualquier perfil de inferencia que Claude Code descubra automáticamente al inicio. Los valores que proporciona directamente a través de `ANTHROPIC_MODEL`, `--model`, o las variables de entorno `ANTHROPIC_DEFAULT_*_MODEL` se pasan al proveedor tal como están y no se transforman por `modelOverrides`.
574 627
575`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.628`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](/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.
576 629
577<h3 id="prompt-caching-configuration">630<h3 id="prompt-caching-configuration">
578 Configuración de almacenamiento en caché de indicaciones631 Configuración de almacenamiento en caché de indicaciones
