Guía de VibeProxy: Usa Claude, Codex y Gemini en Cualquier Herramienta de IA
Guía de VibeProxy: usa tus suscripciones de Claude, Codex y Gemini en cualquier herramienta de código con IA. Instalación, modelos compatibles, Copilot, multi-cuenta y solución de problemas.
37 min de lectura

Ya pagas por Claude Code, ChatGPT Plus u otra suscripción de IA. ¿Por qué volver a pagar por acceso a la API? VibeProxy es una app de macOS para la barra de menús que enruta tus suscripciones existentes hacia herramientas de código como Factory AI Droids, Amp Code, Zed, Codex CLI y cualquier otra aplicación compatible con OpenAI. Sin claves API: entra OAuth, salen llamadas a modelos.
Desde la primera versión de esta guía, la lista de proveedores ha crecido más allá de Claude, Codex y Gemini. VibeProxy ahora también conecta GitHub Copilot, Kimi y Z.AI GLM (Qwen ya estaba antes), y puede ejecutar varias cuentas por proveedor con failover automático.
Lo que aprenderás
- Deja de pagar dos veces por la IA reutilizando las suscripciones que ya financias
- Instala VibeProxy en macOS con descargas DMG/ZIP verificadas (builds para Intel incluidas)
- Conecta Claude Code, Codex, Gemini, GitHub Copilot, Kimi, Qwen y Z.AI GLM
- Configura Factory Droids, Amp Code, Zed, Codex CLI y otras herramientas contra el proxy local
- Ejecuta round-robin multi-cuenta y fija proveedores con los interruptores Priority
- Consulta los IDs de modelo vigentes de cada proveedor compatible (tablas de referencia 2026)
Novedades de esta guía (actualizado en octubre de 2026)
VibeProxy publica versiones casi a diario (v1.8.341 a fecha de 2026-10-21), y mucho ha cambiado desde que se publicó este artículo:
- Existen builds Intel x86_64 desde la v1.8.58 (oficialmente sin probar)
- Nuevos proveedores se han sumado: GitHub Copilot, Z.AI GLM (clave API), Kimi (OAuth)
- Round-robin multi-cuenta con failover por límite de peticiones, además de interruptores Provider Priority
- Releases DMG + ZIP por arquitectura, cada una con su archivo de checksum SHA-256
- Bind solo a loopback por defecto, con un interruptor LAN opcional
- Ruta de Vercel AI Gateway para un acceso a Claude Max de menor riesgo
- IDs de modelo actualizados en todo el catálogo: Claude Opus 4.7, GPT-5.5 / 5.3-codex, Gemini 3.1
Si eres nuevo en las herramientas de código con IA, empieza con nuestra guía de programación con IA para principiantes. Si ya conoces el terreno y quieres la tabla comparativa, consulta las mejores herramientas y agentes de código con IA en 2026.
¿Qué es VibeProxy?
VibeProxy es una app de macOS gratuita con licencia MIT de Automaze (unas 3.393 estrellas en GitHub a fecha de 2026-10-21). Se ejecuta en la barra de menús y crea un proxy local en el puerto 8317. Tus herramientas de código hablan con ese proxy; el proxy habla con tus suscripciones existentes a través del CLIProxyAPI integrado, que gestiona OAuth, la renovación de tokens y el enrutado. (El binario incluido todavía se llama cli-proxy-api-plus, un vestigio del fork retirado CLIProxyAPIPlus. Ignora el nombre.)
Dos puertos locales importan: 8317 es el proxy al que apuntan tus herramientas, 8318 es el backend de CLIProxyAPI que hay detrás. Ambos hacen bind a loopback. Más sobre esto en Consideraciones de seguridad.
¿Por qué usar VibeProxy?
- Gasta la cuota de tu suscripción de tarifa plana en lugar de pagar tarifas de API por token
- Un solo proxy sirve muchos modelos: Claude Opus 4.7, Sonnet 4.6, GPT-5.5, Gemini 3.1, modelos alojados en Copilot, GLM-5
- OAuth en el navegador por proveedor, así que no hay claves API que gestionar; los tokens permanecen en local y se renuevan automáticamente
- Varios inicios de sesión por proveedor te dan distribución round-robin y failover cuando una cuenta alcanza un límite de peticiones
- Los sufijos
-thinking-Nexponen los presupuestos de razonamiento de Claude - Sparkle comprueba a diario y actualiza tanto VibeProxy como el CLIProxyAPI integrado
- Cualquier cosa que hable el formato de API de OpenAI o Anthropic puede apuntar a él
[COSTE] La propia VibeProxy cuesta 0 $. El ahorro viene de no pagar dos veces: si ya financias un plan de Claude o ChatGPT de más de 20 $/mes, cada llamada a la API a través de una herramienta de terceros es dinero que no gastas dos veces.
Suscripciones de IA compatibles: Claude, Codex, Gemini, Copilot, Kimi y GLM
VibeProxy se comunica hoy con estos proveedores (fuente: README del proyecto y documentación de configuración, consultada el 2026-10-21):
| Suscripción | Modelos disponibles (IDs vigentes) | Auth | Requisitos |
|---|---|---|---|
| Claude Code Pro/Max | claude-opus-4-7, claude-sonnet-4-6, variantes thinking |
OAuth | Suscripción activa |
| ChatGPT Plus/Pro (Codex) | gpt-5.5, gpt-5.4, gpt-5.3-codex, gpt-5.3-codex-spark |
OAuth | Suscripción activa |
| Google Antigravity | gemini-3.1-pro-preview, gemini-3-pro-preview, Claude-via-Antigravity |
OAuth | Cuenta de Google |
| Gemini CLI | gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite |
OAuth | Proyecto de Google Cloud |
| GitHub Copilot | claude-opus-4.6, claude-sonnet-4.6, gpt-5.3-codex, gemini-3.1-pro-preview |
OAuth | Plan Copilot activo |
| Qwen | qwen3-coder-plus, qwen3-coder-flash |
OAuth | Cuenta de Qwen |
| Kimi | ver lista de proveedores en la app | OAuth | Cuenta de Kimi |
| Z.AI GLM | glm-5, glm-4.7, glm-4-plus, glm-4-air, glm-4-flash |
Clave API | Clave API de GLM |
¿Ya tienes estas suscripciones?
Si usas modelos Claude Sonnet y GPT gratis o tienes cualquier plan de pago de la lista, VibeProxy te permite gastar esa cuota en todas las herramientas de código que poseas. Los suscriptores de GitHub Copilot obtienen un segundo fondo de uso de Claude/GPT/Gemini a través de la propia API de GitHub; consulta nuestra guía de GitHub Copilot Pro si aún te estás decidiendo por ese plan.
[COSTE] Cada proveedor consume su propia cuota. La ruta de Copilot es un presupuesto separado de tu plan de Claude Code o ChatGPT, que es exactamente por lo que resulta útil: puedes conmutar entre fondos en lugar de agotar una sola suscripción.
El vídeo de arriba se grabó antes de las incorporaciones de proveedores e interfaz de 2026 (GitHub Copilot, Kimi, Z.AI GLM, interruptores Priority). El flujo de configuración es el mismo; la pantalla de ajustes tiene ahora más filas.
Instalación de VibeProxy en macOS (DMG + SHA-256, nota sobre Intel)
Requisitos del sistema
- macOS 13.0 (Ventura) o posterior (
LSMinimumSystemVersionen el bundle de la app) - Apple Silicon (M1/M2/M3/M4/M5) o Intel x86_64. Las builds para Intel se distribuyen desde la v1.8.58 (2026-01-15) pero están oficialmente marcadas como sin probar. Úsalas e informa de los problemas en el repositorio.
- Una suscripción activa (o una clave API de GLM) de al menos un proveedor compatible
- Nada más escuchando en los puertos 8317 (proxy) o 8318 (backend)
Requisitos previos
- macOS 13.0+ en Apple Silicon o Intel
- Al menos una suscripción de IA compatible
- Puertos 8317 y 8318 libres en la máquina
Comprobación rápida de conflictos de puertos:
lsof -i :8317 -i :8318
# empty output = ports are freeDescargar y verificar la release
Las releases se publican por arquitectura tanto en DMG como en ZIP, cada una con un archivo .sha256 (el DMG más reciente pesa unos 34 MB en la v1.8.341, 2026-10-21):
| Archivo | Uso |
|---|---|
VibeProxy-arm64.dmg / .zip |
Macs con Apple Silicon |
VibeProxy-x86_64.dmg / .zip |
Macs Intel (builds sin probar) |
*.sha256 |
archivo de checksum junto a cada paquete |
Instalar con DMG
- Descarga
VibeProxy-arm64.dmg(oVibeProxy-x86_64.dmg) desde la página de releases - Verifica el checksum:
shasum -a 256 -c VibeProxy-arm64.dmg.sha256
# expect: VibeProxy-arm64.dmg: OK- Haz doble clic en el DMG y arrastra
VibeProxy.appa/Applications - Expulsa el DMG y abre VibeProxy desde Aplicaciones
Los DMG están notarizados y con staple desde la v1.8.312 (2026-09-26), así que Gatekeeper no debería protestar.
Instalar con ZIP
- Descarga
VibeProxy-arm64.zip(oVibeProxy-x86_64.zip) - Verifica el checksum:
shasum -a 256 -c VibeProxy-arm64.zip.sha256
# expect: VibeProxy-arm64.zip: OK- Descomprime y mueve la app:
unzip VibeProxy-arm64.zip
mv VibeProxy.app /Applications/- Abre VibeProxy desde
/Applications
Verificación: VibeProxy.app está en /Applications y se abre sin diálogo de Gatekeeper. Si falla: en raras ocasiones puede aparecer un diálogo de «damaged». Elimina la cuarentena y reintenta:
xattr -cr /Applications/VibeProxy.appPrimer inicio
- Abre VibeProxy desde
/Applications - Aparece un icono en la barra de menús (punto verde = servidor en marcha)
- Haz clic en el icono y selecciona «Open Settings»
- El proxy se inicia automáticamente en el puerto 8317
Verificación: el estado en la barra de menús está en verde, y una sonda rápida responde en el puerto del proxy:
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8317
# any HTTP status means the listener is up (404/401 are fine for a bare probe)Si falla: que no aparezca el icono en la barra de menús indica una build antigua con un bug de TCC/entitlements (corregido en la v1.8.313). Actualiza la app desde la página de releases.
Conectar tus suscripciones de IA
Con VibeProxy en marcha, autentica cada proveedor que quieras usar. El flujo es el mismo en todas partes: haz clic en «Connect» en Settings, completa el OAuth en el navegador y VibeProxy detecta la finalización automáticamente.
Conectar Claude Code
- Haz clic en el icono de VibeProxy en la barra de menús y selecciona «Open Settings»
- Haz clic en «Connect» junto a Claude Code
- Inicia sesión cuando se abra el navegador
- VibeProxy detecta la finalización y guarda los tokens
Si falla: si el token caducó o el proveedor aparece desconectado, usa «Disconnect» y luego «Connect» de nuevo (ver Solución de problemas).
Conectar OpenAI Codex
- Haz clic en «Connect» junto a Codex en Settings
- Completa la autenticación en el navegador con tu cuenta de ChatGPT
- Espera a que VibeProxy confirme la conexión
Conectar Antigravity (Gemini 3 y Claude-via-Antigravity)
Antigravity frente a Gemini CLI
- Antigravity te da Gemini 3.x (
gemini-3.1-pro-preview,gemini-3-pro-preview) y los modelos Claude-via-Antigravity con una generosa cuota compartida - Gemini CLI te da la familia 2.x (
gemini-2.5-pro,gemini-2.5-flash) - Conecta ambos si quieres la gama completa
- Haz clic en «Connect» junto a Antigravity
- Inicia sesión con tu cuenta de Google y concede acceso a los modelos
- Reinicia VibeProxy para activar la lista de modelos Gemini 3.x
Conectar Gemini CLI
- Haz clic en «Connect» junto a Gemini
- Inicia sesión con tu cuenta de Google
- Selecciona un proyecto de Google Cloud (o acepta el predeterminado)
- VibeProxy guarda las credenciales en
~/.cli-proxy-api/
Conectar GitHub Copilot
- Haz clic en «Connect» junto a GitHub Copilot en Settings
- Introduce el código de dispositivo en GitHub (el código se copia con su guion, así que pegarlo funciona directamente)
- Autoriza a VibeProxy contra tu cuenta de GitHub
Necesitas una suscripción Copilot activa. La recompensa merece la pena: obtienes modelos de Claude, GPT y Gemini a través de la API de GitHub con una cuota separada. Si estás eligiendo o replanteándote ese plan, lee primero nuestra guía de GitHub Copilot Pro.
Multiplicadores de solicitudes premium de Copilot
Copilot factura los modelos premium a tarifas diferentes. A finales de 2026: claude-opus-4.6 cuenta como 3x, claude-sonnet-4.6 como 1x, claude-haiku-4.5 como 0.33x. Opus a través de Copilot es la forma más rápida de quemar un plan. Si tu uso acaba de pasar a facturarse por consumo, los cambios de precio por uso de GitHub Copilot y las alternativas más baratas repasa los números y las salidas.
Conectar Kimi, Qwen y Z.AI GLM
- Kimi y Qwen: el mismo flujo de Connect y OAuth. Los IDs de modelo de Kimi no están enumerados en la documentación oficial; usa la lista de proveedores dentro de la app.
- Z.AI GLM es la excepción. Usa una clave API en lugar de OAuth: genera una en tu cuenta de Z.AI (página de gestión de claves API), luego pulsa «Add Account» en los ajustes de VibeProxy y pégala. La clave se guarda en
~/.cli-proxy-api/igual que los tokens OAuth.
Verificación (todos los proveedores): cada proveedor que vayas a usar aparece como «Connected» en Settings. Luego ejecuta un prompt de prueba desde cualquier herramienta configurada y confirma que recibes una respuesta. Un error como auth_unavailable: no auth available significa que el proveedor de ese modelo aún no está autenticado.
Configurar Factory AI Droids
Factory Droid CLI es un agente de código con IA que acepta definiciones de modelos personalizadas. Apunta esas definiciones a VibeProxy y tus suscripciones ejecutan toda la sesión.
Instalar Factory CLI
curl -fsSL https://app.factory.ai/cli | shConfigurar modelos personalizados
Crea o edita ~/.factory/config.json. El patrón: los modelos de Claude con formato Anthropic usan base_url: http://localhost:8317 con provider: "anthropic"; todo lo demás pasa por http://localhost:8317/v1 con provider: "openai". El api_key es un placeholder; VibeProxy lo ignora.
{
"custom_models": [
{
"model_display_name": "CC: Opus 4.7 (High)",
"model": "claude-opus-4-7-thinking-32000",
"base_url": "http://localhost:8317",
"api_key": "dummy-not-used",
"provider": "anthropic"
},
{
"model_display_name": "CC: Sonnet 4.6",
"model": "claude-sonnet-4-6",
"base_url": "http://localhost:8317",
"api_key": "dummy-not-used",
"provider": "anthropic"
},
{
"model_display_name": "GPT-5.3 Codex",
"model": "gpt-5.3-codex",
"base_url": "http://localhost:8317/v1",
"api_key": "dummy-not-used",
"provider": "openai"
},
{
"model_display_name": "Gemini 3.1 Pro",
"model": "gemini-3.1-pro-preview",
"base_url": "http://localhost:8317/v1",
"api_key": "dummy-not-used",
"provider": "openai"
}
]
}Usar Factory con VibeProxy
- Ejecuta Factory CLI:
droid- Selecciona un modelo con
/modely elige una de tus entradas personalizadas - A programar. Todas las peticiones se enrutan por VibeProxy automáticamente.
Verificación: /model lista tus modelos personalizados y un prompt de prueba devuelve una respuesta. Si falla: los 404 de Factory suelen significar que VibeProxy no está en marcha o que el base_url es incorrecto. Revisa el estado en la barra de menús y los valores de base_url de arriba.
Configuración completa de Factory con todos los modelos
Un conjunto más completo que cubre los presupuestos de thinking, las entradas de Copilot y GLM:
{
"custom_models": [
{
"model_display_name": "CC: Opus 4.7 (High)",
"model": "claude-opus-4-7-thinking-32000",
"base_url": "http://localhost:8317",
"api_key": "dummy-not-used",
"provider": "anthropic"
},
{
"model_display_name": "CC: Opus 4.7 (Medium)",
"model": "claude-opus-4-7-thinking-10000",
"base_url": "http://localhost:8317",
"api_key": "dummy-not-used",
"provider": "anthropic"
},
{
"model_display_name": "CC: Opus 4.7 (Low)",
"model": "claude-opus-4-7-thinking-4000",
"base_url": "http://localhost:8317",
"api_key": "dummy-not-used",
"provider": "anthropic"
},
{
"model_display_name": "CC: Opus 4.7",
"model": "claude-opus-4-7",
"base_url": "http://localhost:8317",
"api_key": "dummy-not-used",
"provider": "anthropic"
},
{
"model_display_name": "CC: Sonnet 4.6 (High)",
"model": "claude-sonnet-4-6-thinking-32000",
"base_url": "http://localhost:8317",
"api_key": "dummy-not-used",
"provider": "anthropic"
},
{
"model_display_name": "CC: Sonnet 4.6",
"model": "claude-sonnet-4-6",
"base_url": "http://localhost:8317",
"api_key": "dummy-not-used",
"provider": "anthropic"
},
{
"model_display_name": "GPT-5.5 (High)",
"model": "gpt-5.5(high)",
"base_url": "http://localhost:8317/v1",
"api_key": "dummy-not-used",
"provider": "openai"
},
{
"model_display_name": "GPT-5.5",
"model": "gpt-5.5",
"base_url": "http://localhost:8317/v1",
"api_key": "dummy-not-used",
"provider": "openai"
},
{
"model_display_name": "GPT-5.5 (Low)",
"model": "gpt-5.5(low)",
"base_url": "http://localhost:8317/v1",
"api_key": "dummy-not-used",
"provider": "openai"
},
{
"model_display_name": "GPT-5.3 Codex (High)",
"model": "gpt-5.3-codex(high)",
"base_url": "http://localhost:8317/v1",
"api_key": "dummy-not-used",
"provider": "openai"
},
{
"model_display_name": "GPT-5.3 Codex",
"model": "gpt-5.3-codex",
"base_url": "http://localhost:8317/v1",
"api_key": "dummy-not-used",
"provider": "openai"
},
{
"model_display_name": "Gemini 3.1 Pro",
"model": "gemini-3.1-pro-preview",
"base_url": "http://localhost:8317/v1",
"api_key": "dummy-not-used",
"provider": "openai"
},
{
"model_display_name": "Gemini 3 Pro",
"model": "gemini-3-pro-preview",
"base_url": "http://localhost:8317/v1",
"api_key": "dummy-not-used",
"provider": "openai"
},
{
"model_display_name": "GH: Opus 4.6 (via Copilot)",
"model": "claude-opus-4.6",
"base_url": "http://localhost:8317/v1",
"api_key": "dummy-not-used",
"provider": "openai"
},
{
"model_display_name": "GH: Sonnet 4.6 (via Copilot)",
"model": "claude-sonnet-4.6",
"base_url": "http://localhost:8317/v1",
"api_key": "dummy-not-used",
"provider": "openai"
},
{
"model_display_name": "GLM-5",
"model": "glm-5",
"base_url": "http://localhost:8317/v1",
"api_key": "dummy-not-used",
"provider": "openai"
},
{
"model_display_name": "GLM-4.7",
"model": "glm-4.7",
"base_url": "http://localhost:8317/v1",
"api_key": "dummy-not-used",
"provider": "openai"
},
{
"model_display_name": "Qwen3 Coder Plus",
"model": "qwen3-coder-plus",
"base_url": "http://localhost:8317/v1",
"api_key": "dummy-not-used",
"provider": "openai"
}
]
}Configurar Amp Code
Amp Code de Sourcegraph funciona con VibeProxy, pero las reglas han cambiado. El viejo truco del secrets.json ya no existe, y no hay fallback a créditos de Amp para modelos que no hayas autenticado. Eso concuerda con por qué se pausó el tier gratuito de Amp Code: cuando todos los interruptores de proveedor están apagados, Amp recurre a su propio tier gratuito con límite de peticiones. Para cualquier otra cosa, autenticas el proveedor o no obtienes nada.
Ya no hay fallback
Si Amp pide un modelo cuyo proveedor no está conectado, obtienes auth_unavailable: no auth available. Amp no gasta sus propios créditos en silencio. Autentica el proveedor (o elige un modelo de un proveedor que sí hayas autenticado).
Apuntar Amp a VibeProxy
mkdir -p ~/.config/amp
echo '{"amp.url": "http://localhost:8317"}' > ~/.config/amp/settings.jsonAutenticar los proveedores que quieras
Usa el binario del backend incluido dentro del bundle de la app (el nombre de archivo cli-proxy-api-plus es un nombre heredado):
VP=/Applications/VibeProxy.app/Contents/Resources
$VP/cli-proxy-api-plus -config $VP/config.yaml -claude-login # Claude Code
$VP/cli-proxy-api-plus -config $VP/config.yaml -codex-login # ChatGPT / Codex
$VP/cli-proxy-api-plus -config $VP/config.yaml -login # GeminiAhora también puedes ejecutar amp login: redirige directamente a ampcode.com (el antiguo fallo «403 Invalid state parameter» se corrigió en la v1.8.51). Reinicia VibeProxy después de los inicios de sesión.
Cómo se divide el tráfico de Amp: las llamadas de gestión (/auth/cli-login, /api/*) se reenvían a ampcode.com; las llamadas de modelo (/provider/*) van al backend de CLIProxyAPI en 8318. No hay nada que configurar para esa división.
Usar Amp con VibeProxy
# Interactive mode
amp
# Direct prompt
amp "Say hello"Verificación: amp "Say hello" devuelve un saludo. Si falla: auth_unavailable significa que el proveedor del modelo no tiene inicio de sesión. Vuelve a ejecutar el comando de login correspondiente de arriba y reinicia VibeProxy.
Usar VibeProxy con cualquier herramienta de código con IA (sin claves API)
Cualquier herramienta que acepte un endpoint personalizado compatible con OpenAI (o con Anthropic) puede usar VibeProxy. La receta genérica:
| Ajuste | Valor |
|---|---|
| Base URL | http://localhost:8317/v1 (o http://localhost:8317 para APIs con formato Anthropic) |
| API Key | dummy o cualquier cadena de placeholder |
| Model | un ID de modelo vigente de la referencia de abajo |
Si activaste el interruptor LAN (ver Seguridad), sustituye 127.0.0.1/localhost por la IP LAN de la máquina en estas URL. Los editores como Windsurf que aceptan endpoints personalizados compatibles con OpenAI siguen la misma tabla.
Verificación: un prompt de prueba por herramienta configurada. Cualquier respuesta demuestra que la ruta funciona.
Editor Zed
Zed es un editor de código rápido con funciones de IA. En sus ajustes de IA (abre Settings con Cmd+,), pon el endpoint de API en http://localhost:8317/v1 y usa dummy como clave API. Si la interfaz de ajustes ha movido campos desde octubre de 2026, busca la sección de proveedor personalizado / endpoint personalizado.
OpenCode
Para OpenCode y herramientas CLI similares, el patrón de variables de entorno suele funcionar:
export OPENAI_API_BASE="http://localhost:8317/v1"
export OPENAI_API_KEY="dummy"La superficie de configuración de OpenCode cambia a menudo; si eso falla, consulta nuestra guía de configuración de OpenCode para la forma actual del archivo de configuración. Si prefieres comprar acceso barato a modelos en lugar de hacer proxy de suscripciones, OpenCode tiene un plan OpenCode Go con un pool de modelos de bajo coste.
Extensiones de VS Code (Roo Code, Continue, etc.)
Muchas extensiones de VS Code admiten endpoints personalizados:
{
"provider": "OpenAI Compatible",
"base_url": "http://localhost:8317/v1",
"api_key": "dummy-not-used",
"model": "claude-sonnet-4-6"
}Cualquier otra herramienta
Los mismos tres ajustes de la tabla de arriba. La ruta nativa de Anthropic (SDKs con formato Claude) usa http://localhost:8317 como base sin /v1; la ruta con formato OpenAI usa /v1. Si estás ejecutando CLIs de terceros en sandbox, corre herramientas CLI de IA en Docker o Podman de forma segura y apúntalas a la dirección loopback del host.
Usar VibeProxy con el propio Codex CLI
Incluso puedes apuntar Codex CLI a VibeProxy en lugar de apuntarlo directamente a ChatGPT. Edita ~/.codex/config.toml:
Opción 1: override simple de base_url (recomendada)
base_url = "http://127.0.0.1:8317/v1"Esta es la opción a usar. Mantiene funcionando las superficies nativas de ChatGPT de Codex (Quick Chat, «More details», «Computer history»).
Opción 2: bloque de proveedor explícito
model_provider = "cliproxyapi"
[model_providers.cliproxyapi]
name = "cliproxyapi"
base_url = "http://127.0.0.1:8317/v1"
wire_api = "responses"La documentación de CLIProxyAPI recomienda esta forma, pero hay una trampa: ver el aviso de abajo.
Quick Chat falla con el bloque de proveedor explícito (issue #544)
Con el bloque model_provider explícito, las superficies integradas de ChatGPT de Codex (Quick Chat, «More details», «Computer history») fallan de forma consistente. Seguido como issue #544 en el repo de VibeProxy. El override simple de base_url las mantiene funcionando, y por eso lo recomiendo para la mayoría de las configuraciones.
Verificación: ejecuta codex y confirma que recoge la lista de modelos del proxy. Para la app de escritorio de Codex, mira cómo usar la app Codex con cualquier modelo.
Multi-cuenta y prioridad de proveedores
Dos funciones del mismo panel de Settings hacen el trabajo pesado en el uso diario.
Multi-cuenta (v1.7.0+)
Añade varias cuentas por proveedor. VibeProxy distribuye las peticiones entre ellas en round-robin y conmuta automáticamente cuando una cuenta alcanza un límite de peticiones. Las listas de cuentas son plegables; las cuentas se pueden eliminar individualmente.
[COSTE] Esta es la mitigación práctica de límites de peticiones para usuarios de Max/Pro. Dos cuentas de Claude significan que una puede enfriarse en la ventana de 5 horas mientras la otra sirve. No duplica tu cuota por ventana; la reparte y le da respaldo.
Interruptores de prioridad de proveedores (v1.8.51+)
Activa o desactiva proveedores en Settings. Los proveedores desactivados ven sus modelos excluidos de la lista servida (oauth-excluded-models internamente), y el cambio se recarga en caliente sin reiniciar la app.
Cuándo usar los interruptores:
- Fija un solo proveedor cuando quieras un enrutado predecible
- Omite un proveedor limitado por tasa de peticiones sin cerrar su sesión
- Resuelve colisiones de nombres de modelo entre proveedores (el problema de punto vs guion de la referencia de modelos)
Verificación: desactiva un proveedor en Settings y confirma que sus modelos desaparecen de la lista de modelos de tu herramienta conectada sin reiniciar.
¿Añadir una segunda cuenta duplica mi cuota?
No. Los proveedores miden por cuenta (y a menudo por organización). Una segunda cuenta te da una segunda ventana independiente y capacidad de failover, no una supercuota fusionada. Si ambas cuentas están en el mismo plan de equipo, pueden compartir límites a nivel de equipo.
Referencia de modelos compatibles de VibeProxy (2026)
Los IDs de modelo de abajo están vigentes a 2026-10-21 (v1.8.341, según la documentación FACTORY_SETUP incluida). VibeProxy publica casi a diario y los IDs de modelo siguen a los proveedores, así que si un ID listado devuelve not-found, revisa Settings, ejecuta copilot --help para los nombres de Copilot, o lee la documentación de configuración incluida.
Punto vs guion: dos backends distintos
Esta es la trampa más común. Los modelos de Copilot usan notación con punto (claude-opus-4.6, claude-sonnet-4.6) y se enrutan por provider: "openai" con la base URL /v1. Los modelos de la suscripción Claude Code usan notación con guion (claude-opus-4-7, claude-sonnet-4-6) y se enrutan por provider: "anthropic" con la base URL simple. Mezclar las dos falla con errores de modelo no encontrado.
Modelos de Claude (vía suscripción Claude Code)
| ID de modelo | Notas |
|---|---|
claude-opus-4-7 |
El Opus más potente actual |
claude-sonnet-4-6 |
Modelo de código por defecto |
claude-opus-4-7-thinking-32000 |
Opus con pensamiento extendido (presupuesto de 32K) |
claude-opus-4-7-thinking-10000 |
Opus, pensamiento medio |
claude-opus-4-7-thinking-4000 |
Opus, pensamiento bajo |
claude-sonnet-4-6-thinking-32000 |
Sonnet con pensamiento extendido |
Los sufijos de fecha han desaparecido. claude-opus-4-5-20251101 y compañía ya no aparecen; usa los IDs limpios de arriba.
Modelos GPT de OpenAI (vía suscripción ChatGPT)
Todos a través de base_url: http://localhost:8317/v1:
| ID de modelo | Notas |
|---|---|
gpt-5.5 |
Flagship actual |
gpt-5.5(high) |
Variante de mayor esfuerzo |
gpt-5.5(low) |
Variante más barata/rápida |
gpt-5.4 |
Flagship anterior |
gpt-5.4(high) |
Mayor esfuerzo |
gpt-5.4-mini |
Modelo pequeño |
gpt-5.3-codex |
Afinado para código |
gpt-5.3-codex(high) |
Código, alto esfuerzo |
gpt-5.3-codex-spark |
Código ligero |
Modelos Gemini (vía Antigravity y Gemini CLI)
| ID de modelo | Notas | Auth |
|---|---|---|
gemini-3.1-pro-preview |
Gemini 3.1 actual | Antigravity |
gemini-3.1-flash-image-preview |
Generación de imágenes | Antigravity |
gemini-3-pro-preview |
Gemini 3 Pro | Antigravity |
gemini-3-pro-image-preview |
Gemini 3 Pro con visión | Antigravity |
gemini-claude-opus-4-6-thinking |
Claude Opus vía Antigravity (cuota generosa) | Antigravity |
gemini-claude-sonnet-4-6-thinking |
Claude Sonnet thinking vía Antigravity | Antigravity |
gemini-claude-sonnet-4-6 |
Claude Sonnet vía Antigravity | Antigravity |
gemini-2.5-pro |
Gemini 2.5 Pro | Gemini CLI |
gemini-2.5-flash |
Gemini 2.5 Flash | Gemini CLI |
gemini-2.5-flash-lite |
Gemini 2.5 Flash Lite | Gemini CLI |
Merece la pena conocer los IDs de Claude-via-Antigravity: ejecutan modelos de Claude sobre una cuota compartida con Sonnet y GPT-OSS en lugar de tu suscripción de Claude.
Modelos de GitHub Copilot (notación con punto: claude-opus-4.6)
| ID de modelo | Tarifa premium |
|---|---|
claude-opus-4.6 |
3x |
claude-sonnet-4.6 |
1x (por defecto en Copilot) |
claude-haiku-4.5 |
0.33x |
gpt-5.3-codex |
1x |
gemini-3.1-pro-preview |
1x |
Todas las entradas de Copilot pasan por provider: "openai" + /v1. Consejo oficial: ejecuta copilot --help para descubrir los nombres de modelo vigentes de Copilot cuando algo devuelva 404.
Modelos de Qwen, Kimi y Z.AI GLM
| Proveedor | IDs de modelo | Notas |
|---|---|---|
| Qwen | qwen3-coder-plus, qwen3-coder-flash |
OAuth; ver también modelos Qwen 3.6 para agentes de código con IA |
| Z.AI GLM | glm-5, glm-4.7, glm-4-plus, glm-4-air, glm-4-flash |
Clave API; modelos de código baratos, destacados en el recopilatorio de los modelos de IA más baratos para agentes de código |
| Kimi | ver lista de proveedores en la app | OAuth; la documentación oficial aún no enumera los IDs de modelo |
[COSTE] GLM es la vía económica aquí: una clave API de Z.AI GLM más glm-4.7 o glm-5 se encarga del trabajo pesado sin tocar tu cuota de Claude. Reserva tu presupuesto de Opus/Claude para los problemas difíciles.
Modo de pensamiento extendido
VibeProxy expone el Extended Thinking de Claude codificando el presupuesto en el nombre del modelo. Añade un sufijo a cualquier ID de modelo de Claude:
{model-name}-thinking-{NUMBER}Presets (las mismas etiquetas que usa el ecosistema de Claude):
-thinking-4000: «think» (~4K tokens)-thinking-10000: «think harder» (~10K tokens)-thinking-32000: «ultra think» (~32K tokens)
Funciona en Claude 3.7+, Opus 4/4.7 y Sonnet 4/4.6. Ejemplo:
{
"model": "claude-opus-4-7-thinking-10000"
}Qué ocurre: VibeProxy quita el sufijo -thinking-10000, fija el parámetro de presupuesto de pensamiento en 10.000 tokens y reenvía la petición. La respuesta incluye los pasos de razonamiento.
Overrides avanzados de config.yaml
Los usuarios avanzados disponen de un archivo de overrides persistente en ~/.cli-proxy-api/config.yaml. VibeProxy lo fusiona con los valores por defecto incluidos en ~/.cli-proxy-api/merged-config.yaml y recarga en caliente sin reiniciar la app.
Nunca edites merged-config.yaml
merged-config.yaml se regenera en cada fusión. Es un diagnóstico de solo lectura: útil para confirmar cuál es la configuración efectiva. Pon tus ediciones en ~/.cli-proxy-api/config.yaml.
El ejemplo del README que conviene conocer: forzar verbosidad baja en todas las peticiones GPT.
payload:
default:
- models:
- name: "gpt-*"
protocol: "codex"
params:
"text.verbosity": "low"Dos semánticas entre las que elegir:
| Clave | Comportamiento |
|---|---|
default |
Rellena el parámetro solo cuando el cliente no envía nada (no anula a una herramienta que fija su propio valor) |
override |
Impone siempre el valor, independientemente de lo que haya enviado el cliente |
Valores de verbosidad: low, medium, high.
Verificación: cambia el archivo y envía la siguiente petición. El cambio debería aplicarse sin reiniciar VibeProxy. Si falla: una errata de YAML hace que tu regla no se aplique en silencio; revisa el log de la app/proxy y luego haz diff contra merged-config.yaml para ver si tu regla llegó a la configuración efectiva.
Solución de problemas
Estado de VibeProxy en la barra de menús
- Un punto verde significa que el servidor está en marcha; un punto rojo, que se detuvo
- Haz clic en el estado para encender y apagar el servidor
¿No hay icono en absoluto? Era un bug de TCC/entitlements en builds antiguas, corregido en la v1.8.313 (2026-09-27). Actualiza la app.
Problemas de conexión
| Problema | Solución |
|---|---|
| No se puede conectar a Claude/Codex | Vuelve a pulsar «Connect» en los ajustes de VibeProxy |
| Factory muestra errores 404 | VibeProxy no está en marcha o el base_url es incorrecto (revisa la barra de menús) |
| La autenticación caducó | Desconecta y vuelve a conectar el proveedor |
| El puerto 8317 u 8318 ya está en uso | Cierra otras instancias de VibeProxy o CLIProxyAPI. A veces quedan procesos huérfanos tras salir de la app: lsof -i :8317 -i :8318, y luego kill al PID |
auth_unavailable: no auth available |
El proveedor de ese modelo no tiene inicio de sesión. Autentícalo (ver los comandos de login de Amp de arriba) y reinicia VibeProxy |
| Los botones de login fallan con «flag provided but not defined» | Desfase de versiones entre app y backend, corregido en la v1.8.313. Actualiza VibeProxy |
| Gemini devuelve 401 | Verifica que el proyecto de Google Cloud tiene la API de Gemini habilitada |
| Modelo no encontrado | Revisa la notación punto vs guion (Copilot vs Claude Code). Para los nombres de Copilot, ejecuta copilot --help |
El uso se agota más rápido de lo esperado
Reportado por la comunidad (issues #313 y #292, ambas cerradas): el mismo prompt puede quemar el uso de la suscripción 2-3 veces más rápido a través de CLIs de terceros como Droids que a través de Claude Code o Codex nativos. Esa cifra viene de reportes de usuarios, no de un benchmark controlado.
Lo que yo haría al respecto:
- Vigila los paneles de uso del lado del proveedor, no solo el contador de tokens de la herramienta
- Espera un drenaje más rápido de la ventana de 5 horas durante sesiones agénticas intensas
- Usa modelos más pequeños o sin thinking para el trabajo rutinario; guarda Opus/thinking para las tareas difíciles
- Reparte la carga entre proveedores y cuentas (ver Multi-cuenta y prioridad de proveedores)
Cuentas de Claude Enterprise / Team
Si tu panel muestra plan: free o 5-hour-limit 0% en una cuenta enterprise de pago: el endpoint de cuenta de claude.ai devuelve un desafío de Cloudflare en lugar de JSON para cuentas de organización, así que el proxy no puede leer tu plan ni tu uso y falla al registrar o hacer failover. Seguido como issue #382, abierta desde 2026-05-27. Si dependes del seguimiento de uso o del failover automático, pruébalo en tu cuenta de organización antes de confiar en ello.
Error «app is damaged»
Elimina los atributos de cuarentena y vuelve a abrir:
xattr -cr /Applications/VibeProxy.appRaro desde que los DMG notarizados y con staple se publicaron en la v1.8.312, pero la solución sigue siendo la correcta.
Lista de verificación
- VibeProxy está en marcha (el icono de la barra de menús está en verde)
- Cada proveedor que necesitas aparece como «Connected» en Settings
- La base URL de tu herramienta apunta a
localhost:8317(con/v1para APIs con formato OpenAI) - La clave API de la herramienta está puesta (cualquier placeholder vale)
- Un prompt de prueba («¿qué día es hoy?») devuelve una respuesta
Desinstalar / revertir
- Sal de VibeProxy (icono de la barra de menús, o
pkill -f VibeProxy) - Elimina
/Applications/VibeProxy.app - Opcionalmente elimina
~/.cli-proxy-api/. Esto borra los tokens OAuth y es el verdadero paso de «desconectar todos los proveedores» - Revierte la configuración de cada herramienta:
~/.factory/config.json,~/.config/amp/settings.json,~/.codex/config.toml, ajustes de endpoint del editor - Comprueba listeners huérfanos:
lsof -i :8317 -i :8318y mata los que queden
Aviso: eliminar ~/.cli-proxy-api/ cierra la sesión de todas las cuentas detrás del proxy. Tendrás que repetir los flujos OAuth tras reinstalar.
Consideraciones de seguridad
Información de seguridad importante
- Los tokens OAuth se guardan localmente en
~/.cli-proxy-api/con permisos 0600 - Desde la v1.8.313 (2026-09-27), el puerto 8317 solo hace bind a 127.0.0.1. Las builds anteriores enlazaban todas las interfaces; el comportamiento actual es obligatorio
- El interruptor «Allow LAN connections (port 8317)» de Settings expone el proxy a tu red, con un aviso en la interfaz y diagnósticos del modo de bind en el log del proxy. Si lo activas, cualquier máquina de la LAN puede gastar la cuota de tu suscripción. Usa la IP LAN de la máquina en las configuraciones de las herramientas y trata el interruptor como temporal
- El tráfico hacia los proveedores de IA es TLS de extremo a extremo
- Los tokens se renuevan antes de caducar, así que no estás guardando contraseñas en crudo
Riesgo de términos de servicio
Usar tokens OAuth de suscripción a través de un proxy de terceros puede violar los términos de servicio de los proveedores. La propia documentación del proyecto advierte sobre suspensión de cuentas y baneos permanentes. VibeProxy añade una vía de escape oficial: puedes enrutar las peticiones de Claude a través de Vercel AI Gateway para un acceso sancionado a una suscripción Claude Max en lugar de llamar a Anthropic con tokens OAuth directamente. Vercel AI Gateway es un servicio de pago basado en créditos; consulta la documentación de Vercel AI Gateway para precios y configuración vigentes. Úsalo bajo tu propia responsabilidad.
Casos de uso y beneficios
Para desarrolladores profesionales
- Tu suscripción de tarifa plana existente cubre herramientas que de otro modo facturarían por token
- Cambia entre Claude, GPT, Gemini, modelos alojados en Copilot y GLM sin malabares con claves API separadas
- Ejecuta Factory, Amp y Zed contra el mismo proxy, y añade una segunda cuenta para failover
- El pensamiento extendido te da presupuestos de razonamiento para decisiones de arquitectura y depuración difícil
- Cuando un terminal no es suficiente, ejecuta agentes de código con IA en macOS con cmux
Para aficionados y quienes aprenden
- Una sola suscripción rinde más cuando cada herramienta puede gastar su cuota
- Prueba distintas herramientas de código sin abrir una nueva factura de API
- Ver el tráfico llegar a un proxy local te enseña cómo funcionan las APIs de IA
- Los proyectos paralelos pueden funcionar con modelos premium dentro de la cuota de tu plan
[COSTE] La victoria a recordar: evita facturas de API por token para trabajo que tu suscripción de tarifa plana ya cubre. Cuando un proyecto necesite de verdad escala medida, cambia a claves API deliberadamente en lugar de filtrar uso a través de un proxy.
Para más guías de programación con IA:
- Guía de programación con IA para principiantes
- Los mejores LLM open source como alternativas a Claude
- Introducción a MCP para principiantes
Herramientas y recursos relacionados
- Guía completa de GitHub Copilot - el plan Copilot de 10 $ con Zed y CLI
- Amp Code, agente de código con IA gratuito - el tier gratuito pausado de Amp y qué usar en su lugar
- Docker y Podman para herramientas CLI de IA - sandbox para CLIs de terceros
- Instalación de LiteLLM con Docker Compose - autoaloja un gateway LLM para todo el equipo cuando un Mac no es toda la historia
- Guía de BrightData MCP - herramientas de datos web para agentes
- Agent Router - alternativa gestionada: acceso unificado a Claude Code, OpenAI Codex y Gemini CLI sin ejecutar tu propio proxy local (VibeProxy es la vía gratuita y autoalojada)
Preguntas frecuentes
¿VibeProxy es gratis?
Sí. Licencia MIT, 0 $, descárgalo de GitHub y ejecútalo todo el tiempo que quieras. Aun así necesitas al menos una suscripción de IA de pago (o una clave API de GLM) para que el proxy tenga algo que enrutar.
¿Funciona en Macs Intel?
Sí, con matices. Las builds x86_64 se publican desde la v1.8.58 (2026-01-15), pero el proyecto las marca como sin probar. Si ejecutas una, informa de los resultados en el repositorio para que eso cambie.
¿Puede esto hacer que me baneen la cuenta?
Existe un riesgo real. Usar tokens OAuth de suscripción a través de un proxy puede violar los TOS de los proveedores, y la propia documentación del proyecto advierte sobre suspensión y baneos permanentes. Si quieres un acceso a Claude Max de menor riesgo, usa la ruta de Vercel AI Gateway descrita en Consideraciones de seguridad.
¿Puedo usarlo con Linux o Windows?
La app VibeProxy es solo para macOS. El CLIProxyAPI subyacente funciona en otras plataformas si lo inicias manualmente. Consulta el repositorio de CLIProxyAPI.
¿Cómo actualizo VibeProxy?
Desde la v1.6, VibeProxy comprueba actualizaciones a diario y las instala vía Sparkle. Las releases son casi diarias y a menudo siguen los bumps de CLIProxyAPI, así que deja que la auto-actualización haga su trabajo. Las descargas manuales desde la página de releases también funcionan.
¿Qué pasa si un modelo no funciona?
- Confirma que el proveedor del modelo está autenticado en Settings
- Comprueba el ID de modelo contra las tablas de referencia de arriba (ojo con la notación punto vs guion)
- Para los nombres de modelo de Copilot, ejecuta
copilot --help - Reinicia VibeProxy tras los cambios de configuración (excepto los interruptores Priority, que se recargan en caliente)
- Revisa los logs de Console.app, busca «VibeProxy»
¿Por qué se agota más rápido el uso de mi suscripción a través de VibeProxy?
Reportado por la comunidad (issues #313/#292): los CLIs agénticos de terceros pueden quemar la ventana de 5 horas 2-3 veces más rápido que Claude Code o Codex nativos para el mismo trabajo nominal. Ese número proviene de reportes de usuarios, no de una medición. Vigila el panel de uso del propio proveedor y usa modelos más baratos para ediciones rutinarias. Detalles en Solución de problemas.
¿Necesito claves API?
No. Esa es la gracia. Los proveedores se autentican con OAuth en el navegador. La única clave API real del flujo es la de Z.AI GLM. Los campos «API key» del lado de la herramienta aceptan un placeholder como dummy-not-used.
Conclusión
VibeProxy te permite usar las suscripciones de IA que ya pagas en todas las herramientas de código que posees, en lugar de comprar acceso a la API una segunda vez. Claude Code, ChatGPT Plus, Gemini, GitHub Copilot, Kimi, Qwen y Z.AI GLM se enrutan por un único proxy local. El lado de las herramientas también está cubierto: Factory Droids, Amp Code, Zed, Codex CLI, extensiones de VS Code, cualquier cosa compatible con OpenAI. Los IDs de modelo se mantienen al día con la documentación incluida (Opus 4.7, Sonnet 4.6, GPT-5.5, Gemini 3.1, modelos alojados en Copilot, GLM-5), y los controles del día a día están ahí cuando los necesitas: round-robin multi-cuenta, interruptores Priority, overrides de config.yaml, pensamiento extendido. Es una app nativa de macOS, solo loopback por defecto, con auto-actualizaciones y releases verificadas con SHA-256.
Ya uses GitHub Copilot, Amp Code, Factory Droids u otra cosa, VibeProxy es el aburrido proxy local que hace que una suscripción funcione en todas partes.
Descargar VibeProxyEmpieza con la instalación del DMG y el paso de verificación SHA-256, conecta un proveedor y ejecuta un prompt de prueba antes de conectar el resto de tus herramientas.


