Ir al contenido principal
PromptQuorumDiseñado para humanos. Estructurado para la IA.
Inicio/LLM locales avanzados
Overview & Reference

AIClient2API: reseña de un proxy local para todos los protocolos de IA

·10 min de lecturaPor Hans Kuepper · Fundador de PromptQuorum · Motor de descubrimiento de IA de pesos abiertos y código abierto

AIClient2API es un proxy gratuito, de código abierto y autoalojado que convierte los protocolos de cliente de Gemini CLI, Codex, Grok, Kiro y Antigravity en una única API local compatible con OpenAI. Creado por justlovemaki y publicado bajo la licencia GPL-3.0, se ejecuta mediante Docker o Node.js, expone un endpoint con formato OpenAI además de una consola web, y permite que cualquier cliente compatible con OpenAI hable con proveedores a los que de otro modo no podría acceder directamente.

Conclusiones clave

  • AIClient2API (github.com/justlovemaki/AIClient2API) es un proxy de API gratuito, de código abierto y autoalojado — no un servicio alojado
  • Creado por justlovemaki; existen varios forks casi idénticos bajo otras cuentas de GitHub, pero este repositorio está confirmado como la versión original con más estrellas
  • Con licencia GPL-3.0, según el propio campo de licencia del repositorio
  • Convierte los protocolos de cliente de Gemini CLI, Codex, Grok, Kiro y Antigravity en una única API compatible con OpenAI, con conversión bidireccional de protocolos OpenAI/Claude/Gemini
  • Se ejecuta mediante Docker (recomendado) o Node.js/npm; incluye una consola web para configuración y monitoreo de estado
  • Más de 8.700 estrellas en GitHub y más de 1.380 forks al momento de esta reseña, con lanzamientos activos (la v3.5.0 se publicó en septiembre de 2026)

📍 En una frase

AIClient2API es un proxy gratuito, de código abierto (GPL-3.0) y autoalojado, creado por justlovemaki con más de 8.700 estrellas en GitHub, que convierte los protocolos de cliente de Gemini CLI, Codex, Grok, Kiro y Antigravity en una única API local compatible con OpenAI.

💬 En términos simples

AIClient2API es un pequeño servidor que ejecutas en tu propia máquina y que se sitúa entre tus herramientas cliente de IA y los proveedores de IA con los que hablan. En lugar de aprender cinco protocolos de proveedores distintos, apuntas todo a una única dirección local, y AIClient2API traduce las solicitudes por detrás al formato que cada proveedor realmente espera.

📌Nota: Esta reseña se basa en el propio repositorio de GitHub del proyecto, su README y su historial de lanzamientos. No implica que PromptQuorum haya realizado pruebas de carga o auditorías de seguridad prácticas del comportamiento del proxy de AIClient2API.

Leer en:
🇺🇸en🇩🇪de🇫🇷fr🇯🇵ja🇨🇳zh🇪🇸es🇧🇷pt🇸🇦ar🇰🇷ko

AIClient2API (github.com/justlovemaki/AIClient2API) es un proxy gratuito, de código abierto y autoalojado que convierte los protocolos de cliente de Gemini CLI, Codex, Grok, Kiro y Antigravity en una única API compatible con OpenAI, con más de 8.700 estrellas en GitHub. Esta reseña complementa la entrada de AIClient2API en el Directorio de Software de LLM Local y explica qué hace realmente, cómo ejecutarlo y para quién es adecuado.

¿Qué es AIClient2API?

AIClient2API es un proxy gratuito, de código abierto y autoalojado que unifica los protocolos de cliente de varios proveedores de IA y herramientas CLI detrás de una única API local compatible con OpenAI. Está creado por el usuario de GitHub justlovemaki y se distribuye bajo la licencia GPL-3.0.

  • Tipo de producto: un servidor proxy/gateway autoalojado, no una app de chat, un plugin de IDE ni un producto SaaS alojado
  • Creador: justlovemaki (usuario de GitHub); el repositorio en github.com/justlovemaki/AIClient2API está confirmado como la versión original con más estrellas entre varios forks casi idénticos bajo otras cuentas
  • Licencia: GPL-3.0, una licencia copyleft — distribuir versiones modificadas generalmente exige publicar el código fuente bajo la misma licencia
  • Repositorio creado el 20 de julio de 2025, según los metadatos de GitHub
  • Escala: más de 8.700 estrellas en GitHub, más de 1.380 forks y alrededor de 5 issues abiertos al momento de la reseña — un número de issues bajo en relación con su cantidad de forks, lo que sugiere un proyecto mantenido activamente

