Claude Desktop

Exécutez Claude Code dans l’application Claude Desktop (onglet Code) sur OneProvider, sans compte Claude.

Application Claude Desktop avec l’onglet Code

Ce qui fonctionne

L’onglet Code (Claude Code avec une interface visuelle) et Cowork fonctionnent sur OneProvider via le mode passerelle intégré de Claude Desktop, qu’Anthropic appelle third-party inference. Aucun compte Claude ni Anthropic n’est nécessaire. Cela fonctionne sous macOS 14+ et Windows 10 (2004) ou plus récent, Windows 11 compris.

Limite du client

Le mode passerelle est uniquement local : les sessions s’exécutent sur votre ordinateur, sans sessions cloud, SSH ni Remote Control. Desktop prend la passerelle dans le formulaire ci-dessous, et non dans ANTHROPIC_BASE_URL ou ~/.claude/settings.json (ceux-ci concernent la ligne de commande de Claude Code). Sans le formulaire, Desktop ne s’ouvre qu’avec un abonnement Claude payant.

Configuration

1. Installer Claude Desktop sans se connecter

   Téléchargez l’application depuis claude.com/download (macOS : .dmg, glissez Claude dans Applications ; Windows : installateur .msix) et lancez-la. Restez sur l’écran de connexion : ne vous connectez pas et ne créez pas de compte Anthropic.

2. Activer le Developer Mode

   macOS : dans la barre des menus, choisissez Help → Troubleshooting → Enable Developer Mode (Aide → Dépannage → Activer le mode développeur). Windows : cliquez sur le menu de l’application ☰ en haut à gauche de l’écran de connexion, puis sur Help → Troubleshooting → Enable Developer Mode. L’application redémarre et un menu Developer apparaît ; il reste activé après les redémarrages.

3. Ouvrir Configure Third-Party Inference

   Choisissez Developer → Configure Third-Party Inference…. Dans la section Connection, réglez Inference provider sur Gateway et remplissez la carte Gateway credentials comme indiqué. La base URL est exactement celle-ci, sans /v1 ni chemin final ; collez votre clé OneProvider dans Gateway API key.

   Inference provider: Gateway
   Gateway base URL: https://api.oneprovider.dev
   Gateway API key: sk-your-key-here
   Credential kind: Static API key
   Gateway auth scheme: Bearer (x-api-key fonctionne aussi)

4. Vérifier la liste des modèles

   Laissez d’abord Models vide : Desktop interroge https://api.oneprovider.dev/v1/models et affiche les modèles Claude du catalogue. Si le sélecteur reste vide, ouvrez la section Models et ajoutez l’ID exact du modèle Claude (<your-compatible-model-id>) tiré du catalogue des modèles ; la première entrée est celle par défaut pour les nouvelles sessions Code.

5. Appliquer, redémarrer et démarrer en mode passerelle

   Cliquez sur Apply Changes, puis sur Save & Restart. Après le redémarrage, l’écran de connexion propose de démarrer avec votre configuration de fournisseur d’inférence : choisissez cette option, pas la connexion Anthropic. Ouvrez l’onglet Code, sélectionnez un dossier de projet local et envoyez un message.

Vérifier la connexion

Confirmer la requête dans votre espace client

Envoyez un court message dans une nouvelle session Code. En moins d’une minute, la requête doit apparaître dans l’espace client, sous « Consommation », avec le modèle, les jetons et le montant débité. En cas d’échec :

Écran de connexion standard sans l’option de fournisseur → le formulaire n’a pas été appliqué : quittez complètement l’application (Cmd+Q sous macOS, Gestionnaire des tâches sous Windows) et rouvrez-la
"Gateway was unreachable" → vérifiez la base URL (exactement https://api.oneprovider.dev) et désactivez le VPN ou le proxy
401 → clé incorrecte, révoquée ou expirée : vérifiez-la dans l’espace client, sous « Clés »
429 insufficient balance → rechargez le solde de l’espace client, puis renvoyez la requête
Sélecteur de modèles vide → ajoutez l’ID du modèle dans la section Models
"Error 403: Forbidden" → vous êtes sur la connexion Anthropic : choisissez plutôt l’option de fournisseur
Ce que Desktop a appliqué : Help → Troubleshooting → Generate Diagnostic Report → Export to file (managed-config.txt, provider-status.txt)
Journal : ~/Library/Logs/Claude-3p/main.log (macOS) ou %LOCALAPPDATA%\Claude-3p\Logs\main.log (Windows)

Paramètres de connexion

Protocole

anthropic

Endpoint

https://api.oneprovider.dev

Sécurité de la clé

La clé est enregistrée dans la configuration de Desktop, sur cet ordinateur uniquement. Utilisez une clé dédiée avec une limite de dépense ; si l’ordinateur est partagé ou si la clé fuit, supprimez ou mettez en pause cette clé dans l’espace client et le reste de votre solde reste en sécurité.

Réponses rapides

Quelle base URL utiliser ?

Claude Code et les SDK Anthropic utilisent https://api.oneprovider.dev. Les SDK OpenAI et les clients compatibles OpenAI utilisent https://api.oneprovider.dev/v1. Une seule clé fonctionne avec les deux ; la liste des modèles est sur la page des modèles , les tarifs sur la page des tarifs .

Comment s’authentifier ?

Envoyez la clé sk-… telle quelle dans x-api-key ou Authorization: Bearer : l’un des deux, jamais les deux. Conservez la clé dans une variable d’environnement, pas dans un fichier qui sera commité. En savoir plus sur l’authentification .

Où obtenir une clé ?

Ouvrez votre espace client dans le bot Telegram @oneprovider_robot ou sur app.oneprovider.dev, rechargez le solde et appuyez sur « Créer une clé ». Chaque clé peut avoir sa propre limite de dépense. Espace client et clés API .

Que signifient 401, 404 et 429 ?

401 : la clé est absente, mal saisie ou envoyée dans le mauvais en-tête ; collez la clé entière, sans guillemets ni espaces. 404 : le plus souvent une base URL incorrecte, par exemple un /v1 manquant ou en double. 429 avec « Insufficient balance » : le solde de l’espace client est à zéro ou la clé a atteint sa limite de dépense, donc rechargez au lieu de réessayer ; tout autre 429 est une limite de débit, donc attendez le délai indiqué par Retry-After. Détails : codes d’erreur et dépannage .

Pourquoi les flux se coupent-ils ou se réinitialisent-ils ?

Les VPN et les proxys VLESS mettent souvent le SSE en mémoire tampon ou perturbent la négociation HTTP/2. OneProvider n’a aucune restriction régionale et ne met pas les flux en mémoire tampon : désactivez le proxy et réessayez.

Où demander de l’aide si cela ne suffit pas ?

Écrivez à @Oneproviderhelpbot sur Telegram ou ouvrez « Support » dans l’espace client web, en indiquant le code de statut HTTP et le message d’erreur exact. Comment fonctionne le support .