Connecter Cursor / Claude Code / Cherry Studio à une passerelle IA personnalisée

Tutoriel · 2026-11-20 · 7 min de lecture

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.

Prérequis : vous avez déjà une clé API. Sinon, terminez d’abord inscription et création de clé avec « Se connecter à une API IA unifiée en 5 minutes ». Cet article prend pour exemple la Base URL de 4-4 AI (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 :

  1. Ouvrir Settings → Models (ou la page de réglages Models) ;
  2. Déplier la zone OpenAI API Key : saisir la clé de la passerelle (sk-...) ;
  3. Cocher/remplir Override OpenAI Base URL : https://www.4-4.vip/v1 ;
  4. Ajouter à la liste des modèles les noms disponibles dans votre passerelle (strictement identiques aux noms de canaux de la passerelle, sensibilité à la casse) ;
  5. 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"
Deux détails : ① ANTHROPIC_BASE_URL sans suffixe /v1 (le chemin du protocole Anthropic est assemblé par l’outil) ; ② pour faire utiliser à Claude Code des modèles non Claude, vérifiez que le canal de la passerelle a bien le mapping de modèles configuré et utilisez les noms côté passerelle.

Cherry Studio

Cherry Studio est le plus direct pour les fournisseurs personnalisés compatibles OpenAI :

  1. Réglages → Services de modèles : ajouter/sélectionner un fournisseur compatible OpenAI ;
  2. Adresse API : https://www.4-4.vip/v1 (certaines versions complètent /v1 automatiquement, attention aux doublons) ;
  3. Clé API : la clé de la passerelle ;
  4. 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émentValeurPièges fréquents
Base URLhttps://www.4-4.vip/v1Certains outils exigent /v1, d’autres non — en cas de 404, testez avec et sans /v1
API KeyClé de la passerelle (sk-...)Espaces avant/après, clé expirée, crédit épuisé
Nom du modèleLe nom tel que défini dans le canal de la passerelleDoit correspondre strictement à la passerelle ; un nom absent du préset de l’outil ne fonctionnera pas

Mémo de dépannage

401 Unauthorized

404 Not Found

400 Model Not Found / aucun canal disponible

Streaming interrompu / aucune réponse

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

4-4 AI en 5 minutes : se connecter à une API IA unifiée Interface compatible OpenAI : une seule clé pour GLM, DeepSeek, Qwen et plus. Exemples exécutables en trois la 7 pratiques d’ingénierie pour réduire le coût des tokens de vos applications IA Routage par niveau de modèle, rognage de contexte, cache de préfixe, garde-fous budgétaires — sept pratiques d
Prêt à vous connecter ?

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