Integración con IA

Integre únicamente los modelos Claude a través de Essevin en el proyecto actual y siga este contrato.

Alcance
- Implemente solo lo necesario para la API de Claude o Claude Code. No agregue, configure ni pruebe una familia de modelos no seleccionada.
- Conserve el framework, los SDK y el estilo de código existentes. Realice los cambios mínimos necesarios para esta integración.
- Determine si se trata de una herramienta local de un solo usuario, un servicio interno o una aplicación que atiende a clientes o inquilinos externos antes de elegir la ubicación de la clave y la arquitectura.

Clave y modelo
- Use únicamente una clave de grupo Claude. En un proyecto con varios modelos, prefiera ESSEVIN_CLAUDE_API_KEY o el gestor de secretos existente. Reutilice ESSEVIN_API_KEY solo en un proyecto explícitamente de un solo modelo.
- No cree una clave, no lea la clave de otra familia de modelos ni me pida que pegue una clave real en la conversación. Deténgase y pídame que la configure localmente o en el gestor de secretos cuando no esté disponible.
- Primero llame a GET https://api.essevin.com/v1/models con esta clave. Seleccione únicamente IDs de modelo que comiencen con claude- de la respuesta.
- Ante model_not_found, vuelva a llamar a /v1/models y use un ID de modelo completo devuelto por la respuesta. Nunca adivine ni reescriba un nombre de modelo.

Conexión
- Use el protocolo Anthropic con https://api.essevin.com como Base URL, sin /v1.
- Use api_key con el SDK de Anthropic o x-api-key para HTTP nativo. El código Anthropic existente debe conservar la autenticación nativa.
- El SDK envía las solicitudes de la API de Claude a POST /v1/messages. No las convierta a OpenAI Chat Completions.
- Claude Code usa ANTHROPIC_BASE_URL=https://api.essevin.com y ANTHROPIC_AUTH_TOKEN obtenido de la clave Claude seleccionada.

Implementación
- Inspeccione las dependencias y la configuración actuales. Reutilice un SDK ya instalado y conserve toda configuración de otros proveedores.
- Coloque la Base URL, el nombre de la variable de la clave y el modelo predeterminado en el sistema de configuración existente. Actualice .env.example sin agregar una clave real.
- Las llamadas a clientes externos o multiinquilino deben mantener la clave en el servidor y reutilizar la autenticación de quien llama, con una lista de modelos permitidos, límites de solicitud, tiempos de espera, límites de tasa, atribución de consumo y registros con datos sensibles ocultos.
- No agregue un servicio proxy ni un gateway multiinquilino a una herramienta local de un solo usuario.
- Elija el modelo predeterminado solo entre los modelos Claude devueltos por /v1/models. No use como valor fijo un ejemplo de la documentación.
- Transmita el SSE de Anthropic de extremo a extremo y conserve los estados 4xx o 5xx del upstream junto con los detalles de error seguros.

Validación y entrega
- Envíe una solicitud real mínima después de configurar. Agregue una prueba de streaming solo cuando el proyecto realmente use streaming.
- Pida a un modelo Claude devuelto que responda solo ok mediante Messages y verifique su content.
- Informe los archivos modificados, el nombre de la variable de la clave, el ID del modelo, el endpoint, el estado HTTP y un resumen de la respuesta con datos sensibles ocultos. Incluya los comandos de inicio, verificación y reversión.