BroadRouter
Commencer

Claude Code et modèles ouverts : proxys, endpoints natifs, limites

Par l’équipe BroadNet Inference · 6 min de lecture · Publié

Claude Code envoie des requêtes au format de l’API Messages d’Anthropic vers ANTHROPIC_BASE_URL. Pour utiliser un fournisseur compatible OpenAI, lancez un proxy de traduction comme LiteLLM et pointez Claude Code vers lui, ou choisissez un fournisseur doté de son propre endpoint au format Anthropic, comme DeepSeek ou Z.ai. Anthropic ne prend pas en charge les modèles non Claude dans Claude Code : testez vous-même outils, cache et limites de contexte.

Claude Code envoie chaque requête au format de l’API Messages d’Anthropic, vers /v1/messages à l’adresse indiquée par ANTHROPIC_BASE_URL. La plupart des fournisseurs de modèles ouverts, BroadNet Inference compris, parlent plutôt le format OpenAI. Il vous faut donc soit un proxy qui traduit entre les deux, soit un fournisseur qui publie son propre endpoint au format Anthropic. Cet article couvre les deux, ainsi que les limites qui décident si l’effort en vaut la peine.

Pourquoi Claude Code ne peut-il pas appeler directement une API compatible OpenAI ?

Le guide de compatibilité des passerelles de Claude Code liste les formats qu’une passerelle doit exposer. Pour une URL de base simple, c’est Anthropic Messages : /v1/messages, avec /v1/messages/count_tokens en option, et les en-têtes anthropic-beta et anthropic-version transmis. Une API compatible OpenAI sert /v1/chat/completions avec une autre forme de requête et de réponse. Pointez Claude Code directement dessus, et les requêtes échouent.

Une chose encore à savoir avant de commencer. La documentation de Claude Code elle-même indique qu’Anthropic « doesn’t support routing Claude Code to non-Claude models through any gateway » (traduction : « ne prend pas en charge le routage de Claude Code vers des modèles non Claude, quelle que soit la passerelle »). Beaucoup le font quand même, mais personne chez Anthropic ne le déboguera pour vous.

Quelles sont vos trois options ?

Voie Fonctionnement Idéal pour Contrepartie
Proxy de traduction (LiteLLM) Claude Code parle le format Anthropic à un proxy local ; le proxy appelle le fournisseur compatible OpenAI Utiliser un fournisseur compatible OpenAI précis, comme BroadNet Un processus de plus à faire tourner et à mettre à jour ; lacunes de traduction
Endpoint natif au format Anthropic Le fournisseur accepte lui-même /v1/messages Les modèles DeepSeek ou GLM chez leurs créateurs Chacun fait correspondre ou ignore certains champs
Un autre agent Utiliser un agent qui accepte une URL de base compatible OpenAI Tous ceux qui n’ont pas besoin de Claude Code en particulier Vous renoncez à l’interface et aux fonctions de Claude Code

Comment faire passer Claude Code par LiteLLM ?

Le tutoriel de LiteLLM pour les modèles non Anthropic fonctionne ainsi : installez le proxy, définissez les modèles dans config.yaml, démarrez-le, puis réglez deux variables pour Claude Code. LiteLLM traduit entre les formats, si bien que Claude Code continue d’envoyer des requêtes Anthropic.

Définissez les modèles BroadNet comme dans le guide LiteLLM, avec le préfixe openai/ et api_base :

model_list:
  - model_name: glm
    litellm_params:
      model: openai/broadnet/glm-5.3
      api_base: https://inference.broadnet.ai/v1
      api_key: os.environ/BROADNET_API_KEY
      rpm: 30
  - model_name: qwen
    litellm_params:
      model: openai/broadnet/qwen3.8-27b
      api_base: https://inference.broadnet.ai/v1
      api_key: os.environ/BROADNET_API_KEY
      rpm: 30

general_settings:
  master_key: os.environ/LITELLM_MASTER_KEY

Démarrez le proxy :

uv tool install 'litellm[proxy]'
export BROADNET_API_KEY='your-broadnet-key'
export LITELLM_MASTER_KEY='sk-any-local-secret'
litellm --config config.yaml   # listens on http://0.0.0.0:4000

Pointez ensuite Claude Code vers lui. ANTHROPIC_AUTH_TOKEN part sous forme d’en-tête Authorization: Bearer, ce que lit LiteLLM :

export ANTHROPIC_BASE_URL=http://0.0.0.0:4000
export ANTHROPIC_AUTH_TOKEN="$LITELLM_MASTER_KEY"
export ANTHROPIC_MODEL=glm                  # main model
export ANTHROPIC_DEFAULT_HAIKU_MODEL=qwen   # background tasks
export ANTHROPIC_DEFAULT_SONNET_MODEL=glm   # the sonnet alias
export ANTHROPIC_DEFAULT_OPUS_MODEL=glm     # the opus alias
export CLAUDE_CODE_SUBAGENT_MODEL=glm       # subagents
claude

Lancez /status dans Claude Code. La ligne Anthropic base URL doit afficher l’adresse du proxy.