¿Cuál es el historial de versiones de AIClient2API?

AIClient2API ha publicado versiones frecuentes a lo largo de 2026, con la última versión etiquetada, v3.5.0, publicada en septiembre de 2026.

  • v3.5.0 (septiembre de 2026): última versión etiquetada al momento de la reseña
  • v3.4.9.1 y v3.4.8 (septiembre de 2026): lanzamientos de parches incrementales en los días previos a la v3.5.0
  • v3.0.0 (mayo de 2026): las propias notas de la versión del proyecto describen la incorporación de una integración más profunda asistida por IA, incluyendo guías de habilidades automatizadas y endpoints de ayuda de API remota
  • Abril de 2026: soporte completo de la API de generación y edición de imágenes de OpenAI con conversión de protocolos, según el changelog del proyecto
  • Marzo de 2026: se añadió soporte para el protocolo de Grok, incluyendo entrada multimodal y generación de imágenes/video, según el changelog del proyecto

¿Qué hace realmente AIClient2API?

AIClient2API se ejecuta como un servidor local que acepta solicitudes de API en formato estándar de OpenAI y las traduce al protocolo que realmente necesita el proveedor de destino, para luego traducir la respuesta de vuelta.

  • Conversión de protocolos: conversión bidireccional entre los formatos de API de OpenAI, Claude y Gemini, usando lo que el proyecto describe como patrones de diseño de estrategia y adaptador
  • Proveedores/protocolos soportados: Gemini, Claude (accesible vía los protocolos de cliente de Kiro o Antigravity), Grok (vía cookie o OAuth de CLI), Codex, Kimi, MiniMax, OpenAI, además de endpoints personalizados compatibles con OpenAI, según la propia documentación del proyecto
  • Gestión de pool de cuentas: rota entre varias cuentas por proveedor, con conmutación automática por error y comprobaciones de estado
  • Integración OAuth: flujos OAuth integrados para Antigravity, Codex, Grok CLI y Kiro
  • Balanceo de carga: selección de proveedor con un tiempo de espera ante errores HTTP 429 de límite de tasa y cadenas de respaldo entre proveedores
  • Sidecar TLS: un componente proxy independiente basado en Go que el proyecto describe como una simulación de huellas digitales TLS JA3 para sortear bloqueos de Cloudflare o de tipo 403 en algunos endpoints de proveedores
  • Consola web: una interfaz basada en navegador en localhost:3000 para configuración en vivo, monitoreo de estado y pruebas de API
  • Registro (logging): captura completa de solicitudes/respuestas, que el proyecto plantea como útil para auditorías o para construir conjuntos de datos de entrenamiento

¿Cómo se configura y ejecuta?

AIClient2API se configura mediante un archivo de configuración JSON (o la consola web) que asigna las solicitudes entrantes a una o varias cuentas de proveedor en el backend, y luego se ejecuta como un proceso de servidor local de larga duración.

  • Iniciar vía Docker (recomendado): descarga la imagen, monta una carpeta local configs y expón los puertos del proxy
  • Iniciar vía Node.js: clona el repositorio, ejecuta el script de instalación incluido y luego npm start
  • Configura las credenciales de proveedor y los pools de cuentas en el directorio configs montado, o a través de la consola web en http://localhost:3000
  • Apunta cualquier cliente compatible con OpenAI (una app de chat, una CLI de programación, un script propio) a la dirección local del proxy en lugar del endpoint de API del propio proveedor
  • Monitorea el estado de las cuentas, los tiempos de espera por límite de tasa y los registros de solicitudes desde la consola web en tiempo real
