Passer au contenu principal
Utilisez ce guide pour connecter Claude Desktop Cowork sur une inférence tierce à CometAPI. Cette configuration permet à Claude Desktop d’envoyer des requêtes API Claude Messages à CometAPI depuis Cowork, Projects et les workflows desktop pris en charge. Références officielles :
L’inférence tierce de Claude Desktop nécessite une gateway compatible Anthropic. CometAPI prend en charge les modèles Claude via l’Anthropic Messages API.
Le contenu que vous envoyez depuis Claude Desktop est traité par CometAPI et le fournisseur de modèles sélectionné. N’envoyez pas de données confidentielles sauf si votre organisation autorise ce workflow.

​
Prérequis

  • Claude Desktop installé depuis claude.com/download
  • Une version de Claude Desktop qui inclut Developer mode et Configure third-party inference
  • Un compte CometAPI avec une clé API active
  • L’accès aux modèles Claude dans CometAPI
  • Un chemin réseau pouvant atteindre https://api.cometapi.com
Commencez depuis l’écran de connexion de Claude Desktop. Si vous vous êtes déjà connecté avec un compte Anthropic, déconnectez-vous avant de configurer l’inférence tierce.

​
Configuration

1

Activer le mode développeur

Ouvrez Claude Desktop et restez sur l’écran de connexion. Dans le menu de l’application, ouvrez Help → Troubleshooting, puis sélectionnez Enable Developer Mode.Sous Windows, le menu peut être difficile à atteindre avant la connexion. Placez le focus sur le champ email, appuyez sur Tab jusqu’à ce que le menu soit sélectionné, puis appuyez sur Enter.
2

Ouvrir les paramètres d’inférence tierce

Une fois le mode développeur activé, ouvrez Developer → Configure third-party inference.La fenêtre de configuration s’ouvre avec plusieurs sections dans la barre latérale gauche. Utilisez la section Connection pour les paramètres CometAPI.
3

Configurer la gateway

Dans la section Connection, saisissez les valeurs CometAPI ci-dessous :
ChampValeur
Fournisseur d’inférenceGateway
GatewayCompatible Anthropic
URL de base de la gatewayhttps://api.cometapi.com
Clé API de la gatewayVotre clé API CometAPI, par exemple <COMETAPI_KEY>
Schéma d’authentification de la gatewayBearer
En-têtes supplémentaires de la gatewayLaisser vide
Conservez l’URL de base exactement comme indiqué. Claude Desktop exige une URL de base HTTPS.La capture d’écran suivante montre la section Connection remplie avec les valeurs CometAPI.Paramètres Connection de Claude Desktop avec l’URL de base de la gateway CometAPI, le champ de clé API et le schéma d’authentification bearer renseignés
4

Ajouter des model IDs

Dans Model list, ajoutez manuellement ces model IDs :
Model IDUsage recommandé
claude-opus-4-7Planification complexe et tâches d’agent
claude-sonnet-4-6Usage desktop général
claude-haiku-4-5-20251001Prompts légers et brouillons rapides
Le premier modèle de la liste devient le modèle par défaut. Placez claude-sonnet-4-6 en premier si vous voulez un modèle par défaut polyvalent.
La disponibilité des modèles peut changer. Si un modèle n’apparaît pas dans Claude Desktop après la configuration, vérifiez l’accès sur la page Modèles de CometAPI.
La capture d’écran suivante montre la liste des modèles avec les trois model IDs Claude configurés pour CometAPI.Liste des modèles de Claude Desktop montrant claude-opus-4-7, claude-sonnet-4-6 et claude-haiku-4-5-20251001 pour CometAPI
5

Appliquer la configuration localement

Cliquez sur Apply locally. Claude Desktop écrit la configuration sélectionnée dans le profil utilisateur local et relance l’application.Si l’application ne se relance pas, quittez complètement Claude Desktop puis rouvrez-le.
6

Démarrer une session Cowork

Sur l’écran de connexion, choisissez l’option pour Cowork sur une inférence tierce. Ouvrez Cowork ou Projects, sélectionnez l’un des modèles Claude configurés, puis envoyez un court Prompt de test.Une réponse réussie confirme que Claude Desktop utilise CometAPI pour les appels de modèle.

​
Vérifier la configuration

Utilisez un Prompt court qui ne nécessite pas d’outils externes : 
Reply with one sentence: Claude Desktop is connected through CometAPI.
Si Claude Desktop renvoie une réponse, alors l’URL de base, la clé API et la liste des modèles sont correctement configurées. La capture d’écran suivante montre une réponse Cowork réussie via CometAPI. Réponse Cowork de Claude Desktop utilisant CometAPI après la configuration de l’inférence tierce Pour inspecter les paramètres détectés, ouvrez Help → Troubleshooting → Copy Managed Configuration Report. Les valeurs secrètes sont masquées dans le rapport copié.

​
Résolution des problèmes

Vérifiez que vous avez sélectionné Help → Troubleshooting → Enable Developer Mode. Ensuite, quittez complètement Claude Desktop puis rouvrez-le.Si l’option est absente, installez une version de Claude Desktop qui inclut la configuration d’inférence tierce.
Vérifiez les éléments suivants :
  • Inference provider est défini sur Gateway.
  • Gateway base URL est https://api.cometapi.com.
  • Gateway API key contient votre clé API CometAPI sans espaces supplémentaires.
  • Vous avez cliqué sur Apply locally et complètement redémarré Claude Desktop.
Vérifiez que l’URL de base commence par https://. Claude Desktop n’accepte pas les URLs de gateway en HTTP simple.Vérifiez également que votre compte CometAPI a accès aux modèles Claude et que la clé API n’a pas été supprimée ni désactivée.
Rouvrez Developer → Configure third-party inference et vérifiez les entrées de Model list. Les model IDs doivent correspondre exactement aux IDs exposés par CometAPI.Ajoutez chaque model ID comme une entrée distincte. N’incluez ni guillemets, ni virgules, ni espaces supplémentaires dans les champs de l’interface.
L’inférence tierce de Claude Desktop attend une gateway compatible Anthropic pour ce flux. Utilisez https://api.cometapi.com et les model IDs Claude listés ci-dessus.
L’onglet Code utilise le moteur Claude Code à l’intérieur de Claude Desktop. Certains paramètres desktop peuvent ne pas s’appliquer aux sessions Code de la même manière qu’ils s’appliquent à Cowork.Pour une utilisation autonome en terminal, consultez le guide d’intégration Claude Code.