Descripción general del despliegue empresarial
Aprende cómo Claude Code puede integrarse con varios servicios de terceros e infraestructura para cumplir con los requisitos de despliegue empresarial.
Esta página proporciona una descripción general de las opciones de despliegue disponibles y te ayuda a elegir la configuración adecuada para tu organización.
Comparación de proveedores
Característica | Anthropic | Amazon Bedrock | Google Vertex AI |
---|---|---|---|
Regiones | Países compatibles | Múltiples regiones de AWS | Múltiples regiones de GCP |
Caché de prompts | Habilitado por defecto | Habilitado por defecto | Habilitado por defecto |
Autenticación | Clave API | Credenciales de AWS (IAM) | Credenciales de GCP (OAuth/Cuenta de Servicio) |
Seguimiento de costos | Panel de control | AWS Cost Explorer | Facturación de GCP |
Características empresariales | Equipos, monitoreo de uso | Políticas IAM, CloudTrail | Roles IAM, Cloud Audit Logs |
Proveedores de nube
Amazon Bedrock
Usa modelos Claude a través de la infraestructura de AWS con autenticación basada en IAM y monitoreo nativo de AWS
Google Vertex AI
Accede a modelos Claude a través de Google Cloud Platform con seguridad y cumplimiento de nivel empresarial
Infraestructura corporativa
Red Empresarial
Configura Claude Code para trabajar con los servidores proxy de tu organización y los requisitos SSL/TLS
Gateway LLM
Despliega acceso centralizado a modelos con seguimiento de uso, presupuestos y registro de auditoría
Descripción general de la configuración
Claude Code admite opciones de configuración flexibles que te permiten combinar diferentes proveedores e infraestructura:
Comprende la diferencia entre:
- Proxy corporativo: Un proxy HTTP/HTTPS para enrutar tráfico (configurado a través de
HTTPS_PROXY
oHTTP_PROXY
) - Gateway LLM: Un servicio que maneja la autenticación y proporciona endpoints compatibles con proveedores (configurado a través de
ANTHROPIC_BASE_URL
,ANTHROPIC_BEDROCK_BASE_URL
, oANTHROPIC_VERTEX_BASE_URL
)
Ambas configuraciones pueden usarse en conjunto.
Usando Bedrock con proxy corporativo
Enruta el tráfico de Bedrock a través de un proxy HTTP/HTTPS corporativo:
Usando Bedrock con Gateway LLM
Usa un servicio de gateway que proporciona endpoints compatibles con Bedrock:
Usando Vertex AI con proxy corporativo
Enruta el tráfico de Vertex AI a través de un proxy HTTP/HTTPS corporativo:
Usando Vertex AI con Gateway LLM
Combina modelos de Google Vertex AI con un gateway LLM para gestión centralizada:
Configuración de autenticación
Claude Code usa el ANTHROPIC_AUTH_TOKEN
para el encabezado Authorization
cuando es necesario. Las banderas SKIP_AUTH
(CLAUDE_CODE_SKIP_BEDROCK_AUTH
, CLAUDE_CODE_SKIP_VERTEX_AUTH
) se usan en escenarios de gateway LLM donde el gateway maneja la autenticación del proveedor.
Eligiendo la configuración de despliegue correcta
Considera estos factores al seleccionar tu enfoque de despliegue:
Acceso directo al proveedor
Mejor para organizaciones que:
- Quieren la configuración más simple
- Tienen infraestructura existente de AWS o GCP
- Necesitan monitoreo y cumplimiento nativos del proveedor
Proxy corporativo
Mejor para organizaciones que:
- Tienen requisitos de proxy corporativo existentes
- Necesitan monitoreo de tráfico y cumplimiento
- Deben enrutar todo el tráfico a través de rutas de red específicas
Gateway LLM
Mejor para organizaciones que:
- Necesitan seguimiento de uso entre equipos
- Quieren cambiar dinámicamente entre modelos
- Requieren limitación de velocidad personalizada o presupuestos
- Necesitan gestión de autenticación centralizada
Depuración
Al depurar tu despliegue:
- Usa el comando slash
claude /status
. Este comando proporciona observabilidad sobre cualquier configuración de autenticación, proxy y URL aplicada. - Establece la variable de entorno
export ANTHROPIC_LOG=debug
para registrar solicitudes.
Mejores prácticas para organizaciones
1. Invierte en documentación y memoria
Recomendamos encarecidamente invertir en documentación para que Claude Code entienda tu base de código. Las organizaciones pueden desplegar archivos CLAUDE.md en múltiples niveles:
-
A nivel de organización: Despliega en directorios del sistema como
/Library/Application Support/ClaudeCode/CLAUDE.md
(macOS) para estándares de toda la empresa -
A nivel de repositorio: Crea archivos
CLAUDE.md
en las raíces de los repositorios que contengan arquitectura del proyecto, comandos de construcción y pautas de contribución. Registra estos en el control de versiones para que todos los usuarios se beneficien
2. Simplifica el despliegue
Si tienes un entorno de desarrollo personalizado, encontramos que crear una forma de “un clic” para instalar Claude Code es clave para hacer crecer la adopción en toda una organización.
3. Comienza con uso guiado
Anima a los nuevos usuarios a probar Claude Code para preguntas y respuestas sobre la base de código, o en correcciones de errores más pequeñas o solicitudes de características. Pide a Claude Code que haga un plan. Revisa las sugerencias de Claude y da retroalimentación si está fuera de rumbo. Con el tiempo, a medida que los usuarios entiendan mejor este nuevo paradigma, entonces serán más efectivos permitiendo que Claude Code funcione de manera más agéntica.
4. Configura políticas de seguridad
Los equipos de seguridad pueden configurar permisos gestionados para lo que Claude Code puede y no puede hacer, que no pueden ser sobrescritos por la configuración local. Aprende más.
5. Aprovecha MCP para integraciones
MCP es una excelente manera de dar a Claude Code más información, como conectarse a sistemas de gestión de tickets o registros de errores. Recomendamos que un equipo central configure servidores MCP y registre una configuración .mcp.json
en la base de código para que todos los usuarios se beneficien. Aprende más.
En Anthropic, confiamos en Claude Code para impulsar el desarrollo en cada base de código de Anthropic. ¡Esperamos que disfrutes usando Claude Code tanto como nosotros!
Próximos pasos
- Configura Amazon Bedrock para despliegue nativo de AWS
- Configura Google Vertex AI para despliegue de GCP
- Configura Red Empresarial para requisitos de red
- Despliega Gateway LLM para gestión empresarial
- Configuraciones para opciones de configuración y variables de entorno