CC Switch

Trois champs et deux menus déroulants. https://api.kunavo.com comme point de terminaison, votre clé sk-kn-… et — le détail omis par la plupart des guides — laissez API Format sur Anthropic Messages (Native) et Auth Field sur ANTHROPIC_AUTH_TOKEN. Kunavo prend en charge nativement l’API Messages ; aucun routage local n’est donc nécessaire du côté de Claude Code.

Provider Name   Kunavo
API Key         sk-kn-...
API Endpoint    https://api.kunavo.com      <- service root, no /v1, no trailing slash

Advanced Options
  API Format    Anthropic Messages (Native) <- the default; do NOT switch
  Auth Field    ANTHROPIC_AUTH_TOKEN (Default)

Étapes à suivre (onglet Claude Code)

1. Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
2. Ouvrez CC Switch dans l’onglet principal Claude Code et cliquez sur le bouton plus. Conservez la valeur par défaut Custom Configuration plutôt qu’un préréglage.
3. Renseignez Provider Name, API Key et définissez API Endpoint sur https://api.kunavo.com.
4. Développez Advanced Options et vérifiez que API Format est défini sur Anthropic Messages (Native) et Auth Field sur ANTHROPIC_AUTH_TOKEN (Default). Ce sont les valeurs par défaut ; il s’agit de vérifier, pas de modifier.
5. Enregistrez, puis Activate. La carte ne doit pas afficher de marqueur Needs Routing — ce marqueur apparaît uniquement pour les fournisseurs dont le protocole doit être converti.

Pourquoi le marqueur « Routage requis » n’apparaît pas

Le routage local de CC Switch sert à faire le pont entre les protocoles. Claude Code envoie des requêtes Anthropic Messages à /v1/messages ; une passerelle qui n’expose que l’API OpenAI Chat Completions ou Responses ne peut pas y répondre. La route convertit donc la requête à l’aller et la réponse au retour. Cette conversion remodèle les événements de diffusion en continu, les appels d’outils et la configuration de réflexion — cela fonctionne, mais ajoute un élément intermédiaire entre votre éditeur et le modèle.

Kunavo fournit directement POST /v1/messages ; côté Claude Code, rien n’est donc à convertir : le fournisseur reste Anthropic Messages (Native) et la route n’intervient pas du tout. Kunavo fournit aussi POST /v1/chat/completions et POST /v1/responses avec la même clé, ce qui permet d’utiliser Codex comme décrit ci-dessous.

Utiliser des modèles Claude dans Codex

C’est le cas que les guides des autres fournisseurs ne couvrent pas. Codex utilise l’API OpenAI Responses ; si vous le pointez directement vers un point de terminaison /v1/messages, vous obtenez une erreur 404. CC Switch résout ce problème en maintenant Codex sur la route locale et en effectuant la conversion. Dans l’onglet Codex, il n’y a pas de préréglage Anthropic ; il s’agit donc également d’une Custom Configuration :

Provider Name      Kunavo
API Key            sk-kn-...
API Request URL    https://api.kunavo.com
Default Model      claude-sonnet-5

Advanced Options
  Upstream Format  Anthropic Messages (routing required)

Mappage des modèles

CC Switch associe les trois niveaux de Claude Code à de véritables identifiants de modèle. Renseignez les trois niveaux ainsi que Default fallback model — les requêtes non correspondantes passent autrement avec leur nom Claude d’origine et échouent en amont. Les tarifs sont en USD par million de jetons, entrée / sortie, et sont lus en direct depuis le catalogue.

Vérifiez avant de déboguer l’application

Une paire de requêtes suffit à déterminer si l’échec vient de la clé, du point de terminaison ou de CC Switch. Si les deux renvoient 200, tout problème persistant vient d’un champ du formulaire — presque toujours Auth Field ou un /v1 qui ne devrait pas figurer dans le point de terminaison.

# Settles whether a failure is the key, the endpoint, or CC Switch.
# 200 + a JSON list of model ids means the same key works in the app.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

# The Anthropic face, which is the one the Claude Code tab actually calls.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":16,
       "messages":[{"role":"user","content":"ping"}]}'

Références

CC Switch est un logiciel libre disponible sur github.com/farion1231/cc-switch. Les noms des champs et leur comportement décrits ci-dessus proviennent de ses propres guides : le guide de routage pour Claude Code et le guide de routage pour Codex, qui précisent tous deux s’appliquer à la version 3.17.0 et aux suivantes. Le formulaire diffère dans les anciennes versions ; consultez la section À propos de l’application si un champ mentionné ici est absent. La configuration côté Kunavo est décrite dans l’API Messages, Chat Completions et le centre d’intégrations.