CC Switch : le guide complet de l'application de bureau qui gère Claude Code, Codex et Gemini CLI en un seul endroit (2026)

Si vous utilisez Claude Code, Codex et Gemini CLI côte à côte, vous avez sans doute déjà rencontré ce problème : à chaque changement de fournisseur d'API — endpoint officiel, relais, modèle local — il faut ouvrir manuellement ~/.claude/settings.json, ~/.codex/config.toml et ~/.gemini/.env pour les modifier un par un, tout en se souvenant du format des champs de configuration propre à chaque outil. CC Switch existe précisément pour résoudre ce problème : c'est une application de bureau multiplateforme qui vous permet de gérer les configurations de Provider, les serveurs MCP et les Skills de chaque CLI IA depuis une seule interface, en changeant d'un clic plutôt qu'en éditant des fichiers de configuration à la main.

Qu'est-ce que CC Switch ?

CC Switch (site officiel : ccswitch.io, GitHub : farion1231/cc-switch) est une application de bureau open source créée par le développeur Jason Young, construite sur le framework Tauri 2, avec une taille d'installation d'environ 10 Mo. En juin 2026, le projet a dépassé les 67 000 étoiles sur GitHub avec 125 contributeurs — ce qui en fait l'outil de gestion de CLI IA le plus activement maintenu par la communauté.

Il permet de gérer simultanément la configuration des 7 outils de programmation IA suivants :

