Sobre el proyecto

claude-desktop-gateway es un programa proxy ligero que permite que Claude Desktop acceda a modelos de IA de proveedores ajenos a Anthropic, como OpenAI, Gemini, DeepSeek y otros. Funciona traduciendo las solicitudes de la API de Anthropic a formatos compatibles con OpenAI y viceversa, lo que permite una integración fluida sin modificar el comportamiento central de Claude Desktop. El gateway se configura enteramente a través de un único archivo YAML (models.yaml), donde los usuarios definen los proveedores y sus modelos asociados. Cada proveedor puede habilitarse o deshabilitarse, y las claves de API se cargan desde variables de entorno, un archivo auth.json o se incrustan directamente en la configuración (con advertencias de seguridad). Los modelos se mapean con alias que comienzan con 'claude-' para evitar conflictos con los modelos oficiales de Anthropic. Soporta entrada de texto e imágenes, llamadas a herramientas, modos de razonamiento y respuestas en streaming. El gateway se ejecuta como un servicio headless en Linux/WSL o como una aplicación de bandeja de sistema en Windows, escuchando en el puerto 3458 por defecto. Los usuarios deben habilitar el Developer Mode en Claude Desktop y configurarlo para que apunte a la URL local del gateway. No se requieren dependencias de tiempo de ejecución más allá de Go para la compilación. El programa registra las solicitudes cuando GATEWAY_LOG está configurado, lo que ayuda en la resolución de problemas. Es necesario reiniciar el gateway y Claude Desktop después de realizar cambios en la configuración para actualizar las listas de modelos. El gateway no valida la clave de la Gateway API; cualquier valor (por ejemplo, 'x') es suficiente para la autenticación dentro de Claude Desktop.