Connecter Cursor / Claude Code / Cherry Studio à une passerelle IA personnalisée
Les principaux outils IA prennent en charge les API personnalisées — ce qui signifie que vous pouvez les pointer vers votre propre passerelle (comme 4-4 AI) et unifier clés et facturation. Cet article couvre la configuration des trois outils les plus utilisés et la démarche de diagnostic commune.
https://www.4-4.vip/v1) — les autres passerelles compatibles OpenAI fonctionnent de la même manière.Cursor
Le modèle de conversation de Cursor peut passer par une interface personnalisée compatible OpenAI :
- Ouvrir
Settings → Models(ou la page de réglagesModels) ; - Déplier la zone
OpenAI API Key: saisir la clé de la passerelle (sk-...) ; - Cocher/remplir
Override OpenAI Base URL:https://www.4-4.vip/v1; - Ajouter à la liste des modèles les noms disponibles dans votre passerelle (strictement identiques aux noms de canaux de la passerelle, sensibilité à la casse) ;
- Après une vérification Verify réussie, basculez simplement vers le modèle personnalisé en bas de la conversation.
Remarque : la complétion Tab intégrée de Cursor et une partie de Composer passent par le service propre de Cursor et ne sont pas affectées ; les modèles personnalisés servent surtout au chat.
Claude Code
Claude Code utilise le protocole Anthropic. Le prérequis pour passer par la passerelle est que celle-ci prenne en charge l’endpoint du protocole Anthropic (/v1/messages) — les passerelles sur socle new-api (dont 4-4 AI) assurent cette conversion ; les requêtes du protocole Claude sont transformées puis routées vers le canal de modèle réel.
Configuration par variables d’environnement (dans le terminal qui lance claude) :
export ANTHROPIC_BASE_URL="https://www.4-4.vip"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_GATEWAY_KEY"
# start
claude
Sous Windows PowerShell :
$env:ANTHROPIC_BASE_URL = "https://www.4-4.vip"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_GATEWAY_KEY"
Cherry Studio
Cherry Studio est le plus direct pour les fournisseurs personnalisés compatibles OpenAI :
Réglages → Services de modèles: ajouter/sélectionner un fournisseur compatible OpenAI ;- Adresse API :
https://www.4-4.vip/v1(certaines versions complètent /v1 automatiquement, attention aux doublons) ; - Clé API : la clé de la passerelle ;
- Ajouter manuellement les noms de modèles disponibles dans la gestion des modèles, puis les sélectionner dans la conversation.
La règle commune : tout outil compatible OpenAI
Quantité d’outils (LobeChat, Open WebUI, Immersive Translate, plugins IDE divers) suivent le même schéma de configuration — retenez le trio :
| Élément | Valeur | Pièges fréquents |
|---|---|---|
| Base URL | https://www.4-4.vip/v1 | Certains outils exigent /v1, d’autres non — en cas de 404, testez avec et sans /v1 |
| API Key | Clé de la passerelle (sk-...) | Espaces avant/après, clé expirée, crédit épuisé |
| Nom du modèle | Le nom tel que défini dans le canal de la passerelle | Doit correspondre strictement à la passerelle ; un nom absent du préset de l’outil ne fonctionnera pas |
Mémo de dépannage
401 Unauthorized
- Espaces/sauts de ligne copiés avec la clé → recopier ;
- Clé désactivée ou crédit épuisé → vérifier sur la page Tokens de la console ;
- Format de l’en-tête Authorization incorrect → doit être
Bearer sk-....
404 Not Found
- Chemin de la Base URL incorrect → tester en alternant « avec /v1 » et « sans /v1 » ;
- L’endpoint du protocole demandé n’est pas pris en charge → vérifier que la passerelle supporte le protocole (OpenAI /v1/chat/completions ou Anthropic /v1/messages).
400 Model Not Found / aucun canal disponible
- Nom de modèle différent du canal de la passerelle → vérifier les noms sur la page modèles/canaux de la console ;
- Canal désactivé ou groupe sans droits → vérifier le périmètre de modèles et les réglages de groupe du token.
Streaming interrompu / aucune réponse
- Le proxy d’entreprise met en tampon le SSE → tester en connexion directe ;
- Timeout de l’outil trop court → l’allonger ; pour les tâches longues, vérifier d’abord l’absence de timeout forcé côté passerelle.
Questions fréquentes (FAQ)
Les données sont-elles en sécurité via la passerelle ?
Vos requêtes transitent par la passerelle vers le canal de modèle amont. Vérifiez la politique de journaux et de confidentialité de la passerelle ; pour les données sensibles, désactivez la conservation des logs de conversation côté passerelle ou utilisez des canaux sans persistance des données.
Peut-on configurer plusieurs passerelles dans un même outil ?
La plupart des outils gèrent plusieurs fournisseurs avec bascule instantanée (Cherry Studio, Cursor, etc.). Avec des tokens différents par outil, vous séparez aussi les statistiques d’usage et les plafonds.
Pourquoi recommander une passerelle unifiée plutôt qu’une connexion directe par outil ?
Trois raisons : gestion centralisée des clés (surface de fuite réduite), facturation et usage visibles au même endroit (pas de réconciliation multi-plateformes), modèles remplaçables à tout moment (découplage du fournisseur, le changement ne touche que la configuration de la passerelle).
Articles liés
Une clé pour GLM, DeepSeek, Qwen et autres modèles phares — facturation unifiée et suivi visuel de l’utilisation.
Voir les modèles et tarifs Essayer gratuitement