SpyBara
Go Premium

llm-gateway.md 2026-10-21 23:02 UTC to 2026-10-22 22:58 UTC

This page contains 16 additions and 16 deletions.

2026
Thu 1 23:59 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

Otras puertas de enlace LLM

Enrute Claude Code a través de una puerta de enlace LLM que su organización ya ejecuta. Cubre la conexión de Claude Code a una puerta de enlace, el despliegue de una para su organización, y qué envía Claude Code a una puerta de enlace.

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.

[!NOTE]

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.

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

Páginas relacionadas