Guide de configuration

Guide de configuration du fournisseur

Consultez les étapes de configuration et le dépannage par outil.

Guide de configuration du fournisseur/Guide d'utilisation de CC-Switch-CLI

Guide d'utilisation de CC-Switch-CLI

CC-Switch-CLI est un outil de basculement de provider en ligne de commande, adapté aux serveurs sans interface graphique, aux environnements SSH ou aux utilisateurs souhaitant basculer rapidement de provider entre Claude Code, Codex, Gemini CLI, OpenCode et OpenClaw.

Informations officielles Les téléchargements et la documentation officielle font foi.
GitHub Dépôt officiel de CC-Switch-CLI, liste des commandes et Releases Releases Télécharger la version Windows / macOS / Linux Homebrew Installation possible via Homebrew sous macOS

À qui s'adresse cet outil

Si vous êtes un utilisateur classique sur ordinateur de bureau, privilégiez l'interface graphique de CC Switch. Si vous êtes déjà habitué au terminal ou si vous devez gérer des configurations par lot, cette page est faite pour vous. Les blocs de code ci-dessous ne contiennent que les commandes, les explications se trouvant à l'extérieur pour éviter de les copier accidentellement avec le code.

Installation et démarrage

Les utilisateurs macOS / Linux peuvent suivre la documentation officielle pour utiliser le script d'installation ou le paquet Releases ; il est recommandé aux utilisateurs Windows de télécharger l'archive correspondante depuis Releases et de l'exécuter dans le répertoire du programme après extraction.

Script d'installation officiel
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash cc-switch

En saisissant directement cc-switch, vous accédez à l'interface interactive, idéale pour découvrir le menu ; les commandes suivantes sont adaptées si vous savez déjà quoi faire et souhaitez une exécution directe.

Vérification de l'environnement

Éléments à vérifierComment vérifierPourquoi
CC Switch ou la version CLI est installéeLe terminal reconnaît la commande correspondanteToute commande de configuration échouera si l'outil n'est pas installé.
Le CLI cible est installéClaude Code, Codex et Gemini CLI peuvent au moins démarrer individuellementCC-Switch-CLI n'installe pas l'outil cible à votre place
Les informations du provider sont complètesPréparez la Base URL, la clé API et le nom du modèleLa configuration en ligne de commande n'a pas d'invites graphiques, et un élément manquant entraîne facilement une erreur.
Valider d'abord dans un répertoire de testNe basculez pas en masse directement sur des projets réelsPlus facile de revenir en arrière en cas d'erreur de configuration
Vérifiez d'abord l'environnement local La commande suivante permet de confirmer les outils détectés par CC-Switch-CLI, le provider actuellement configuré et l'état du proxy.
Commandes de vérification de l'environnement
cc-switch env tools cc-switch env check cc-switch provider current cc-switch --app codex provider current

Commandes relatives aux providers

Un Provider correspond à la configuration d'un fournisseur (provider). Avant d'ajouter un Provider, préparez la Base URL, la clé API et le nom du modèle depuis le tableau de bord du provider ; lors de la modification ou du basculement, confirmez d'abord l'identifiant (numéro) à l'aide de la commande de liste.

Afficher, ajouter et modifier un Provider
cc-switch provider list cc-switch provider add cc-switch provider edit <id> cc-switch provider fetch-models <id>
Basculer de Provider et tester la connexion
cc-switch provider switch <id> cc-switch provider stream-check <id> cc-switch provider fetch-models <id>
< id> doit être remplacé par le numéro affiché dans cc-switch provider list. N'exécutez pas directement < id> tel quel.

Gestion par application

Si vous souhaitez uniquement consulter la configuration d'un outil cible spécifique, vous pouvez ajouter --app. C'est très utile pour dépanner séparément Claude Code, Codex et Gemini CLI.

Afficher les providers par application
cc-switch --app claude provider list cc-switch --app codex provider list cc-switch --app gemini provider list cc-switch --app opencode provider list cc-switch --app openclaw provider list
Vérifier le provider actif par application
cc-switch --app claude provider current cc-switch --app codex provider current cc-switch --app gemini provider current

Après avoir vérifié que l'application cible et le provider actuel sont corrects, effectuez le basculement. Une fois le basculement terminé, redémarrez le terminal, puis envoyez une question de test minimale avec l'outil cible.

Test minimal après le basculement
claude "Please reply only: Claude Code is active" codex "Please reply only: Codex is active" gemini "Please reply only: Gemini is active"

Synchronisation MCP

MCP n'est pas nécessaire pour tous les débutants. Ne vous en préoccupez que si vous utilisez déjà MCP dans Claude Code, Codex ou Gemini CLI et avez besoin d'une synchronisation multi-outils. Pour une première utilisation, il est conseillé d'accéder d'abord au menu TUI pour explorer la section MCP, plutôt que de copier aveuglément des commandes avancées issues d'anciens tutoriels.

Accéder à la gestion MCP
cc-switch cc-switch --app codex

Démarche de configuration

  1. Confirmez d'abord l'outil cible vers lequel vous souhaitez basculer : Claude Code, Codex, Gemini CLI ou un autre CLI.
  2. Préparez la Base URL, la clé API et le nom du modèle depuis le panneau d'administration du provider.
  3. Ajoutez ou sélectionnez un Provider dans CC-Switch-CLI.
  4. Appliquez le Provider à l'outil cible.
  5. Après avoir rouvert le terminal, faites un test avec une requête très courte sur le CLI cible.
  6. Une fois le bon fonctionnement confirmé, appliquez le même Provider aux autres outils cibles.
ScénariosRecommandations
Utilisation sur bureau localPrivilégiez l'interface graphique de CC Switch : les champs et les statuts y sont plus intuitifs
Serveur distant / SSHUtilisez CC-Switch-CLI ; vérifiez les commandes de la version actuelle avant d'opérer
Basculement de configuration par lotValidez d'abord le fonctionnement sur un projet de test avant de l'appliquer aux projets réels
Machine partagée entre plusieurs personnesNe consignez pas votre clé dans une configuration partagée ; vérifiez d'abord la portée du fichier de configuration

Dépannage pour les débutants

Problème rencontréVérification prioritaireSolutions
Commande introuvableVérifiez si l'outil est installé et ajouté au PATHRouvrez le terminal, ou consultez la documentation officielle pour vérifier l'emplacement d'installation
L'outil cible n'a pas changé après le basculementVérifiez si le terminal a été rouvert et si le bon outil cible a été sélectionnéFermez la fenêtre du terminal actuelle, rouvrez-la et réessayez
401 / UnauthorizedVérifiez si la clé est complète et si elle n'a pas expiréRecopiez la clé en veillant à ne pas inclure d'espaces superflus
Modèle introuvable (model not found)Vérifiez si le nom du modèle est recopié fidèlement depuis la console du providerRenseignez-le à nouveau d'après la liste des modèles du provider
C'est avec la ligne de commande que les erreurs surviennent le plus souvent en copiant d'anciens tutoriels. Cette page présente la logique de configuration et de dépannage ; référez-vous toujours à la version actuelle pour la syntaxe exacte des commandes.