Les variables de modèle comptent. La page Claude Code de LiteLLM prévient que choisir un nom Claude intégré que votre configuration ne définit pas échoue avec « Invalid model name passed in ». La référence des variables d’environnement de Claude Code indique que ANTHROPIC_DEFAULT_HAIKU_MODEL sert aussi aux fonctions d’arrière-plan : faites-la correspondre elle aussi, sinon les requêtes d’arrière-plan demandent un nom Haiku que le proxy ne connaît pas. CLAUDE_CODE_SUBAGENT_MODEL définit le modèle par défaut des sous-agents, mais un modèle que Claude transmet en lançant un sous-agent, souvent un alias comme sonnet ou haiku, a la priorité. En faisant aussi correspondre les alias sonnet et opus, ces requêtes aboutissent quand même à un modèle connu du proxy. Gardez votre clé BroadNet dans l’environnement du proxy, jamais dans un .claude/settings.json versionné dans un projet.

Quels endpoints DeepSeek et GLM fonctionnent sans proxy ?

Deux créateurs de modèles publient des URL de base au format Anthropic :

Fournisseur URL de base Gestion des modèles (d’après leur documentation, vérifiée le 2026-11-15)
DeepSeek https://api.deepseek.com/anthropic Les noms claude-sonnet* et claude-haiku* correspondent à deepseek-flash ; claude-opus* à deepseek-v4-pro ; les noms qui ne commencent pas par claude renvoient 400
Z.ai (GLM Coding Plan) https://api.z.ai/api/anthropic Clé dans ANTHROPIC_AUTH_TOKEN ; l’exemple de configuration manuelle fait correspondre Opus et Sonnet à glm-5.3[1m] et Haiku à glm-5.3-flash[1m]

La note de version de DeepSeek du 10 septembre 2026 indique que deepseek-flash sert DeepSeek-V4.1-Flash. Sa page sur l’API Anthropic liste aussi ce qu’elle ignore : cache_control, budget_tokens, disable_parallel_tool_use et l’en-tête anthropic-version, entre autres. Sur deepseek-flash, les images dans les messages de l’assistant renvoient 400, et deepseek-v4-pro remplace les images par « [Unsupported Image] ».

Si vous voulez seulement DeepSeek ou GLM dans Claude Code, ces endpoints natifs sont le chemin le plus court. Les prix et les limites de forfait des deux sont comparés sur la page des alternatives à l’API Claude.

Qu’est-ce qui casse ou change avec un modèle non Claude ?

La traduction fait circuler les requêtes, mais plusieurs fonctions de Claude Code dépendent d’éléments qu’un proxy ou un autre modèle peut ne pas transmettre. La documentation de Claude Code les cite :

  • Prompt caching. Claude Code marque les blocs system et les blocs de message avec cache_control. Si la passerelle ou l’amont l’abandonne, il n’y a pas d’erreur, mais chaque tour est facturé comme entrée hors cache. Sur un amont compatible OpenAI, le cache suit plutôt les règles propres au fournisseur. BroadNet facture l’entrée en cache à un prix réduit quand son bloc usage signale un hit de cache ; vérifiez cached_tokens dans vos journaux.
  • Comptage des tokens. Sans /v1/messages/count_tokens, Claude Code se rabat sur une estimation fondée sur les caractères : /context devient approximatif.
  • Fenêtre de contexte. Claude Code applique sa propre fenêtre par défaut aux noms de modèles qu’il ne reconnaît pas. Réglez CLAUDE_CODE_AUTO_COMPACT_WINDOW (de 100 000 à 1 000 000 tokens) selon le modèle. Pour Qwen3.8 27B, avec un contexte de 262 144 tokens, réglez-la bien en dessous.
  • Champs inconnus. Une erreur 400 mentionnant Extra inputs are not permitted ou une valeur anthropic-beta signifie qu’un élément en amont a rejeté un champ en préversion. La documentation suggère CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1.
  • Réflexion. MAX_THINKING_TOKENS et la réflexion adaptative sont des fonctions de Claude. Chez BroadNet, DeepSeek V4.1 Flash, GLM 5.3 et Qwen3.8 27B raisonnent avant de répondre, et ces tokens de raisonnement comptent dans max_tokens. Si les réponses reviennent vides, augmentez la limite de sortie ou envoyez reasoning_effort à low. Voir pourquoi les modèles de raisonnement renvoient des réponses vides.
  • Images. GLM 5.3 ne traite que du texte chez BroadNet. Utilisez Qwen3.8 27B si vous collez des captures d’écran.

Testez une vraie tâche de bout en bout, avec des modifications de fichiers, des commandes shell et une longue session, avant de vous y fier.

Quel modèle BroadNet placer derrière Claude Code ?

Claude Code lit des fichiers, les modifie et exécute des commandes par des appels d’outils. La référence de l’API de BroadNet documente les outils, la sortie structurée et le raisonnement pour deux modèles :

Modèle Entrée / sortie par million de tokens Contexte Images Outils documentés
GLM 5.3 $0.78 / $3.46 1 048 576 Non Oui
Qwen3.8 27B $0.175 / $2.17 262 144 Oui Oui
DeepSeek V4.1 Flash $0.175 / $0.52 1 048 576 Oui Non documentés

