Paseo con modelos de GetVibe

Configuración de Paseo paso a paso con GetVibe: instala las CLI, coloca el config.json listo para usar, evita volver a vincular OAuth y verifica el gasto.

Configuración lista para usar

Download config.json

Se genera a partir de nuestro catálogo cuando lo solicitas: la dirección de la API, todos los modelos publicados con su contexto y límite de salida, y la configuración recomendada. No contiene ninguna clave. Paseo pasa los valores de env a los agentes sin modificarlos, por lo que el archivo contiene tres marcadores PASTE-YOUR-GETVIBE-API-KEY-HERE: reemplázalos por tu clave (pasos a continuación).

# macOS / Linux
mkdir -p ~/.paseo
curl -fsSL https://getvibeapi.com/api/integrations/paseo.json -o ~/.paseo/config.json

# Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.paseo" | Out-Null
Invoke-WebRequest https://getvibeapi.com/api/integrations/paseo.json -OutFile "$HOME\.paseo\config.json"

Modelo principal — gpt-6.1-sol: agente programador sólido con un contexto amplio a un precio moderado; el id sin modificaciones mantiene activa la conmutación por error entre canales.
Tareas pequeñas — deepseek-v4.1-flash: el modelo capaz más económico con un contexto de 1M, para títulos, resúmenes, mensajes de commit y compactación.
Transmisión activada, un tiempo de espera de 600 segundos por solicitud y esfuerzo de razonamiento medium: una respuesta de razonamiento larga tarda minutos y, sin transmisión, alcanza el límite de espera.
Usa los IDs de modelo sin formato, sin :suffix — esto mantiene activo el failover automático hacia un canal saludable.

El catálogo cambia: cuando aparezcan modelos nuevos, vuelve a descargar el archivo. Para conservar solo algunos modelos, añade ?models= con IDs separados por comas a la URL.

Paseo es un programa gráfico para Windows y macOS. Instala la aplicación y luego conecta el conjunto listo para usar de tres proveedores de GetVibe: Codex, Claude Code y OpenCode. Solo necesitas la línea de comandos para instalar esas tres herramientas CLI; no para instalar ni ejecutar Paseo.

1. Descarga e instala Paseo Desktop

Abre la página oficial paseo.sh/download y descarga la compilación para tu sistema:

Parámetro	Tipo	Descripción
`Windows`	installer	Normalmente Intel / x64. Ejecuta el archivo descargado Paseo-Setup-…-x64.exe y sigue las instrucciones del instalador.
`macOS`	DMG	Apple Silicon: para Mac con un chip M1/M2/M3/M4 o posterior; Intel: para Mac más antiguos. Abre el DMG y arrastra Paseo a Applications.

Inicia Paseo desde el menú Inicio en Windows o desde Aplicaciones en una Mac. La primera vez que se inicia, la aplicación inicia su propio daemon local; no es necesario instalar Paseo por separado mediante npm ni escribir el comando paseo.

La página de descarga también muestra una opción de npm, pero está pensada para servidores y uso sin interfaz. Para esta guía, elige el bloque de Desktop.

2. Instala las CLI de los proveedores que necesitas

Paseo Desktop gestiona agentes, pero Codex, Claude Code y OpenCode deben estar instalados en tu sistema. Primero instala la versión LTS actual de Node.js desde nodejs.org y vuelve a abrir la terminal después.

Cómo abrir una terminal

Una terminal es una ventana donde escribes comandos como texto. Para abrir una:

Parámetro	Tipo	Descripción
`Windows`	PowerShell	Presiona Win + X → “Terminal” (o “Windows PowerShell”). O: Win + R, escribe powershell y presiona Enter.
`macOS`	Terminal	Presiona Cmd + Space, escribe Terminal y presiona Enter.

Se abre una ventana con un cursor parpadeante. Pega los comandos de abajo uno por uno y presiona Enter después de cada uno. Para pegar: haz clic derecho o presiona Ctrl + V en Windows, Cmd + V en macOS. La instalación tarda entre 1 y 3 minutos; mantén la ventana abierta mientras se ejecuta.

