Paseo avec les modèles GetVibe

Configuration de Paseo étape par étape avec GetVibe : installez les CLI, ajoutez le config.json prêt à l’emploi, évitez le réancrage OAuth et vérifiez les dépenses.

Configuration prête à l’emploi

Download config.json

Généré à la demande à partir de notre catalogue : l’adresse de l’API, chaque modèle publié avec sa fenêtre de contexte et sa limite de sortie, ainsi que les paramètres recommandés. Il ne contient aucune clé. Paseo transmet les valeurs env aux agents telles quelles ; le fichier contient donc trois marqueurs PASTE-YOUR-GETVIBE-API-KEY-HERE — remplacez-les par votre clé (étapes ci-dessous).

# 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"

Modèle principal — gpt-6.1-sol : agent de programmation performant avec un grand contexte à un prix modéré ; l’id nu permet de maintenir le basculement entre canaux.
Petites tâches — deepseek-v4.1-flash : le modèle compétent le moins cher avec un contexte de 1M, pour les titres, les résumés, les messages de commit et la condensation.
Diffusion en continu activée, délai d’expiration de la requête de 600 secondes, effort de raisonnement medium : une réponse nécessitant un long raisonnement prend plusieurs minutes et, sans diffusion en continu, dépasse la limite d’attente.
Utilisez partout les identifiants de modèles seuls, sans :suffix — cela permet le basculement automatique vers un canal sain.

Le catalogue évolue : lorsque de nouveaux modèles apparaissent, téléchargez à nouveau le fichier. Pour ne conserver que certains modèles, ajoutez ?models= avec des ID séparés par des virgules à l’URL.

Paseo est un programme graphique pour Windows et macOS. Installez l’application, puis configurez l’ensemble prêt à l’emploi de trois fournisseurs GetVibe : Codex, Claude Code et OpenCode. La ligne de commande est uniquement nécessaire pour installer ces trois outils CLI, et non pour installer ou exécuter Paseo lui-même.

1. Télécharger et installer Paseo Desktop

Ouvrez la page officielle paseo.sh/download et téléchargez la version correspondant à votre système :

Paramètre	Type	Description
`Windows`	installer	Généralement Intel / x64. Exécutez le fichier Paseo-Setup-…-x64.exe téléchargé et suivez les instructions du programme d’installation.
`macOS`	DMG	Apple Silicon : pour les Mac équipés d’une puce M1/M2/M3/M4 ou plus récente ; Intel : pour les anciens Mac. Ouvrez le DMG et faites glisser Paseo vers Applications.

Lancez Paseo depuis le menu Démarrer sous Windows ou depuis Applications sur Mac. Au premier lancement, l’application démarre son propre daemon local : il n’est pas nécessaire d’installer Paseo séparément via npm ni de saisir la commande paseo.

La page de téléchargement affiche également une option npm, mais celle-ci est destinée aux serveurs et à l’utilisation sans interface. Pour ce guide, sélectionnez le bloc Desktop.

2. Installer les CLI des fournisseurs dont vous avez besoin

Paseo Desktop gère les agents, mais Codex, Claude Code et OpenCode eux-mêmes doivent être installés sur votre système. Commencez par installer la version LTS actuelle de Node.js depuis nodejs.org, puis rouvrez votre terminal.

Comment ouvrir un terminal

Un terminal est une fenêtre dans laquelle vous saisissez des commandes sous forme de texte. Pour en ouvrir un :

Paramètre	Type	Description
`Windows`	PowerShell	Appuyez sur Win + X → « Terminal » (ou « Windows PowerShell »). Ou : Win + R, saisissez powershell, puis appuyez sur Entrée.
`macOS`	Terminal	Appuyez sur Cmd + Space, saisissez Terminal, puis appuyez sur Entrée.

Une fenêtre avec un curseur clignotant s’ouvre. Collez les commandes ci-dessous une par une et appuyez sur Entrée après chacune. Pour coller : clic droit ou Ctrl + V sous Windows, Cmd + V sous macOS. L’installation prend 1–3 minutes ; laissez la fenêtre ouverte pendant son exécution.

Si vous n’avez besoin que d’un seul fournisseur, vous pouvez installer uniquement son CLI. Node.js est requis pour les commandes ci-dessous, mais pas pour Paseo Desktop déjà installé.

