Configurer BetterToken dans CC Switch

CC Switch est une application de bureau facultative pour gérer les API Keys, endpoints et modèles de Claude Code, Claude Desktop, Codex CLI, OpenCode et OpenClaw.

Installer CC Switch

macOS

Homebrew est la solution la plus simple. Vous pouvez aussi télécharger le dernier .dmg ou .zip depuis les versions GitHub.

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows

Téléchargez le dernier programme d’installation CC-Switch-v{version}-Windows.msi ou la version portable .zip depuis les versions GitHub.

Linux

Téléchargez la dernière version .deb, .rpm ou .AppImage depuis les versions GitHub.

Éléments à préparer

• BetterToken API Key (inscrivez-vous pour l’obtenir)
• Claude Code utilise le protocole Anthropic ; sa Base URL est donc https://bettertoken.ai
• Codex, OpenCode et OpenClaw utilisent le protocole OpenAI compatible ; leur Base URL est donc https://bettertoken.ai/v1
• Préparez un model ID actuel 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://bettertoken.ai et https://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

Claude Code

Dans CC Switch, sélectionnez Claude Code et cliquez sur Add Provider.

Connectez Claude Code avec votre BetterToken API Key, la Base URL https://bettertoken.ai et le Model ID souhaité.

• Provider Name: BetterToken
• API Key: YOUR_API_KEY
• API Endpoint: https://bettertoken.ai

Utilisez le format Anthropic Messages API. Saisissez les Model ID choisis dans Model Mapping, puis enregistrez.

Copiez le Model ID exact depuis la model plaza.

Enregistrez la configuration, activez BetterToken et redémarrez complètement le client.

Claude Desktop

Claude Desktop prend uniquement en charge les modèles Claude. Il s’agit d’une limitation du client Claude Desktop.

Ouvrez la page distincte Claude Desktop dans CC Switch pour ajouter un fournisseur ou importer des fournisseurs Claude Code existants. Vérifiez les Model ID Claude importés et le mode de connexion avant l’activation ; consultez le manuel officiel Claude Desktop.

Pour configurer directement Claude Desktop, suivez le guide Claude Desktop : sélectionnez Gateway, indiquez la Base URL https://bettertoken.ai, votre BetterToken API Key et Gateway auth scheme x-api-key. Enregistrez avec Apply Changes pour relancer Claude Desktop.

Codex

Dans CC Switch actuel, connectez-vous d’abord au compte officiel pour le conserver. Ouvrez Paramètres → Configuration des applications → Codex, activez Conserver la connexion officielle lors d’un changement sans prise en charge, puis ajoutez ou activez BetterToken. Ne remplacez pas le fichier officiel par une clé tierce.

Ouvrir Codex dans CC Switch et ajouter un fournisseur

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

Remplir les champs principaux

• Provider Name: BetterToken
• Base URL: https://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

Récupérer et mapper un modèle

Cliquez sur Fetch Models et choisissez un Model ID actuel dans le model plaza. Codex ne nécessite pas le CC Switch proxy.

Enregistrer et changer de fournisseur

Enregistrez et activez BetterToken. La clé tierce est écrite dans le provider de config.toml ; le bouton de conservation détermine si le auth.json officiel reste présent.

Après l’enregistrement, revenez à la liste et vérifiez que l’entrée BetterToken est marquée In Use.

OpenCode

Ouvrir OpenCode dans CC Switch et ajouter un fournisseur

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.

Remplir les champs principaux

• Provider Name: BetterToken
• Base URL: https://bettertoken.ai/v1
• API Key : votre BetterToken API Key
• API Format: OpenAI Compatible

Choisir le modèle par défaut

Utilisez Fetch Models lorsque possible. Si vous devez saisir le modèle manuellement, utilisez un model ID actuel dans le model plaza BetterToken.

OpenCode lit directement la configuration du fournisseur enregistrée et ne nécessite pas le CC Switch proxy.

Enregistrer et changer de fournisseur

Ajoutez le fournisseur dans CC Switch, puis sélectionnez le fournisseur BetterToken et le modèle dans OpenCode. CC Switch enregistre ce fournisseur aux côtés de vos autres fournisseurs OpenCode.

OpenClaw

Ouvrir OpenClaw dans CC Switch et ajouter un fournisseur

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.

Remplir les champs principaux

• Provider Name: BetterToken
• Base URL: https://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.

Choisir le modèle par défaut

Utilisez Fetch Models lorsque possible. Si vous devez saisir le modèle manuellement, utilisez un model ID actuel.

OpenClaw utilise directement la configuration du fournisseur enregistrée et ne nécessite pas le CC Switch proxy.

Enregistrer et changer de fournisseur

Ajoutez le fournisseur dans CC Switch, puis sélectionnez le fournisseur BetterToken et le modèle dans OpenClaw. CC Switch enregistre ce fournisseur aux côtés de vos autres fournisseurs OpenClaw.

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 d’un changement direct. Historique unifié des sessions Codex est facultatif et concerne uniquement la liste CLI resume ; inutile pour la version de bureau actuelle. Reprendre une session avec un autre provider peut échouer ; créez une nouvelle session après changement. Voir connexion officielle et historique.

Problèmes courants

• N’ajoutez pas /v1 à la Base URL de Claude Code

• 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://bettertoken.ai/v1

• Lorsque Codex, OpenCode ou OpenClaw demande un modèle, utilisez un model ID

• Si Fetch Models échoue, vérifiez l’API Key et la Base URL, puis collez le model ID manuellement

• Si les changements ne sont pas appliqués, vérifiez que BetterToken est actif dans CC Switch pour Codex, ou sélectionné dans OpenCode/OpenClaw, puis redémarrez le client ou la passerelle concerné comme indiqué ci-dessus

• Si Codex bloque l’envoi après épuisement du quota officiel, conserver la connexion officielle peut maintenir ce blocage. Suivez les instructions de la version officielle : passez en mode direct, désactivez Keep official login for direct switches dans Settings → App config → Codex, activez BetterToken et redémarrez complètement Codex. Ce réglage utilise le mode API Key et rend indisponibles les fonctions qui exigent la connexion officielle ; rétablissez la configuration qui conserve cette connexion lorsque le quota est réinitialisé.

Pages associées

• Détails de Claude Code : Claude Code

• Configuration directe du fournisseur Claude pour Claude Desktop : Claude Desktop

• Détails de Codex : Codex

• Détails d’OpenCode : OpenCode

• Détails d’OpenClaw : OpenClaw

• Comparer tous les outils pris en charge

• Erreurs API, codes de statut et limites de débit

FAQ associée

• Endpoint de Claude Desktop
• API OpenAI compatible et API Anthropic compatible
• MCP, API Key et Base URL
• Que sont model_provider, base_url et wire_api ?
• Configurer une API OpenAI compatible dans Cline