Saltar al contenido
Nubent

/AI-native: AWS + Claude

Claude Code para empresas: adopción ordenada en equipos de ingeniería

Ayudamos a tu equipo a adoptar Claude Code, la herramienta de programación agéntica de Anthropic, con reglas claras. Configuramos CLAUDE.md, permisos, servidores MCP y su uso en CI/CD, conectamos los modelos vía Amazon Bedrock si lo necesitás y medimos el impacto en las entregas.

/Diagnóstico

Señales de que es el momento

Cada ingeniero lo usa a su manera

Algunos ya usan Claude Code y otros no, cada uno con su configuración, y no hay acuerdos sobre qué puede hacer el agente en el repositorio.

Seguridad todavía no lo aprobó

Hay dudas sobre credenciales, acceso a producción, qué código sale de la empresa y dónde se procesa, y nadie tiene tiempo de responderlas.

El agente no conoce tu código

Claude Code propone cambios que no respetan tus convenciones, tu arquitectura ni tus comandos de build, porque nadie le dio ese contexto.

No sabés si está sirviendo

Pagás licencias o consumo de tokens, pero no tenés datos sobre tiempos de revisión, calidad de los pull requests ni adopción real.

/Qué entregamos

Entregables concretos, en tu repositorio

  • Configuración base del equipo

    Settings compartidos en el repositorio, permisos por defecto, comandos permitidos y bloqueados, y hooks para formateo, lint y tests.

  • CLAUDE.md por repositorio

    Archivos de contexto con la arquitectura, convenciones, comandos de build y test, y reglas de seguridad de cada repositorio.

  • Integración con Amazon Bedrock

    Claude Code apuntando a los modelos Claude en tu cuenta AWS, con roles de IAM, IAM Identity Center y control de consumo por equipo.

  • Servidores MCP aprobados

    Catálogo de servidores MCP revisados para tickets, documentación y observabilidad, con permisos de solo lectura por defecto.

  • Claude Code en CI/CD

    Workflows de GitHub Actions para revisión de pull requests y tareas asistidas, con OIDC hacia AWS en lugar de claves estáticas.

  • Guía de uso y métricas

    Buenas prácticas escritas para el equipo, sesiones de pairing y un tablero con indicadores de adopción y de flujo de entrega.

/Cómo lo hacemos

Nuestro proceso

  1. Relevamiento

    Revisamos repositorios, pipelines, políticas de seguridad y cómo trabaja hoy el equipo, y acordamos qué métricas seguir.

  2. Piloto con un equipo

    Configuramos Claude Code en uno o dos repositorios, escribimos el CLAUDE.md y acompañamos al equipo en tareas reales.

  3. Estandarización

    Llevamos la configuración, los permisos, los servidores MCP y los workflows de CI al resto de los repositorios por pull request.

  4. Medición y ajuste

    Comparamos las métricas con la línea de base, ajustamos reglas y contexto, y dejamos al equipo autónomo para mantenerlo.

Qué es Claude Code y por qué adoptarlo con reglas

Claude Code es una herramienta de Anthropic que trabaja en la terminal y en el editor: lee el repositorio, ejecuta comandos, edita archivos y propone cambios completos. Para un ingeniero individual se instala en minutos. Para una empresa, la pregunta es otra: qué puede hacer el agente, con qué credenciales, sobre qué repositorios y cómo se revisa lo que produce.

Cuando esas reglas no existen, cada persona decide por su cuenta. Aparecen permisos demasiado amplios, contextos incompletos y resultados dispares entre equipos. Nuestro trabajo es convertir esa adopción espontánea en una práctica de ingeniería: configuración compartida, contexto escrito, límites claros y revisión humana de todo lo que llega a la rama principal.

CLAUDE.md, permisos y servidores MCP

El archivo CLAUDE.md le da al agente el contexto que un ingeniero nuevo necesitaría: arquitectura, convenciones, comandos de build y test, y lo que nunca debe tocar. Un buen CLAUDE.md es corto, concreto y vive en el repositorio, así que se revisa y se actualiza como cualquier otro código.

Los permisos definen qué comandos puede ejecutar Claude Code sin pedir confirmación y cuáles quedan bloqueados. Los configuramos de forma conservadora y los ampliamos con evidencia. Lo mismo con los servidores MCP: armamos un catálogo aprobado, con acceso de solo lectura por defecto, para que el agente consulte tickets, documentación u observabilidad sin abrir puertas innecesarias.

