Claude Desktop (Chat, Cowork, Code)
Connectez l’application officielle Claude Desktop à GetVibe API via Third-Party Inference : activez Developer Mode, indiquez l’URL de base de la passerelle et une clé sk-pv- avec le schéma x-api-key. Utilisez Chat, Cowork et Code sans compte Anthropic.
L’application officielle Claude Desktop (macOS et Windows) peut passer par une passerelle tierce — la fonction Third-Party Inference. GetVibe API parle le format natif d’Anthropic (/v1/messages avec l’en-tête x-api-key), donc l’application se connecte directement, sans proxy de traduction. Les trois onglets fonctionnent : Chat, Cowork et Code. Aucun compte Anthropic n’est nécessaire — ne te connecte pas. La documentation d’Anthropic indique que l’application détecte le mode tiers (3P) au lancement à partir du fournisseur configuré ; lorsque le fournisseur et les identifiants sont présents, l’écran de connexion propose le démarrage tiers sans compte Anthropic, et la documentation ne décrit pas de contrôle de région en mode 3P. Voir la présentation 3P et le guide d’installation.
Pour qui
- Windows 10/11 ou macOS. Rien d’autre à installer — ni Node.js, ni terminal.
- Tu as seulement besoin de ta clé
sk-pv-…depuis Tableau de bord → Clés API.
1. Installer l’application
Téléchargez Claude Desktop depuis le site officiel, installez-le et lancez-le. Sur l’écran de connexion, ne vous connectez pas à un compte Anthropic.
Si Windows indique « Cette application ne peut pas s’exécuter sur votre PC », le programme d’installation ne correspond pas à votre processeur ou le téléchargement a été interrompu. Vérifiez Paramètres → Système → Informations système → Type du système (x64 ou ARM64), téléchargez à nouveau le programme d’installation correspondant à cette architecture et exécutez-le.
2. Activer le mode développeur
Dans le menu de l’application elle-même (barre de menus macOS ; sous Windows ☰ en haut à gauche de l’écran de connexion), ouvre Help → Troubleshooting → Enable Developer Mode. Un élément Developer apparaît dans le menu.
3. Configurer la passerelle GetVibe API
- Dans le nouveau menu Developer, choisissez Configure Third-Party Inference….
- Dans Connection, basculez le type sur Gateway.
- URL de base de la passerelle :
https://getvibeapi.com— aucun/v1, l’application ajoute elle-même/v1/messages. - Type d’identifiant : clé API statique ; schéma d’authentification :
x-api-key. - Clé API de la passerelle : votre clé
sk-pv-…depuis Dashboard → API keys. - Dans l’onglet Modèles, ajoutez les modèles manuellement avant de tester la connexion :
claude-sonnet-5.5,claude-opus-5.5,claude-haiku-5.5. Le test de connexion échoue si aucun modèle n’est ajouté, et toutes les versions de l’application ne remplissent pas automatiquement la liste à partir de/v1/models.
4. Redémarre complètement l’application
Clique sur Apply Changes, quitte complètement l’application (Quit dans le menu, pas seulement fermer la fenêtre), puis rouvre-la. Sur l’écran de connexion, choisis le démarrage tiers qui apparaît après l’enregistrement de la configuration ; ne te connecte pas à Anthropic. Si la configuration définit deploymentMode: "3p" (Claude Desktop 4.16336.0+), l’option de connexion claude.ai est masquée.
5. Vérifie la connexion
Envoie un message et ouvre Tableau de bord → Utilisation : une entrée récente doit apparaître avec le modèle et le montant. Sinon, voir « Problèmes fréquents » ci-dessous — aucun terminal n’est nécessaire pour vérifier.
Limitations
- Cowork sur Windows nécessite l’installateur
.msixet la virtualisation matérielle activée (exigence de l’application). - Anthropic désactive certaines fonctionnalités bêta (par exemple, la recherche d’outils) pour les passerelles tierces ; il s’agit d’une limitation de l’application, et non d’un problème lié à votre clé.
Problèmes courants
| Paramètre | Type | Description |
|---|---|---|
App unavailable in region | screen | C’est le premier écran de connexion de l’application, pas notre passerelle. Le menu Help/☰ est dans l’application, pas sur le site web. Configure la passerelle ; si le menu est absent, utilise la CLI. |
401 | error | Vérifiez la clé et assurez-vous que Auth scheme est x-api-key, et non Bearer. |
404 | error | L’adresse de la passerelle ne doit pas contenir /v1 — utilise l’adresse racine indiquée ci-dessus. |
Models did not appear / “The connection test needs at least one model” | config | Ajoutez manuellement les identifiants dans l’onglet Models : claude-sonnet-5.5, claude-opus-5.5, claude-haiku-5.5. |
“Couldn’t load your organization’s model list”, “Gateway /v1/models was unreachable”, “Can’t reach … provider didn’t respond” | network | The request never reached us — Usage shows no new record. On the same computer open https://getvibeapi.com/v1/models in a browser: it must return a JSON error (the browser sends no key, that is expected). If the page does not open, a VPN, proxy, antivirus or corporate network is cutting the connection. Add the models by hand on the Models tab as well. |
Changes not applied | config | Quittez complètement l’application via Quit/Exit, puis rouvrez-la : fermer la fenêtre ne suffit pas. |