GLM 5.3 est le modèle principal naturel pour les grands dépôts. Qwen3.8 27B coûte moins cher par token d’entrée et convient aux images et aux appels d’arrière-plan plus légers. Les deux nécessitent une recharge ; ils ne sont pas couverts par le crédit de départ de $5. La comparaison GLM 5.3 vs Qwen3.8 27B les met côte à côte.

Pouvez-vous utiliser le forfait de BroadNet avec Claude Code ?

Ce n’est pas une combinaison documentée, et mieux vaut le savoir avant d’acheter. Les forfaits Full Moon, Orbit et Meteor ne couvrent que DeepSeek V4.1 Flash, et BroadNet ne documente pas l’appel d’outils pour ce modèle. Chaque session de forfait traite aussi une requête à la fois. Claude Code peut lancer des sous-agents et des tâches d’arrière-plan en plus de la boucle principale, et ces requêtes feraient la queue sur une seule session.

Si c’est un prix fixe que vous cherchez, utilisez un agent que BroadNet documente avec le forfait, comme Aider. Pour Claude Code, utilisez GLM 5.3 ou Qwen3.8 27B en paiement à l’usage, qui autorisent 30 requêtes par minute et 4 requêtes en cours par clé. En cas de 429, appliquez un backoff comme dans erreurs et relances.

Quand un autre agent est-il le meilleur choix ?

Si vous n’avez pas besoin de Claude Code lui-même, passez-vous du proxy. opencode, Cline, Roo Code, Continue et Aider acceptent tous directement une URL de base compatible OpenAI, une clé et un ID de modèle. Les noms des champs pour chacun figurent dans utiliser des modèles ouverts dans les agents de code, avec des guides de configuration pour opencode et Cline. Moins de pièces mobiles, c’est moins de bugs de traduction. Pour comparer les modèles pour ce travail, voir le meilleur modèle ouvert pour les agents de code.

Restez sur les modèles Claude si votre travail dépend de fonctions propres à Claude, comme l’extended thinking, le prompt caching d’Anthropic ou les dernières bêtas de Claude Code. Dans ce cas, réduisez les coûts dans Claude Code plutôt que de changer de modèle.

La place de BroadNet Inference

BroadNet Inference est une API compatible OpenAI : il ne rejoint donc Claude Code que via un proxy comme LiteLLM. Derrière un proxy, GLM 5.3 et Qwen3.8 27B sont les deux modèles avec appel d’outils documenté, facturés au token, sans conservation du contenu après la requête. Si vous voulez un endpoint natif au format Anthropic, DeepSeek et Z.ai sont plus simples. Si vous voulez le forfait de BroadNet, associez-le à un agent qui parle le format OpenAI.

Questions fréquentes

Claude Code peut-il utiliser DeepSeek ?

Oui, de deux façons. DeepSeek publie une URL de base au format Anthropic, https://api.deepseek.com/anthropic, qui fait correspondre les noms claude-sonnet et claude-haiku à deepseek-flash et les noms claude-opus à deepseek-v4-pro. Ou bien vous placez un proxy de traduction comme LiteLLM devant n’importe quel hébergeur compatible OpenAI de modèles DeepSeek.

Claude Code fonctionne-t-il avec une API compatible OpenAI ?

Pas directement. Claude Code envoie des requêtes de l’API Messages d’Anthropic vers /v1/messages. Un proxy comme LiteLLM accepte ces requêtes, les transmet à un endpoint /chat/completions de style OpenAI, puis retraduit la réponse.

Anthropic prend-il en charge Claude Code avec d’autres modèles ?

Non. La documentation des passerelles de Claude Code indique qu’Anthropic ne prend pas en charge le routage de Claude Code vers des modèles non Claude, quelle que soit la passerelle. En pratique, cela fonctionne pour beaucoup de gens, mais les bugs sur cette voie sont à vous de les déboguer.

Quel modèle BroadNet utiliser derrière Claude Code ?

GLM 5.3 ou Qwen3.8 27B. BroadNet ne documente l’appel d’outils que pour ces deux modèles, et Claude Code modifie les fichiers et exécute les commandes via des outils. GLM 5.3 a un contexte de 1 048 576 tokens ; Qwen3.8 27B en a 262 144 et accepte les images.

Puis-je faire tourner Claude Code sur le forfait illimité de BroadNet ?

Ce n’est pas une combinaison documentée. Les forfaits ne couvrent que DeepSeek V4.1 Flash, et BroadNet ne documente pas l’appel d’outils pour ce modèle. Une session de forfait traite aussi une requête à la fois, alors que Claude Code peut lancer des sous-agents en parallèle.

Pourquoi Claude Code affiche-t-il « Invalid model name » via LiteLLM ?

Claude Code a demandé un nom de modèle que votre config.yaml ne définit pas, souvent un alias Claude intégré ou le modèle Haiku d’arrière-plan. Réglez ANTHROPIC_MODEL et ANTHROPIC_DEFAULT_HAIKU_MODEL sur des noms de votre model_list.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity