> ## 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.
# Configuration avancée de CC Switch pour les fournisseurs BetterToken
> Gérez dans CC Switch les fournisseurs BetterToken, les mappages de modèles et les paramètres de proxy pour Claude Code, Claude Desktop, Codex CLI, OpenCode et OpenClaw.
CC Switch est une application de bureau multiplateforme qui gère les fournisseurs pour Claude Code, Claude Desktop, Codex, OpenCode et OpenClaw. Cette page centralise la configuration avancée. Commencez par la page de configuration directe de chaque outil, puis utilisez CC Switch uniquement si vous devez changer de fournisseur ou exécuter un modèle non natif.
## Installer CC Switch
Homebrew est la solution la plus simple. Vous pouvez aussi télécharger le dernier `.dmg` ou `.zip` depuis les [versions GitHub](https://github.com/farion1231/cc-switch/releases).
```bash theme={null}
brew tap farion1231/ccswitch
brew install --cask cc-switch
```
Téléchargez le dernier programme d’installation `CC-Switch-v{version}-Windows.msi` ou la version portable `.zip` depuis les [versions GitHub](https://github.com/farion1231/cc-switch/releases).
Téléchargez la dernière version `.deb`, `.rpm` ou `.AppImage` depuis les [versions GitHub](https://github.com/farion1231/cc-switch/releases).
## Éléments à préparer
* BetterToken API Key (inscrivez-vous pour l’obtenir)
* Claude Code utilise le protocole Anthropic ; sa `Base URL` est donc `https://www.bettertoken.ai`
* Claude Desktop avec un fournisseur autre que Claude nécessite la version la plus récente de Claude Desktop et CC Switch `v3.16.5` ou ultérieure
* Codex, OpenCode et OpenClaw utilisent le protocole OpenAI compatible ; leur `Base URL` est donc `https://www.bettertoken.ai/v1`
* Préparez un model ID actuel du **fournisseur GPT** pour Codex, OpenCode et OpenClaw. Vous pouvez le copier depuis le model plaza BetterToken, ou laisser CC Switch le récupérer depuis `/v1/models`
Au premier lancement, CC Switch importe automatiquement les configurations déjà présentes sur votre machine. Vous pouvez conserver votre fournisseur officiel comme solution de repli et ajouter BetterToken à côté.
BetterToken propose deux modes d’accès : Anthropic et OpenAI compatible. Pour ne pas mélanger `https://www.bettertoken.ai` et `https://www.bettertoken.ai/v1`, créez plutôt un fournisseur par application que de tenter de regrouper Claude Code et les outils OpenAI compatibles dans un fournisseur universel.
## Ajouter un fournisseur BetterToken
Ouvrez CC Switch, passez à **Claude Code** et cliquez sur **Add Provider**.
* **Provider Name** : `BetterToken-claude` (ou un autre nom permettant d’identifier facilement le fournisseur)
* **Base URL**: `https://www.bettertoken.ai`
* **API Key** : votre BetterToken API Key
* **API Format**: `OpenAI Responses API`
Les repères numérotés de la capture correspondent à ces champs :
1. **Provider Name**
2. **API Key**
3. **Base URL**
* Avec le **fournisseur Claude**, vous n’avez généralement pas besoin de modifier les options avancées ni le mappage de modèles
* Avec le **fournisseur GPT**, effectuez la configuration supplémentaire ci-dessous :
1. Ouvrez **Advanced Options**
2. Réglez **API Format** sur **OpenAI Responses API**
3. Dans **Model Mapping**, cliquez sur **Fetch Model List**
4. Choisissez explicitement une valeur dans les listes déroulantes pour **Primary Model**, **Thinking Model**, **Haiku Default Model**, **Sonnet Default Model** et **Opus Default Model**
Tous ces modèles doivent utiliser des model ID actuels du **fournisseur GPT** depuis le model plaza BetterToken.
Après l’enregistrement, revenez à la liste des fournisseurs :
1. Marquez le fournisseur BetterToken comme actif
2. Avec le **fournisseur Claude**, vous n’avez pas besoin d’activer le **CC Switch proxy** depuis le coin supérieur gauche
3. Avec le **fournisseur GPT**, activez le **CC Switch proxy**
La capture ci-dessous montre BetterToken-claude activé dans la liste des fournisseurs. Activez le **CC Switch proxy** depuis le coin supérieur gauche uniquement avec le **fournisseur GPT**.
Cet onglet est destiné à GPT, Kimi, GLM et aux autres fournisseurs non-Claude. Pour le fournisseur Claude, utilisez la [configuration directe de Claude Desktop](/fr/faq/claude-desktop-bettertoken-api).
Ouvrez CC Switch, sélectionnez l’icône **Claude Desktop** dans la barre d’outils supérieure, puis cliquez sur **+** en haut à droite.
* **Provider Name** : utilisez un nom identifiable comme `BetterToken-GPT`
* **API Key** : votre BetterToken API Key
* **API Endpoint**: `https://www.bettertoken.ai`
Sélectionnez **OpenAI Responses API (Requires routing)** pour **API Format**, puis cliquez sur **Fetch Models**.
Mappez Sonnet, Opus, Fable et Haiku vers le model ID que vous souhaitez utiliser :
| Rôle du modèle | Modèle demandé |
| -------------- | --------------- |
| Sonnet | `YOUR_MODEL_ID` |
| Opus | `YOUR_MODEL_ID` |
| Fable | `YOUR_MODEL_ID` |
| Haiku | `YOUR_MODEL_ID` |
Copiez un model ID actuel depuis le model plaza ou la boîte de dialogue **Setup** de l’API Key. Activez **Declare 1M** uniquement si le model plaza indique que ce modèle prend en charge une fenêtre de contexte de 1M.
Enregistrez le fournisseur, définissez-le sur **In use**, puis activez le commutateur de proxy dans le coin supérieur gauche.
Quittez complètement Claude Desktop, puis rouvrez-le. **Gateway** en bas à gauche confirme que la configuration est active. Choisissez un modèle mappé dans le menu des modèles de la zone de message.
Ouvrez CC Switch, passez à **Codex** et cliquez sur **Add Provider**. Si CC Switch vous demande d’abord de choisir un préréglage, privilégiez **OpenAI Compatible** ou **Custom**.
Les repères numérotés de la capture correspondent à ces actions :
1. Passez à **Codex**
2. Cliquez sur **Add Provider** en haut à droite
* **Provider Name**: `BetterToken`
* **Base URL**: `https://www.bettertoken.ai/v1`
* **API Key** : votre BetterToken API Key
Si vous passez à une vue de configuration personnalisée, vérifiez que la configuration sous-jacente utilise `wire_api = "responses"`.
Les repères numérotés de la capture correspondent à ces champs :
1. **Provider Name**
2. **API Key**
3. **Base URL**
Cliquez sur **Fetch Models** et choisissez un Model ID actuel dans le model plaza. Codex ne nécessite pas le CC Switch proxy.
Enregistrez le fournisseur et basculez Codex vers BetterToken. CC Switch écrit pour vous les fichiers d’authentification et de configuration Codex correspondants.
Après l’enregistrement, revenez à la liste et vérifiez que l’entrée BetterToken est marquée **In Use**.
Ouvrez CC Switch, passez à **OpenCode** et cliquez sur **Add Provider**. Si CC Switch demande d’abord un préréglage, privilégiez **OpenAI Compatible** ou **Custom**.
* **Provider Name**: `BetterToken`
* **Base URL**: `https://www.bettertoken.ai/v1`
* **API Key** : votre BetterToken API Key
* **API Format**: `OpenAI Compatible`
Utilisez **Fetch Models** lorsque possible. Si vous devez saisir le modèle manuellement, utilisez un model ID actuel du **fournisseur GPT** dans le model plaza BetterToken.
OpenCode lit directement la configuration du fournisseur enregistrée et ne nécessite pas le CC Switch proxy.
Enregistrez le fournisseur et basculez OpenCode vers BetterToken.
Ouvrez CC Switch, passez à **OpenClaw** et cliquez sur **Add Provider**. Si CC Switch demande d’abord un préréglage, privilégiez **OpenAI Compatible** ou **Custom**.
* **Provider Name**: `BetterToken`
* **Base URL**: `https://www.bettertoken.ai/v1`
* **API Key** : votre BetterToken API Key
* **API Format**: `OpenAI Responses API`
Si vous modifiez une configuration de fournisseur OpenClaw personnalisée, vérifiez que `api` est réglé sur `openai-responses`.
Utilisez **Fetch Models** lorsque possible. Si vous devez saisir le modèle manuellement, utilisez un model ID actuel du **fournisseur GPT**.
OpenClaw utilise directement la configuration du fournisseur enregistrée et ne nécessite pas le CC Switch proxy.
Enregistrez le fournisseur et basculez OpenClaw vers BetterToken.
## Appliquer les modifications enregistrées
Après avoir enregistré et changé de fournisseur, redémarrez le client ou la passerelle concerné avant de vérifier la configuration.
* Claude Code : quittez complètement la session Claude Code actuelle, puis redémarrez-la.
* Claude Desktop : quittez complètement l’application, rouvrez-la et vérifiez que **Gateway** apparaît en bas à gauche.
* Codex : redémarrez le processus Codex actuel ou ouvrez une nouvelle session de terminal.
* OpenCode : quittez la session OpenCode actuelle, puis redémarrez-la.
* OpenClaw : exécutez `openclaw gateway restart`, puis utilisez `/new`, `/status` et `/model` dans Discord.
## Fonctions avancées propres à CC Switch
CC Switch peut conserver la connexion officielle à Codex lors du passage à un fournisseur tiers et regrouper les sessions officielles et tierces dans un même historique. Redémarrez Codex après avoir activé ces options. Consultez [conserver la connexion officielle à Codex et l’historique de session unifié](/fr/faq/codex/official-login-third-party-api).
## Problèmes courants
* N’ajoutez pas `/v1` à la `Base URL` de Claude Code
* Lorsque Claude Code utilise le **fournisseur GPT**, définissez **API Format** sur **OpenAI Responses API** dans **Advanced Options**
* Lorsque Claude Code utilise le **fournisseur Claude**, il n’est pas nécessaire d’activer le **CC Switch proxy**
* Lorsque Claude Desktop utilise un fournisseur autre que Claude, activez le **CC Switch proxy** et redémarrez complètement l’application
* Codex, OpenCode et OpenClaw doivent utiliser `https://www.bettertoken.ai/v1`
* Lorsque Codex, OpenCode ou OpenClaw demande un modèle, utilisez un model ID du **fournisseur GPT**
* Si **Fetch Models** échoue, vérifiez l’API Key et la `Base URL`, puis collez le model ID manuellement
* Si le changement n’est pas appliqué, vérifiez que BetterToken est le fournisseur actif dans CC Switch et redémarrez le client ou la passerelle concerné comme décrit ci-dessus
## Pages associées
* Détails de Claude Code : [Claude Code](/fr/ai-tools/claude-code)
* Configuration directe du fournisseur Claude pour Claude Desktop : [Claude Desktop](/fr/faq/claude-desktop-bettertoken-api)
* Détails de Codex : [Codex](/fr/ai-tools/codex)
* Détails d’OpenCode : [OpenCode](/fr/ai-tools/opencode)
* Détails d’OpenClaw : [OpenClaw](/fr/ai-tools/openclaw)
## FAQ associée
* [Utiliser des modèles tiers et Codex dans Claude Desktop](/fr/faq/claude-desktop/third-party-models)
* [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)