> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Utiliser Claude Desktop avec CometAPI

> Utilisez ce guide pour configurer Claude Desktop avec CometAPI en définissant l’URL de base, la clé API et les options de modèle ou de fournisseur.

Utilisez ce guide pour connecter l’inférence tierce Cowork sur Claude Desktop à CometAPI. Cette configuration permet à Claude Desktop d’envoyer des requêtes de l’API Claude Messages à CometAPI depuis Cowork, Projects et les workflows desktop pris en charge.

Références officielles :

* [Installation et configuration de Claude Desktop](https://claude.com/docs/cowork/3p/installation)
* [Configuration de la passerelle Claude Desktop](https://claude.com/docs/cowork/3p/gateway)
* [Référence de configuration de Claude Desktop](https://claude.com/docs/cowork/3p/configuration)

<Note>
  L’inférence tierce de Claude Desktop nécessite une passerelle compatible Anthropic. CometAPI prend en charge les modèles Claude via l’[Anthropic Messages API](/api/text/anthropic-messages).
</Note>

<Warning>
  Le contenu que vous envoyez depuis Claude Desktop est traité par CometAPI et le fournisseur de modèle sélectionné. N’envoyez pas de données confidentielles sauf si votre organisation autorise ce workflow.
</Warning>

## Prérequis

* Claude Desktop installé depuis [claude.com/download](https://claude.com/download)
* Une version de Claude Desktop qui inclut le **mode développeur** et **Configurer l’inférence tierce**
* Un compte CometAPI avec une clé API active
* Accès aux modèles Claude dans CometAPI
* Un chemin réseau permettant d’atteindre `https://api.cometapi.com`

Commencez depuis l’écran de connexion de Claude Desktop. Si vous êtes déjà connecté avec un compte Anthropic, déconnectez-vous avant de configurer l’inférence tierce.

## Configuration

<Steps>
  <Step title="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 d’accès 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`.
  </Step>

  <Step title="Ouvrir les paramètres d’inference tiers">
    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 de gauche. Utilisez la section **Connection** pour les paramètres CometAPI.
  </Step>

  <Step title="Configurer la passerelle">
    Dans la section **Connection**, saisissez les valeurs CometAPI ci-dessous :

    | Champ                 | Valeur                                              |
    | --------------------- | --------------------------------------------------- |
    | Inference provider    | Gateway                                             |
    | Gateway               | Anthropic-compatible                                |
    | Gateway base URL      | `https://api.cometapi.com`                          |
    | Gateway API key       | Votre clé API CometAPI, par exemple `$COMETAPI_KEY` |
    | Gateway auth scheme   | Bearer                                              |
    | Gateway extra headers | Laisser vide                                        |

    Conservez la base URL exactement comme indiqué. Claude Desktop exige une base URL en HTTPS.

    La capture d’écran suivante montre la section Connection remplie avec les valeurs CometAPI.

    <img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-connection.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=879de5e2a4587861f220a7f6e0f7d2a5" alt="Paramètres Connection de Claude Desktop avec la base URL de passerelle CometAPI, le champ de clé API et le schéma d’authentification bearer renseignés" width="1800" height="1440" data-path="images/integrations/claude-desktop-cometapi-connection.png" />
  </Step>

  <Step title="Ajouter des model IDs">
    Dans **Model list**, ajoutez manuellement ces model IDs :

    | Model ID                    | Utilisation recommandée                  |
    | --------------------------- | ---------------------------------------- |
    | `claude-opus-4-7`           | Planification complexe et tâches d’agent |
    | `claude-sonnet-4-6`         | Usage général sur ordinateur             |
    | `claude-haiku-4-5-20251001` | Prompts 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.

    <Tip>
      La disponibilité des modèles peut changer. Si un modèle n’apparaît pas dans Claude Desktop après la configuration, vérifiez votre accès sur la [page des modèles CometAPI](/fr/overview/models).
    </Tip>

    La capture d’écran suivante montre la liste des modèles avec les trois model IDs Claude configurés pour CometAPI.

    <img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-model-list.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=63dcdfe05db59c09782e1514e09a734d" alt="Liste des modèles de Claude Desktop affichant claude-opus-4-7, claude-sonnet-4-6 et claude-haiku-4-5-20251001 pour CometAPI" width="1764" height="1278" data-path="images/integrations/claude-desktop-cometapi-model-list.png" />
  </Step>

  <Step title="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 redémarre pas, quittez complètement Claude Desktop et ouvrez-le de nouveau.
  </Step>

  <Step title="Démarrer une session Cowork">
    Sur l’écran de connexion, choisissez l’option Cowork sur third-party inference. 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.
  </Step>
</Steps>

## Vérifier la configuration

Utilisez un court Prompt qui ne nécessite pas d’outils externes :

```text theme={null}
Reply with one sentence: Claude Desktop is connected through CometAPI.
```

Si Claude Desktop renvoie une réponse, cela signifie que la base URL, 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.

<img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-chat.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=93bb3b1a60de0d7edbd25cb6ba3b58d8" alt="Réponse Cowork de Claude Desktop utilisant CometAPI après la configuration de third-party inference" width="2880" height="1600" data-path="images/integrations/claude-desktop-cometapi-chat.png" />

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é.

## Dépannage

<AccordionGroup>
  <Accordion title="Le menu développeur n’apparaît pas">
    Vérifiez que vous avez sélectionné **Help** → **Troubleshooting** → **Enable Developer Mode**. Ensuite, quittez complètement Claude Desktop et rouvrez-le.

    Si l’option est absente, installez une version de Claude Desktop qui inclut la configuration de l’inference tierce.
  </Accordion>

  <Accordion title="Claude Desktop ouvre le flux de connexion standard">
    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 redémarré complètement Claude Desktop.
  </Accordion>

  <Accordion title="La validation de la connexion échoue">
    Vérifiez que l’URL de base commence par `https://`. Claude Desktop n’accepte pas les URL 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 ou désactivée.
  </Accordion>

  <Accordion title="Les modèles configurés n’apparaissent pas">
    Rouvrez **Developer** → **Configure third-party inference** et vérifiez les entrées de la **Model list**. Les model ID doivent correspondre aux ID 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.
  </Accordion>

  <Accordion title="Une URL de base compatible OpenAI ne fonctionne pas">
    L’inference tierce de Claude Desktop attend une gateway compatible Anthropic pour ce flux. Utilisez `https://api.cometapi.com` et les model ID Claude listés ci-dessus.
  </Accordion>

  <Accordion title="L’onglet Code se comporte différemment">
    L’onglet Code utilise le moteur Claude Code dans Claude Desktop. Certains paramètres du bureau peuvent ne pas s’appliquer aux sessions Code de la même manière qu’aux sessions Cowork.

    Pour une utilisation autonome dans le terminal, consultez le [guide d’intégration Claude Code](/fr/integrations/claude-code).
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#howto",
        "name": "Utiliser Claude Desktop avec CometAPI",
        "description": "Utilisez ce guide pour configurer Claude Desktop avec CometAPI en définissant l’URL de base, la clé API et les options de modèle ou de fournisseur.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-1",
            "position": 1,
            "name": "Activer le mode développeur",
            "text": "Effectuez l’étape Activer le mode développeur dans le guide Utiliser Claude Desktop avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-2",
            "position": 2,
            "name": "Ouvrir les paramètres d’inference tierce",
            "text": "Effectuez l’étape Ouvrir les paramètres d’inference tierce dans le guide Utiliser Claude Desktop avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-3",
            "position": 3,
            "name": "Configurer la gateway",
            "text": "Effectuez l’étape Configurer la gateway dans le guide Utiliser Claude Desktop avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-4",
            "position": 4,
            "name": "Ajouter les model ID",
            "text": "Effectuez l’étape Ajouter les model ID dans le guide Utiliser Claude Desktop avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-5",
            "position": 5,
            "name": "Appliquer la configuration localement",
            "text": "Effectuez l’étape Appliquer la configuration localement dans le guide Utiliser Claude Desktop avec CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-6",
            "position": 6,
            "name": "Démarrer une session Cowork",
            "text": "Effectuez l’étape Démarrer une session Cowork dans le guide Utiliser Claude Desktop avec CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentation CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Intégrations",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Utiliser Claude Desktop avec CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/claude-desktop"
          }
        ]
      }
    ]
    }
    `}
</script>