Guide complet CC-Switch : Apprenez à gérer les configurations multi-API de Claude Code en 5 minutes

Coder avec Claude Code est un pur bonheur, mais l'API officielle coûte un bras ? Vous voulez passer à un intermédiaire API tiers, mais vous ne savez pas comment modifier le fichier de configuration ? CC-Switch est l'outil né pour résoudre ce problème précisément. Cet article va vous permettre de maîtriser l'installation et l'utilisation de CC-Switch en 5 minutes, pour gérer facilement les API de quatre assistants de programmation IA : Claude Code, Codex, OpenCode et Gemini CLI.

Valeur ajoutée : À la fin de cette lecture, vous saurez utiliser CC-Switch pour gérer visuellement plusieurs fournisseurs d'API (Providers), changer de configuration en un clic et dire adieu à la corvée de l'édition manuelle des fichiers JSON.

C'est quoi CC-Switch ? Et pourquoi en avez-vous besoin ?

CC-Switch est une application de bureau open-source et multiplateforme, spécialement conçue pour centraliser la gestion des configurations de vos assistants de programmation IA. Elle a été créée et mise en open-source par le développeur farion1231 sur GitHub.

Le positionnement de CC-Switch

Pour faire simple, CC-Switch est le « centre de contrôle des configurations » pour vos outils de codage IA :

Les 4 outils de programmation IA supportés par CC-Switch

🚀 Démarrage rapide : CC-Switch permet de se connecter à des services tiers comme APIYI (apiyi.com). Une fois votre Provider configuré, vous pouvez utiliser des outils comme Claude Code à moindre coût, tout en profitant du confort d'un basculement instantané.

Détails des fonctionnalités clés de CC-Switch

CC-Switch ne se contente pas d'être un simple sélecteur de configuration, c'est une plateforme complète de gestion d'outils d'IA :

Fonctionnalité 1 : Gestion des Providers (Cœur du système)

C'est la fonctionnalité la plus utilisée de CC-Switch, elle permet de :

Exemple de configuration d'un Provider :

{
  "name": "APIYI",
  "baseUrl": "https://api.apiyi.com",
  "apiKey": "sk-your-apiyi-key",
  "models": {
    "claude-sonnet-4-20250514": "claude-sonnet-4-20250514",
    "claude-opus-4-20250514": "claude-opus-4-20250514"
  }
}

Fonctionnalité 2 : Gestion des serveurs MCP

Le MCP (Model Context Protocol) est le protocole d'extension de Claude Code. CC-Switch propose une interface de gestion MCP unifiée :

• Supporte les types de transport stdio / http / sse
• Configuration unifiée inter-applications (Claude/Codex/Gemini)
• Ajout, édition et suppression visuelle des serveurs MCP

Fonctionnalité 3 : Gestion des compétences (Skills)

CC-Switch peut découvrir et installer automatiquement les Skills Claude :

• Scan automatique des Skills dans les dépôts GitHub
• Installation en un clic dans le répertoire ~/.claude/skills/
• Supporte le scan récursif des répertoires imbriqués

Fonctionnalité 4 : Gestion des invites système

Créez des préréglages d'invites système pour différents scénarios :

• Nombre illimité de préréglages d'invites
• Supporte CLAUDE.md, AGENTS.md, GEMINI.md
• Basculement rapide entre différents modes de travail

Fonctionnalité 5 : Proxy API local (v3.9.0+)

CC-Switch intègre un serveur proxy local offrant des fonctionnalités avancées :

💡 Conseil technique : La fonctionnalité de proxy local fonctionne encore mieux lorsqu'elle est couplée à APIYI (apiyi.com). APIYI fournit des interfaces compatibles OpenAI stables, et le failover de CC-Switch permet de basculer automatiquement en cas de fluctuations réseau, garantissant une expérience de programmation sans interruption.

Guide d'installation de CC-Switch

CC-Switch est compatible avec les trois plateformes majeures : Windows, macOS et Linux, et propose plusieurs méthodes d'installation.

Installation sur Windows

Option 1 : Installateur MSI (recommandé)

Téléchargez le fichier .msi depuis les Releases GitHub, puis double-cliquez dessus pour lancer l'installation.

