Puertas de enlace LLM

Enruta Claude Code a través de una puerta de enlace LLM para autenticación centralizada, seguimiento de uso y controles de costos. Cubre la conexión de Claude Code a una puerta de enlace, el despliegue de una para su organización, qué envía Claude Code a una puerta de enlace e interacciones de puertas de enlace con suscripciones de claude.ai.

Una puerta de enlace LLM es un proxy que su organización ejecuta entre Claude Code y un proveedor de modelos. Claude Code envía tráfico de API a la puerta de enlace, y la puerta de enlace lo reenvía al proveedor usando una credencial que su organización controla.

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 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.

Cómo funciona una puerta de enlace

Por defecto, Claude Code envía solicitudes directamente a la API de Anthropic en api.anthropic.com. Para enrutar a través de una puerta de enlace, establezca ANTHROPIC_BASE_URL en la dirección de la puerta de enlace; Claude Code envía las mismas solicitudes allí en su lugar. La puerta de enlace autentica al desarrollador, adjunta la credencial del proveedor de su organización, y reenvía cada solicitud al proveedor para el cual está configurada.

ANTHROPIC_BASE_URL es la variable de dirección para la mayoría de puertas de enlace. Una puerta de enlace que frontal un proveedor en la nube específico, como Bedrock, Vertex, Foundry, o la Plataforma Claude en AWS, usa la variable de URL base de ese proveedor en su lugar; Formatos de API lista qué variable va con cada configuración.

Dos tipos de credencial están involucrados:

• Credenciales de desarrollador: cada desarrollador tiene la suya propia, emitida por la puerta de enlace. Autentica al desarrollador en la puerta de enlace e lo identifica en el seguimiento de uso
• Credencial del proveedor: la puerta de enlace tiene una credencial para su cuenta de proveedor, compartida por todo el tráfico reenviado. No aprovisiona claves de proveedor por desarrollador

La puerta de enlace reenvía cada solicitud al proveedor que configura, como la API de Anthropic, Amazon Bedrock, Google Vertex AI, Microsoft Foundry, o la Plataforma Claude en AWS. Debido a que Claude Code solo habla con la puerta de enlace, la opción de proveedor es la configuración de la puerta de enlace, no la del cliente.

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, vea Configure Claude Code para su organización.

Puertas de enlace de terceros

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. Despliegue siguiendo su propia documentación, luego complete el lado de Claude Code del despliegue con los pasos de despliegue.

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, Vertex o Foundry cuando la puerta de enlace enruta allí.

Establecer solo ANTHROPIC_BASE_URL, 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; vea la referencia de encabezados de solicitud.

Configurar por separado de la puerta de enlace

Una puerta de enlace determina dónde se envían las solicitudes de API del modelo. La selección de modelo, el resto del tráfico de red de Claude Code y los proxies corporativos se configuran por separado:

• Selección de modelo: la URL base decide dónde van las solicitudes, no qué modelo las responde. Elija el modelo con el comando /model o las variables de entorno del modelo; vea cómo establecer su modelo
• Tráfico del lado del cliente: comprobaciones de versión y telemetría de cliente opcional, ambas deshabilitadas con CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, y tráfico de inicio de sesión cuando se está usando un inicio de sesión de claude.ai o Consola, van a los puntos finales de actualización y autenticación de Anthropic en lugar de la puerta de enlace. Vea requisitos de acceso a la red para los dominios
• Proxies corporativos: un proxy establecido con HTTPS_PROXY se sienta entre Claude Code y cada servidor con el que habla, incluyendo la puerta de enlace. Si su red requiere un proxy, configure ambos; vea configuración de proxy

Páginas relacionadas

• Conecte Claude Code a una puerta de enlace LLM: establezca la URL base y la credencial en su propia máquina, con configuración por superficie y una tabla de solución de problemas
• Despliegue una puerta de enlace LLM para su organización: la lista de verificación del administrador para desplegar una puerta de enlace, emitir credenciales de desarrollador y distribuir configuración administrada
• Referencia del protocolo de puerta de enlace: qué envía Claude Code a una puerta de enlace, para operadores que configuran una, cubriendo puntos finales, encabezados a reenviar y paso a través de características
• Configure Claude Code para su organización: las decisiones de despliegue más amplias de las que una puerta de enlace es una parte, incluyendo aplicación de políticas y visibilidad de uso