---
title: "Intégration avec Cursor"
description: "Appeler les modèles Claude de 1折AI dans Cursor avec une clé API OpenAI personnalisée et une URL de base, ainsi que les fonctionnalités qui n'utilisent pas la clé API personnalisée."
headingIds: {"Configuration":"section-1","Problèmes connus":"section-2","Questions fréquentes":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentation maintenue par [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Sources et corrections](https://1zheai.com/en/editorial/).

Vous avez trouvé une erreur ? [Contactez l'assistance](mailto:support@1zheai.com) en indiquant l'adresse de la page et une description. N'envoyez pas de clés API ni d'identifiants de compte.

</aside>
Cursor permet de renseigner sa propre clé API (API key) dans les paramètres ; les modèles de chat envoient les requêtes avec cette clé API. Voici la procédure d'intégration avec 1折AI, ainsi que plusieurs restrictions à connaître avant de commencer.

<Warning>

Prenez d'abord connaissance de ces trois points avant de vous lancer :

- Selon la documentation officielle de Cursor, **la clé API personnalisée ne s'applique qu'aux modèles de chat ; l'auto-complétion Tab utilise toujours les modèles propres à Cursor**.
- Les requêtes passent d'abord par les serveurs de Cursor avant d'être envoyées à l'adresse que vous avez renseignée ; l'URL de base doit donc être accessible sur Internet public (`https://1zheai.com/v1` convient, un proxy local `localhost` ne convient pas).
- L'interrupteur « Override OpenAI Base URL » n'apparaît pas dans la documentation officielle de Cursor ; la description de l'interface ci-dessous provient du forum Cursor et de tutoriels communautaires, et peut changer après une refonte de Cursor.

</Warning>

## Configuration

<Steps>
<Step title="Ouvrir les paramètres du modèle">

Cursor → **Cursor Settings** → **Models**, localisez la section Keys.

</Step>
<Step title="Renseigner l'OpenAI API Key et l'URL de base">

```text
OpenAI API Key              sk-你的Key（1折AI 的 Key）
Override OpenAI Base URL    https://1zheai.com/v1
```

L'URL de base doit inclure `/v1`.

</Step>
<Step title="Ajouter un modèle">

Dans la liste des modèles, cliquez sur **Add model**, saisissez l'identifiant du modèle, par exemple `claude-sonnet-5-5`, puis activez son interrupteur. Les identifiants de modèles sont listés dans les [modèles pris en charge](/fr/docs/models/).

</Step>
<Step title="Essayer une fois dans le chat">

Sélectionnez le modèle que vous venez d'ajouter dans le panneau Chat et envoyez un message. Une fois la réponse correcte, vérifiez cet appel dans les [journaux d'appel](/fr/docs/usage-logs/) de la console.

</Step>
</Steps>

## Problèmes connus

<Warning>

Des retours sur le forum Cursor indiquent qu'après avoir défini Override OpenAI Base URL, les modèles dont le nom commence par `claude-` peuvent être considérés par Cursor comme des modèles Anthropic, pris en charge par la clé API Anthropic, ou provoquer directement une erreur. Lors du choix de Claude, l'identifiant du modèle commence par `claude-` ; si vous rencontrez ce problème, videz d'abord la clé API Anthropic renseignée dans Cursor, puis réessayez.

Références : [publication du forum 144899](https://forum.cursor.com/t/anthropic-models-break-when-override-openai-baseurl-is-set/144899), [publication du forum 146998](https://forum.cursor.com/t/override-anthropic-base-url-automatically-switches-on-when-using-anthropic-byok/146998).

</Warning>

## Questions fréquentes

<AccordionGroup>
<Accordion title="L'onglet de complétion utilise-t-elle 1折AI ?">

Non. Selon la documentation officielle de Cursor, l'auto-complétion Tab utilise toujours les modèles fournis par Cursor et ne passe pas par votre clé API.

</Accordion>
<Accordion title="Échec du clic sur Verify ?">

Vérifiez d'abord que l'URL de base inclut `/v1`. La communauté signale que le bouton Verify ne passe pas nécessairement pour des noms de modèles non OpenAI ; vous pouvez directement envoyer un message dans le Chat pour tester, en vous basant sur l'enregistrement dans les journaux d'appel.

</Accordion>
<Accordion title="Agent / Composer peuvent-ils être utilisés ?">

Les tutoriels communautaires indiquent généralement que seul le Chat utilise la clé API personnalisée ; des fonctionnalités comme Agent, Apply, Inline Edit peuvent encore passer par le backend propre à Cursor. Faites foi de ce que vous voyez réellement dans les journaux d'appel.

</Accordion>
<Accordion title="Utiliser Claude en entier dans l'éditeur ?">

Si votre objectif principal est d'écrire du code avec Claude, [Claude Code](/fr/docs/quickstart-claude-code/) (ligne de commande ou extension VS Code) et [Cline](/fr/docs/quickstart-cline/) offrent une prise en charge plus complète des adresses personnalisées.

</Accordion>
</AccordionGroup>