Installez les trois CLI :

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

Vérifiez que les commandes sont disponibles :

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

3. Connecter le fichier config.json prêt à l’emploi

Téléchargez paseo-getvibe-config.json. Renommez-le en config.json et placez-le :

Paramètre	Type	Description
`macOS / Linux`	path	~/.paseo/config.json
`Windows`	path	%USERPROFILE%\.paseo\config.json

Le dossier .paseo commence par un point et est donc masqué par défaut. Si vous ne le voyez pas, ne créez pas un nouveau dossier ; affichez plutôt les fichiers masqués :

Paramètre	Type	Description
`Windows`	Explorateur de fichiers	Collez %USERPROFILE%\.paseo dans la barre d’adresse de l’Explorateur, puis appuyez sur Entrée : le dossier s’ouvre même lorsqu’il est masqué.
`macOS`	Finder	Dans le Finder, appuyez sur Cmd + Shift + G, saisissez ~/.paseo, puis appuyez sur Entrée. Affichez les fichiers masqués avec Cmd + Shift + . (point).

Si le dossier .paseo n’existe pas encore — lancez Paseo une fois, puis quittez-le : il crée lui-même le dossier. Cette méthode est plus fiable que de le créer manuellement.

La version actuelle de Paseo Desktop ne dispose pas d’un bouton « Import config » dédié. Placer le fichier sous le nom exact config.json dans ce dossier est la méthode standard pour charger des fournisseurs personnalisés prêts à l’emploi.

Windows peut enregistrer le fichier sous le nom config.json.txt — l’extension est masquée. Dans l’Explorateur, activez « Affichage → Afficher → Extensions de noms de fichiers » et vérifiez que le nom est exactement config.json. C’est la raison la plus fréquente pour laquelle Paseo « ne voit pas » la configuration.

Le fichier téléchargé est une configuration minimale complète. Si Paseo est déjà configuré, commencez par enregistrer une sauvegarde, puis déplacez uniquement les trois objets de agents.providersdans votre fichier existant. Ne remplacez pas vos propres paramètres et fournisseurs.

4. Coller votre clé API

Ouvrez le fichier dans un éditeur de texte brut : sous Windows, utilisez « Notepad » (clic droit sur le fichier → « Ouvrir avec » → « Notepad »), et sous macOS, utilisez « TextEdit » (clic droit → « Ouvrir avec » → TextEdit). Ne l’ouvrez pas dans Word ou Pages : ces applications ajoutent une mise en forme et le fichier cesse d’être lisible.

Remplacez les trois occurrences de PASTE-YOUR-GETVIBE-API-KEY-HERE par votre clé depuis le tableau de bord GetVibe, puis enregistrez (Ctrl + S sous Windows, Cmd + S sous macOS). Collez la clé entre les guillemets et conservez-les. Ne publiez pas le fichier terminé et ne l’ajoutez pas à Git.

Sur macOS dans TextEdit, choisissez « Format → Convertir au format texte » avant de modifier le fichier, si l’option est disponible. Sinon, le fichier est enregistré au format RTF et Paseo ne pourra pas le lire.

5. Supprimer les anciennes connexions

Codex peut réutiliser une connexion « Sign in with ChatGPT » enregistrée. Une requête pourrait alors être envoyée directement à OpenAI sans indication visible. Claude Code avec un token GetVibe la choisit avant un abonnement enregistré, mais la déconnexion supprime également toute ancienne session Apps Gateway. Exécutez les deux commandes une fois :

codex logout
claude auth logout

OpenCode ne nécessite aucune déconnexion : l’authentification est stockée séparément pour chaque identifiant de fournisseur, et la configuration sélectionne explicitement getvibe, son adresse et sa clé. N’exécutez pas codex login --with-api-key avec une clé GetVibe.

6. Redémarrer et tout vérifier dans Paseo

Ne sélectionnez pas Auto-review pour Codex (GetVibe) avant d’avoir mis à jour le Codex CLI. Avec des versions incompatibles, l’agent échoue avant même de démarrer et affiche l’erreur unknown variant auto_review, expected user or guardian_subagent. La principale solution consiste à exécuter npm install -g @openai/codex@latest dans un terminal, puis à quitter complètement Paseo Desktop et à le rouvrir. Un seul Restart daemon peut ne pas suffire à mettre à jour une application déjà en cours d’exécution.

