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

# Configurer Roo Code : installation, API Key, Base URL et modèles personnalisés

> Installez Roo Code, configurez la Base URL et l’API Key BetterToken, choisissez un modèle d’un fournisseur compatible et résolvez les erreurs courantes.

Pour connecter Roo Code à BetterToken, préparez une API Key, saisissez la Base URL ci-dessous et choisissez un Model ID actuel dans le model plaza.

## Paramètres principaux

| Champ    | Valeur                                                                           |
| -------- | -------------------------------------------------------------------------------- |
| API Key  | BetterToken API Key                                                              |
| Base URL | `https://www.bettertoken.ai/v1`                                                  |
| Model    | Un Model ID actuel du <a href={"https://bettertoken.ai/pricing"}>model plaza</a> |

## Prérequis

* La version actuelle de l’outil est installée
* Une BetterToken API Key : <a href={"https://bettertoken.ai/register"}>inscrivez-vous pour en obtenir une</a>
* Un Model ID du <a href={"https://bettertoken.ai/pricing"}>model plaza</a>

### Exigences supplémentaires

* VS Code est installé

## Installation

### Installer Roo Code

Ouvrez VS Code, recherchez **Roo Code** dans la marketplace des extensions et installez-le.

## Configuration manuelle

Effectuez cette configuration dans l’interface des paramètres Roo Code. Vous n’avez pas besoin de modifier de fichier de configuration.

| Champ    | Valeur                                                                           |
| -------- | -------------------------------------------------------------------------------- |
| API Key  | BetterToken API Key                                                              |
| Base URL | `https://www.bettertoken.ai/v1`                                                  |
| Model    | Un Model ID actuel du <a href={"https://bettertoken.ai/pricing"}>model plaza</a> |

### Configuration

<Steps>
  <Step title="Effacer les variables d’environnement en conflit">
    ```bash theme={null}
    unset OPENAI_API_KEY
    unset OPENAI_BASE_URL
    ```
  </Step>

  <Step title="Ouvrir les paramètres Roo Code">
    Ouvrez le panneau **Settings** de Roo Code.
  </Step>

  <Step title="Configurer le fournisseur d’API">
    Renseignez :

    * **API Provider** → `OpenAI Compatible`
    * **Base URL** → `https://www.bettertoken.ai/v1`
    * **API Key** → votre BetterToken API Key
    * **Model** → un **model ID d’un fournisseur compatible** copié depuis le <a href={"https://bettertoken.ai/pricing"}>model plaza</a>
  </Step>

  <Step title="Configurer des en-têtes supplémentaires uniquement si la documentation officielle l’exige explicitement">
    La documentation officielle Roo Code consultée se concentre sur la configuration d’API OpenAI compatible ou personnalisée, mais ne traite pas un `User-Agent` supplémentaire comme une étape obligatoire pour BetterToken.

    Si vous utilisez aussi une passerelle personnalisée, un routage de locataire, une couche d’observabilité ou de cache, ajoutez des en-têtes uniquement selon la documentation officielle de ce service en amont.
  </Step>

  <Step title="Enregistrer et commencer à l’utiliser">
    Cliquez sur **Save** et **Done**, puis sélectionnez le modèle configuré.
  </Step>

  <Step title="Redémarrer Roo Code">
    Après avoir enregistré la configuration, redémarrez VS Code ou rechargez l’extension Roo Code avant de sélectionner le modèle configuré.
  </Step>
</Steps>

<Note>
  Le fournisseur OpenAI Compatible de Roo Code dépend toujours des appels d’outils au format OpenAI. Si vous avez besoin d’en-têtes supplémentaires, suivez la documentation actuelle de Roo Code ou les exigences de votre passerelle en amont au lieu de supposer que `User-Agent` est obligatoire pour BetterToken.
</Note>

## Vérifier la connexion

Envoyez un court prompt de test. Si l’outil renvoie une réponse sans erreur d’authentification ni erreur de Model ID, la connexion fonctionne. Redémarrez complètement l’outil après avoir modifié sa configuration.

## Changer de modèle

Ouvrez le sélecteur de modèle ou modifiez le champ `Model` dans la configuration. Utilisez le Model ID exact du <a href={"https://bettertoken.ai/pricing"}>model plaza</a>, puis redémarrez la session actuelle.

## Erreurs courantes

| Erreur                                   | Vérifications                                                                |
| ---------------------------------------- | ---------------------------------------------------------------------------- |
| `401` ou `Unauthorized`                  | Vérifiez la BetterToken API Key et supprimez les espaces initiaux ou finaux. |
| `404`                                    | Vérifiez la Base URL et n’ajoutez pas de chemin d’endpoint spécifique.       |
| `model not found`                        | Copiez un Model ID actuel depuis le model plaza.                             |
| Les modifications ne sont pas appliquées | Enregistrez la configuration et redémarrez complètement l’outil.             |

* [API OpenAI compatible et API Anthropic compatible](/fr/faq/concepts/openai-compatible-vs-anthropic-compatible)
* [MCP, API Key et Base URL](/fr/faq/concepts/mcp-vs-api-key-base-url)
* [Que sont model\_provider, base\_url et wire\_api ?](/fr/faq/codex/model-provider-base-url-wire-api)
* [Configurer une API OpenAI compatible dans Cline](/fr/faq/cline/openai-compatible-api)

## Configuration avancée

### Fournisseurs compatibles

| Fournisseur | État                   |
| ----------- | ---------------------- |
| Claude      | Non compatible         |
| GPT         | Configuration manuelle |
| Kimi        | Configuration manuelle |
| GLM         | Configuration manuelle |

<Note>Les états concernent la méthode de configuration de BetterToken décrite sur cette page.</Note>

<Accordion title="Signification des méthodes de configuration">
  * **Configuration manuelle** : saisissez l’API Key, la Base URL et le Model.
  * **Non compatible** : aucune méthode de connexion directe vérifiée n’est disponible pour le moment.
</Accordion>

## Détails techniques

<Accordion title="Protocole, endpoint et champs internes du fournisseur">
  Cette configuration utilise `https://www.bettertoken.ai/v1`. L’outil ajoute le chemin d’endpoint OpenAI compatible. N’ajoutez pas `/chat/completions` ni `/responses` sauf si un champ spécifique l’exige explicitement.
</Accordion>