llm-gateway.md +0 −96 deleted
File Deleted View Diff
1> ## Documentation Index
2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.
4
5# Puertas de enlace LLM
6
7> 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.
8
9Una 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.
10
11<Note>
12 * Si es un desarrollador que se conecta a una puerta de enlace existente: [conecte Claude Code a su puerta de enlace](/es/llm-gateway-connect)
13 * Si es un administrador que despliega una puerta de enlace para su organización: [despliegue y distribuya una puerta de enlace](/es/llm-gateway-rollout)
14 * Si está configurando un producto de puerta de enlace: la [referencia del protocolo de puerta de enlace](/es/llm-gateway-protocol)
15</Note>
16
17<h2 id="what-a-gateway-provides">
18 Qué proporciona una puerta de enlace
19</h2>
20
21Una puerta de enlace le da a su organización un lugar para gestionar:
22
23* **Credenciales**: la clave del proveedor permanece del lado del servidor; los desarrolladores tienen credenciales de puerta de enlace en su lugar
24* **Seguimiento de uso**: atribuya el uso por desarrollador o equipo, independientemente de qué proveedor sirva la solicitud
25* **Controles de costos**: aplique presupuestos y límites de velocidad en un solo lugar
26* **Registro de auditoría**: registre cada solicitud de modelo para cumplimiento normativo
27* **Cambio de proveedor**: cambie el proveedor en la configuración de la puerta de enlace, sin tocar máquinas de desarrolladores
28
29Todos estos excepto el cambio de proveedor se aplican si el upstream es la API de Anthropic o un [proveedor en la nube](/es/third-party-integrations).
30
31El 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](/es/llm-gateway-protocol) cubre qué reenviar.
32
33<h2 id="how-a-gateway-works">
34 Cómo funciona una puerta de enlace
35</h2>
36
37Por 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.
38
39`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](/es/llm-gateway-protocol#api-formats) lista qué variable va con cada configuración.
40
41<Frame>
42 <img src="https://mintcdn.com/claude-code/-uq-4JE0W_JO5Er5/images/llm-gateway-flow.svg?fit=max&auto=format&n=-uq-4JE0W_JO5Er5&q=85&s=1c1a8dcc0cfcc3a58652cc8e28cd3e20" alt="Diagrama que muestra Claude Code enrutado a través de una puerta de enlace LLM. En una zona de máquinas de desarrolladores, la CLI de Claude Code, la extensión de VS Code, y los clientes de SDK de CI o Agent envían solicitudes a la puerta de enlace, con la variable de URL base del formato de API de la puerta de enlace apuntando a ella y cada desarrollador teniendo una credencial por desarrollador, y la aplicación de escritorio llega a la misma puerta de enlace a través de configuración distribuida por la organización. En una zona etiquetada como su infraestructura, la puerta de enlace LLM maneja autenticación, seguimiento de uso, presupuestos y enrutamiento, y reenvía solicitudes con la credencial de su organización. En una zona de proveedores de modelos, una flecha sólida lleva al proveedor que configura, mostrado como la API de Anthropic, y flechas punteadas llevan a otras opciones de proveedor, ilustradas con Amazon Bedrock, Google Vertex AI y Microsoft Foundry como ejemplos." width="780" height="322" data-path="images/llm-gateway-flow.svg" />
43</Frame>
44
45Dos tipos de credencial están involucrados:
46
47* **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
48* **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
49
50La puerta de enlace reenvía cada solicitud al proveedor que configura, como la API de Anthropic, [Amazon Bedrock](/es/amazon-bedrock), [Google Vertex AI](/es/google-vertex-ai), [Microsoft Foundry](/es/microsoft-foundry), o la [Plataforma Claude en AWS](/es/claude-platform-on-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.
51
52<h2 id="roll-out-a-gateway">
53 Desplegar una puerta de enlace
54</h2>
55
56Cuando 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:
57
581. Despliegue la puerta de enlace y déle su credencial de proveedor, para que pueda autenticar las solicitudes que reenvía.
592. 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.
603. Distribuya la configuración a través de un [archivo de configuración administrada](/es/settings#settings-files) 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](/es/llm-gateway-connect) para establecer las variables ellos mismos.
614. Haga que cada desarrollador [verifique la configuración en Claude Code](/es/llm-gateway-connect#check-for-an-existing-configuration), para que los problemas de distribución salgan a la superficie antes de que dependan de la puerta de enlace.
62
63[Despliegue una puerta de enlace LLM para su organización](/es/llm-gateway-rollout) 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](/es/admin-setup).
64
65<h2 id="third-party-gateways">
66 Puertas de enlace de terceros
67</h2>
68
69Cualquier puerta de enlace que exponga un [formato de API compatible](/es/llm-gateway-protocol#api-formats) 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](/es/llm-gateway-rollout).
70
71<h2 id="subscriptions-and-gateways">
72 Suscripciones y puertas de enlace
73</h2>
74
75Mientras una [variable de credencial de puerta de enlace](/es/llm-gateway-connect#set-the-credential-variable) 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í.
76
77Establecer 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](/es/llm-gateway-protocol#request-headers).
78
79<h2 id="configure-separately-from-the-gateway">
80 Configurar por separado de la puerta de enlace
81</h2>
82
83Una 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:
84
85* **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](/es/model-config#setting-your-model)
86* **Tráfico del lado del cliente**: comprobaciones de versión y telemetría de cliente opcional, ambas deshabilitadas con [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/es/env-vars), 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](/es/network-config#network-access-requirements) para los dominios
87* **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](/es/network-config#proxy-configuration)
88
89<h2 id="related-pages">
90 Páginas relacionadas
91</h2>
92
93* [Conecte Claude Code a una puerta de enlace LLM](/es/llm-gateway-connect): 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
94* [Despliegue una puerta de enlace LLM para su organización](/es/llm-gateway-rollout): la lista de verificación del administrador para desplegar una puerta de enlace, emitir credenciales de desarrollador y distribuir configuración administrada
95* [Referencia del protocolo de puerta de enlace](/es/llm-gateway-protocol): 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
96* [Configure Claude Code para su organización](/es/admin-setup): 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