Logotipo de Bitdoze

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.

Dragos

37 min de lectura

Guía de VibeProxy: Usa Claude, Codex y Gemini en Cualquier Herramienta de IA

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.)

Arquitectura de VibeProxy: las herramientas de código se conectan por loopback al proxy de VibeProxy en el puerto 8317, que enruta a través del backend CLIProxyAPI integrado en el puerto 8318 hacia los proveedores de suscripciones

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-N exponen 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 (LSMinimumSystemVersion en 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:

bash
lsof -i :8317 -i :8318
# empty output = ports are free

Descargar 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

  1. Descarga VibeProxy-arm64.dmg (o VibeProxy-x86_64.dmg) desde la página de releases
  2. Verifica el checksum:
bash
shasum -a 256 -c VibeProxy-arm64.dmg.sha256
# expect: VibeProxy-arm64.dmg: OK
  1. Haz doble clic en el DMG y arrastra VibeProxy.app a /Applications
  2. 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

  1. Descarga VibeProxy-arm64.zip (o VibeProxy-x86_64.zip)
  2. Verifica el checksum:
bash
shasum -a 256 -c VibeProxy-arm64.zip.sha256
# expect: VibeProxy-arm64.zip: OK
  1. Descomprime y mueve la app:
bash
unzip VibeProxy-arm64.zip
mv VibeProxy.app /Applications/
  1. Abre VibeProxy desde /Applications
Descargar VibeProxy

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:

bash
xattr -cr /Applications/VibeProxy.app

Primer inicio

  1. Abre VibeProxy desde /Applications
  2. Aparece un icono en la barra de menús (punto verde = servidor en marcha)
  3. Haz clic en el icono y selecciona «Open Settings»
  4. 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:

bash
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

  1. Haz clic en el icono de VibeProxy en la barra de menús y selecciona «Open Settings»
  2. Haz clic en «Connect» junto a Claude Code
  3. Inicia sesión cuando se abra el navegador
  4. 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

  1. Haz clic en «Connect» junto a Codex en Settings
  2. Completa la autenticación en el navegador con tu cuenta de ChatGPT
  3. 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
  1. Haz clic en «Connect» junto a Antigravity
  2. Inicia sesión con tu cuenta de Google y concede acceso a los modelos
  3. Reinicia VibeProxy para activar la lista de modelos Gemini 3.x

Conectar Gemini CLI

  1. Haz clic en «Connect» junto a Gemini
  2. Inicia sesión con tu cuenta de Google
  3. Selecciona un proyecto de Google Cloud (o acepta el predeterminado)
  4. VibeProxy guarda las credenciales en ~/.cli-proxy-api/

Conectar GitHub Copilot

  1. Haz clic en «Connect» junto a GitHub Copilot en Settings
  2. Introduce el código de dispositivo en GitHub (el código se copia con su guion, así que pegarlo funciona directamente)
  3. 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

bash
curl -fsSL https://app.factory.ai/cli | sh

Configurar 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.

json
{
  "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

  1. Ejecuta Factory CLI:
bash
droid
  1. Selecciona un modelo con /model y elige una de tus entradas personalizadas
  2. 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:

json
{
  "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

bash
mkdir -p ~/.config/amp
echo '{"amp.url": "http://localhost:8317"}' > ~/.config/amp/settings.json

Autenticar 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):

bash
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          # Gemini

Ahora 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

bash
# 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:

bash
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:

json
{
  "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)

toml
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

toml
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:

text
{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:

json
{
  "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.

yaml
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:

bash
xattr -cr /Applications/VibeProxy.app

Raro 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 /v1 para 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
  1. Sal de VibeProxy (icono de la barra de menús, o pkill -f VibeProxy)
  2. Elimina /Applications/VibeProxy.app
  3. Opcionalmente elimina ~/.cli-proxy-api/. Esto borra los tokens OAuth y es el verdadero paso de «desconectar todos los proveedores»
  4. Revierte la configuración de cada herramienta: ~/.factory/config.json, ~/.config/amp/settings.json, ~/.codex/config.toml, ajustes de endpoint del editor
  5. Comprueba listeners huérfanos: lsof -i :8317 -i :8318 y 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:

Herramientas y recursos relacionados

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?
  1. Confirma que el proveedor del modelo está autenticado en Settings
  2. Comprueba el ID de modelo contra las tablas de referencia de arriba (ojo con la notación punto vs guion)
  3. Para los nombres de modelo de Copilot, ejecuta copilot --help
  4. Reinicia VibeProxy tras los cambios de configuración (excepto los interruptores Priority, que se recargan en caliente)
  5. 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 VibeProxy

Empieza 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.