Passer au contenu principal

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 :
  1. Un outil CLI pris en charge installé Au moins un outil CLI pris en charge installé, comme Claude Code ou Codex CLI
  2. 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 :
Installer via Homebrew (recommandé) :
brew tap farion1231/ccswitch
brew install --cask cc-switch
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.
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 :
ChampValeurDescription
NameAPIMartLibellé personnalisé pour identification
Endpoint URLhttps://api.apimart.aiURL de base de l’API APIMart
API Keysk-xxxxxxxxxxxxVotre clé API APIMart
API FormatAnthropic MessagesConservez le format natif Anthropic par défaut
CC-Switch main interface
4. Sauvegarder la configurationCliquez sur Add pour sauvegarder. APIMart apparaîtra dans la liste des fournisseurs.
À 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

  1. Sélectionnez APIMart dans la liste des fournisseurs
  2. Cliquez sur le bouton Enable (ou Use)
  3. Un toast « Switched successfully » confirme le changement
CC-Switch main interface

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 :
  1. Cliquez sur l’icône CC-Switch dans la barre des tâches système
  2. 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èlePoints fortsCas d’utilisation recommandés
claude-opus-4-6Le plus puissant globalementArchitecture complexe, débogage difficile
claude-sonnet-4-6Performance & vitesse équilibréesCodage quotidien, génération de code
gpt-5.5Excellentes compétences en codageTâches d’ingénierie complexes
gpt-4oHaute performance, rapideCodage quotidien, itération rapide
Dans Claude Code, utilisez la commande /model pour changer de modèle ; dans Codex, utilisez également la commande /model. Pour la liste complète des modèles, consultez le guide Claude Code et le guide Codex CLI.

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 ?

  1. Assurez-vous que la clé API commence par sk- et est copiée entièrement sans espaces supplémentaires
  2. Allez dans la console APIMart pour confirmer que la clé est active
  3. Vérifiez que l’URL du point de terminaison est correcte (Claude Code utilise https://api.apimart.ai, Codex utilise https://api.apimart.ai/v1)

Q3 : Erreur de format lors de l’ajout d’un fournisseur Codex ?

CC-Switch valide auth.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.toml et ~/.codex/auth.json
CC-Switch sauvegarde automatiquement ces fichiers avant de basculer, vous n’avez donc pas besoin de les éditer à la main.

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 :

Commencer avec APIMart

Inscrivez-vous à APIMart maintenant, obtenez votre clé API et gérez plusieurs outils de codage IA sans effort dans CC-Switch !