82 Requisitos previos82 Requisitos previos
83</h2>83</h2>
84 84
85Antes de configurar Claude Code con Bedrock, asegúrese de tener:85Antes de configurar Claude Code con Amazon Bedrock, asegúrese de tener:
86 86
87* Una cuenta de AWS con acceso a Bedrock habilitado87* Una cuenta de AWS con acceso a Amazon Bedrock habilitado
88* Acceso a los modelos Claude deseados (por ejemplo, Claude Sonnet 4.6) en Bedrock88* Acceso a los modelos Claude deseados (por ejemplo, Claude Sonnet 4.6) en Amazon Bedrock
89* AWS CLI instalado y configurado (opcional - solo se necesita si no tiene otro mecanismo para obtener credenciales)89* AWS CLI instalado y configurado (opcional - solo se necesita si no tiene otro mecanismo para obtener credenciales)
90* Permisos de IAM apropiados90* Permisos de IAM apropiados
91 91
92Para iniciar sesión con sus propias credenciales de Bedrock, siga [Iniciar sesión con Bedrock](#sign-in-with-bedrock) a continuación. Para implementar Claude Code en un equipo, utilice los pasos de [configuración manual](#set-up-manually) y [fije las versiones de su modelo](#4-pin-model-versions) antes de implementar.92Para iniciar sesión con sus propias credenciales de Amazon Bedrock, siga [Iniciar sesión con Amazon Bedrock](#sign-in-with-bedrock) a continuación. Para implementar Claude Code en un equipo, utilice los pasos de [configuración manual](#set-up-manually) y [fije las versiones de su modelo](#4-pin-model-versions) antes de implementar.
93 93
94<h2 id="sign-in-with-bedrock">94<h2 id="sign-in-with-bedrock">
95 Iniciar sesión con Bedrock95 Iniciar sesión con Bedrock
96</h2>96</h2>
97 97
98Si tiene credenciales de AWS y desea comenzar a usar Claude Code a través de Bedrock, el asistente de inicio de sesión lo guía a través del proceso. Completa los requisitos previos del lado de AWS una vez por cuenta; el asistente maneja el lado de Claude Code.98Si tiene credenciales de AWS y desea comenzar a usar Claude Code a través de Amazon Bedrock, el asistente de inicio de sesión lo guía a través del proceso. Completa los requisitos previos del lado de AWS una vez por cuenta; el asistente maneja el lado de Claude Code.
99 99
100<Steps>100<Steps>
101 <Step title="Habilitar modelos de Anthropic en su cuenta de AWS">101 <Step title="Habilitar modelos de Anthropic en su cuenta de AWS">
102 En la [consola de Amazon Bedrock](https://console.aws.amazon.com/bedrock/), abra el catálogo de modelos, seleccione un modelo de Anthropic y envíe el formulario de caso de uso. El acceso se otorga inmediatamente después del envío. Vea [Enviar detalles del caso de uso](#1-submit-use-case-details) para AWS Organizations y [configuración de IAM](#iam-configuration) para los permisos que su rol necesita.102 En la [consola de Amazon Bedrock](https://console.aws.amazon.com/bedrock/), abra el catálogo de modelos, seleccione un modelo de Anthropic y envíe el formulario de caso de uso. El acceso se otorga inmediatamente después del envío. Vea [Enviar detalles del caso de uso](#1-submit-use-case-details) para AWS Organizations y [configuración de IAM](#iam-configuration) para los permisos que su rol necesita.
103 </Step>103 </Step>
104 104
105 <Step title="Inicie Claude Code y elija Bedrock">105 <Step title="Inicie Claude Code y elija Amazon Bedrock">
106 Ejecute `claude`. En el mensaje de inicio de sesión, seleccione **3rd-party platform**, luego **Amazon Bedrock**.106 Ejecute `claude`. En el mensaje de inicio de sesión, seleccione **3rd-party platform**, luego **Amazon Bedrock**.
107 </Step>107 </Step>
108 108
109 <Step title="Siga los mensajes del asistente">109 <Step title="Siga los mensajes del asistente">
110 Elija cómo se autentica en AWS: un perfil de AWS detectado desde su directorio `~/.aws`, una clave de API de Bedrock, una clave de acceso y secreto, o credenciales ya en su entorno. El asistente recoge su región, verifica qué modelos de Claude puede invocar su cuenta, y le permite fijarlos. Guarda el resultado en el bloque `env` de su [archivo de configuración de usuario](/es/settings), por lo que no necesita exportar variables de entorno usted mismo.110 Elija cómo se autentica en AWS: un perfil de AWS detectado desde su directorio `~/.aws`, una clave de API de Amazon Bedrock, una clave de acceso y secreto, o credenciales ya en su entorno. El asistente recoge su región, verifica qué modelos de Claude puede invocar su cuenta, y le permite fijarlos. Guarda el resultado en el bloque `env` de su [archivo de configuración de usuario](/es/settings), por lo que no necesita exportar variables de entorno usted mismo.
111 </Step>111 </Step>
112</Steps>112</Steps>
113 113
117 Configurar manualmente117 Configurar manualmente
118</h2>118</h2>
119 119
120Para configurar Bedrock a través de variables de entorno en lugar del asistente, por ejemplo en CI o una implementación empresarial con script, siga los pasos a continuación.120Para configurar Amazon Bedrock a través de variables de entorno en lugar del asistente, por ejemplo en CI o una implementación empresarial con script, siga los pasos a continuación.
121 121
122<h3 id="1-submit-use-case-details">122<h3 id="1-submit-use-case-details">
123 1. Enviar detalles del caso de uso123 1. Enviar detalles del caso de uso
168 168
169[Obtenga más información](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html) sobre `aws login`.169[Obtenga más información](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html) sobre `aws login`.
170 170
171**Opción E: Claves de API de Bedrock**171**Opción E: Claves de API de Amazon Bedrock**
172 172
173```bash theme={null}173```bash theme={null}
174export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key174export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key
175```175```
176 176
177Las claves de API de Bedrock proporcionan un método de autenticación más simple sin necesidad de credenciales completas de AWS. [Obtenga más información sobre las claves de API de Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/).177Las claves de API de Amazon Bedrock proporcionan un método de autenticación más simple sin necesidad de credenciales completas de AWS. [Obtenga más información sobre las claves de API de Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/).
178 178
179<h4 id="advanced-credential-configuration">179<h4 id="advanced-credential-configuration">
180 Configuración avanzada de credenciales180 Configuración avanzada de credenciales
185Estas dos configuraciones tienen diferentes condiciones de activación:185Estas dos configuraciones tienen diferentes condiciones de activación:
186 186
187* **`awsAuthRefresh`**: se ejecuta solo cuando Claude Code detecta que sus credenciales de AWS han expirado, ya sea localmente según su marca de tiempo o cuando la API devuelve un error de credencial, luego reintenta la solicitud con credenciales actualizadas.187* **`awsAuthRefresh`**: se ejecuta solo cuando Claude Code detecta que sus credenciales de AWS han expirado, ya sea localmente según su marca de tiempo o cuando la API devuelve un error de credencial, luego reintenta la solicitud con credenciales actualizadas.
188* **`awsCredentialExport`**: se ejecuta al inicio de la sesión y en cada recarga de credenciales, incluso cuando las credenciales en su cadena de proveedores de credenciales predeterminada de AWS aún son válidas. Utilice esto cuando su cuenta de Bedrock requiera credenciales entre cuentas que difieran de las que la cadena de proveedores predeterminada resolvería.188* **`awsCredentialExport`**: se ejecuta al inicio de la sesión y en cada recarga de credenciales, incluso cuando las credenciales en su cadena de proveedores de credenciales predeterminada de AWS aún son válidas. Utilice esto cuando su cuenta de Amazon Bedrock requiera credenciales entre cuentas que difieran de las que la cadena de proveedores predeterminada resolvería.
189 189
190<h5 id="example-configuration">190<h5 id="example-configuration">
191 Configuración de ejemplo191 Configuración de ejemplo
227 3. Configurar Claude Code227 3. Configurar Claude Code
228</h3>228</h3>
229 229
230Establezca las siguientes variables de entorno para habilitar Bedrock:230Establezca las siguientes variables de entorno para habilitar Amazon Bedrock:
231 231
232```bash theme={null}232```bash theme={null}
233# Enable Bedrock integration233# Enable Bedrock integration
243# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com243# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com
244```244```
245 245
246Al habilitar Bedrock para Claude Code, tenga en cuenta lo siguiente:246Al habilitar Amazon Bedrock para Claude Code, tenga en cuenta lo siguiente:
247 247
248* {/* min-version: 2.1.172 */}A partir de v2.1.172, solo necesita establecer `AWS_REGION` para anular la región de su perfil de AWS o cuando su perfil no tiene región. Claude Code resuelve la región en este orden:248* {/* min-version: 2.1.172 */}A partir de v2.1.172, solo necesita establecer `AWS_REGION` para anular la región de su perfil de AWS o cuando su perfil no tiene región. Claude Code resuelve la región en este orden:
249 249
253 * `us-east-1`253 * `us-east-1`
254 254
255 El perfil activo es `AWS_PROFILE` si está establecido, de lo contrario `default`. Establezca `AWS_SHARED_CREDENTIALS_FILE` o `AWS_CONFIG_FILE` para apuntar a rutas de archivo no predeterminadas. Ejecute `/status` para ver la región resuelta. Cuando la región proviene de sus archivos de configuración de AWS o del fallback predeterminado, `/status` también anota la fuente. En v2.1.171 y anteriores, Claude Code no lee los archivos de configuración de AWS, así que establezca `AWS_REGION` explícitamente.255 El perfil activo es `AWS_PROFILE` si está establecido, de lo contrario `default`. Establezca `AWS_SHARED_CREDENTIALS_FILE` o `AWS_CONFIG_FILE` para apuntar a rutas de archivo no predeterminadas. Ejecute `/status` para ver la región resuelta. Cuando la región proviene de sus archivos de configuración de AWS o del fallback predeterminado, `/status` también anota la fuente. En v2.1.171 y anteriores, Claude Code no lee los archivos de configuración de AWS, así que establezca `AWS_REGION` explícitamente.
256* Cuando se usa Bedrock, el comando `/logout` no está disponible ya que la autenticación se maneja a través de credenciales de AWS.256* Cuando se usa Amazon Bedrock, el comando `/logout` no está disponible ya que la autenticación se maneja a través de credenciales de AWS.
257* La herramienta WebSearch no está disponible en Bedrock. Vea [Comportamiento de la herramienta WebSearch](/es/tools-reference#websearch-tool-behavior).257* La herramienta WebSearch no está disponible en Amazon Bedrock. Vea [Comportamiento de la herramienta WebSearch](/es/tools-reference#websearch-tool-behavior).
258* Puede usar archivos de configuración para variables de entorno como `AWS_PROFILE` que no desea filtrar a otros procesos. Vea [Configuración](/es/settings) para más información.258* Puede usar archivos de configuración para variables de entorno como `AWS_PROFILE` que no desea filtrar a otros procesos. Vea [Configuración](/es/settings) para más información.
259 259
260<h3 id="4-pin-model-versions">260<h3 id="4-pin-model-versions">
262</h3>262</h3>
263 263
264<Warning>264<Warning>
265 Fije versiones de modelo específicas al implementar para múltiples usuarios. Sin fijar, alias de modelo como `sonnet` y `opus` se resuelven al valor predeterminado integrado de Claude Code para Bedrock, que puede estar rezagado con respecto a la versión más reciente y puede que aún no esté disponible en su cuenta. Claude Code [retrocede](#startup-model-checks) a la versión anterior al inicio cuando el valor predeterminado no está disponible, pero fijar le permite controlar cuándo sus usuarios se mueven a un nuevo modelo.265 Fije versiones de modelo específicas al implementar para múltiples usuarios. Sin fijar, alias de modelo como `sonnet` y `opus` se resuelven al valor predeterminado integrado de Claude Code para Amazon Bedrock, que puede estar rezagado con respecto a la versión más reciente y puede que aún no esté disponible en su cuenta. Claude Code [retrocede](#startup-model-checks) a la versión anterior al inicio cuando el valor predeterminado no está disponible, pero fijar le permite controlar cuándo sus usuarios se mueven a un nuevo modelo.
266</Warning>266</Warning>
267 267
268Establezca estas variables de entorno en IDs de modelo de Bedrock específicos.268Establezca estas variables de entorno en IDs de modelo de Amazon Bedrock específicos.
269 269
270Sin `ANTHROPIC_DEFAULT_OPUS_MODEL`, el alias `opus` en Bedrock se resuelve a Opus 4.6. Establézcalo en el ID de Opus 4.8 para usar el modelo más reciente:270Sin `ANTHROPIC_DEFAULT_OPUS_MODEL`, el alias `opus` en Amazon Bedrock se resuelve a Opus 4.6. Establézcalo en el ID de Opus 4.8 para usar el modelo más reciente:
271 271
272```bash theme={null}272```bash theme={null}
273export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'273export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'
284| Modelo principal | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |284| Modelo principal | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |
285| Modelo pequeño/rápido | Igual que el modelo principal |285| Modelo pequeño/rápido | Igual que el modelo principal |
286 286
287Las tareas en segundo plano, como la generación de títulos de sesión, utilizan el modelo pequeño/rápido, normalmente un modelo de clase Haiku. En Bedrock, Claude Code establece por defecto esto al modelo principal porque Haiku puede no estar habilitado en todas las cuentas o regiones. Para usar Haiku para tareas en segundo plano, establezca `ANTHROPIC_DEFAULT_HAIKU_MODEL` en un ID de modelo que esté disponible en su cuenta.287Las tareas en segundo plano, como la generación de títulos de sesión, utilizan el modelo pequeño/rápido, normalmente un modelo de clase Haiku. En Amazon Bedrock, Claude Code establece por defecto esto al modelo principal porque Haiku puede no estar habilitado en todas las cuentas o regiones. Para usar Haiku para tareas en segundo plano, establezca `ANTHROPIC_DEFAULT_HAIKU_MODEL` en un ID de modelo que esté disponible en su cuenta.
288 288
289Para personalizar modelos aún más, utilice uno de estos métodos:289Para personalizar modelos aún más, utilice uno de estos métodos:
290 290
305 305
306La TTL de caché de 1 hora se factura a una tasa más alta que la predeterminada de 5 minutos. Vea [duración del caché](/es/prompt-caching#cache-lifetime).306La TTL de caché de 1 hora se factura a una tasa más alta que la predeterminada de 5 minutos. Vea [duración del caché](/es/prompt-caching#cache-lifetime).
307 307
308<Note>Prompt caching puede no estar disponible en todas las regiones de Bedrock. Si los recuentos de tokens de caché permanecen en cero, verifique [modelos, regiones y límites compatibles](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) en la documentación de Bedrock.</Note>308<Note>Prompt caching puede no estar disponible en todas las regiones de Amazon Bedrock. Si los recuentos de tokens de caché permanecen en cero, verifique [modelos, regiones y límites compatibles](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models) en la documentación de Amazon Bedrock.</Note>
309 309
310<h4 id="map-each-model-version-to-an-inference-profile">310<h4 id="map-each-model-version-to-an-inference-profile">
311 Asignar cada versión de modelo a un perfil de inferencia311 Asignar cada versión de modelo a un perfil de inferencia
326}326}
327```327```
328 328
329Cuando un usuario selecciona una de estas versiones en `/model`, Claude Code llama a Bedrock con el ARN asignado. Las versiones sin una anulación se revierten al ID de modelo de Bedrock integrado o a cualquier perfil de inferencia coincidente descubierto al inicio. Vea [Anular IDs de modelo por versión](/es/model-config#override-model-ids-per-version) para detalles sobre cómo las anulaciones interactúan con `availableModels` y otras configuraciones de modelo.329Cuando un usuario selecciona una de estas versiones en `/model`, Claude Code llama a Amazon Bedrock con el ARN asignado. {/* min-version: 2.1.200 */}La misma asignación se aplica cuando pasa el ID de modelo de Anthropic directamente a través de `--model` o `ANTHROPIC_MODEL`. Las versiones sin una anulación se revierten al ID de modelo de Amazon Bedrock integrado o a cualquier perfil de inferencia coincidente descubierto al inicio. Antes de v2.1.200, los valores de `--model` y `ANTHROPIC_MODEL` llegaban a Amazon Bedrock tal cual sin pasar por el mapa de anulación. Vea [Anular IDs de modelo por versión](/es/model-config#override-model-ids-per-version) para detalles sobre cómo las anulaciones interactúan con `availableModels` y otras configuraciones de modelo.
330 330
331<h2 id="startup-model-checks">331<h2 id="startup-model-checks">
332 Verificaciones de modelo al inicio332 Verificaciones de modelo al inicio
333</h2>333</h2>
334 334
335Cuando Claude Code se inicia con Bedrock configurado, verifica que los modelos que pretende usar sean accesibles en su cuenta. Esta verificación requiere Claude Code v2.1.94 o posterior.335Cuando Claude Code se inicia con Amazon Bedrock configurado, verifica que los modelos que pretende usar sean accesibles en su cuenta. Esta verificación requiere Claude Code v2.1.94 o posterior.
336 336
337Si ha fijado una versión de modelo que es más antigua que el valor predeterminado actual de Claude Code, y su cuenta puede invocar la versión más reciente, Claude Code le solicita que actualice la fijación. Aceptar escribe el nuevo ID de modelo en su [archivo de configuración de usuario](/es/settings) y reinicia Claude Code. Rechazar se recuerda hasta el próximo cambio de versión predeterminada. Las fijaciones que apuntan a un [ARN de perfil de inferencia de aplicación](#map-each-model-version-to-an-inference-profile) se omiten, ya que son administradas por su administrador.337Si ha fijado una versión de modelo que es más antigua que el valor predeterminado actual de Claude Code, y su cuenta puede invocar la versión más reciente, Claude Code le solicita que actualice la fijación. Aceptar escribe el nuevo ID de modelo en su [archivo de configuración de usuario](/es/settings) y reinicia Claude Code. Rechazar se recuerda hasta el próximo cambio de versión predeterminada. Las fijaciones que apuntan a un [ARN de perfil de inferencia de aplicación](#map-each-model-version-to-an-inference-profile) se omiten, ya que son administradas por su administrador.
338 338
339Si no ha fijado un modelo y el valor predeterminado actual no está disponible en su cuenta, Claude Code retrocede a la versión anterior para la sesión actual y muestra un aviso. El retroceso no se persiste. Habilite el modelo más reciente en su cuenta de Bedrock o [fije una versión](#4-pin-model-versions) para hacer la opción permanente.339Si no ha fijado un modelo y el valor predeterminado actual no está disponible en su cuenta, Claude Code retrocede a la versión anterior para la sesión actual y muestra un aviso. El retroceso no se persiste. Habilite el modelo más reciente en su cuenta de Amazon Bedrock o [fije una versión](#4-pin-model-versions) para hacer la opción permanente.
340 340
341<h2 id="iam-configuration">341<h2 id="iam-configuration">
342 Configuración de IAM342 Configuración de IAM
433 Usar el punto final de Mantle433 Usar el punto final de Mantle
434</h2>434</h2>
435 435
436Mantle es un punto final de Amazon Bedrock que sirve modelos de Claude a través de la forma de API nativa de Anthropic en lugar de la API de Invoke de Bedrock. Utiliza las mismas credenciales de AWS, permisos de IAM y configuración de `awsAuthRefresh` descritos anteriormente en esta página.436Mantle es un punto final de Amazon Bedrock que sirve modelos de Claude a través de la forma de API nativa de Anthropic en lugar de la API de Invoke de Amazon Bedrock. Utiliza las mismas credenciales de AWS, permisos de IAM y configuración de `awsAuthRefresh` descritos anteriormente en esta página.
437 437
438<Note>438<Note>
439 Mantle requiere Claude Code v2.1.94 o posterior. Ejecute `claude --version` para verificar.439 Mantle requiere Claude Code v2.1.94 o posterior. Ejecute `claude --version` para verificar.
450export AWS_REGION=us-east-1450export AWS_REGION=us-east-1
451```451```
452 452
453Claude Code construye la URL del punto final desde la región de AWS. A partir de v2.1.172, la región se resuelve con la misma precedencia que [Bedrock anterior](#3-configure-claude-code); las versiones anteriores utilizan solo `AWS_REGION`. Para anular la URL para un punto final personalizado o puerta de enlace, establezca `ANTHROPIC_BEDROCK_MANTLE_BASE_URL`.453Claude Code construye la URL del punto final desde la región de AWS. {/* min-version: 2.1.172 */}A partir de v2.1.172, la región se resuelve con la misma precedencia que [Amazon Bedrock anterior](#3-configure-claude-code); las versiones anteriores utilizan solo `AWS_REGION`. Para anular la URL para un punto final personalizado o puerta de enlace, establezca `ANTHROPIC_BEDROCK_MANTLE_BASE_URL`.
454 454
455Ejecute `/status` dentro de Claude Code para confirmar. La línea del proveedor muestra `Amazon Bedrock (Mantle)` cuando Mantle está activo.455Ejecute `/status` dentro de Claude Code para confirmar. La línea del proveedor muestra `Amazon Bedrock (Mantle)` cuando Mantle está activo.
456 456
470 Ejecutar Mantle junto con la API de Invoke470 Ejecutar Mantle junto con la API de Invoke
471</h3>471</h3>
472 472
473Los modelos disponibles para usted en Mantle pueden no incluir todos los modelos que usa hoy. Establecer tanto `CLAUDE_CODE_USE_BEDROCK` como `CLAUDE_CODE_USE_MANTLE` permite que Claude Code llame a ambos puntos finales desde la misma sesión. Los IDs de modelo que coinciden con el formato de Mantle se enrutan a Mantle, y todos los demás IDs de modelo van a la API de Invoke de Bedrock.473Los modelos disponibles para usted en Mantle pueden no incluir todos los modelos que usa hoy. Establecer tanto `CLAUDE_CODE_USE_BEDROCK` como `CLAUDE_CODE_USE_MANTLE` permite que Claude Code llame a ambos puntos finales desde la misma sesión. Los IDs de modelo que coinciden con el formato de Mantle se enrutan a Mantle, y todos los demás IDs de modelo van a la API de Invoke de Amazon Bedrock.
474 474
475```bash theme={null}475```bash theme={null}
476export CLAUDE_CODE_USE_BEDROCK=1476export CLAUDE_CODE_USE_BEDROCK=1
508Estas variables son específicas del punto final de Mantle. Vea [Variables de entorno](/es/env-vars) para la lista completa.508Estas variables son específicas del punto final de Mantle. Vea [Variables de entorno](/es/env-vars) para la lista completa.
509 509
510| Variable | Propósito |510| Variable | Propósito |
511| :-------------------------------------- | :----------------------------------------------------------------------------- |511| :-------------------------------------- | :------------------------------------------------------------------------------------ |
512| `CLAUDE_CODE_USE_MANTLE` | Habilitar el punto final de Mantle. Establezca en `1` o `true`. |512| `CLAUDE_CODE_USE_MANTLE` | Habilitar el punto final de Mantle. Establezca en `1` o `true`. |
513| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Anular la URL del punto final de Mantle predeterminada |513| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Anular la URL del punto final de Mantle predeterminada |
514| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Omitir la autenticación del lado del cliente para configuraciones de proxy |514| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Omitir la autenticación del lado del cliente para configuraciones de proxy |
515| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Anular la región de AWS para el modelo de clase Haiku (compartido con Bedrock) |515| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Anular la región de AWS para el modelo de clase Haiku (compartido con Amazon Bedrock) |
516 516
517<h2 id="troubleshooting">517<h2 id="troubleshooting">
518 Solución de problemas518 Solución de problemas
540 540
541* Especifique el modelo como un ID de [perfil de inferencia](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)541* Especifique el modelo como un ID de [perfil de inferencia](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)
542 542
543Claude Code utiliza la [API de Invoke](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) de Bedrock y no admite la API de Converse.543Claude Code utiliza la [API de Invoke](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) de Amazon Bedrock y no admite la API de Converse.
544 544
545<h3 id="zero-token-counts-in-/context">545<h3 id="zero-token-counts-in-/context">
546 Recuentos de tokens cero en /context546 Recuentos de tokens cero en /context
547</h3>547</h3>
548 548
549El comando `/context` cuenta tokens para cada grupo de herramientas enviando los esquemas de herramientas a la API de conteo de tokens de Bedrock. {/* min-version: 2.1.196 */}En versiones de Claude Code anteriores a v2.1.196, Bedrock rechazó esa solicitud porque los esquemas llevaban campos que su API de conteo de tokens no acepta, por lo que cada grupo de herramientas mostraba 0 tokens. Otras filas en el desglose, como archivos de mensajes y memoria, no se ven afectadas.549El comando `/context` cuenta tokens para cada grupo de herramientas enviando los esquemas de herramientas a la API de conteo de tokens de Amazon Bedrock. {/* min-version: 2.1.196 */}En versiones de Claude Code anteriores a v2.1.196, Amazon Bedrock rechazó esa solicitud porque los esquemas llevaban campos que su API de conteo de tokens no acepta, por lo que cada grupo de herramientas mostraba 0 tokens. Otras filas en el desglose, como archivos de mensajes y memoria, no se ven afectadas.
550 550
551Actualice a v2.1.196 o posterior.551Actualice a v2.1.196 o posterior.
552 552
558 558
559Un `403` del punto final de Mantle con credenciales válidas significa que su cuenta de AWS no ha sido autorizada para acceder al modelo que solicitó. Póngase en contacto con su equipo de cuenta de AWS para solicitar acceso.559Un `403` del punto final de Mantle con credenciales válidas significa que su cuenta de AWS no ha sido autorizada para acceder al modelo que solicitó. Póngase en contacto con su equipo de cuenta de AWS para solicitar acceso.
560 560
561Un `400` que nombra el ID del modelo significa que ese modelo no se sirve en Mantle. Mantle tiene su propio catálogo de modelos separado del catálogo estándar de Bedrock, por lo que los IDs de perfil de inferencia como `us.anthropic.claude-sonnet-4-6` no funcionarán. Utilice un ID de formato de Mantle, o habilite [ambos puntos finales](#run-mantle-alongside-the-invoke-api) para que Claude Code enrute cada solicitud al punto final donde el modelo está disponible.561Un `400` que nombra el ID del modelo significa que ese modelo no se sirve en Mantle. Mantle tiene su propio catálogo de modelos separado del catálogo estándar de Amazon Bedrock, por lo que los IDs de perfil de inferencia como `us.anthropic.claude-sonnet-4-6` no funcionarán. Utilice un ID de formato de Mantle, o habilite [ambos puntos finales](#run-mantle-alongside-the-invoke-api) para que Claude Code enrute cada solicitud al punto final donde el modelo está disponible.
562 562
563<h2 id="additional-resources">563<h2 id="additional-resources">
564 Recursos adicionales564 Recursos adicionales
565</h2>565</h2>
566 566
567* [Documentación de Bedrock](https://docs.aws.amazon.com/bedrock/)567* [Documentación de Amazon Bedrock](https://docs.aws.amazon.com/bedrock/)
568* [Precios de Bedrock](https://aws.amazon.com/bedrock/pricing/)568* [Precios de Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/)
569* [Perfiles de inferencia de Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)569* [Perfiles de inferencia de Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)
570* [Burndown de tokens de Bedrock y cuotas](https://docs.aws.amazon.com/bedrock/latest/userguide/quotas-token-burndown.html)570* [Burndown de tokens de Amazon Bedrock y cuotas](https://docs.aws.amazon.com/bedrock/latest/userguide/quotas-token-burndown.html)
571* [Claude Code en Amazon Bedrock: Guía de configuración rápida](https://community.aws/content/2tXkZKrZzlrlu0KfH8gST5Dkppq/claude-code-on-amazon-bedrock-quick-setup-guide)571* [Claude Code en Amazon Bedrock: Guía de configuración rápida](https://community.aws/content/2tXkZKrZzlrlu0KfH8gST5Dkppq/claude-code-on-amazon-bedrock-quick-setup-guide)
572* [Implementación de monitoreo de Claude Code (Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md)572* [Implementación de monitoreo de Claude Code (Amazon Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md)