Rouvrez Paseo Desktop.
Ouvrez Settings → Host → Overview et cliquez sur Restart daemon.
Ouvrez Settings → Host → Providers. La liste devrait maintenant afficher Codex (GetVibe), Claude Code (GetVibe) et OpenCode (GetVibe).
Retournez à l'espace de travail et créez un agent. Dans le menu déroulant du mode/des autorisations situé en bas du formulaire du nouvel agent, choisissez Default Permissions. Il s'agit d'un choix temporaire sûr pour un débutant. Ne choisissez pas Auto-review. L'option Full Access permet à l'agent d'exécuter des actions sans les demandes de confirmation habituelles et n'est pas nécessaire pour cette correction.
Envoyez un court test : Reply with a single word: ready.

Le bouton Refresh d’une carte de fournisseur actualise la liste des modèles, mais ne remplace pas Restart daemon après le remplacement manuel de l’intégralité de config.json.

7. Vérifier où la requête a été envoyée

Avant le test, ouvrez Usage and requests dans le tableau de bord GetVibe.
Envoyez un test depuis Paseo et attendez la réponse.
Actualisez la page : une nouvelle ligne avec le modèle choisi et le débit devrait apparaître.

Une réponse dans Paseo seule ne prouve pas le routage. S’il n’y a aucune nouvelle ligne dans l’utilisation, arrêtez-vous et corrigez la configuration : ne poursuivez pas avec des tâches payantes.

Dépannage

« Command not found »

Fermez puis rouvrez votre terminal. Si un seul CLI manque, relancez sa commande d’installation de l’étape 2. Vous n’avez pas besoin de réinstaller Paseo Desktop.

Vérification automatique : variante inconnue auto_review

Mettez Codex à jour avec npm install -g @openai/codex@latest, quittez complètement Paseo Desktop, puis rouvrez-le. Tant que le problème de compatibilité n’est pas résolu, sélectionnez Default Permissions dans le menu déroulant du mode en bas. Si une session déjà en échec n’applique pas le nouveau mode, créez un nouvel agent ou un nouvel onglet et sélectionnez-le avant l’envoi.

401 ou un espace réservé laissé dans le fichier

Recherchez et remplacez les trois occurrences du placeholder, vérifiez les virgules et les guillemets, puis dans Paseo ouvrez Settings → Host → Overview → Restart daemon.

Codex répond, mais aucune dépense GetVibe n’apparaît

Exécutez codex logout à nouveau, vérifiez codex login status, redémarrez le daemon via Settings et ne sélectionnez que Codex (GetVibe).

Claude demande une connexion ou affiche Gateway

Exécutez claude auth logout, vérifiez votre clé et redémarrez le fournisseur claude-getvibe.

OpenCode : « Fournisseur introuvable : getvibe »

Vérifiez que l’environnement du fournisseur contient OPENCODE_CONFIG_CONTENT, que le fichier a été enregistré comme un véritable JSON, puis redémarrez le daemon via Settings.

Qwen3.8 manquant ou commençant par une ancienne erreur

Téléchargez à nouveau la version actuelle de paseo-getvibe-config.json : une copie enregistrée précédemment ne se met pas à jour automatiquement.
Quittez complètement Paseo Desktop. Remplacez l’ancien config.json dans le dossier .paseo par le nouveau fichier, puis collez à nouveau votre clé dans les trois emplacements réservés. N’envoyez pas ce fichier au support.
Ouvrez Paseo, exécutez Settings → Host → Overview → Restart daemon, puis créez un nouvel agent : un ancien onglet peut continuer à utiliser le modèle précédent.
Choisissez exactement OpenCode (GetVibe), puis Qwen3.8 Max Preview. Qwen n’appartient pas au fournisseur Codex (GetVibe).

Si l’erreur se répète, faites une capture d’écran uniquement de la zone contenant le nom du fournisseur, le modèle et le texte complet de l’erreur. Masquez ou recadrez votre clé et le contenu de config.json. Vous pouvez également copier une seule ligne d’erreur depuis la fenêtre de l’agent, sans messages de tâche, clés ni variables d’environnement.

Sources officielles

← PrécédentPrésentation Suivant →Pi Agent