Saltar al contenido principal
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 y cambia lo que Claude Code envía y qué valores predeterminados aplica. 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 guía de compatibilidad 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. Para hacer que una puerta de enlace alcanzada a través de ANTHROPIC_BASE_URL sea el único destino que una máquina administrada pueda usar, establezca allowedProviders en ["customEndpoint"] en el mismo archivo de configuración administrada y coloque la ANTHROPIC_BASE_URL de la puerta de enlace en el bloque env de ese archivo. Claude Code entonces rechaza una sesión apuntada a cualquier otro lugar, incluyendo a Anthropic directamente o al proxy propio de un desarrollador, y acepta ANTHROPIC_BASE_URL solo con el valor que establezca allí. Para una puerta de enlace alcanzada a través de una variable de punto final específica del proveedor como ANTHROPIC_BEDROCK_BASE_URL, la entrada allowedProviders dice qué variable fijar. Requiere Claude Code v2.1.285 o posterior.
Con Desktop con la sesión iniciada en claude.ai, una sesión de Cowork en la máquina del usuario cuenta como "anthropic". Si lo dejas fuera de esta lista en una política de MDM o en un archivo de configuración administrada, esa sesión se rechaza. Si lo incluyes, las sesiones enviadas directamente a Anthropic también pasan esta lista.

Suscripciones y puertas de enlace

Mientras una variable de credencial de puerta de enlace o apiKeyHelper está activa, las solicitudes llevan esa credencial en lugar del inicio de sesión de suscripción de claude.ai de un desarrollador, y los límites de uso de la suscripción no se aplican a ellas. Claude Code mantiene un inicio de sesión de claude.ai guardado en la máquina pero no lo envía con esas solicitudes. 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 Amazon Bedrock, Agent Platform de Google Cloud o Foundry de Microsoft cuando la puerta de enlace enruta allí. ANTHROPIC_BASE_URL es la variable que dirige Claude Code al gateway. Establecer solo esa variable, sin una credencial del gateway, no reemplaza la suscripción. Las solicitudes aún se enrutan a través del gateway, pero un inicio de sesión de claude.ai guardado permanece como la credencial activa, por lo que se aplican sus límites de uso y su facturación. Los gateways que pasan este tráfico a Anthropic deben reenviar Authorization y la capacidad OAuth en anthropic-beta; consulta la referencia de encabezados de solicitud.