claude, por lo que no tiene que adoptar un producto de puerta de enlace separado para ejecutar uno. Si su organización ya ejecuta una puerta de enlace LLM, Claude Code también funciona con esa.
Esta página cubre:
- Cómo una puerta de enlace se sitúa entre Claude Code y su proveedor
- Elegir entre la puerta de enlace de aplicaciones Claude y una puerta de enlace que ya ejecuta
- Cómo las puertas de enlace interactúan con las suscripciones de claude.ai
- Qué se configura por separado de la puerta de enlace
Cómo funciona una puerta de enlace
Cada Claude Code del desarrollador se apunta a la dirección de la puerta de enlace y se autentica con una credencial emitida por la puerta de enlace. La puerta de enlace autentica al desarrollador, aplica las reglas de acceso y presupuesto que configure, y reenvía la solicitud a su proveedor con la credencial de la organización. El proveedor puede ser la API de Anthropic o un proveedor de nube como Amazon Bedrock, Agent Platform de Google Cloud o Microsoft Foundry; la configuración de la puerta de enlace lo decide. Con la puerta de enlace de aplicaciones Claude, u otra puerta de enlace que exponga un único punto de conexión en formato Anthropic, cambiar de proveedor no requiere tocar máquinas de desarrolladores.
- Credencial del desarrollador: cada desarrollador posee la suya propia, emitida por la puerta de enlace. Los autentica en la puerta de enlace e los identifica en el seguimiento de uso
- Credencial del proveedor: la puerta de enlace posee una credencial para su cuenta de proveedor, compartida por todo el tráfico reenviado
Elegir una puerta de enlace
Claude Code funciona con la puerta de enlace propia de Anthropic o con una puerta de enlace que su organización ya ejecuta.Puerta de enlace de aplicaciones Claude
La puerta de enlace de aplicaciones Claude es la puerta de enlace autohospedada propia de Anthropic, incluida en el binarioclaude. Enruta a Amazon Bedrock, Google Cloud, Microsoft Foundry o la API de Anthropic como el proveedor ascendente. Los desarrolladores inician sesión con su proveedor de identidad corporativa a través de /login, la puerta de enlace aplica el acceso a modelos y configuración administrada por grupo de IdP, y emite métricas de uso del Protocolo OpenTelemetry (OTLP) a su propia pila de observabilidad.
Debido a que se construye y prueba junto con cada versión de Claude Code, reenvía los encabezados y campos de solicitud que Claude Code envía. Una puerta de enlace mantenida por separado necesita que sus reglas de reenvío se actualicen a medida que esos encabezados y campos cambian con cada versión; la puerta de enlace de aplicaciones Claude se lanza con la CLI, por lo que no hay lista que mantener actualizada. Consulte Disponibilidad y limitaciones para el pequeño conjunto de características que se comportan de manera diferente en una sesión de puerta de enlace.
El inicio de sesión de la puerta de enlace es un paso de SSO del navegador, y no hay flujo de token de servicio, por lo que una canalización de CI sin un desarrollador para aprobar el inicio de sesión no puede autenticarse a través de ella; configure esos contra su proveedor directamente. Las sesiones del SDK de Agent y las ejecuciones de claude -p en una máquina donde un desarrollador ha iniciado sesión usan la sesión de puerta de enlace de esa máquina y se rigen por sus políticas. Consulte Canalizaciones de CI y máquinas remotas.
Consulte Puerta de enlace de aplicaciones Claude para implementarla.
Otras puertas de enlace
Si su organización ya ejecuta una puerta de enlace LLM o puerta de enlace de API, puede usarla en su lugar. Anthropic no respalda, mantiene ni audita otros productos de puerta de enlace, y no admite enrutar Claude Code a modelos que no sean de Claude a través de ninguna puerta de enlace. Consulte Otras puertas de enlace LLM para la lista de verificación de implementación del administrador, lo que una puerta de enlace debe implementar y cómo apuntar Claude Code a ella.Suscripciones y puertas de enlace
Cuando los desarrolladores se conectan a través de una puerta de enlace con una credencial de puerta de enlace, el uso se factura a la cuenta de proveedor de su organización a tasas de API, y sus suscripciones de claude.ai no se usan ni se cobran. ConfigurarANTHROPIC_AUTH_TOKEN para una puerta de enlace que ejecuta, o iniciar sesión en una puerta de enlace de aplicaciones Claude con /login, desactiva el inicio de sesión de suscripción para esa sesión. Cada solicitud reenviada bajo esa credencial se cobra a la cuenta detrás de la credencial del proveedor de la puerta de enlace.
La excepción es configurar solo ANTHROPIC_BASE_URL, sin credencial de puerta de enlace. 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 los límites de uso y la facturación de la suscripción se aplican. Otras puertas de enlace LLM cubre esa configuración y lo que la puerta de enlace tiene que reenviar para que funcione.
Configurar por separado de la puerta de enlace
Una puerta de enlace enruta solicitudes de API de modelos. Algunas cosas que podría esperar que maneje se configuran en otro lugar:- Qué modelo responde: seleccione el modelo con el comando
/modelo variables de entorno de modelo. La puerta de enlace decide dónde van las solicitudes, no qué modelo selecciona el desarrollador. La puerta de enlace de aplicaciones Claude puede limitar la opción con una lista de permitidosavailableModelspor grupo, pero el desarrollador aún elige dentro de ella. - Otro tráfico de red: Claude Code en sí envía comprobaciones de versión y descargas directamente a Anthropic, separado de la ruta de la puerta de enlace. Si la secuencia de telemetría del cliente opcional también está activada depende de su proveedor; la tabla de valores predeterminados de telemetría cubre cada caso. En una sesión de puerta de enlace de aplicaciones Claude con sesión iniciada, la credencial de la puerta de enlace desactiva el análisis vinculado a Anthropic y, cuando se configura el reenvío de telemetría, fija la exportación de OTLP a la puerta de enlace. Su red aún necesita salida a los dominios requeridos, o configure
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICpara desactivar las secuencias opcionales. - Proxies HTTP corporativos: un
HTTPS_PROXYse sitúa entre Claude Code y cada servidor con el que habla, incluida la puerta de enlace. Si su red requiere uno, configure el proxy además de la puerta de enlace. Para la puerta de enlace de aplicaciones Claude específicamente, el inicio de sesión verifica que el host del proxy también esté en una red privada; si no es así, agregue el host de la puerta de enlace aNO_PROXYpara que la CLI se conecte a él directamente.
Próximos pasos
La siguiente página depende de quién ejecute la puerta de enlace. La puerta de enlace de Anthropic se ejecuta desde el binarioclaude y tiene su propia guía de configuración; una puerta de enlace que su organización ya ejecuta tiene un protocolo que implementar y una lista de verificación de implementación del administrador.
- Puerta de enlace de aplicaciones Claude para implementar la puerta de enlace autohospedada propia de Anthropic con inicio de sesión SSO y telemetría OTLP
- Otras puertas de enlace LLM para lo que una puerta de enlace que su organización ya ejecuta debe implementar, y cómo apuntar Claude Code a ella
- Configurar Claude Code para su organización para las decisiones de implementación más amplias de las que una puerta de enlace es una parte