Documentation Index
Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
Use this file to discover all available pages before exploring further.
Introduction
CC-Switch est une application de bureau open source qui unifie la gestion des configurations de fournisseurs d’API sur plusieurs outils CLI de codage IA tels que Claude Code, Codex et Gemini CLI. Elle transforme l’édition fastidieuse de fichiers de configuration en quelques clics dans une interface graphique — une fois qu’un fournisseur est ajouté, vous pouvez basculer instantanément entre les services API, sans avoir à éditer les fichiers de configuration à la main. En connectant APIMart via CC-Switch, vous pouvez facilement configurer le service APIMart pour Claude Code et Codex, et basculer librement entre plusieurs fournisseurs.Prérequis
Avant de commencer, assurez-vous d’avoir :- Un outil CLI pris en charge installé Au moins un outil CLI pris en charge installé, comme Claude Code ou Codex CLI
-
Obtenu une clé API APIMart
Connectez-vous à la console APIMart pour obtenir votre clé API (commence par
sk-)
Astuce : si vous n’avez pas encore de compte APIMart, inscrivez-vous d’abord sur APIMart et obtenez votre clé API.
Étape 1 : Installer CC-Switch
Choisissez la méthode d’installation selon votre système d’exploitation :- macOS
- Windows
- Linux
Installer via Homebrew (recommandé) :Vous pouvez également télécharger l’installeur
.dmg depuis les GitHub Releases. CC-Switch est signé et notarisé par Apple, donc il peut être installé directement (nécessite macOS 12 ou plus récent).Au premier lancement, CC-Switch détecte automatiquement les outils CLI installés sur votre machine et peut importer les configurations existantes comme fournisseurs par défaut.
Étape 2 : Ajouter le fournisseur APIMart
En haut de la fenêtre principale de CC-Switch, vous pouvez basculer entre différents groupes d’outils CLI. Suivez les étapes ci-dessous selon l’outil que vous voulez configurer.- Configurer pour Claude Code
- Configurer pour Codex
1. Basculer vers le groupe Claude CodeSélectionnez Claude Code en haut de la fenêtre principale.2. Ouvrir le panneau d’ajout de fournisseurCliquez sur le bouton + dans le coin supérieur droit de la fenêtre principale.3. Remplir les détails du fournisseurRemplissez le formulaire comme suit :

4. Sauvegarder la configurationCliquez sur Add pour sauvegarder. APIMart apparaîtra dans la liste des fournisseurs.
| Champ | Valeur | Description |
|---|---|---|
| Name | APIMart | Libellé personnalisé pour identification |
| Endpoint URL | https://api.apimart.ai | URL de base de l’API APIMart |
| API Key | sk-xxxxxxxxxxxx | Votre clé API APIMart |
| API Format | Anthropic Messages | Conservez le format natif Anthropic par défaut |

À propos de l’URL du point de terminaison : Claude Code utilise le format natif Anthropic avec l’URL
https://api.apimart.ai (sans /v1) ; Codex utilise le format compatible OpenAI avec l’URL https://api.apimart.ai/v1 (avec
/v1). Ne les confondez pas.Étape 3 : Basculer entre les fournisseurs
Une fois ajouté, vous pouvez basculer entre APIMart et d’autres fournisseurs à tout moment :Basculer dans la fenêtre principale
- Sélectionnez APIMart dans la liste des fournisseurs
- Cliquez sur le bouton Enable (ou Use)
- Un toast « Switched successfully » confirme le changement

Basculer depuis la barre des tâches système
CC-Switch reste dans la barre des tâches système, vous pouvez donc basculer sans ouvrir la fenêtre principale :- Cliquez sur l’icône CC-Switch dans la barre des tâches système
- Cliquez sur le nom du fournisseur cible dans le menu — cela prend effet immédiatement
À propos de l’activation : Claude Code prend en charge le hot-switching — les nouvelles sessions reprennent automatiquement la nouvelle configuration. Après avoir basculé pour Codex, vous devez redémarrer le terminal ou Codex pour que le changement prenne effet.
Modèles pris en charge
Après avoir basculé vers le fournisseur APIMart, vous pouvez utiliser différents modèles dans l’outil CLI correspondant :| ID du modèle | Points forts | Cas d’utilisation recommandés |
|---|---|---|
claude-opus-4-6 | Le plus puissant globalement | Architecture complexe, débogage difficile |
claude-sonnet-4-6 | Performance & vitesse équilibrées | Codage quotidien, génération de code |
gpt-5.5 | Excellentes compétences en codage | Tâches d’ingénierie complexes |
gpt-4o | Haute performance, rapide | Codage quotidien, itération rapide |
FAQ
Q1 : Le changement de fournisseur ne prend pas effet ?
- Claude Code : prend en charge le hot-switching — démarrez une nouvelle session ; si cela ne fonctionne toujours pas, redémarrez Claude Code
- Codex : après le changement, redémarrez le terminal ou Codex
Q2 : La clé API est signalée comme invalide ?
- Assurez-vous que la clé API commence par
sk-et est copiée entièrement sans espaces supplémentaires - Allez dans la console APIMart pour confirmer que la clé est active
- Vérifiez que l’URL du point de terminaison est correcte (Claude Code utilise
https://api.apimart.ai, Codex utilisehttps://api.apimart.ai/v1)
Q3 : Erreur de format lors de l’ajout d’un fournisseur Codex ?
CC-Switch valideauth.json (syntaxe JSON) et config.toml (syntaxe TOML). Vérifiez que :
- Les crochets, guillemets et virgules dans le JSON sont complets
- Aucun guillemet pleine largeur / intelligent n’est utilisé
- Les noms de champs dans le TOML sont écrits correctement
Q4 : Quels fichiers CC-Switch modifie-t-il ?
CC-Switch écrit dans les fichiers de configuration de chaque outil :- Claude Code :
~/.claude/settings.json - Codex :
~/.codex/config.tomlet~/.codex/auth.json
Q5 : Comment consulter l’utilisation et la facturation de l’API ?
Connectez-vous à la console APIMart pour consulter les statistiques d’appels API, les détails de consommation des tokens et les tendances des coûts.Support et aide
Si vous rencontrez des problèmes lors de l’utilisation de CC-Switch :- 📚 Centre de documentation APIMart
- 📚 Page du projet CC-Switch
- 💬 Communauté Discord
- 🐦 Twitter @APIMart_
- 📧 Support technique : zhihong@apimart.ai
Commencer avec APIMart
Inscrivez-vous à APIMart maintenant, obtenez votre clé API et gérez plusieurs outils de codage IA sans effort dans CC-Switch !