Guide de configuration

Guide de configuration du fournisseur

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

CC-Switch Claude Code

Cette page n'explique qu'une seule chose : ajouter ou sélectionner un fournisseur dans CC Switch, puis l'appliquer à Claude Code. Il ne s'agit pas d'un tutoriel de configuration directe de Claude Code ; si vous souhaitez modifier directement le fichier de configuration de Claude Code, veuillez consulter la configuration CLI de Claude Code.

Ce que cette page explique

L'objectif de CC Switch est de vous aider à gérer de manière centralisée les fournisseurs et à synchroniser les configurations vers les outils cibles. Pour Claude Code, veillez à bien vérifier le protocole Claude / Anthropic, la clé et le nom du modèle. N'utilisez pas directement une adresse compatible OpenAI comme adresse Claude, sauf si le fournisseur indique explicitement qu'il prend en charge Claude Code.

Vérifications préalables

Éléments à confirmerComment vérifierPourquoi
Claude Code peut démarrer dès maintenantVérifiez dans le terminal ou le client que Claude Code s'ouvre normalementCC Switch gère uniquement le basculement des configurations, pas l'installation de Claude Code
Le fournisseur prend en charge Claude CodeVous trouverez des instructions relatives à Claude / Anthropic / Claude Code dans le tableau de bord ou la documentationLes fournisseurs qui ne proposent que des interfaces compatibles OpenAI peuvent ne pas fonctionner avec Claude Code
La clé et le nom du modèle sont utilisablesVous pouvez voir les jetons, les clés, les listes de modèles ou les instructions sur les modèles disponibles dans le tableau de bordUne erreur dans le nom du modèle entraînera directement une erreur de type modèle introuvable
Ne modifiez qu'un seul outil cible pour commencerAu départ, sélectionnez uniquement Claude CodeIl est plus facile d'identifier l'élément en cause lors du dépannage

Comment remplir les champs

ParamètreMéthode de saisieAttention pour les débutants
Nom du fournisseurIndiquez un nom facile à reconnaîtrePar exemple, « Fournisseur principal Claude », ne mettez pas seulement des chiffres
Outil cible / PréréglageSélectionnez Claude Code ou un préréglage lié à ClaudeNe sélectionnez pas Codex, OpenAI ou Gemini
Base URLCopiez le lien d'API fourni par le tableau de bord du fournisseur pour Claude / AnthropicTous les fournisseurs ne partagent pas la même Base URL qu'OpenAI
Clé APICopiez la clé complète générée dans le tableau de bordElle est souvent appelée token, Key ou clé secrète
Nom du modèleCopiez exactement le nom du modèle Claude pris en charge par le tableau de bordNe l'abrégez pas vous-même et ne confondez pas le nom d'affichage avec le nom du modèle
Si le tableau de bord du fournisseur sépare différents protocoles, Claude Code utilise le groupe Claude / Anthropic. Remplissez selon cette consigne uniquement si le tableau de bord indique explicitement que « Claude Code utilise une adresse compatible OpenAI ».

Appliquer à Claude Code

  1. Ouvrez CC Switch et accédez à la section de gestion des fournisseurs.
  2. Ajoutez un nouveau fournisseur ou choisissez une configuration de fournisseur déjà créée.
  3. Sélectionnez les préréglages associés à l'outil cible Claude Code.
  4. Renseignez dans l'ordre le nom du fournisseur, la Base URL, la clé API et le nom du modèle.
  5. Après avoir enregistré, exécutez Apply / Switch pour appliquer le fournisseur actuel à Claude Code.
  6. Si la page vous invite à redémarrer le terminal ou l'outil cible, fermez la session Claude Code en cours puis rouvrez-la.

Tester le bon fonctionnement

Lors du test, envoyez d'abord une question très courte et n'ouvrez pas directement un vrai projet. Tant qu'une réponse normale est renvoyée, cela indique que la clé, la Base URL, le nom du modèle et la synchronisation de l'outil cible sont globalement opérationnels.

Test minimal de Claude Code
claude "Please reply only: CC-Switch Claude Code is active"
Si le test échoue, vérifiez dans cet ordre de priorité : si l'outil cible est mal sélectionné, si la Base URL correspond bien à Claude / Anthropic, si la clé est copiée dans son intégralité et si le nom du modèle est copié exactement depuis le tableau de bord.