Si 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.
1
Habilitar modelos de Anthropic en su cuenta de AWS
En la consola de Amazon 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 para AWS Organizations y configuración de IAM para los permisos que su rol necesita.
2
Inicie Claude Code y elija Amazon Bedrock
Ejecute claude. En el mensaje de inicio de sesión, seleccione 3rd-party platform, luego Amazon Bedrock.
3
Siga los mensajes del asistente
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, por lo que no necesita exportar variables de entorno usted mismo.
Después de haber iniciado sesión, ejecute /setup-bedrock en cualquier momento para reabrirlo el asistente y cambiar sus credenciales, región o fijaciones de modelo. El paso de fijación de modelo comienza desde sus modelos actualmente fijados. El asistente escribe en ~/.claude/settings.json, o en $CLAUDE_CONFIG_DIR/settings.json cuando CLAUDE_CONFIG_DIR está configurado.
Configurar manualmente
Para 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.
1. Enviar detalles del caso de uso
Los usuarios por primera vez de modelos de Anthropic deben enviar detalles del caso de uso antes de invocar un modelo. Esto se realiza una vez por cuenta de AWS.
Asegúrese de tener los permisos de IAM correctos descritos a continuación
Seleccione un modelo de Anthropic del catálogo de modelos
Complete el formulario de caso de uso. El acceso se otorga inmediatamente después del envío.
Si utiliza AWS Organizations, puede enviar el formulario una vez desde la cuenta de administración utilizando la API PutUseCaseForModelAccess. Esta llamada requiere el permiso de IAM bedrock:PutUseCaseForModelAccess. La aprobación se extiende a las cuentas secundarias automáticamente.
2. Configurar credenciales de AWS
Claude Code utiliza la cadena de credenciales predeterminada del SDK de AWS. Configure sus credenciales utilizando uno de estos métodos:
Claude Code solicita credenciales de rol desde la región del Centro de Identidades de IAM nombrada por el sso_region del perfil, que no necesita coincidir con la región en la que ejecuta Amazon Bedrock. {/* min-version: 2.1.208 */}En v2.1.207, la región de Amazon Bedrock anuló sso_region, por lo que un perfil cuya instancia del Centro de Identidades de IAM está en una región diferente no se autenticó con un error Session token not found or invalid.
Opción D: Credenciales de la consola de administración de AWS
Almacenamiento en caché de credenciales y tiempo de espera de resolución
Claude Code resuelve la cadena de proveedores de credenciales predeterminada de AWS una vez y mantiene las credenciales resueltas en memoria. Las reutiliza hasta cinco minutos antes de que expiren, o durante una hora cuando no tienen expiración, por lo que un perfil respaldado por SSO solicita credenciales del Centro de Identidades de IAM aproximadamente una vez por vida útil de credenciales. Un error de credencial de la API borra el caché, y el reintento resuelve credenciales nuevas.
Antes de v2.1.207, Claude Code resolvía la cadena en cada solicitud de API, por lo que un perfil respaldado por SSO solicitaba credenciales nuevas del Centro de Identidades de IAM cada vez y podría ser limitado en implementaciones grandes.
El caché cubre todas las opciones de credenciales anteriores excepto una clave de API de Amazon Bedrock, que no utiliza la cadena de proveedores. Para resolver la cadena en cada solicitud en su lugar, establezca CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1.
Cada resolución de la cadena agota el tiempo de espera después de 60 segundos. Si un paso en la cadena se detiene, por ejemplo un asistente credential_process que espera entrada que no puede recibir, la solicitud falla con AWS default-chain credential resolve timed out. Si su cadena ejecuta un inicio de sesión interactivo que legítimamente necesita más tiempo, como SSO basado en navegador con MFA a través de un contenedor como aws-vault, aumente el límite en milisegundos con CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS. Antes de v2.1.207, una resolución de credencial detenida dejaba la solicitud esperando indefinidamente.
Configuración avanzada de credenciales
Claude Code admite la actualización automática de credenciales para AWS SSO y proveedores de identidad corporativos. Agregue estas configuraciones a su archivo de configuración de Claude Code (vea Configuración para ubicaciones de archivos).
Estas dos configuraciones tienen diferentes condiciones de activación:
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.
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.
awsAuthRefresh: Utilice esto para comandos que modifiquen el directorio .aws, como actualizar credenciales, caché de SSO o archivos de configuración. La salida del comando se muestra al usuario, pero la entrada interactiva no es compatible. Esto funciona bien para flujos de SSO basados en navegador donde la CLI muestra una URL o código y usted completa la autenticación en el navegador.
awsCredentialExport: Solo use esto si no puede modificar .aws y debe devolver credenciales directamente. Este comando se ejecuta siempre que sea necesario actualizar las credenciales, no solo cuando las credenciales han expirado. La salida se captura silenciosamente y no se muestra al usuario. El comando debe generar JSON en este formato:
{/* min-version: 2.1.181 */}A partir de Claude Code v2.1.181, la salida plana de aws configure export-credentials --format process también se acepta, con las mismas claves en el nivel superior en lugar de anidadas bajo Credentials.
Expiration es opcional. {/* min-version: 2.1.176 */}A partir de Claude Code v2.1.176, cuando el comando devuelve un Expiration válido en ISO 8601, Claude Code almacena en caché las credenciales hasta cinco minutos antes de esa hora. Sin él, o en versiones anteriores, las credenciales se almacenan en caché durante una hora.
Cuando configura awsCredentialExport sin awsAuthRefresh, Claude Code utiliza las credenciales exportadas directamente y no re-resuelve la cadena de proveedores de credenciales predeterminada de AWS al inicio. Antes de v2.1.206, el inicio también re-resolvía la cadena de proveedores predeterminada, lo que realizaba una llamada SSO o STS en vivo fuera de su configuración de proxy y podría bloquear el primer mensaje durante varios minutos en redes con salida restringida.
3. Configurar Claude Code
Establezca las siguientes variables de entorno para habilitar Amazon Bedrock:
# Enable Bedrock integrationexport CLAUDE_CODE_USE_BEDROCK=1export AWS_REGION=us-east-1# optional if your AWS profile already sets a region# Optional: Override the AWS region for the small/fast model (Bedrock and Mantle).# On Bedrock, has no effect without ANTHROPIC_DEFAULT_HAIKU_MODEL# or the deprecated ANTHROPIC_SMALL_FAST_MODEL set.export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2# Optional: Override the Bedrock endpoint URL for custom endpoints or gateways# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com
Al habilitar Amazon Bedrock para Claude Code, tenga en cuenta lo siguiente:
{/* 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:
AWS_REGION
AWS_DEFAULT_REGION
la region establecida en su perfil de AWS activo, leída primero desde el archivo de credenciales compartidas de AWS y luego desde el archivo de configuración compartida, coincidiendo con la precedencia del SDK de AWS
us-east-1
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.
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.
Puede usar archivos de configuración para variables de entorno como AWS_PROFILE que no desea filtrar a otros procesos. Vea Configuración para más información.
4. Fijar versiones de modelo
Establezca estas variables de entorno en IDs de modelo de Amazon Bedrock específicos.
Sin ANTHROPIC_DEFAULT_OPUS_MODEL, el alias opus en Amazon Bedrock se resuelve a Opus 4.8, y sin ANTHROPIC_DEFAULT_SONNET_MODEL, el alias sonnet se resuelve a Sonnet 4.5. Este ejemplo fija cada alias a una versión específica:
Estas variables utilizan IDs de perfil de inferencia entre regiones (con el prefijo us.). Si utiliza un prefijo de región diferente o perfiles de inferencia de aplicación, ajuste en consecuencia. En regiones de AWS GovCloud, utilice el prefijo us-gov.. Para IDs de modelo actuales y heredados, vea Descripción general de modelos. Vea Configuración de modelo para la lista completa de variables de entorno.
Claude Code utiliza estos modelos predeterminados cuando no se establecen variables de fijación:
Tipo de modelo
Valor predeterminado
Modelo principal
us.anthropic.claude-opus-4-8
Modelo pequeño/rápido
us.anthropic.claude-sonnet-4-5-20250929-v1:0
Las 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 utiliza el modelo Sonnet predeterminado para tareas en segundo plano porque Haiku puede no estar habilitado en todas las cuentas o regiones. Dos selecciones cambian qué modelo las realiza:
Cuando selecciona un modelo principal con --model, ANTHROPIC_MODEL, o la configuración model, las tareas en segundo plano utilizan ese modelo. Establecer ANTHROPIC_DEFAULT_OPUS_MODEL sin ANTHROPIC_DEFAULT_SONNET_MODEL también cuenta como una selección, porque el modelo Sonnet integrado puede no estar habilitado en una cuenta que dirige su propio Opus.
Para usar Haiku para tareas en segundo plano, establezca ANTHROPIC_DEFAULT_HAIKU_MODEL en un ID de modelo que esté disponible en su cuenta.
{/* min-version: 2.1.207 */}Antes de v2.1.207, el modelo principal en Amazon Bedrock se establecía de forma predeterminada en Sonnet 4.5, el alias opus se resolvía a Opus 4.6, y las tareas en segundo plano siempre utilizaban el modelo principal.
Para personalizar modelos aún más, utilice uno de estos métodos:
# Using inference profile IDexport ANTHROPIC_MODEL='us.anthropic.claude-sonnet-4-6'export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'# Using application inference profile ARNexport ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'# Optional: Disable prompt caching if neededexport DISABLE_PROMPT_CACHING=1# Optional: Request 1-hour prompt cache TTL instead of the 5-minute defaultexport ENABLE_PROMPT_CACHING_1H=1
La 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é.
Asignar cada versión de modelo a un perfil de inferencia
Las variables de entorno ANTHROPIC_DEFAULT_*_MODEL configuran un perfil de inferencia por familia de modelo. Si su organización necesita exponer varias versiones de la misma familia en el selector /model, cada una enrutada a su propio ARN de perfil de inferencia de aplicación, utilice la configuración modelOverrides en su archivo de configuración en su lugar.
Este ejemplo asigna cuatro versiones de Opus a ARN distintos para que los usuarios puedan cambiar entre ellas sin eludir los perfiles de inferencia de su organización:
Cuando 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 para detalles sobre cómo las anulaciones interactúan con availableModels y otras configuraciones de modelo.
Verificaciones de modelo al inicio
Cuando Claude Code se inicia con Amazon Bedrock configurado, verifica que los modelos que pretende usar sean accesibles en su cuenta.
Si 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 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 se omiten, ya que son administradas por su administrador.
Si no ha fijado un modelo y el valor predeterminado actual no está disponible en su cuenta, Claude Code retrocede para la sesión actual y muestra un aviso. Intenta primero versiones anteriores del modelo predeterminado y, cuando el valor predeterminado es un modelo Opus y no hay ninguna versión de Opus disponible, retrocede al modelo Sonnet predeterminado. El retroceso no se persiste. Habilite el modelo más reciente en su cuenta de Amazon Bedrock o fije una versión para hacer la opción permanente.
Configuración de IAM
Cree una política de IAM con los permisos requeridos para Claude Code:
Para permisos más restrictivos, puede limitar el Resource a ARN de perfil de inferencia específicos.
bedrock:GetInferenceProfile permite que Claude Code resuelva un ARN de perfil de inferencia de aplicación a su modelo de fundación de respaldo, que se utiliza para seleccionar la forma de solicitud correcta para ese modelo.
Si el token carece de este permiso, Claude Code se recupera automáticamente reintentando una vez con la forma alternativa, por lo que las solicitudes aún tienen éxito pero cada nuevo modelo agrega un viaje de ida y vuelta adicional. Otorgar el permiso evita el reintento. Esto se aplica con mayor frecuencia a implementaciones de AWS_BEARER_TOKEN_BEDROCK, donde la política del token es típicamente más estrecha que un rol de IAM completo.
Claude Sonnet 5, Opus 4.6 y posteriores, y Sonnet 4.6 admiten la ventana de contexto de 1M de tokens en Amazon Bedrock. Sonnet 5 se sirve a través del punto de conexión Mantle y siempre se ejecuta con la ventana de 1M, sin variante [1m] para seleccionar. Para los otros modelos, Claude Code habilita automáticamente la ventana de contexto extendida cuando selecciona una variante de modelo de 1M.
Claude Code envía esto como el encabezado X-Amzn-Bedrock-Service-Tier en cada solicitud. La disponibilidad de niveles varía según el modelo y la región. La capacidad reservada utiliza un ARN de rendimiento aprovisionado como el ID del modelo en lugar de esta configuración.
AWS Guardrails
Amazon Bedrock Guardrails le permite implementar filtrado de contenido para Claude Code. Cree un Guardrail en la consola de Amazon Bedrock, publique una versión, luego agregue los encabezados de Guardrail a su archivo de configuración. Habilite la inferencia entre regiones en su Guardrail si está utilizando perfiles de inferencia entre regiones.
Mantle 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.
Habilitar Mantle
Con credenciales de AWS ya configuradas, establezca CLAUDE_CODE_USE_MANTLE para enrutar solicitudes al punto final de Mantle:
Claude 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; 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.
Ejecute /status dentro de Claude Code para confirmar. La línea del proveedor muestra Amazon Bedrock (Mantle) cuando Mantle está activo.
Seleccionar un modelo de Mantle
Mantle utiliza IDs de modelo con prefijo anthropic. y sin sufijo de versión, por ejemplo anthropic.claude-sonnet-5 o anthropic.claude-haiku-4-5. Los modelos disponibles para su cuenta dependen de lo que su organización haya sido autorizada; los IDs de modelo adicionales se enumeran en sus materiales de incorporación de AWS. Póngase en contacto con su equipo de cuenta de AWS para solicitar acceso a modelos permitidos.
Establezca el modelo con la bandera --model o con /model dentro de Claude Code:
claude --model anthropic.claude-haiku-4-5
Ejecutar Mantle junto con la API de Invoke
Los 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.
Para mostrar un modelo de Mantle en el selector /model, enumere su ID en availableModels en su archivo de configuración. Esta configuración también restringe el selector a las entradas enumeradas. Enumerar anthropic.claude-haiku-4-5 elimina el alias haiku simple del selector, así que también enumere prefijos de versión o IDs completos para las versiones que desee mantener seleccionables. El ID de Mantle y el alias haiku se resuelven en la misma familia de modelos, por lo que la fusión mantiene solo la entrada más específica. Vea Comportamiento de fusión:
Las entradas con el prefijo anthropic. se agregan como opciones de selector personalizado y se enrutan a Mantle. Reemplace anthropic.claude-haiku-4-5 con el ID de modelo que su cuenta ha sido autorizada. Vea Restringir selección de modelo para cómo availableModels interactúa con otras configuraciones de modelo.
Cuando ambos proveedores están activos, /status muestra Amazon Bedrock + Amazon Bedrock (Mantle).
Enrutar Mantle a través de una puerta de enlace
Si su organización enruta el tráfico de modelo a través de una puerta de enlace LLM centralizada que inyecta credenciales de AWS del lado del servidor, deshabilite la autenticación del lado del cliente para que Claude Code envíe solicitudes sin firmas SigV4 o encabezados x-api-key:
Estas variables son específicas del punto final de Mantle. Vea Variables de entorno para la lista completa.
Variable
Propósito
CLAUDE_CODE_USE_MANTLE
Habilitar el punto final de Mantle. Establezca en 1 o true.
ANTHROPIC_BEDROCK_MANTLE_BASE_URL
Anular la URL del punto final de Mantle predeterminada
CLAUDE_CODE_SKIP_MANTLE_AUTH
Omitir la autenticación del lado del cliente para configuraciones de proxy
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION
Anular la región de AWS para el modelo de clase Haiku (compartido con Amazon Bedrock)
Solución de problemas
Bucle de autenticación con SSO y proxies corporativos
Si las pestañas del navegador se abren repetidamente cuando se usa AWS SSO, elimine la configuración awsAuthRefresh de su archivo de configuración. Esto puede ocurrir cuando las VPN corporativas o los proxies de inspección TLS interrumpen el flujo del navegador SSO. Claude Code trata la conexión interrumpida como un error de autenticación, vuelve a ejecutar awsAuthRefresh y entra en un bucle indefinido.
Si su entorno de red interfiere con los flujos de SSO automáticos basados en navegador, use aws sso login manualmente antes de iniciar Claude Code en lugar de depender de awsAuthRefresh.
Problemas de región
Si encuentra problemas de región:
Verifique la disponibilidad del modelo: aws bedrock list-inference-profiles --region your-region
Cambie a una región compatible: export AWS_REGION=us-east-1
Considere usar perfiles de inferencia para acceso entre regiones
Si recibe un error "on-demand throughput isn't supported":
Claude Code utiliza la API de Invoke de Amazon Bedrock y no admite la API de Converse.
Errores de streaming detrás de una puerta de enlace o proxy
Si las solicitudes de streaming fallan con un error que comienza con Bedrock streaming response has content-type, una puerta de enlace o proxy entre Claude Code y Amazon Bedrock está transformando la respuesta de streaming. Amazon Bedrock transmite respuestas en un formato de evento binario event-stream con el tipo de contenido application/vnd.amazon.eventstream, y Claude Code rechaza una respuesta de streaming exitosa que reporta un tipo de contenido diferente en lugar de decodificar un cuerpo que no puede leer. El error nombra el tipo de contenido que recibió, comúnmente text/event-stream de una integración de Amazon API Gateway y Lambda que reemite el stream como eventos enviados por el servidor.
Antes de v2.1.208, la misma configuración incorrecta aparecía como API Error: Truncated event message received después de que toda la respuesta había sido almacenada en búfer.
Para solucionarlo, configure la puerta de enlace para pasar el cuerpo de la respuesta InvokeModelWithResponseStream y su encabezado Content-Type sin modificar. Si la puerta de enlace reescribe solo el encabezado y pasa el cuerpo binario intacto, establezca CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 para omitir la verificación hasta que se corrija la puerta de enlace. Con la verificación desactivada, un cuerpo de respuesta que fue transformado falla con Truncated event message received nuevamente.
Recuentos de tokens cero en /context
El 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.
Actualice a v2.1.196 o posterior.
Errores del punto final de Mantle
Si /status no muestra Amazon Bedrock (Mantle) después de establecer CLAUDE_CODE_USE_MANTLE, la variable no está llegando al proceso. Confirme que se exporta en el shell donde lanzó claude, o establézcala en el bloque env de su archivo de configuración.
Un 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.
Un 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 para que Claude Code enrute cada solicitud al punto final donde el modelo está disponible.
114Después de haber iniciado sesión, ejecute `/setup-bedrock` en cualquier momento para reabrirlo el asistente y cambiar sus credenciales, región o fijaciones de modelo.114Después de haber iniciado sesión, ejecute `/setup-bedrock` en cualquier momento para reabrirlo el asistente y cambiar sus credenciales, región o fijaciones de modelo. El paso de fijación de modelo comienza desde sus modelos actualmente fijados. El asistente escribe en `~/.claude/settings.json`, o en `$CLAUDE_CONFIG_DIR/settings.json` cuando [`CLAUDE_CONFIG_DIR`](/es/env-vars#variables) está configurado.
165Claude Code solicita credenciales de rol desde la región del Centro de Identidades de IAM nombrada por el `sso_region` del perfil, que no necesita coincidir con la región en la que ejecuta Amazon Bedrock. {/* min-version: 2.1.208 */}En v2.1.207, la región de Amazon Bedrock anuló `sso_region`, por lo que un perfil cuya instancia del Centro de Identidades de IAM está en una región diferente no se autenticó con un error `Session token not found or invalid`.
166
163**Opción D: Credenciales de la consola de administración de AWS**167**Opción D: Credenciales de la consola de administración de AWS**
164168
165```bash theme={null}169```bash theme={null}
176180
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/).181Las 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/).
184 Almacenamiento en caché de credenciales y tiempo de espera de resolución
185</h4>
186
187Claude Code resuelve la cadena de proveedores de credenciales predeterminada de AWS una vez y mantiene las credenciales resueltas en memoria. Las reutiliza hasta cinco minutos antes de que expiren, o durante una hora cuando no tienen expiración, por lo que un perfil respaldado por SSO solicita credenciales del Centro de Identidades de IAM aproximadamente una vez por vida útil de credenciales. Un error de credencial de la API borra el caché, y el reintento resuelve credenciales nuevas.
188
189Antes de v2.1.207, Claude Code resolvía la cadena en cada solicitud de API, por lo que un perfil respaldado por SSO solicitaba credenciales nuevas del Centro de Identidades de IAM cada vez y podría ser limitado en implementaciones grandes.
190
191El caché cubre todas las opciones de credenciales anteriores excepto una clave de API de Amazon Bedrock, que no utiliza la cadena de proveedores. Para resolver la cadena en cada solicitud en su lugar, establezca [`CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`](/es/env-vars).
192
193Cada resolución de la cadena agota el tiempo de espera después de 60 segundos. Si un paso en la cadena se detiene, por ejemplo un asistente `credential_process` que espera entrada que no puede recibir, la solicitud falla con [`AWS default-chain credential resolve timed out`](/es/errors#aws-default-chain-credential-resolve-timed-out). Si su cadena ejecuta un inicio de sesión interactivo que legítimamente necesita más tiempo, como SSO basado en navegador con MFA a través de un contenedor como `aws-vault`, aumente el límite en milisegundos con [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/es/env-vars). Antes de v2.1.207, una resolución de credencial detenida dejaba la solicitud esperando indefinidamente.
180 Configuración avanzada de credenciales196 Configuración avanzada de credenciales
181</h4>197</h4>
223239
224`Expiration` es opcional. {/* min-version: 2.1.176 */}A partir de Claude Code v2.1.176, cuando el comando devuelve un `Expiration` válido en ISO 8601, Claude Code almacena en caché las credenciales hasta cinco minutos antes de esa hora. Sin él, o en versiones anteriores, las credenciales se almacenan en caché durante una hora.240`Expiration` es opcional. {/* min-version: 2.1.176 */}A partir de Claude Code v2.1.176, cuando el comando devuelve un `Expiration` válido en ISO 8601, Claude Code almacena en caché las credenciales hasta cinco minutos antes de esa hora. Sin él, o en versiones anteriores, las credenciales se almacenan en caché durante una hora.
225241
242Cuando configura `awsCredentialExport` sin `awsAuthRefresh`, Claude Code utiliza las credenciales exportadas directamente y no re-resuelve la cadena de proveedores de credenciales predeterminada de AWS al inicio. Antes de v2.1.206, el inicio también re-resolvía la cadena de proveedores predeterminada, lo que realizaba una llamada SSO o STS en vivo fuera de su configuración de proxy y podría bloquear el primer mensaje durante varios minutos en redes con salida restringida.
227 3. Configurar Claude Code245 3. Configurar Claude Code
228</h3>246</h3>
262</h3>280</h3>
263281
264<Warning>282<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 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.283 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 una versión anterior o modelo de nivel inferior 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>284</Warning>
267285
268Establezca estas variables de entorno en IDs de modelo de Amazon Bedrock específicos.286Establezca estas variables de entorno en IDs de modelo de Amazon Bedrock específicos.
269287
270Sin estas variables, el alias `opus` en Amazon Bedrock se resuelve a Opus 4.8 y el alias `sonnet` se resuelve a Sonnet 4.5. Establezca cada variableparafijarsu alias a una versión específica:288Sin `ANTHROPIC_DEFAULT_OPUS_MODEL`, el alias `opus` en Amazon Bedrock se resuelve a Opus 4.8, y sin `ANTHROPIC_DEFAULT_SONNET_MODEL`, el alias `sonnet` se resuelve a Sonnet 4.5. Esteejemplofijacada alias a una versión específica:
280Claude Code utiliza estos modelos predeterminados cuando no se establecen variables de fijación:298Claude Code utiliza estos modelos predeterminados cuando no se establecen variables de fijación:
281299
282| Tipo de modelo | Valor predeterminado |300| Tipo de modelo | Valor predeterminado |
284| Modelo principal | `us.anthropic.claude-opus-4-8` |302| Modelo principal | `us.anthropic.claude-opus-4-8` |
285| Modelo pequeño/rápido | Igual que el modeloprincipal |303| Modelo pequeño/rápido | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |
304
305Las 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 utiliza el modelo Sonnet predeterminado para tareas en segundo plano porque Haiku puede no estar habilitado en todas las cuentas o regiones. Dos selecciones cambian qué modelo las realiza:
286306
287Las tareas en segundoplano,comolageneracióndetítulosdesesión, utilizanelmodelopequeño/rápido, normalmenteunmodelodeclaseHaiku. EnAmazonBedrock,ClaudeCodeestablecepordefectoestoalmodeloprincipalporqueHaiku 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 demodelo que esté disponible en su cuenta.307*Cuandoseleccionaunmodeloprincipalcon`--model`,`ANTHROPIC_MODEL`, olaconfiguración`model`, lastareasensegundoplanoutilizan ese modelo. Establecer`ANTHROPIC_DEFAULT_OPUS_MODEL`sin`ANTHROPIC_DEFAULT_SONNET_MODEL`tambiéncuentacomounaselección,porqueelmodeloSonnetintegrado puede no estar habilitado en unacuenta que dirige su propio Opus.
308* Para usar Haiku para tareas en segundo plano, establezca `ANTHROPIC_DEFAULT_HAIKU_MODEL` en un ID de modelo que esté disponible en su cuenta.
309
310<Warning>
311 Los modelos Opus tienen un precio por token más alto que los modelos Sonnet, por lo que una implementación que no fija un modelo principal se factura a la tasa de Opus una vez que se actualiza a v2.1.207 o posterior. Para mantener Sonnet 4.5 como el modelo principal, establezca `ANTHROPIC_MODEL` en su ID de modelo completo. Una implementación que dirige el valor predeterminado con `ANTHROPIC_DEFAULT_SONNET_MODEL` y no establece `ANTHROPIC_DEFAULT_OPUS_MODEL` mantiene su modelo Sonnet dirigido como el valor predeterminado.
312</Warning>
313
314{/* min-version: 2.1.207 */}Antes de v2.1.207, el modelo principal en Amazon Bedrock se establecía de forma predeterminada en Sonnet 4.5, el alias `opus` se resolvía a Opus 4.6, y las tareas en segundo plano siempre utilizaban el modelo principal.
288315
289Para personalizar modelos aún más, utilice uno de estos métodos:316Para personalizar modelos aún más, utilice uno de estos métodos:
290317
336363
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.364Si 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.
338365
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.366Si no ha fijado un modelo y el valor predeterminado actual no está disponible en su cuenta, Claude Code retrocede para la sesión actual y muestra un aviso. Intenta primero versiones anteriores del modelo predeterminado y, cuando el valor predeterminado es un modelo Opus y no hay ninguna versión de Opus disponible, retrocede al modelo Sonnet predeterminado. 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.
397 Ventana de contexto de 1M de tokens424 Ventana de contexto de 1M de tokens
398</h2>425</h2>
399426
400Claude Sonnet 5, Opus 4.6 y posteriores, y Sonnet 4.6 admiten la [ventana de contexto de 1M de tokens](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window) en Amazon Bedrock. Sonnet 5 se sirve a través del [punto de conexión Mantle](#use-the-mantle-endpoint) y siempre se ejecuta con la ventana de 1M, sin variante `[1m]` para seleccionar. Para los otros modelos, Claude Code habilita automáticamente la ventana de contexto extendida cuando selecciona una variante de modelo de 1M.427Claude Sonnet 5, Opus 4.6 y posteriores, y Sonnet 4.6 admiten la [ventana de contexto de 1M de tokens](https://platform.claude.com/docs/es/build-with-claude/context-windows#context-window-sizes-by-model) en Amazon Bedrock. Sonnet 5 se sirve a través del [punto de conexión Mantle](#use-the-mantle-endpoint) y siempre se ejecuta con la ventana de 1M, sin variante `[1m]` para seleccionar. Para los otros modelos, Claude Code habilita automáticamente la ventana de contexto extendida cuando selecciona una variante de modelo de 1M.
401428
402El [asistente de configuración](#sign-in-with-bedrock) ofrece una opción de contexto de 1M cuando fija modelos. Para habilitarlo para un modelo fijado manualmente en su lugar, agregue `[1m]` al ID del modelo. Vea [Fijar modelos para implementaciones de terceros](/es/model-config#pin-models-for-third-party-deployments) para detalles.429El [asistente de configuración](#sign-in-with-bedrock) ofrece una opción de contexto de 1M cuando fija modelos. Para habilitarlo para un modelo fijado manualmente en su lugar, agregue `[1m]` al ID del modelo. Vea [Fijar modelos para implementaciones de terceros](/es/model-config#pin-models-for-third-party-deployments) para detalles.
403430
538565
539Claude 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.566Claude 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.
569 Errores de streaming detrás de una puerta de enlace o proxy
570</h3>
571
572Si las solicitudes de streaming fallan con un error que comienza con `Bedrock streaming response has content-type`, una puerta de enlace o proxy entre Claude Code y Amazon Bedrock está transformando la respuesta de streaming. Amazon Bedrock transmite respuestas en un formato de evento binario event-stream con el tipo de contenido `application/vnd.amazon.eventstream`, y Claude Code rechaza una respuesta de streaming exitosa que reporta un tipo de contenido diferente en lugar de decodificar un cuerpo que no puede leer. El error nombra el tipo de contenido que recibió, comúnmente `text/event-stream` de una integración de Amazon API Gateway y Lambda que reemite el stream como eventos enviados por el servidor.
573
574Antes de v2.1.208, la misma configuración incorrecta aparecía como `API Error: Truncated event message received` después de que toda la respuesta había sido almacenada en búfer.
575
576Para solucionarlo, configure la puerta de enlace para pasar el cuerpo de la respuesta `InvokeModelWithResponseStream` y su encabezado `Content-Type` sin modificar. Si la puerta de enlace reescribe solo el encabezado y pasa el cuerpo binario intacto, establezca [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/es/env-vars) para omitir la verificación hasta que se corrija la puerta de enlace. Con la verificación desactivada, un cuerpo de respuesta que fue transformado falla con `Truncated event message received` nuevamente.
