CC Switch Commutation d'API en un clic

À mesure que les outils de codage IA comme Claude Code, OpenAI Codex et Gemini CLI gagnent en popularité, les développeurs doivent souvent basculer fréquemment entre plusieurs fournisseurs d'API — API officielles, miroirs domestiques, proxys tiers... Modifier manuellement les fichiers de configuration à chaque fois est à la fois fastidieux et source d'erreurs.

CC Switch est un outil de bureau qui résout ce problème. Il fournit une interface graphique unifiée qui vous permet de :

Fonctionnalités Description
🔄 Changement de fournisseur en un clic Enregistrez plusieurs configurations d'API et basculez en un seul clic — plus besoin de modifier manuellement le JSON
🖥️ Gestion unifiée de plusieurs applications Gérez simultanément cinq outils : Claude Code, Codex, Gemini CLI, OpenCode et OpenClaw
🛡️ Proxy d'API local Proxy HTTP haute performance intégré avec basculement automatique et surveillance des requêtes
🔌 Gestion des serveurs MCP Ajoutez, modifiez et synchronisez visuellement les configurations des serveurs MCP
📊 Statistiques d'utilisation Consultez la consommation de tokens et les coûts d'API en temps réel
💾 Sauvegarde et restauration Sauvegarder automatiquement les configurations pour éviter toute perte de données causée par des opérations accidentelles

Applications prises en charge

  • 🤖 Claude Code（Anthropic）
  • ⚡ Codex（OpenAI）
  • ✨ Gemini CLI（Google）
  • 🧩 OpenCode(Open Source)
  • 🦅 OpenClaw(Cinquième application, nouvelle dans la v3.11.0)

Installation

Rendez-vous surGitHub Releases : https://github.com/farion1231/cc-switch/releases/latestTéléchargez l'installateur pour votre plateforme.

Faites défiler jusqu'en bas de la page, jusqu'à la section des packages de ressources, et téléchargez l'installateur pour votre plateforme :

Configuration système requise

Système Version minimale Architecture
Windows Windows 10 et versions ultérieures x64
macOS macOS 10.15 (Catalina) et versions ultérieures Intel (x64) / Apple Silicon (arm64)
Linux Voir le tableau ci-dessous x64 / arm64

Windows

Fichier Description
CC-Switch-vX.X.X-Windows.msi ✅ Recommandé— programme d’installation MSI, prend en charge les mises à jour automatiques
CC-Switch-vX.X.X-Windows-Portable.zip Version portable, à extraire et exécuter, n’écrit pas dans le registre

Double-cliquez sur le fichier MSI et suivez l’assistant pour terminer l’installation. Ensuite, recherchez « CC Switch » dans le menu Démarrer pour le lancer.

⚠️ La fonction « installation en un clic » est désactivée dans la version Windows afin d’éviter les effets secondaires des gestionnaires de protocoles. Si vous devez installer des outils comme Claude Code, veuillez les installer manuellement, puis les gérer via CC Switch.

macOS

Méthode 1 : Téléchargement direct (recommandé)

  1. TéléchargementCC-Switch-vX.X.X-macOS.zip
  2. Après extraction, faites glisserCC Switch.appdans le dossier « Applications »
  3. Au premier lancement, faites un clic droit → Ouvrir, ou allez dans « Réglages Système → Confidentialité et sécurité → Ouvrir quand même »

⚠️ Comme l’auteur n’a pas de compte Apple Developer, macOS peut afficher un avertissement « Développeur non identifié ». Après avoir fermé l’invite, allez dans « Réglages Système → Confidentialité et sécurité » et cliquez sur « Ouvrir quand même ». Ensuite, il se lancera normalement à chaque fois.

Méthode 2 : Homebrew

# 添加 tap 并安装
brew tap farion1231/ccswitch
brew install --cask cc-switch
# 更新
brew upgrade --cask cc-switch

Linux

Choisissez le format correspondant à votre distribution :

Distribution Format recommandé Commande d'installation
Ubuntu / Debian / Mint .deb sudo apt install ./CC-Switch-*.deb
Fedora / RHEL / Rocky .rpm sudo dnf install ./CC-Switch-*.rpm
openSUSE .rpm sudo zypper install ./CC-Switch-*.rpm
Arch / Manjaro / Autres .AppImage Voir ci-dessous