bash
docker run -d -p 3000:3000 -p 8086:8086 -p 1455:1455 -p 56121:56121 \
  -v "your_path/configs:/app/configs" \
  justlikemaki/aiclient-2-api

Plataforma, precios y licencia

Plataforma

Lo que indica AIClient2API:
Un servidor autoalojado, multiplataforma (Mac, Windows, Linux) vía Docker o Node.js — sin versión alojada en la nube.

Costo

Lo que indica AIClient2API:
Gratuito y de código abierto. Puede que sigas pagando la cuenta o clave de API del proveedor al que lo conectes; el proxy en sí no tiene costo.

Licencia

Lo que indica AIClient2API:
GPL-3.0, una licencia copyleft, según el campo de licencia del repositorio.

Método de instalación

Lo que indica AIClient2API:
Docker (recomendado, un único comando docker run) o Node.js mediante un script de instalación incluido y npm start.

Verifica el método de instalación recomendado actual y la lista de puertos en github.com/justlovemaki/AIClient2API antes de ejecutar cualquiera de los dos comandos.

¿Cuánto cuesta AIClient2API?

AIClient2API en sí es gratuito — no tiene tarifa de licencia, suscripción ni cargo por uso. Tu costo real depende por completo de las cuentas o claves de API de proveedores a las que lo conectes.

  • El software proxy: gratuito, de código abierto bajo GPL-3.0, sin nivel de pago
  • Costos de proveedor: lo que ya cueste la cuenta o clave de API subyacente por la que enrutes (una clave de API de pago de OpenAI/Claude/Gemini, o una suscripción vinculada a una herramienta CLI como Codex o Kiro)
  • Costos de autoalojamiento: solo tu propio cómputo — al ser un proxy ligero en Node.js, esto suele ser insignificante incluso en un VPS pequeño

AIClient2API frente a LiteLLM: ¿cuál es la diferencia?

AIClient2API y LiteLLM permiten hablar un único formato de API y llegar a muchos proveedores, pero apuntan a problemas distintos: LiteLLM se enfoca en el enrutamiento multi-proveedor de nivel producción para APIs comerciales estándar, mientras que AIClient2API se enfoca en conectar herramientas de IA basadas en suscripciones CLI y OAuth de navegador a un formato compatible con OpenAI.

Objetivo principal

AIClient2API:
Conectar herramientas de IA basadas en CLI/OAuth (Gemini CLI, Codex, Kiro, Antigravity) en una sola API
LiteLLM:
Unificar más de 100 APIs de proveedores estándar detrás de una interfaz compatible con OpenAI

Licencia

AIClient2API:
GPL-3.0 (copyleft)
LiteLLM:
MIT (permisiva)

Usuario típico

AIClient2API:
Desarrolladores que quieren reutilizar suscripciones de herramientas CLI mediante una API estándar
LiteLLM:
Equipos que estandarizan tráfico de LLM en producción entre muchos proveedores

Funciones adicionales

AIClient2API:
Sidecar de huellas TLS, flujos OAuth para herramientas CLI específicas
LiteLLM:
Presupuestos, seguimiento de gasto, claves virtuales, amplias integraciones de ecosistema

Estas herramientas resuelven problemas superpuestos pero distintos — algunos equipos usan ambas, con LiteLLM para APIs de proveedores estándar y AIClient2API específicamente para proveedores basados en suscripciones CLI.

Comparar en el directorio

¿Quién debería usar AIClient2API?

AIClient2API es adecuado para desarrolladores que ya tienen acceso a varios proveedores de IA a través de distintas herramientas cliente y quieren un único endpoint local, consistente y compatible con OpenAI para construir sobre él.

Usa AIClient2API si

  • Ya usas varias herramientas o suscripciones CLI de IA (Gemini CLI, Codex, Kiro, Antigravity, Grok) y quieres acceder a ellas mediante una API estándar
  • Quieres un proxy autoalojado que controles por completo, en lugar de enrutar solicitudes a través de un gateway alojado de terceros
  • Necesitas conmutación automática por error entre varias cuentas de un mismo proveedor para evitar los límites de tasa de una sola cuenta
  • Quieres registro completo de solicitudes/respuestas para auditorías o para construir tus propios conjuntos de datos de entrenamiento o evaluación
  • Te sientes cómodo ejecutando y manteniendo un pequeño servidor autoalojado mediante Docker o Node.js

