Skip to main content
Esta sección cubre el uso de un producto de puerta de enlace que su organización ya ejecuta, en lugar de puerta de enlace de aplicaciones Claude. Para saber qué es una puerta de enlace, cómo se sitúa entre Claude Code y su proveedor, y cómo elegir entre puerta de enlace de aplicaciones Claude y otro producto, consulte la descripción general de puertas de enlace.
Cualquier puerta de enlace que exponga un formato de API compatible funciona. Anthropic no respalda, mantiene ni audita productos de puerta de enlace de terceros, y no admite enrutar Claude Code a modelos que no sean de Claude a través de ninguna puerta de enlace. Despliegue la puerta de enlace siguiendo su propia documentación, luego complete el lado de Claude Code con los pasos de despliegue a continuación.

​
Qué proporciona una puerta de enlace

Una puerta de enlace le da a su organización un lugar para gestionar:
  • Credenciales: la clave del proveedor permanece del lado del servidor; los desarrolladores tienen credenciales de puerta de enlace en su lugar
  • Seguimiento de uso: atribuya el uso por desarrollador o equipo, independientemente de qué proveedor sirva la solicitud
  • Controles de costos: aplique presupuestos y límites de velocidad en un solo lugar
  • Registro de auditoría: registre cada solicitud de modelo para cumplimiento normativo
  • Cambio de proveedor: cambie el proveedor en la configuración de la puerta de enlace, sin tocar máquinas de desarrolladores
Todos estos excepto el cambio de proveedor se aplican si el upstream es la API de Anthropic o un proveedor en la nube. El cambio de proveedor sin reconfigurar máquinas de desarrolladores también depende de que la puerta de enlace exponga un único punto final en formato Anthropic independientemente del upstream; una puerta de enlace que exponga el formato propio de un proveedor vincula la configuración del cliente a ese proveedor. El compromiso es que la puerta de enlace se convierte en infraestructura que su organización opera. Claude Code añade capacidades con cada lanzamiento, y una puerta de enlace que no las reenvía rompe las características correspondientes, por lo que el producto de puerta de enlace necesita mantenerse actualizado a medida que Claude Code evoluciona. La referencia del protocolo de puerta de enlace cubre qué reenviar.

​
Desplegar una puerta de enlace

Cuando esté listo para desplegar una puerta de enlace LLM a su organización, la secuencia es la misma sin importar qué producto de puerta de enlace elija:
  1. Despliegue la puerta de enlace y déle su credencial de proveedor, para que pueda autenticar las solicitudes que reenvía.
  2. Emita a cada desarrollador una credencial de puerta de enlace, para que el uso se atribuya al desarrollador y la desvinculación revoque una credencial.
  3. Distribuya la configuración a través de un archivo de configuración administrada y su herramienta de secretos, para que cada máquina reciba la URL base y una credencial. Cuando ambas se distribuyen, los desarrolladores no configuran nada. Si no tiene distribución de configuración en su lugar, los desarrolladores siguen la página de conexión para establecer las variables ellos mismos.
  4. Haga que cada desarrollador verifique la configuración en Claude Code, para que los problemas de distribución salgan a la superficie antes de que dependan de la puerta de enlace.
Despliegue una puerta de enlace LLM para su organización camina cada paso y muestra los archivos de configuración a distribuir en cada uno. La puerta de enlace es una parte de la configuración de la organización; para aplicación de políticas, visibilidad de uso y decisiones de manejo de datos, consulte Configure Claude Code para su organización.

​
Suscripciones y puertas de enlace

Mientras una variable de credencial de puerta de enlace o apiKeyHelper está activa, la suscripción de claude.ai de un desarrollador no se usa: la credencial reemplaza el inicio de sesión de suscripción para esa sesión, y los límites de uso de la suscripción no se aplican. Ese tráfico se factura por token a quien sea propietario de la credencial que la puerta de enlace reenvía, como la cuenta de Consola de Anthropic de su organización, o su cuenta de Bedrock, Agent Platform o Foundry cuando la puerta de enlace enruta allí. ANTHROPIC_BASE_URL es la variable que apunta Claude Code a la puerta de enlace. Establecer solo esa variable, sin una credencial de puerta de enlace, no reemplaza la suscripción. Las solicitudes aún se enrutan a través de la puerta de enlace, pero un inicio de sesión de claude.ai guardado permanece como la credencial activa, por lo que sus límites de uso y facturación se aplican. Las puertas de enlace que pasan este tráfico a Anthropic deben reenviar la capacidad OAuth en anthropic-beta; consulte la referencia de encabezados de solicitud.