Si solo necesitas un proveedor, puedes instalar únicamente su CLI. Necesitas Node.js para los comandos siguientes, pero no si ya tienes instalado Paseo Desktop.

Instala las tres CLI:

npm install -g @openai/codex @anthropic-ai/claude-code opencode-ai

Comprueba que los comandos estén disponibles:

codex --version
claude --version
opencode --version

3. Conecta el config.json listo

Descarga paseo-getvibe-config.json. Cámbiale el nombre a config.json y colócalo:

Parámetro	Tipo	Descripción
`macOS / Linux`	path	~/.paseo/config.json
`Windows`	path	%USERPROFILE%\.paseo\config.json

La carpeta .paseo comienza con un punto, por lo que está oculta de forma predeterminada. Si no la ves, no crees una nueva; muestra los archivos ocultos en su lugar:

Parámetro	Tipo	Descripción
`Windows`	Explorador de archivos	Pega %USERPROFILE%\.paseo en la barra de direcciones del Explorador y presiona Enter; la carpeta se abre incluso cuando está oculta.
`macOS`	Finder	En Finder, presiona Cmd + Shift + G, escribe ~/.paseo y presiona Enter. Mostrar archivos ocultos: Cmd + Shift + . (punto).

Si la carpeta .paseo aún no existe, inicia Paseo una vez y ciérralo: la carpeta se crea automáticamente. Es más fiable que crearla manualmente.

La versión actual de Paseo Desktop no tiene un botón específico de “Importar configuración”. Colocar el archivo con el nombre exacto config.json en esta carpeta es la forma estándar de cargar proveedores personalizados ya preparados.

Windows puede guardar el archivo como config.json.txt; la extensión está oculta. En el Explorador, activa “Vista → Mostrar → Extensiones de nombre de archivo” y verifica que el nombre sea exactamente config.json. Esta es la razón más común por la que Paseo “no ve” la configuración.

El archivo descargado es una configuración mínima completa. Si Paseo ya está configurado, guarda primero una copia de seguridad y mueve únicamente los tres objetos de agents.providers a tu archivo existente. No sobrescribas tus propios ajustes ni proveedores.

4. Pega tu clave de API

Abre el archivo en un editor de texto sin formato: en Windows, usa “Notepad” (haz clic derecho en el archivo → “Abrir con” → “Notepad”); en macOS, usa “TextEdit” (haz clic derecho → “Abrir con” → TextEdit). No lo abras en Word ni Pages, ya que agregan formato y el archivo deja de ser legible.

Reemplaza las tres apariciones de PASTE-YOUR-GETVIBE-API-KEY-HERE por tu clave del panel de GetVibe y guarda (Ctrl + S en Windows, Cmd + S en macOS). Pega la clave entre las comillas y conserva las comillas. No publiques el archivo terminado ni lo agregues a Git.

En macOS, en TextEdit, selecciona “Formato → Convertir en texto sin formato” antes de editar, si está disponible. De lo contrario, el archivo se guarda como RTF y Paseo no podrá leerlo.

5. Elimina los inicios de sesión obsoletos

Codex puede reutilizar un inicio de sesión guardado de “Iniciar sesión con ChatGPT”. En ese caso, una solicitud podría dirigirse silenciosamente directamente a OpenAI. Claude Code con un token de GetVibe lo selecciona antes que una suscripción guardada, pero cerrar sesión también elimina cualquier sesión antigua de Apps Gateway. Ejecuta ambos comandos una vez:

codex logout
claude auth logout

OpenCode no necesita cerrar sesión: la autenticación se almacena por separado para cada id de proveedor, y la configuración selecciona explícitamente getvibe, su dirección y su clave. No ejecutes codex login --with-api-key con una clave de GetVibe.

6. Reinicia y verifica todo en Paseo

No selecciones Auto-review para Codex (GetVibe) hasta que hayas actualizado Codex CLI. Con versiones incompatibles, el agente falla antes de iniciarse siquiera con el error unknown variant auto_review, expected user or guardian_subagent. La solución principal: ejecuta npm install -g @openai/codex@latest en una terminal, luego cierra por completo Paseo Desktop y vuelve a abrirlo. Es posible que un solo Restart daemon no sea suficiente para actualizar una aplicación que ya está en ejecución.