Option 2 : Version portable

Téléchargez la version portable au format .zip. Une fois décompressée, vous pouvez l'exécuter directement sans installation préalable.

Installation sur macOS

Option 1 : Homebrew (recommandé)

brew install --cask cc-switch

Option 2 : Installation manuelle

Téléchargez le fichier .dmg ou .zip, puis faites glisser l'application dans votre dossier Applications.

Note : Lors du premier lancement, vous pourriez rencontrer un avertissement de Gatekeeper. Vous devrez autoriser l'exécution dans « Réglages Système → Sécurité et confidentialité ».

Installation sur Linux

CC-Switch propose plusieurs formats de paquets pour Linux :

Vérifier l'installation

Une fois l'installation terminée, lancez CC-Switch. Vous devriez voir l'interface principale affichant l'état des outils CLI détectés.

Configuration rapide de CC-Switch

Étape 1 : Ajouter le fournisseur APIYI

1. Cliquez sur le bouton « Add Provider » de l'interface principale.
2. Choisissez la configuration personnalisée « Custom ».
3. Remplissez les informations suivantes :

Nom : APIYI
Base URL : https://api.apiyi.com
API Key : sk-votre-cle-apiyi  # À récupérer sur apiyi.com

4. Configurer le mappage des modèles (facultatif) :

{
  "claude-sonnet-4-20250514": "claude-sonnet-4-20250514",
  "claude-opus-4-20250514": "claude-opus-4-20250514",
  "gpt-4o": "gpt-4o"
}

5. Cliquez sur « Save » pour enregistrer la configuration.

Obtenir une clé API : Rendez-vous sur APIYI (apiyi.com) pour créer un compte et récupérer votre clé API. La plateforme offre un crédit de test gratuit et prend en charge les modèles majeurs comme Claude, GPT, Gemini, etc.

Étape 2 : Changer de fournisseur

Une fois la configuration enregistrée, dans la liste des fournisseurs de l'interface principale :

1. Trouvez le fournisseur « APIYI » que vous venez d'ajouter.
2. Cliquez sur « Switch » ou directement sur le fournisseur.
3. CC-Switch modifiera automatiquement le fichier de configuration de l'outil correspondant.
4. Redémarrez vos outils CLI, comme Claude Code, pour que les changements prennent effet.

Étape 3 : Tester la connexion

Utilisez la fonction de test de vitesse de CC-Switch pour valider votre configuration :

1. Cliquez sur le bouton « Test » à côté du fournisseur.
2. Attendez la fin du test de latence.
3. Vérifiez le temps de réponse et l'indicateur d'état.

Si le test réussit, ouvrez votre terminal et lancez Claude Code :

claude

Si vous pouvez dialoguer normalement, c'est que la configuration est réussie !

Exemple de configuration minimaliste

{
  "id": "apiyi-provider",
  "name": "APIYI (recommandé)",
  "baseUrl": "https://api.apiyi.com",
  "apiKey": "sk-votre-cle-apiyi",
  "enabled": true,
  "models": {
    "claude-sonnet-4-20250514": {
      "id": "claude-sonnet-4-20250514",
      "name": "Claude Sonnet 4",
      "maxTokens": 64000
    },
    "claude-opus-4-20250514": {
      "id": "claude-opus-4-20250514",
      "name": "Claude Opus 4",
      "maxTokens": 32000
    },
    "gpt-4o": {
      "id": "gpt-4o",
      "name": "GPT-4o",
      "maxTokens": 16384
    },
    "gpt-4o-mini": {
      "id": "gpt-4o-mini",
      "name": "GPT-4o Mini",
      "maxTokens": 16384
    }
  },
  "healthCheck": {
    "enabled": true,
    "interval": 60
  }
}

Fonctionnalités avancées de CC-Switch

Stratégies de gestion multi-providers

CC-Switch permet de configurer plusieurs providers pour une utilisation flexible :

┌─────────────────────────────────────────────────┐
│          Liste des providers CC-Switch          │
├─────────────────────────────────────────────────┤
│  ⭐ APIYI (Principal)     Latence : 120ms  ✓ OK    │
│  📦 OpenRouter (Secours)  Latence : 280ms  ✓ OK    │
│  🏢 Claude Officiel (Repli) Latence : 350ms  ✓ OK    │
└─────────────────────────────────────────────────┘

