Si vous recherchez CC Switch Claude Code, vous avez probablement déjà installé l’assistant de codage. Le problème de configuration est plus précis : vous devez demander à CC Switch d’écrire la bonne configuration du fournisseur Claude Code, utiliser la bonne clé Flatkey, pointer vers la bonne URL de base, choisir des modèles auxquels votre clé peut réellement accéder et vérifier la requête dans les journaux d’utilisation.
Ce guide couvre la voie pratique pour le routage CC Switch Claude Code avec Flatkey et le workflow de type NewAPI en un clic. La documentation actuelle de NewAPI sur CC Switch décrit une importation via lien profond ccswitch:// depuis la page du jeton New API. Les utilisateurs de Flatkey peuvent utiliser la même surface de configuration CC Switch manuellement : ajoutez un fournisseur Claude Code, collez une clé API Flatkey, définissez l’URL de base de la passerelle Claude Code, récupérez les modèles, enregistrez le profil et vérifiez la route.
Ce guide est uniquement textuel. Il n’utilise pas de captures d’écran de l’application, car le flux actuel de l’interface CC Switch et Flatkey doit être vérifié par capture d’écran avant de publier des images d’étapes.
Réponse rapide : paramètres CC Switch Claude Code pour Flatkey
Pour une configuration CC Switch Claude Code adossée à Flatkey, créez un fournisseur Claude Code dans CC Switch et utilisez le routeur Flatkey comme passerelle. Pour les requêtes de style Anthropic Messages de Claude Code, utilisez l’URL racine de la passerelle, et non le chemin OpenAI chat-completions.
| Champ ou config CC Switch | Valeur Flatkey | À vérifier |
|---|---|---|
| Application | Claude ou Claude Code |
Ne configurez pas l’application Codex ou Gemini lorsque la cible est Claude Code. |
| Onglet Provider | App-specific Provider pour Claude Code, ou Universal Provider si vous synchronisez aussi Codex/Gemini |
Les fournisseurs universels nécessitent une vérification après synchronisation, car chaque application peut attendre une forme d’URL différente. |
| Name | Flatkey Claude Code |
Utilisez un nom qui sera clair plus tard dans la sélection par tray de CC Switch. |
| API Key | Votre clé API Flatkey | Créez-la ou copiez-la depuis le tableau de bord Flatkey. Ne collez jamais une vraie clé dans des documents partagés. |
| Claude Code base URL | https://router.flatkey.ai |
Utilisez cette valeur pour ANTHROPIC_BASE_URL. Claude Code accède alors à des chemins tels que /v1/messages. |
| OpenAI-compatible base URL | https://router.flatkey.ai/v1 |
Utilisez cette valeur pour les clients compatibles OpenAI et les vérifications de récupération des modèles qui appellent /v1/models. |
| Main/Sonnet/Opus/Haiku models | Identifiants de modèle provenant du résultat de fetch de CC Switch, de la console Flatkey ou du catalogue tarifaire | Utilisez les identifiants exacts des modèles. N’utilisez pas les noms marketing ni les libellés de famille de modèles. |
| Verification | Lancez une petite invite Claude Code et consultez les journaux d’utilisation Flatkey | La configuration n’est pas terminée tant que la requête n’apparaît pas dans le tableau de bord Flatkey. |
Si votre formulaire CC Switch expose un éditeur JSON avancé, le profil Claude Code devrait se résoudre à une forme comme celle-ci. Utilisez un placeholder dans la documentation ; ne stockez jamais une clé active dans un dépôt.
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-fk-your-flatkey-key",
"ANTHROPIC_BASE_URL": "https://router.flatkey.ai",
"ANTHROPIC_MODEL": "your-claude-model-id"
}
}Claude Code prend également en charge ANTHROPIC_API_KEY. Utilisez une seule variable d’authentification, pas les deux, sauf si vous comprenez intentionnellement la priorité. Pour un routage de passerelle de type bearer, ANTHROPIC_AUTH_TOKEN rend le mappage explicite, car Claude Code l’envoie comme valeur de l’en-tête Authorization.
Où NewAPI s’insère dans le workflow CC Switch
La documentation actuelle de NewAPI sur CC Switch indique que la console New API peut ajouter un raccourci vers les paramètres de Chat avec ce JSON :
{ "CC Switch": "ccswitch" }Ensuite, la page de gestion des jetons de New API peut afficher une option CC Switch qui lance CC Switch via le lien profond ccswitch:// et ouvre la boîte de dialogue d’import du fournisseur. La documentation de NewAPI décrit les champs de cette boîte de dialogue comme étant le type d’application, le nom, le modèle principal et les sélections de modèle Haiku/Sonnet/Opus.
Pour Flatkey, utilisez le même concept sans prétendre à un import depuis la page de jetons de NewAPI. Si votre clé est une clé Flatkey, ajoutez directement le fournisseur dans CC Switch. Si votre clé se trouve dans un déploiement NewAPI, utilisez l’import en un clic de NewAPI. La distinction importante est simple : CC Switch gère la configuration locale de Claude Code, tandis que Flatkey ou NewAPI gère la couche de routage en amont.
Avant de commencer
Avant de modifier le fournisseur CC Switch Claude Code, confirmez ces prérequis :
- CC Switch est installé sur la machine où Claude Code s’exécute.
- Claude Code est déjà installé et peut s’ouvrir normalement.
- Vous pouvez vous connecter à Flatkey et ouvrir le tableau de bord.
- Vous disposez d’une clé API Flatkey pour ce poste de travail ou ce développeur.
- Vous connaissez au moins un ID de modèle Claude disponible pour votre compte Flatkey.
- Vous pouvez consulter les journaux d’utilisation Flatkey après la première requête de test.
N’utilisez pas une clé de production partagée pour le premier test. Créez une clé limitée nommée d’après l’outil et le propriétaire, par exemple cc-switch-lee ou claude-code-devbox. Cela permet de vérifier facilement le premier test rapide de CC Switch Claude Code et de le révoquer facilement.
Étape 1 : Créer ou copier une clé API Flatkey
Ouvrez le tableau de bord Flatkey et créez une clé pour l’utilisation de Claude Code via CC Switch. Copiez-la une seule fois et stockez-la dans votre gestionnaire de mots de passe ou dans le gestionnaire de secrets de votre équipe.
Le champ de clé API CC Switch doit contenir la clé Flatkey. N’insérez pas une clé Anthropic, OpenAI, Google ou spécifique à un fournisseur dans ce profil, sauf si vous configurez intentionnellement ce fournisseur direct à la place de Flatkey.
Pour les équipes, créez des clés distinctes par utilisateur, appareil ou environnement. Une clé partagée peut fonctionner techniquement, mais elle rend l’examen de l’utilisation et la révocation plus difficiles par la suite.
Étape 2 : ajouter un fournisseur Claude Code dans CC Switch
Ouvrez CC Switch et accédez à la zone des fournisseurs Claude Code. Le manuel utilisateur de CC Switch décrit deux parcours d’ajout : des fournisseurs spécifiques à l’application pour l’application sélectionnée, et un fournisseur universel pour une configuration partagée entre Claude Code, Codex et Gemini.
Pour la première configuration Flatkey CC Switch Claude Code, commencez par un fournisseur Claude Code spécifique à l’application :
- Ouvrez CC Switch.
- Sélectionnez Claude ou Claude Code dans le sélecteur d’application.
- Cliquez sur le bouton + pour ajouter un fournisseur.
- Choisissez un chemin de fournisseur personnalisé s’il n’existe pas de préréglage Flatkey.
- Définissez le nom du fournisseur sur
Flatkey Claude Code. - Collez votre clé API Flatkey.
- Définissez l’URL de base du passerelle Claude Code sur
https://router.flatkey.ai. - Choisissez les ID de modèle pour Main, Sonnet, Opus et Haiku uniquement après avoir confirmé qu’ils sont disponibles pour votre compte.
Si vous utilisez un fournisseur universel, renseignez Name, API Key et Endpoint URL, puis cochez les applications que vous souhaitez synchroniser. Après la synchronisation, inspectez la configuration Claude Code générée. Pour Claude Code, la base active doit être https://router.flatkey.ai. Pour les configurations d’applications compatibles OpenAI, https://router.flatkey.ai/v1 est généralement l’URL de base attendue.
Étape 3 : récupérer les modèles avant de choisir Main, Sonnet, Opus et Haiku
CC Switch documente une action Fetch Models à côté des entrées de modèle. Elle utilise la clé API configurée pour appeler un point de terminaison /v1/models compatible avec OpenAI, puis vous permet de sélectionner les identifiants de modèle renvoyés dans une liste déroulante.
Pour cet article, une vérification datée de Flatkey le 11 juin 2026 a renvoyé HTTP 200 depuis https://router.flatkey.ai/v1/models avec une réponse de liste de modèles pour la clé de test configurée. Les exemples renvoyés incluaient des identifiants de modèles de la famille Claude tels que claude-sonnet-4-6, claude-sonnet-4-5, claude-opus-4-7 et claude-haiku-4-5. Considérez ces exemples comme un instantané actuel, et non comme une recommandation permanente de modèle.
Utilisez cette règle de sélection des modèles :
- Modèle principal : choisissez le modèle Claude que vous souhaitez utiliser par défaut avec Claude Code.
- Modèle Sonnet : choisissez le modèle équilibré que votre équipe attend pour le codage quotidien.
- Modèle Opus : choisissez un modèle aux capacités supérieures uniquement si votre budget et votre accès le permettent.
- Modèle Haiku : choisissez un modèle léger pour des tâches plus rapides ou en arrière-plan, si disponible.
Si Fetch Models échoue, ne devinez pas. Ouvrez la console Flatkey ou le catalogue des tarifs, copiez un identifiant exact de modèle compatible Claude, et testez d’abord uniquement avec ce modèle.
Étape 4 : Enregistrer, synchroniser et vérifier la configuration Claude Code générée
Après avoir enregistré le fournisseur, CC Switch écrit la configuration active du fournisseur pour Claude Code. Le chemin exact du fichier peut varier selon la version de CC Switch et la portée de l’application, mais la documentation officielle des paramètres de Claude Code confirme que les variables d’environnement peuvent être configurées via settings.json sous la clé env.
Vérifiez que la configuration générée ne contient pas de valeurs d’authentification en conflit. Un profil Flatkey propre devrait suivre l’un de ces schémas :
# Style passerelle avec jeton Bearer
ANTHROPIC_AUTH_TOKEN=sk-fk-your-flatkey-key
ANTHROPIC_BASE_URL=https://router.flatkey.aiou :
# Style clé API
ANTHROPIC_API_KEY=sk-fk-your-flatkey-key
ANTHROPIC_BASE_URL=https://router.flatkey.aiNe laissez pas une ancienne clé Anthropic directe active dans votre shell pendant que vous testez un nouveau profil CC Switch Claude Code. Si le shell exporte encore une autre ANTHROPIC_API_KEY, cela peut compliquer le dépannage, car le processus actif peut ne pas utiliser le profil CC Switch que vous pensez utiliser.
Étape 5 : Vérifier dans Claude Code et les journaux d’utilisation de Flatkey
Ouvrez un nouveau terminal après avoir activé le fournisseur Flatkey dans CC Switch. Claude Code peut prendre en charge le changement à chaud dans certains chemins de CC Switch, mais un nouveau terminal élimine toute confusion liée à l’état du shell lors du premier test.
- Démarrez Claude Code.
- Vérifiez le modèle actif ou l’état dans Claude Code.
- Envoyez une petite requête, par exemple en lui demandant de répondre par une seule phrase courte.
- Ouvrez le tableau de bord Flatkey.
- Examinez les journaux d’utilisation pour l’heure de la requête, l’ID du modèle et le nom de la clé.
La configuration CC Switch Claude Code n’est terminée que lorsque les trois niveaux concordent : CC Switch affiche le fournisseur Flatkey comme actif, Claude Code utilise le modèle/l’URL de base attendu, et les journaux Flatkey montrent la requête.
Dépannage de CC Switch Claude Code avec Flatkey
| Problème | Cause probable | Correction |
|---|---|---|
| Erreur d'authentification | La clé est incorrecte, désactivée, copiée avec des espaces, ou n'est pas une clé Flatkey. | Créez une nouvelle clé dans Flatkey, collez-la à nouveau, et vérifiez que vous utilisez soit ANTHROPIC_AUTH_TOKEN soit ANTHROPIC_API_KEY, sans valeurs conflictuelles. |
| 404 ou chemin de point de terminaison incorrect | L'URL inclut la mauvaise forme de chemin pour Claude Code. | Pour Claude Code, utilisez https://router.flatkey.ai. Pour l'extraction de modèles compatible OpenAI ou d'autres clients, utilisez https://router.flatkey.ai/v1. |
| Échec de Fetch Models | La clé ne peut pas appeler /v1/models, l'URL de base est incorrecte, ou le point de terminaison est temporairement indisponible. |
Utilisez https://router.flatkey.ai/v1 pour le chemin de récupération des modèles, puis revenez aux identifiants exacts des modèles depuis la console Flatkey. |
| Claude Code utilise encore l'ancien fournisseur | Un ancien processus de terminal ou une exportation de shell remplace le profil CC Switch. | Ouvrez un nouveau terminal, vérifiez les variables d'environnement du shell, et assurez-vous que le fournisseur Flatkey est activé dans CC Switch. |
| La sélection du modèle fonctionne mais les requêtes échouent | Le modèle sélectionné est सूचीé mais n'est pas disponible pour votre clé, groupe, solde ou politique de compte actuelle. | Testez d'abord un modèle dont l'accès est connu. Consultez l'accès au compte Flatkey, le solde, les quotas et les journaux d'utilisation. |
| La recherche d'outil MCP modifie le comportement | Claude Code traite les URL de base qui ne sont pas celles du fournisseur principal comme du routage de passerelle. | Suivez les নির্দেশances de passerelle de Claude Code avant d'activer un comportement avancé de recherche d'outils via un proxy. N'activez pas de drapeaux spécifiques à la passerelle, sauf si votre passerelle relaie les blocs requis. |
La plupart des échecs de CC Switch Claude Code se résument à quatre champs : clé, URL de base, identifiant du modèle et profil actif. Vérifiez-les avant de reconstruire toute la base de données CC Switch.
CC Switch Vs A Claude Code Router
CC Switch et un routeur Claude Code résolvent différentes parties du flux de travail. CC Switch est le gestionnaire de configuration local. Flatkey est la couche de routage et d'accès.
| Couche | Ce qu'elle fait | Ce qu'elle ne fait pas |
|---|---|---|
| CC Switch | Stocke les profils de fournisseurs, bascule les configurations Claude Code/Codex/Gemini, gère les champs des modèles et peut importer des fournisseurs via des liens profonds. | Ce n'est ni le compte de modèle en amont, ni le système de facturation, ni le routeur. |
| Claude Code | Exécute l'assistant de codage et lit les valeurs actives d'environnement/de configuration. | Il ne gère pas à lui seul les clés multi-fournisseurs de votre équipe ni la facturation. |
| Flatkey | Fournit une clé unique, des points de terminaison de passerelle, l'accès aux modèles, la visibilité de l'utilisation, le routage et les contrôles de facturation pour les modèles pris en charge. | Il ne remplace pas l'interface utilisateur locale de changement de profil de CC Switch. |
Si vous n'avez besoin que d'un seul paramètre de passerelle permanent, vous pouvez configurer Claude Code directement. Si vous basculez entre plusieurs fournisseurs, postes de travail ou niveaux de modèles, le flux de travail CC Switch Claude Code vous offre une surface de contrôle plus claire. Si vous migrez également le code de l'application vers une passerelle, lisez le guide Migration d'API compatible OpenAI. Si vous hésitez entre un proxy Claude uniquement et une passerelle plus large, lisez proxy Claude API vs routeur.
Déploiement d’équipe recommandé
Pour un développeur, une clé Flatkey et un fournisseur CC Switch suffisent. Pour une équipe, considérez la configuration CC Switch Claude Code comme un petit déploiement de contrôle d’accès.
- Créez une clé Flatkey nommée par développeur, poste de travail ou environnement.
- Documentez les identifiants de modèle Claude approuvés et la catégorie à laquelle chacun correspond dans CC Switch.
- Utilisez des quotas avant d’inviter davantage d’utilisateurs dans la même configuration de routage.
- Examinez les journaux d’utilisation après le premier jour, et pas seulement après une mauvaise surprise sur la facturation.
- Évitez d’inclure des captures d’écran dans les documents publics tant que l’interface actuelle n’a pas été validée par le relecteur.
- Utilisez l’importation en un clic de NewAPI uniquement pour les clés gérées dans NewAPI ; utilisez la configuration manuelle du fournisseur Flatkey pour les clés Flatkey.
FAQ
Qu'est-ce qu'une configuration CC Switch Claude Code ?
Une configuration CC Switch Claude Code est un profil de fournisseur dans CC Switch qui définit le point de terminaison, la clé et les paramètres de modèle que Claude Code doit utiliser. Avec Flatkey, ce profil pointe Claude Code vers le routeur Flatkey et utilise une clé Flatkey.
L'URL de base Flatkey Claude Code doit-elle inclure /v1 ?
Pour ANTHROPIC_BASE_URL de Claude Code, utilisez https://router.flatkey.ai. Pour les clients d'application compatibles OpenAI et les vérifications de récupération de modèle qui appellent explicitement /v1/models, utilisez https://router.flatkey.ai/v1.
L'importation en un clic de NewAPI configure-t-elle Flatkey automatiquement ?
Non. Le parcours CC Switch en un clic de NewAPI est documenté pour la page de gestion des jetons New API. Pour Flatkey, ajoutez le fournisseur manuellement dans CC Switch, sauf si Flatkey publie plus tard un lien d'importation dédié ccswitch://.
CC Switch peut-il récupérer les modèles Flatkey ?
Oui, lorsque la clé configurée peut accéder à la liste de modèles compatible OpenAI de Flatkey. Une vérification effectuée le 11 juin 2026 pour cet article a renvoyé HTTP 200 depuis https://router.flatkey.ai/v1/models et une réponse de liste de modèles pour la clé de test configurée.
Dois-je utiliser ANTHROPIC_API_KEY ou ANTHROPIC_AUTH_TOKEN ?
Claude Code documente les deux. ANTHROPIC_API_KEY est envoyé comme en-tête de clé API, tandis que ANTHROPIC_AUTH_TOKEN est envoyé via le chemin d'autorisation. Utilisez une seule méthode claire pour le profil Flatkey, et évitez de laisser les deux définis avec des valeurs différentes.
Comment savoir si la configuration a fonctionné ?
La configuration a fonctionné lorsque CC Switch indique que le fournisseur Flatkey est actif, que Claude Code utilise le modèle attendu, qu'une petite invite de test réussit et que la requête apparaît dans les journaux d'utilisation Flatkey.
Vérification finale
Votre configuration Flatkey CC Switch Claude Code est prête lorsque cette liste de contrôle est validée :
- CC Switch dispose sous Claude Code d’un fournisseur Flatkey clairement nommé.
- La clé API est une clé Flatkey provenant du tableau de bord.
ANTHROPIC_BASE_URLpointe vershttps://router.flatkey.ai.- Les identifiants de modèle sélectionnés correspondent exactement aux identifiants disponibles pour votre clé.
- La récupération des modèles ou la saisie manuelle d’un modèle réussit.
- Claude Code exécute une petite invite de test.
- Les journaux d’utilisation Flatkey affichent la requête.
Obtenez une clé pour acheminer Claude Code via Flatkey, puis utilisez CC Switch pour garder le profil du fournisseur local facile à basculer, à निरीpেকter et à restaurer.