Busca otra opción si

  • Solo usas una clave de API de un proveedor estándar y no necesitas conversión de protocolos ni enrutamiento multi-proveedor
  • Quieres un gateway totalmente gestionado y alojado, en lugar de algo que tú mismo autoalojas y mantienes
  • No te sientes cómodo con la zona gris de términos de servicio de enrutar tráfico a través de protocolos de herramientas CLI o OAuth de navegador en lugar de APIs oficiales de pago
  • Necesitas funciones empresariales como presupuestos por equipo, paneles de gasto o SSO — esas están más maduras en gateways dedicados como LiteLLM

Para qué no sirve AIClient2API

AIClient2API no es una buena opción si necesitas un gateway totalmente gestionado, controles empresariales de gasto, o quieres evitar la ambigüedad de términos de servicio de conectar protocolos CLI.

  • No es un servicio gestionado ni alojado — eres responsable de ejecutar, actualizar y proteger tu propia instancia
  • No está construido principalmente en torno a APIs de proveedores estándar y con licencia oficial — varias de sus integraciones pasan por protocolos de herramientas CLI u OAuth no diseñados para el proxying de terceros, lo que puede entrar en conflicto con los términos de servicio de un proveedor determinado
  • No se enfoca en funciones de gobernanza empresarial (presupuestos por equipo, paneles de gasto, SSO) como sí lo hacen los gateways de LLM dedicados
  • No ha sido auditado de forma independiente en materia de seguridad, hasta donde esta reseña pudo verificar — trátalo como cualquier proxy autoalojado que maneja credenciales de API, y revisa su configuración de pool de cuentas y de registro antes de exponerlo más allá de tu propia máquina
  • No cuenta con el respaldo de una empresa o ronda de financiación que esta reseña haya podido verificar — trátalo como un proyecto mantenido de forma independiente y respaldado por la comunidad

Errores comunes al evaluar AIClient2API

La mayor parte de la confusión sobre AIClient2API viene de confundirlo con sus numerosos forks, o de asumir que funciona como un gateway multi-proveedor estándar.

Error 1: instalar un fork en lugar del repositorio original

Existen varios proyectos casi idénticos con la misma descripción bajo distintas cuentas de GitHub. Esta reseña confirma que github.com/justlovemaki/AIClient2API es el repositorio original con más estrellas — verifica que estás apuntando a ese repositorio, y no a un fork, antes de reportar problemas o buscar actualizaciones.

Error 2: asumir que solo hace proxy de APIs estándar y oficiales de proveedores

Varias de las integraciones de AIClient2API pasan por protocolos de herramientas CLI u OAuth de navegador (Kiro, Antigravity, autenticación por cookie de Grok) en lugar de acceso a API de terceros oficialmente soportado. Revisa los propios términos de servicio de cada proveedor antes de enrutar tráfico de producción de esta manera.

Error 3: tratarlo como un reemplazo directo de un gateway de LLM de producción

AIClient2API actualmente no documenta las funciones de presupuesto por equipo, seguimiento de gasto o SSO que sí se encuentran en gateways de producción dedicados como LiteLLM. Evalúalo específicamente para conectar suscripciones CLI, no como una capa general de enrutamiento empresarial.

Error 4: saltarse los pasos de configuración del sidecar TLS y OAuth

Algunas de las integraciones de proveedores de AIClient2API dependen de su sidecar TLS independiente basado en Go o de que un flujo OAuth se complete correctamente. Si falla la conexión con un proveedor específico, revisa si ese proveedor requiere el sidecar o un paso de inicio de sesión OAuth, según la propia documentación del proyecto.

Competidores y alternativas

AIClient2API se compara más directamente con LiteLLM; también vale la pena evaluarlo frente a los servidores compatibles con OpenAI a los que puede anteponerse, como vLLM, SGLang y LocalAI, dependiendo de si necesitas un proxy de conexión de protocolos o el propio servidor de inferencia.

LiteLLM