Claude Code con modelos en Amazon Bedrock

Claude Code puede usar los modelos Claude a través de Amazon Bedrock en lugar de la API de Anthropic. Se habilita con la variable de entorno CLAUDE_CODE_USE_BEDROCK y toma las credenciales de la cadena estándar de AWS, así que encaja con IAM Identity Center y con los roles que tu equipo ya usa.

Para muchas empresas esto resuelve la objeción principal de seguridad: el consumo queda en la cuenta AWS, se factura junto al resto de la plataforma y se audita con CloudTrail. Configuramos el acceso a los modelos, los perfiles de inferencia, las cuotas y las alarmas de costo por equipo, todo en Terraform.

Claude Code en CI/CD y revisión de código

Claude Code también corre en pipelines. Con GitHub Actions puede revisar pull requests, responder comentarios o implementar tareas acotadas a partir de un issue. Configuramos esos workflows con OIDC hacia AWS para usar Bedrock sin claves estáticas, con permisos mínimos sobre el repositorio y límites de tiempo y consumo.

La regla que mantenemos es simple: el agente propone y una persona aprueba. Ningún cambio llega a la rama principal sin revisión humana, y los workflows dejan registro de lo que hizo el agente. Así la revisión asistida acelera el trabajo del equipo sin reemplazar el criterio de quien conoce el sistema.

Cómo medir el impacto de Claude Code

Medir solo líneas de código generadas no dice mucho. Preferimos indicadores de flujo que el equipo ya entiende: tiempo desde el primer commit hasta el merge, tiempo de primera revisión, tamaño de los pull requests, frecuencia de despliegue y tasa de cambios que fallan en producción. Tomamos una línea de base antes del piloto y comparamos después.

Sumamos datos de adopción y de consumo por equipo, y entrevistas cortas con los ingenieros para entender dónde ayuda y dónde no. Con eso decidís con evidencia si ampliar el uso, cambiar reglas o enfocar el agente en tareas específicas como tests, migraciones o documentación.

/FAQ

Preguntas frecuentes: Claude Code para equipos

¿Tenés otra duda? Escribinos a hello@nubent.com y te responde un ingeniero.

¿Se puede usar Claude Code con Amazon Bedrock?

Sí. Claude Code admite Amazon Bedrock como proveedor de modelos. Se habilita con la variable de entorno CLAUDE_CODE_USE_BEDROCK y usa la cadena de credenciales estándar de AWS, por lo que funciona con perfiles, IAM Identity Center o roles. Antes hay que habilitar el acceso a los modelos Claude en la consola de Bedrock de tu cuenta.

¿Es seguro usar Claude Code con el código de mi empresa?

Puede serlo si se configura bien. Definimos permisos conservadores, bloqueamos comandos peligrosos, evitamos credenciales de producción en las máquinas de desarrollo y usamos Bedrock cuando seguridad pide que la inferencia quede en tu cuenta AWS. Además, todo cambio pasa por pull request y revisión humana. Documentamos esas decisiones para que tu equipo de seguridad las apruebe.

¿Qué es el archivo CLAUDE.md?

CLAUDE.md es un archivo de texto en el repositorio que Claude Code lee al iniciar una sesión. Contiene el contexto del proyecto: arquitectura, convenciones, comandos para compilar y probar, y reglas que el agente debe respetar. Funciona como una guía de incorporación para el agente, y se versiona y revisa como el resto del código.

¿Claude Code puede revisar pull requests en GitHub?

Sí. Anthropic publica una integración con GitHub Actions que permite a Claude Code revisar pull requests, responder comentarios e implementar tareas a partir de issues. Puede usar los modelos vía Amazon Bedrock con autenticación OIDC. La configuramos con permisos mínimos y siempre como apoyo a la revisión humana, que sigue siendo la que aprueba el merge.

¿Cuánto tarda la adopción de Claude Code en un equipo?

Un piloto con uno o dos repositorios suele mostrar resultados en pocas semanas, porque se trabaja sobre tareas reales del equipo. La estandarización en el resto de los repositorios depende de cuántos haya y de la madurez de los pipelines. Lo planificamos por etapas, con métricas de base, para que cada paso tenga evidencia antes del siguiente.

Siguiente paso

Hablemos de tu proyecto de Claude Code para equipos

30 minutos con un ingeniero. Próximos pasos concretos, trabajes o no con nosotros.