Vuelve a abrir Paseo Desktop.
Abre Settings → Host → Overview y presiona Restart daemon.
Abre Settings → Host → Providers. La lista ahora debería mostrar Codex (GetVibe), Claude Code (GetVibe) y OpenCode (GetVibe).
Regresa al espacio de trabajo y crea un agente. En el menú desplegable de modo/permisos situado en la parte inferior del formulario del nuevo agente, selecciona Permisos predeterminados. Es una opción temporal segura para principiantes. No selecciones Revisión automática. La opción Acceso total permite que el agente se ejecute sin las solicitudes de confirmación habituales y no es necesaria para esta corrección.
Envía una prueba breve: Reply with a single word: ready.

El botón Refresh de una tarjeta de proveedor actualiza la lista de modelos, pero no sustituye a Restart daemon después de reemplazar manualmente todo config.json.

7. Verifica adónde fue la solicitud

Antes de la prueba, abre Usage and requests en el panel de GetVibe.
Envía una prueba desde Paseo y espera la respuesta.
Actualiza la página: debería aparecer una nueva fila con el modelo elegido y el cargo.

Una respuesta en Paseo por sí sola no demuestra el enrutamiento. Si no aparece una fila nueva en el uso, detente y corrige la configuración: no continúes con tareas de pago.

Solución de problemas

«Comando no encontrado»

Cierra y vuelve a abrir tu terminal. Si falta un solo CLI, vuelve a ejecutar su comando de instalación del paso 2. No necesitas reinstalar Paseo Desktop.

Revisión automática: variante desconocida auto_review

Actualiza Codex con npm install -g @openai/codex@latest, cierra completamente Paseo Desktop y vuelve a abrirlo. Hasta que se solucione el problema de compatibilidad, selecciona Default Permissions en el menú desplegable de modo inferior. Si una sesión que ya falló no aplica el nuevo modo, crea un agente o pestaña nuevos y selecciónalo antes de enviar.

401 o un marcador de posición dejado en el archivo

Busca y reemplaza las tres apariciones del marcador de posición, comprueba las comas y las comillas y, después, en Paseo abre Settings → Host → Overview → Restart daemon.

Codex responde, pero no aparece ningún gasto de GetVibe

Ejecuta codex logout de nuevo, comprueba codex login status, reinicia el daemon mediante Settings y selecciona solo Codex (GetVibe).

Claude solicita iniciar sesión o muestra Gateway

Ejecuta claude auth logout, comprueba tu clave y reinicia el proveedor claude-getvibe.

OpenCode: «Proveedor no encontrado: getvibe»

Asegúrate de que el entorno del proveedor tenga OPENCODE_CONFIG_CONTENT, que el archivo se haya guardado como JSON válido y reinicia el daemon mediante Configuración.

Qwen3.8 falta o comienza con un error antiguo

Vuelve a descargar la versión actual de paseo-getvibe-config.json: una copia guardada anteriormente no se actualiza sola.
Cierra por completo Paseo Desktop. Reemplaza el config.json anterior en la carpeta .paseo con el archivo nuevo y pega tu clave nuevamente en los tres placeholders. No envíes este archivo al soporte.
Abre Paseo, ejecuta Settings → Host → Overview → Restart daemon y crea un agente nuevo: una pestaña antigua podría seguir usando el modelo anterior.
Elige exactamente OpenCode (GetVibe) y después Qwen3.8 Max Preview. Qwen no pertenece al proveedor Codex (GetVibe).

Si el error se repite, haz una captura de pantalla solo del área que contiene el nombre del proveedor, el modelo y el texto completo del error. Cubre o recorta tu clave y el contenido de config.json. También puedes copiar una sola línea del error desde la ventana del agente, sin mensajes de tareas, claves ni variables de entorno.

Fuentes oficiales

← AnteriorDescripción general Siguiente →Pi Agent