Claude Code --cloud no puede usar Amazon Bedrock cuando Claude Code está configurado con ese proveedor: Anthropic exige una cuenta de Anthropic para sus sesiones cloud nativas. AWS plantea otra vía, un despliegue personalizado que ejecuta tareas en sesiones de Amazon Bedrock AgentCore Runtime y devuelve un pull request para revisión humana. Anthropic explica las condiciones de --cloud, mientras que AWS describe el ejemplo de AgentCore.
| Ruta | Cuenta y proveedor | Cómo se ejecuta la tarea y qué resultado produce |
Claude Code --cloud | Requiere una cuenta de Anthropic; no está disponible si Claude Code está configurado para Amazon Bedrock. | Es la función cloud nativa de Claude Code. |
| Ejemplo de AWS con AgentCore | Usa Amazon Bedrock en la cuenta de AWS donde se despliega. | Un plugin de Claude Code con un servidor MCP local o una consola web envía la tarea a una sesión de AgentCore Runtime. El ejemplo abre un pull request para que una persona lo revise; no lo fusiona. |
Si quieres conservar Amazon Bedrock como proveedor, considera AgentCore una implementación propia que requiere revisión humana, no una opción de --cloud.
Qué ocurre con una tarea en AgentCore
AWS describe un flujo en el que Claude Opus prepara el plan, Claude Sonnet escribe código y los comandos de configuración y pruebas definidos por el repositorio se ejecutan en una sesión independiente. Claude Opus revisa el resultado; si hace falta, el trabajo puede volver a planificación, hasta un máximo de tres intentos. Al final, el agente abre un pull request. Si la verificación no pasa, lo deja como borrador. Una persona debe revisar el cambio y decidir si lo fusiona.
Requisitos antes del despliegue
Necesitas una cuenta de AWS y credenciales para AWS CLI, Docker en ejecución, Python 3.11 o posterior, uv y Node.js 22.12 o posterior. El repositorio debe ser de confianza y definir los comandos de configuración y pruebas que usará el flujo. Para enviar tareas desde el terminal hace falta, además, compatibilidad con el marketplace de plugins de Claude Code; también puedes utilizar la consola web.
La guía de AWS enumera cinco regiones para AgentCore Runtime V2: us-east-1, us-east-2, us-west-2, ap-northeast-1 y eu-west-1. El recorrido utiliza us-west-2. AWS estima que el despliegue lleva entre 15 y 25 minutos y que registrar un repositorio requiere otros 8–12 minutos.
Desplegar y conectar el repositorio
- Comprueba los requisitos y prepara un repositorio de confianza. Verifica las versiones de las herramientas y define los comandos de configuración y pruebas del proyecto. El agente ejecuta esos comandos dentro del flujo.
- Ejecuta la comprobación previa y despliega el ejemplo. AWS describe el despliegue de
sample-remote-coding-agent; sigue el orden y los pasos de su implementación para crear los recursos en tu cuenta. - Instala y autoriza la GitHub App. La aplicación limita el acceso a los repositorios que autorices y los permisos descritos cubren Contents y Pull requests. AWS indica que AgentCore Identity proporciona un token de usuario a servidor que caduca a las ocho horas y se renueva automáticamente.
- Registra el repositorio. Hazlo después de autorizar la aplicación. AWS calcula entre 8 y 12 minutos para este paso.
- Envía una tarea acotada. Puedes hacerlo desde el plugin de Claude Code mediante el servidor MCP local o desde la consola web. El agente trabaja en su sesión y presenta el resultado como pull request para revisión.
Límites de seguridad y gasto
El control de prompts examina la tarea enviada, pero no los archivos del repositorio ni la salida de los comandos que se ejecutan. Por eso AWS no recomienda el ejemplo para repositorios con código no confiable; tampoco lo considera adecuado para trabajo abierto que pueda exceder el límite de tres intentos.
Las sesiones usan subredes privadas y endpoints privados para servicios de AWS, pero la conexión a GitHub y a registros de paquetes sale a internet mediante una pasarela NAT. El DNS Firewall descrito por AWS bloquea dominios seleccionados; no es una lista general de destinos HTTPS permitidos.
El despliegue sigue generando cargos cuando está inactivo. La configuración predeterminada de presupuesto de Amazon Bedrock, de 200 dólares estadounidenses al mes, envía un aviso por correo, pero no limita el gasto.
Retirar el despliegue
Para limpiar los recursos, da de baja los repositorios registrados y desconecta GitHub antes de destruir las pilas de AWS. Después, elimina la GitHub App. AWS advierte que algunos recursos conservados pueden seguir generando cargos hasta que se borren por separado.