Configuration recommandée :

• Principal : APIYI – Prix avantageux, accès rapide.
• Secours : OpenRouter – Large choix de modèles, stable à l'international.
• Sécurité (Repli) : Connexion officielle – Pour garantir une disponibilité constante en dernier recours.

Configuration de la synchronisation Cloud

CC-Switch permet de synchroniser vos réglages sur un stockage cloud :

1. Allez dans Settings → Storage.
2. Sélectionnez un dossier de synchronisation cloud (Dropbox, OneDrive, iCloud Drive).
3. CC-Switch synchronisera automatiquement la configuration de vos providers.

Cela vous permet de partager la même configuration API entre plusieurs appareils en toute simplicité.

Configuration avancée du proxy local

Une fois le proxy local activé, CC-Switch va :

1. Lancer un serveur proxy sur votre machine.
2. Modifier automatiquement la configuration de la CLI pour pointer vers ce proxy local.
3. Rediriger les requêtes du serveur proxy vers le provider réel.

Avantages :

• Toutes les requêtes passent par un point d'entrée unique, facilitant la surveillance.
• Basculement automatique (failover) : si un provider tombe, le système change automatiquement.
• Journalisation des requêtes (logs) pour faciliter le dépannage.

# Flux de requête en mode proxy
Claude Code → localhost:8080 → Proxy CC-Switch → APIYI → Claude API

Fonction Claude Rectifier

La fonction Claude Rectifier, ajoutée dans la v3.10.0, sert à corriger les problèmes de compatibilité des API tierces :

• Correction automatique du format de la signature "thinking".
• Amélioration de la compatibilité avec les API non officielles.
• Réduction des erreurs de type "format invalide".

FAQ CC-Switch

# Méthode 1 : Fermez le terminal actuel et rouvrez-le
# Méthode 2 : Tapez /exit dans Claude Code pour quitter, puis relancez-le
claude  # Redémarrage

# Supprimer la configuration personnalisée pour restaurer l'officiel
rm ~/.claude/settings.json
claude  # Reconnectez-vous à votre compte officiel

Comparaison entre CC-Switch et la configuration manuelle

🎯 Conseil de choix : Si vous jonglez souvent entre plusieurs fournisseurs d'API ou utilisez plusieurs outils de programmation IA, CC-Switch va vous faire gagner un temps fou. En le couplant avec APIYI (apiyi.com), vous profitez d'une expérience fluide au meilleur prix.

Comparaison des outils liés à CC-Switch

Au-delà de l'application principale, voici quelques outils complémentaires ou alternatifs :

Combo recommandé : CC-Switch (pour la config) + APIYI (pour le relais API) = La meilleure solution rapport qualité-prix.

Ressources

Conclusion

CC-Switch est l'outil indispensable pour gérer les configurations de vos assistants de programmation IA. Il résout les points de douleur suivants :

1. Configurations fastidieuses : Une interface visuelle remplace l'édition manuelle de fichiers JSON.
2. Bascule complexe : Changez de fournisseur (Provider) en un seul clic.
3. Outils dispersés : Gestion unifiée pour Claude Code, Codex, OpenCode et Gemini CLI.
4. Absence de test de vitesse : Test de latence intégré pour choisir le Provider le plus rapide.
5. Perte de configuration : Sauvegarde automatique et synchronisation cloud pour ne jamais rien perdre.

Pour les développeurs qui utilisent fréquemment des outils de programmation IA, le combo CC-Switch + APIYI est la solution recommandée :

• CC-Switch : Offre une gestion simplifiée des configurations.
• APIYI (apiyi.com) : Fournit un service API stable et à prix compétitif.

Rendez-vous sur APIYI (apiyi.com) pour créer un compte, obtenez votre clé API, puis ajoutez le fournisseur dans CC-Switch pour commencer à profiter d'une expérience de programmation IA ultra-fluide.

📝 Auteur : Équipe technique APIYI | APIYI apiyi.com – Simplifier vos appels API IA.