CLIProxyAPI en FlyEnv
CLIProxyAPI es un proxy local de código abierto que coloca herramientas de IA basadas en CLI —como Gemini CLI, Claude Code y Codex, que FlyEnv también gestiona— detrás de endpoints de API estándar compatibles con OpenAI, Gemini y Claude. Permite que las aplicaciones que esperan una API de modelo alojada llamen a estas cuentas CLI como si fueran servicios HTTP normales, con varios proveedores unificados tras un único gateway local. FlyEnv ejecuta CLIProxyAPI como un gateway de IA local gestionado: instala versiones desde el Version Manager, inicia el proceso cli-proxy-api desde la barra lateral o la página del módulo, edita config.yaml y el archivo de entorno de los backends dentro de la aplicación, y abre el panel de administración integrado en tu navegador. La salida del arranque se captura en archivos de log por versión, de modo que un arranque fallido es fácil de diagnosticar.
Gestión de versiones
Instala y mantén varias versiones de CLIProxyAPI en paralelo desde CLIProxyAPI → Version Manager, y luego elige cuál ejecutará el servicio.
- Descargas estáticas: una lista en línea de paquetes
.zipy.tgzvinculados a las releases de GitHub del proyecto, obtenidos para tu plataforma y arquitectura. - Homebrew: la fórmula
cliproxyapiaparece como fuente de instalación en sistemas con Homebrew; MacPorts no se ofrece para este módulo. - Directorios personalizados: añade cualquier carpeta que contenga tu propio binario
cli-proxy-apiocliproxyapiy FlyEnv lo mostrará junto a las versiones gestionadas. - Gestión de la cuarentena en macOS: tras una instalación estática, FlyEnv elimina el atributo de cuarentena del binario para que arranque sin avisos de Gatekeeper.
Servicio y configuración
La pestaña Service lanza la versión seleccionada como cli-proxy-api -config <config.yaml>, apuntando al config.yaml dentro del directorio CLIProxyAPI de FlyEnv, con las variables de entorno cargadas desde cliproxyapi.env. Solo una versión se ejecuta a la vez; su ID de proceso se registra en un archivo pid dentro del mismo directorio, y el interruptor de la barra lateral —también disponible en la bandeja del sistema— lo inicia y lo detiene.
- Pestaña Config File: un editor sin formato para
config.yaml. Las instalaciones nuevas se crean a partir de una plantilla incluida, de modo que el archivo existe con valores predeterminados funcionales antes de que cambies nada. - Pestaña Env: un editor sin formato para
cliproxyapi.env, que contiene las variables de backend que CLIProxyAPI lee al arrancar:GITSTORE_*para un almacenamiento basado en git,PGSTORE_*para PostgreSQL,OBJECTSTORE_*para almacenamiento de objetos, además deMANAGEMENT_PASSWORDpara el panel de administración.
Interfaz de administración en el puerto 8317
Mientras el servicio está en ejecución, la pestaña Service muestra un botón que abre el panel de administración integrado de CLIProxyAPI en tu navegador en http://127.0.0.1:<port>/management.html. FlyEnv lee el puerto desde config.yaml; con la plantilla predeterminada es 8317. Define MANAGEMENT_PASSWORD en la pestaña Env antes de exponer el panel a algo más que el uso local.
Logs
La pestaña Log muestra la salida capturada de cada versión como cliproxyapi-<version>-start-out.log y cliproxyapi-<version>-start-error.log, con un conmutador entre ambos flujos. Cuando una versión se niega a arrancar o la página de administración no responde, el log de errores es el primer lugar donde mirar.
Guías, soluciones y demos relacionados
Continúa con una guía práctica, una solución, una demo o una perspectiva de la comunidad.
Notas de compatibilidad
FlyEnv gestiona el binario CLIProxyAPI, su comando de arranque y los archivos de su directorio de módulo; el comportamiento del gateway —reglas de enrutamiento, proveedores admitidos y compatibilidad de modelos— proviene de la versión de CLIProxyAPI que instales, así que consulta las releases de GitHub del proyecto para saber qué hace cada versión. Las fuentes de instalación que aparecen dependen de tu plataforma y de si Homebrew está presente. Si además quieres modelos totalmente autoalojados en la misma máquina, el módulo Ollama los sirve a través de su propia API local, y la guía sobre FlyEnv trabajando con asistentes de IA cubre el panorama más amplio de la IA local. La página de descarga lista las compilaciones actuales de FlyEnv por plataforma, y las demos muestran el módulo funcionando en la práctica.