> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiperai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Proxy Transparente (Enrutamiento Local de IA)

> Enrutar el tráfico de IA del desarrollador (por ejemplo, Claude Code) a través de la puerta de enlace SecureAI desde el endpoint

# Proxy transparente (enrutamiento AI)

El agente puede enrutar de forma transparente el tráfico de IA de un desarrollador, por ejemplo [Claude Code](https://docs.hiperai.com/integrations/ide-claude-code.md), a través de la puerta de enlace SecureAI. Esto hace que el uso del asistente de codificación esté bajo la misma gobernanza, seguimiento de costos y política que el resto de su patrimonio de IA, sin que el desarrollador cambie sus herramientas.

## Cómo funciona

El enrutamiento se configura por [política](https://docs.hiperai.com/agent/policies-and-groups.md) a través de `claudeCodeRouting`:

| Configuración | Descripción |
| - | - |
| **Habilitado** | Active el enrutamiento para dispositivos bajo esta política. |
| **Bloquear** | `user` (el desarrollador puede alternar), `force_on` (siempre enrutado) o `force_off` (nunca enrutado). |
| **Asignaciones de modelos** | Mapeo por familia para `opus` / `sonnet` / `haiku` al modelo realmente servido. |
| **Bloqueo de modelo** | `user` o `force`: si el desarrollador puede cambiar la asignación. |

Cuando el enrutamiento está habilitado, SecureAI **crea una clave API por dispositivo** y la inyecta en el entorno del endpoint (por ejemplo, como `ANTHROPIC_AUTH_TOKEN`) a través de la configuración de proxy transparente. El uso se **factura al depósito de puntos del desarrollador vinculado**, así que asegúrese de que el dispositivo esté vinculado a un usuario propietario (consulte [Inscripción y paquetes](https://docs.hiperai.com/agent/enrollment-and-packages.md)).

## Valores predeterminados para toda la flota

Los valores predeterminados de la puerta de enlace se pueden configurar una vez para la flota (`anthropicBaseUrl`, `openaiBaseUrl`, el token de autenticación y un bloqueo) y los dispositivos los heredan. El agente informa si el proxy está actualmente activado o desactivado y esas transiciones se auditan.

## ¿Por qué enrutar en lugar de bloquear?

Para la IA de un desarrollador autorizado, el enrutamiento a través de la puerta de enlace suele ser preferible a un [bloque de salida](https://docs.hiperai.com/agent/egress-enforcement.md): el desarrollador sigue trabajando, mientras usted obtiene la aplicación de políticas, la atribución de costos y la auditoría de ese tráfico. Bloqueo/bloqueo de reserva para proveedores no autorizados.

## Relacionado

* [Aplicación de salida](https://docs.hiperai.com/agent/egress-enforcement.md)
* [Políticas y grupos](https://docs.hiperai.com/agent/policies-and-groups.md)
* [Descripción general de la puerta de enlace AI](https://docs.hiperai.com/ai-gateway/overview.md)
* [Integración IDE de Claude Code](https://docs.hiperai.com/integrations/ide-claude-code.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.