Connecter Cherry Studio à Claude

Cherry Studio est un client de bureau bien organisé permettant de discuter avec de nombreux modèles, et il prend directement en charge le format natif d’Anthropic. En ajoutant la passerelle AI Prime Tech comme fournisseur de type Anthropic, vous disposez de Claude dans la même fenêtre que tous vos autres modèles, avec un seul hôte et une seule clé.

Ouvrir les services de modèles

Accédez aux Paramètres et ouvrez les Services de modèles. C’est là que Cherry Studio répertorie tous les fournisseurs avec lesquels il peut communiquer et que vous pouvez en ajouter de nouveaux. Appuyez sur le bouton plus pour ajouter un fournisseur ; son type vous sera alors demandé.

Le choix du type est important, car il détermine le format des échanges. Pour utiliser Claude sur la passerelle, choisissez le type Anthropic, qui cible l’interface native /v1/messages plutôt qu’un endpoint au format OpenAI.

Comme Cherry Studio conserve les fournisseurs sous forme de liste, la passerelle figure aux côtés des autres services que vous avez configurés, et vous passez de l’un à l’autre pour chaque conversation. C’est donc un environnement pratique pour une passerelle multimodèle : une seule entrée de fournisseur peut contenir plusieurs modèles Claude, que vous sélectionnez dans le menu selon vos besoins. Le fait de traiter la passerelle comme une entrée parmi d’autres fait de Cherry Studio un poste de commande multimodèle agréable. Vous changez de fournisseur pour chaque conversation sans quitter l’application.

Choisir le type Anthropic

Sélectionnez Anthropic comme type de fournisseur et activez-le. Cherry Studio affiche alors deux champs qui déterminent toute la configuration : la clé API et l’hôte API. Collez votre clé de passerelle dans le champ de clé.

Comme le type correspond au format natif d’Anthropic, Cherry Studio enverra les requêtes au format Messages que la passerelle prend en charge pour Claude. Une fois le type défini, aucun réglage de protocole distinct n’est nécessaire.

Si votre passerelle expose également une interface compatible avec OpenAI pour d’autres modèles, ajoutez-les comme fournisseur distinct de type OpenAI au lieu de les mélanger à celui-ci. En réservant l’entrée de type Anthropic à Claude, vous gardez un format d’échange sans ambiguïté et évitez toute confusion entre protocoles. Conserver les protocoles dans des entrées de fournisseurs distinctes est une petite discipline qui évite beaucoup de confusion par la suite. Chaque entrée correspond alors à un seul format d’échange à prendre en compte.

Définir correctement l’hôte API

L’hôte API est le champ dans lequel les erreurs sont les plus fréquentes. Saisissez uniquement la racine de l’hôte, sans /v1 à la fin, car Cherry Studio ajoute lui-même le chemin de version. Ajouter /v1 manuellement entraîne un chemin doublé et l’échec de la requête.

La valeur se limite donc à l’hôte de la passerelle. Si vous avez rencontré des erreurs 404 ou des erreurs de chemin après avoir ajouté un fournisseur, un /v1 superflu dans l’hôte API en est presque toujours la cause.

Une barre oblique finale sur l’hôte provoque le même type de problème ; saisissez donc l’hôte seul, sans rien après. Lorsqu’une requête échoue, le diagnostic le plus rapide consiste à relire le champ Hôte API et à supprimer tout ce qui suit le nom d’hôte avant de chercher ailleurs. En cas de problème, vérifier ce champ en premier permet de résoudre immédiatement la plupart des problèmes de configuration. L’objectif est d’obtenir un hôte seul, sans suffixe.

Le verrouillage par un dièse final

Cherry Studio prend en charge une astuce discrète mais importante : terminez l’hôte API par un #, et le client utilisera cette URL exacte sans rien ajouter. Cela permet d’imposer un endpoint précis lorsque l’ajout automatique pose problème.

Pour une passerelle standard, laissez généralement l’hôte seul et laissez Cherry Studio compléter le chemin. Utilisez le # uniquement lorsque votre passerelle exige un chemin exact que l’ajout automatique risquerait d’altérer.

Le # mérite d’être retenu précisément parce que son rôle n’est pas évident : il sert de solution de secours pour toute passerelle dont le chemin ne correspond pas à ce que Cherry Studio suppose par défaut. Si le chemin /v1/messages ajouté automatiquement ne correspond pas à celui attendu par votre passerelle, le # vous permet de saisir manuellement l’URL complète. En gardant cette astuce en mémoire, vous reconnaîtrez immédiatement la solution si un chemin ne correspond pas. C’est le mécanisme qui permet de remplacer le comportement par défaut pour tout chemin de passerelle non standard.

Choisir un modèle et discuter

Ajoutez les modèles Claude souhaités dans le fournisseur en utilisant les identifiants proposés par la passerelle, tels que claude-sonnet-4-5 pour les conversations quotidiennes et claude-opus-4-8 pour les raisonnements plus complexes. Ils apparaissent ensuite dans le menu des modèles de Cherry Studio.

Démarrez une conversation, choisissez un modèle Claude dans le menu, et vous communiquez avec la passerelle. Comme le fournisseur utilise le format natif d’Anthropic, les fonctionnalités qui dépendent du format Messages se comportent comme prévu.

Vous pouvez garder plusieurs conversations ouvertes avec différents modèles Claude en même temps, ce qui est pratique pour comparer la manière dont Sonnet et Opus répondent au même prompt. Comme ils passent tous par le même fournisseur de passerelle, changer de modèle consiste à faire un choix dans le menu plutôt qu’à reconfigurer le client. Comparer les modèles côte à côte fait partie des petits plaisirs de tout faire passer par un seul fournisseur. Pour soumettre le même prompt à Sonnet et à Opus, il suffit de changer de modèle dans le menu.

# Cherry Studio -> Settings -> Model Services -> + Add
# Provider type: Anthropic   (native /v1/messages)
# API Key:  <your gateway key>
# API Host: https://aiprimetech.io        (root only, NO /v1 -- it auto-appends)
#   end with #  ->  https://aiprimetech.io#   to lock the exact URL
# Model: claude-sonnet-4-5

Questions fréquentes

AI Prime Tech est une passerelle API indépendante. Elle n’est ni affiliée à Anthropic, ni approuvée par Anthropic, ni revendeuse d’Anthropic. Claude et les noms de modèles associés sont des marques de leurs propriétaires respectifs.