Configurer le fournisseur de modèles

Nous recommandons d’utiliser CC Switch pour la configuration — un outil open source de gestion des fournisseurs avec une interface visuelle, sans besoin de modifier manuellement des fichiers JSON ou des variables d’environnement.

1. Installer CC Switch

macOS


brew install --cask cc-switch

Ou rendez-vous sur la page Releases pour télécharger le fichier .dmg et installer manuellement.

Windows

Rendez-vous sur la page Releases pour télécharger l’installateur .msi.

Linux


# Debian / Ubuntu
sudo dpkg -i CC-Switch-*.deb
 
# Fedora / RHEL
sudo rpm -i CC-Switch-*.rpm
 
# AppImage
chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

Compatible avec macOS 12+, Windows 10+, Ubuntu 22.04+ / Debian 11+ / Fedora 34+

2. Ajouter le fournisseur OfoxAI

Étape 1 : Ajouter un nouveau fournisseur

Ouvrez CC Switch, accédez à la page de gestion des fournisseurs et cliquez sur le bouton + en haut à droite.

Étape 2 : Remplir la configuration

Remplissez les champs comme indiqué ci-dessous, puis cliquez sur + Ajouter pour terminer.

Champ	Valeur	Description
❶ Nom du fournisseur	`ofoxai-claude`	Personnalisable, pour faciliter l’identification
❷ Site web	`https://ofox.ai`	Site officiel du fournisseur
❸ API Key	Votre clé API OfoxAI	Obtenez-la sur app.ofox.ai
❹ URL de requête	`https://api.ofox.ai/anthropic`	Ne pas ajouter de barre oblique finale
❺ Format API / Champ d’authentification	`Anthropic Messages (natif)` / `ANTHROPIC_AUTH_TOKEN (par défaut)`	Conserver les valeurs par défaut
❻ Configuration du modèle	Laisser vide	Laisser vide pour utiliser le modèle Claude par défaut
❼ Options	Cocher « Masquer la signature AI » et « Mode Teammates »	Cocher selon vos besoins
❽ Écrire dans la configuration globale	✅ Cocher	Écrit dans la configuration globale, applicable à tous les projets

CC Switch écrit automatiquement dans ~/.claude/settings.json, sans modification manuelle de fichier.

Étape 3 : Activer le fournisseur

De retour à la liste, sélectionnez ofoxai-claude et cliquez sur le bouton Utiliser. Le message « Changement réussi » confirme l’activation.

3. Vérifier la configuration

Accédez au répertoire de votre projet et lancez Claude Code :


cd your-project
claude

Au premier lancement, appuyez sur Esc pour passer la connexion. Après le démarrage, vérifiez la barre d’information en haut et confirmez que API Usage Billing (❶) est affiché, indiquant la facturation via OfoxAI :

Si ces informations sont correctes, la configuration est réussie.

Dépannage

En cas de problème, exécutez /status dans le terminal Claude Code pour vérifier la configuration :


/status

Vérifiez les champs clés suivants :

❶ Anthropic base URL doit être https://api.ofox.ai/anthropic
❷ Model affiche le modèle actuellement utilisé

Sortie de la commande /status de Claude Code

Q : Message “Authentication error”

Vérifiez que l’Anthropic base URL est correct et que votre clé API est valide.

Q : Délai de connexion dépassé

Vérifiez que l’URL de requête est https://api.ofox.ai/anthropic, sans barre oblique finale.

Q : Réponse en streaming saccadée

OfoxAI dispose d’une accélération mondiale intégrée. Il s’agit généralement d’un problème de réseau local. Vérifiez votre connexion et réessayez.