Best known for:
Proxy con licencia MIT que unifica más de 100 APIs de proveedores estándar con presupuestos y seguimiento de gasto
Link:
Reseña de LiteLLM

vLLM

Best known for:
Servidor/motor de inferencia local de alto rendimiento y compatible con OpenAI
Link:
vLLM explicado
Artículos sobre vLLM (10)

+92 más no mostrados

SGLang

Best known for:
Motor de inferencia compatible con OpenAI con optimizaciones de generación estructurada
Link:
SGLang explicado
Artículos sobre SGLang (8)

También mencionado en:

+6 más no mostrados

LocalAI

Best known for:
Servidor de inferencia local autoalojado y compatible con OpenAI para modelos de peso abierto
Link:
LocalAI explicado
Artículos sobre LocalAI (10)

+10 más no mostrados

Esta lista refleja herramientas comúnmente evaluadas junto a AIClient2API, no un ranking independiente de PromptQuorum — verifica el conjunto de funciones actual de cada herramienta antes de elegir.

Comparar en el directorio

Preguntas frecuentes

¿Qué es AIClient2API?

AIClient2API (github.com/justlovemaki/AIClient2API) es un proxy gratuito, de código abierto (GPL-3.0) y autoalojado que convierte los protocolos de cliente de Gemini CLI, Codex, Grok, Kiro y Antigravity en una única API compatible con OpenAI.

¿Es gratuito AIClient2API?

Sí, AIClient2API en sí es gratuito y de código abierto bajo GPL-3.0. Puede que sigas pagando la cuenta o clave de API del proveedor subyacente al que lo conectes.

¿Cómo instalo AIClient2API?

El propio README del proyecto recomienda Docker: ejecuta docker run -d -p 3000:3000 -p 8086:8086 -p 1455:1455 -p 56121:56121 -v "your_path/configs:/app/configs" justlikemaki/aiclient-2-api. También hay disponible un script de instalación para Node.js. Verifica primero las instrucciones actuales en el repositorio de GitHub.

¿Qué proveedores de IA soporta AIClient2API?

Según la propia documentación del proyecto: Gemini, Claude (vía Kiro o Antigravity), Grok, Codex, Kimi, MiniMax, OpenAI, y endpoints personalizados compatibles con OpenAI.

¿Quién creó AIClient2API?

AIClient2API fue creado por el usuario de GitHub justlovemaki. Existen varios forks casi idénticos bajo otras cuentas, pero este repositorio está confirmado como la versión original con más estrellas.

¿Es AIClient2API lo mismo que LiteLLM?

No. Ambos unifican varios proveedores detrás de una API compatible con OpenAI, pero LiteLLM (con licencia MIT) se enfoca en APIs comerciales estándar de proveedores con funciones de producción como presupuestos, mientras que AIClient2API (GPL-3.0) se enfoca en conectar suscripciones de IA basadas en herramientas CLI y OAuth.

¿AIClient2API requiere una GPU?

No. AIClient2API es un proxy ligero de conversión de protocolos en Node.js, no un motor de inferencia — no ejecuta modelos por sí mismo, así que no tiene requisito de GPU.

¿Es seguro enrutar tráfico a través de las integraciones de protocolo CLI de AIClient2API?

Varias de sus integraciones pasan por protocolos de herramientas CLI u OAuth de navegador que no están diseñados oficialmente para el proxying de terceros, lo que puede entrar en conflicto con los términos de servicio de un proveedor determinado. Revisa los propios términos de cada proveedor antes de usarlo para tráfico de producción.

¿AIClient2API soporta varias cuentas por proveedor?

Sí, según la documentación del proyecto soporta gestión de pool de cuentas con rotación, conmutación automática por error y comprobaciones de estado entre varias cuentas de un mismo proveedor.

¿Ha probado PromptQuorum de forma independiente las afirmaciones de AIClient2API?

Esta reseña se basa en el propio repositorio de GitHub del proyecto, su README y su historial de lanzamientos, en lugar de pruebas de carga o auditorías de seguridad prácticas realizadas por PromptQuorum.

Fuentes

← Volver a LLM locales avanzados

MCP