Utilisation d'AppImage :

chmod +x CC-Switch-*.AppImage
./CC-Switch-*.AppImage

Démarrage rapide

Après l'installation, effectuez la configuration initiale en suivant ces étapes :

Étape 1 : Lancer CC Switch

Lors du premier lancement, CC Switch détecte automatiquement les outils CLI installés et tente d'importer les configurations existantes. L'icône CC Switch apparaîtra dans la zone de notification.

Étape 2 : Sélectionner l'application à gérer

En haut de l'interface principale se trouve la barre de sélection des applications. Cliquez sur l'icône correspondante (Claude Code / Codex / Gemini CLI, etc.) pour changer l'application actuellement gérée. Vous pouvez masquer les applications inutiles dans les Paramètres.

Étape 3 : Ajouter votre premier fournisseur

Cliquez sur le bouton en haut à droite+et choisissez parmi les préréglages intégrés (tels que l'API officielle Anthropic, DeepSeek, Alibaba Bailian, etc.), ou remplissez manuellement les informations suivantes :

  • Nom: Un nom indicatif pour faciliter l'identification
  • Clé API: La clé API fournie par le fournisseur de services
  • URL de base(facultatif) : Adresse de proxy personnalisée
  • Modèle: Spécifiez le nom du modèle par défaut à utiliser
  • Format d'API: format natif Anthropic Messages ou format compatible OpenAI Chat Completions

Étape 4 : Changer de fournisseur

Dans la liste, cliquez sur le fournisseur cible, puis cliquez sur « Activer ». CC Switch écrira automatiquement la configuration dans le fichier de configuration de l'outil CLI correspondant :

Exécutez laclaudecommande directement dans le terminal, et la nouvelle configuration sera utilisée.

Étape 5 : Vérifier la configuration (facultatif)

Cliquez sur le bouton « Vérification de l'état » à côté du fournisseur pour envoyer une requête de test et vérifier la clé API ainsi que la connectivité réseau.

💡 Appuyez surCmd/Ctrl + ,pour ouvrir rapidement les paramètres ; appuyez surESCpour fermer le panneau actuel.

Fonctionnalités avancées

Gestion des serveurs MCP

Dans le panneau « MCP », ajoutez, modifiez et supprimez visuellement des serveurs MCP (Model Context Protocol). Les configurations sont automatiquement synchronisées avec les outils CLI correspondants, avec prise en charge de l’import en un clic des configurations MCP existantes à partir des applications installées.

Gestion des Skills

Les Skills sont une fonctionnalité d’amélioration de prompt de Claude Code. CC Switch prend en charge :

  • Installation de Skills à partir de dépôts GitHub (dépôts prédéfinis intégrés tels quebaoyu-skillsetc.)
  • Installation à partir de fichiers ZIP locaux
  • Gestion des Skills pour Claude Code et Codex

Gestionnaire de sessions

Sur la page « Sessions », vous pouvez parcourir l’historique des conversations des cinq applications. Il prend en charge la navigation dans les répertoires et la recherche dans la session, et filtre automatiquement l’affichage en fonction de l’application actuelle.

Gestion des sauvegardes

CC Switch sauvegarde automatiquement la base de données régulièrement, ainsi qu’avant la migration de la base de données. Dans « Paramètres → Gestion des sauvegardes », vous pouvez : afficher toutes les sauvegardes, les renommer, les supprimer et créer manuellement des sauvegardes.

Statistiques d'utilisation et facturation

La page « Usage » affiche les statistiques de consommation de jetons, avec prise en charge de l'actualisation automatique, de l'analyse du taux de succès du cache et de la consultation des coûts par modèle et par fournisseur, vous aidant à garder les dépenses API sous contrôle.

Claude Rectifier (Correctif de signature de réflexion)

Lors de l'utilisation de certaines passerelles API tierces, le format des blocs de réflexion de Claude peut être incompatible. Après avoir activé Rectifier, la couche proxy corrigera automatiquement ce problème. Vous pouvez l'activer/désactiver dans « Paramètres → Avancé ».

Synchronisation automatique WebDAV

Prend en charge la synchronisation de la base de données vers un service WebDAV (tel que Nutstore), permettant le partage de configuration entre plusieurs appareils. Un mécanisme intégré de protection des fichiers volumineux empêche les envois accidentels.

Autres extensions