• Claude Code (le CLI officiel d'Anthropic)
• Claude Desktop
• Codex (le CLI officiel d'OpenAI)
• Gemini CLI (le CLI officiel de Google)
• OpenCode
• OpenClaw
• Hermes Agent

Pourquoi les développeurs ont-ils besoin de CC Switch ?

Avec la prolifération des outils de programmation IA, il est désormais courant qu'un développeur fasse tourner 2 à 3 CLI en parallèle. Avant l'existence de CC Switch, changer de fournisseur d'API ressemblait à ceci :

• Trouver ~/.claude/settings.json, modifier manuellement ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN
• Trouver ~/.codex/config.toml, modifier base_url et la clé API
• Trouver ~/.gemini/.env, mettre à jour les variables correspondantes
• Redémarrer le terminal, vérifier que ça a bien pris effet
• Répéter toute cette procédure au prochain changement

Avec CC Switch, tout ce flux devient : clic droit sur l'icône de la barre système → choisir le Provider cible → terminé. Claude Code et Gemini CLI prennent même en charge le changement à chaud, sans avoir besoin de redémarrer le terminal.

Pour les développeurs qui passent par un relais, CC Switch embarque aussi plus de 50 préréglages pour des fournisseurs de relais et des Providers tiers — pas besoin de saisir un base_url à la main, il suffit de choisir le préréglage et de coller sa clé API. C'est une grande partie de la raison pour laquelle il est aussi souvent recommandé dans les communautés orientées relais.

Installation

macOS

Homebrew est recommandé, car il prend en charge les mises à jour automatiques :

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

Vous pouvez aussi télécharger le fichier .dmg depuis la page GitHub Releases, puis double-cliquer pour l'installer et le glisser dans votre dossier Applications. Prérequis système : macOS 12+ (Monterey ou ultérieur).

Windows

Téléchargez le fichier d'installation CC-Switch-vX.X.X-Windows.msi depuis la page GitHub Releases, double-cliquez et suivez les instructions. Une version portable en .zip est également disponible — décompressez-la et lancez directement CC-Switch.exe, sans installation. Prérequis système : Windows 10+.

Linux

Choisissez le format correspondant à votre distribution :

• Ubuntu/Debian : téléchargez le paquet .deb, sudo dpkg -i cc-switch_*.deb
• Arch Linux : paru -S cc-switch-bin (AUR)
• Fedora/RHEL : téléchargez le paquet .rpm
• Générique : téléchargez le .AppImage, rendez-le exécutable et lancez-le directement

À noter : sous Linux, si l'icône de la barre système disparaît, installez gnome-shell-extension-appindicator et redémarrez votre session.

Fonctionnalités principales en détail

1. Gestion des Providers (la fonctionnalité centrale)

Au premier lancement, CC Switch détecte automatiquement les CLI IA que vous avez déjà installés et importe leurs configurations existantes. Étapes pour ajouter un nouveau Provider :

1. Cliquez sur le bouton « + » en haut à droite de l'interface
2. Choisissez le type de Provider : Provider spécifique à l'app (s'applique uniquement au CLI en cours) ou Provider universel (partagé entre Claude Code, Codex et Gemini CLI)
3. Choisissez un fournisseur cible parmi plus de 50 préréglages (couvrant AWS Bedrock, NVIDIA NIM, des relais populaires, et bien d'autres), ou saisissez manuellement un base_url personnalisé
4. Collez votre clé API — CC Switch remplit automatiquement l'URL de l'endpoint et le format du protocole
5. Cliquez sur « Activer » pour finaliser le changement

Le moment où le changement prend effet varie selon l'outil : Claude Code et Gemini CLI prennent en charge le changement à chaud (pas besoin de redémarrer le terminal) ; Codex, OpenCode, OpenClaw et Hermes Agent nécessitent un redémarrage du terminal pour que le changement s'applique.

CC Switch écrit la configuration directement dans le fichier de configuration natif de chaque outil, sans introduire de dépendance d'exécution supplémentaire :

• Claude Code → ~/.claude/settings.json
• Codex → ~/.codex/auth.json + ~/.codex/config.toml
• Gemini CLI → ~/.gemini/.env + ~/.gemini/settings.json
• OpenCode → ~/.config/opencode/opencode.json

2. Proxy local et changement à chaud

CC Switch fait tourner une couche de proxy local intégrée — ce n'est pas juste un outil qui écrit des fichiers de configuration. Il prend aussi en charge :

• Le changement à chaud : pas besoin de redémarrer le terminal, les changements prennent effet immédiatement (pour les CLI compatibles)
• La conversion de protocole : convertit les requêtes Responses API de Codex au format OpenAI Chat Completions, pour que les relais qui ne prennent pas en charge la Responses API puissent quand même servir Codex
• Le basculement automatique : avec plusieurs Providers configurés, il bascule automatiquement vers un Provider de secours si le principal devient indisponible
• Les contrôles de santé : envoie des requêtes de test aux Providers configurés pour vérifier que la clé API et l'endpoint sont valides

3. Gestion unifiée des serveurs MCP

MCP (Model Context Protocol) est le protocole standard qui permet aux CLI IA de se connecter à des outils externes — bases de données, systèmes de fichiers, moteurs de recherche, et plus encore. CC Switch propose un panneau de gestion MCP unifié qui vous permet de :

• Consulter et gérer la liste des serveurs MCP de chaque CLI (lue depuis l'emplacement de configuration natif de chaque outil, par exemple ~/.claude.json pour Claude Code)
• Activer/désactiver les serveurs MCP par CLI
• Importer des configurations MCP en un clic via un Deep Link
• Synchroniser les configurations de serveurs MCP dans les deux sens entre plusieurs CLI

4. Installation et gestion des Skills

Les Skills sont un mécanisme de plugin qui étend les CLI IA avec des instructions et des capacités de prompt supplémentaires (similaire aux /commands et Prompts de Claude Code). CC Switch prend en charge :

• L'installation en un clic de Skills depuis un dépôt GitHub ou un fichier ZIP
• La mise à jour groupée des Skills installées
• Le choix d'un mode d'installation : mode symlink (un seul fichier partagé entre plusieurs CLI) ou mode copie (pour les CLI en bac à sable qui ne prennent pas en charge les liens symboliques)

5. Statistiques d'usage et historique des sessions

CC Switch intègre un tableau de bord d'usage qui suit la consommation de tokens et les dépenses par Provider, ainsi qu'un historique d'appels ventilé par outil CLI. Son gestionnaire de sessions permet de parcourir et de rechercher les conversations passées sur plusieurs applications.

6. Synchronisation cloud

CC Switch stocke ses données locales dans ~/.cc-switch/ (une base de données SQLite + une configuration JSON + un répertoire de Skills) et prend en charge la synchronisation entre appareils via Dropbox, OneDrive, iCloud, un NAS ou WebDAV. À noter : il n'est pas recommandé de synchroniser directement le fichier SQLite cc-switch.db vers un stockage cloud classique (il manque de verrouillage de fichier) — préférez WebDAV ou une solution de synchronisation qui prend en charge le verrouillage de fichiers.

Prise en main rapide : 3 étapes pour votre premier changement

1. Installer et lancer : suivez les étapes d'installation pour votre plateforme ci-dessus ; au premier lancement, l'application détecte automatiquement les CLI déjà installés.
2. Ajouter un Provider : cliquez sur « + » en haut à droite, choisissez un préréglage de relais (ou saisissez un base_url personnalisé), collez la clé API, et enregistrez.
3. Activer et vérifier : cliquez sur « Activer » à côté de la configuration cible dans la liste des Providers, puis cliquez sur « Contrôle de santé » pour vérifier la connectivité, et ouvrez un terminal pour exécuter claude (ou codex/gemini) afin de confirmer que ça fonctionne.

Si vous êtes utilisateur de Codex, après le changement, vous devez quitter complètement le processus Codex (pas seulement fermer l'invite) et le redémarrer pour que la nouvelle configuration soit chargée — c'est un comportement de mise en cache au démarrage propre à Codex, pas un problème de CC Switch.

Pour quels développeurs CC Switch est-il le plus adapté ?

CC Switch est particulièrement utile si :

• Vous utilisez Claude Code + Codex ensemble, ou les trois avec Gemini CLI
• Vous alternez fréquemment entre API officielles, relais et modèles locaux
• Votre équipe partage un même jeu de configurations Provider et doit le distribuer sur plusieurs appareils via la synchronisation cloud
• Vous avez besoin de gérer les serveurs MCP sur plusieurs outils sans dupliquer la configuration
• Vous voulez suivre la consommation de tokens et les dépenses sur plusieurs CLI IA

Si vous n'utilisez qu'un seul CLI IA avec un unique fournisseur d'API fixe, l'intérêt pratique de CC Switch reste relativement limité — coder la clé en dur dans une variable d'environnement suffirait. Mais dès que vous avez un besoin de type « plusieurs CLI, plusieurs Providers, changements fréquents », CC Switch est à peu près la solution la plus mature qui existe aujourd'hui.

Ressources complémentaires

• Dépôt GitHub : github.com/farion1231/cc-switch
• Documentation officielle : ccswitch.io
• Version CLI (sans interface graphique) : github.com/saladday/cc-switch-cli

Pour un comparatif côte à côte des principaux fournisseurs de relais, consultez notre page comparatif des relais d'API IA.