Comment utiliser ERNIE 5.5 Flash gratuitement dans OpenCode et Claude Code

ERNIE 5.5 Flash Preview est disponible gratuitement sur OpenRouter. Voici comment l'intégrer à OpenCode et Claude Code, une tâche de codage adaptée à la limite de 50 requêtes par jour, et ce qui ne fonctionne pas sur la route gratuite.

INEZA Felin-Michel

INEZA Felin-Michel

12 November 2026

Comment utiliser ERNIE 5.5 Flash gratuitement dans OpenCode et Claude Code

Apidog pour les entreprises

Déploiement sur site

SSO & RBAC

Conforme SOC 2

Découvrir Apidog Enterprise

Réponse rapide : vous pouvez utiliser ERNIE 5.5 Flash gratuitement dans OpenCode et Claude Code via le point de terminaison baidu/ernie-5.5-flash-preview:free d’OpenRouter. Dans OpenCode, connectez OpenRouter et définissez "model": "openrouter/baidu/ernie-5.5-flash-preview:free". Dans Claude Code, pointez ANTHROPIC_BASE_URL vers OpenRouter et fixez le slug d’ERNIE comme modèle. Cela coûte 0 $ par token, mais sans crédits achetés, vous êtes limité à 50 requêtes par jour.

Ce plafond quotidien est toute la question pour les agents de codage. Un agent n’effectue pas une seule requête par tâche ; il en fait une à chaque étape. Ce guide configure les deux agents, présente une tâche de codage qui entre dans le budget gratuit et vous dit où la route gratuite atteint ses limites.

Toutes les limites ci-dessous ont été vérifiées sur les pages officielles d’OpenRouter le 12 novembre 2026.

Qu’est-ce qu’ERNIE 5.5 Flash Preview ?

ERNIE 5.5 Flash Preview est le modèle de conversation et d’agent de Baidu, publié le 10 novembre 2026. C’est un modèle épars de type mixture-of-experts avec 280 milliards de paramètres au total, 14 milliards actifs par token et une fenêtre de contexte de 1 024 000 tokens. Baidu le destine au codage, aux tâches agentiques et à la recherche approfondie, et OpenRouter le répertorie comme un modèle avec raisonnement activé et appel d’outils.

Il existe aussi un modèle ERNIE 5.5 Flash Base, réservé au pré-entraînement, sur Hugging Face, mais c’est celui que vous fine-tunez ou hébergez vous-même. Le Preview est celui avec lequel votre agent de codage communique. Pour une présentation complète du modèle, lisez qu’est-ce qu’ERNIE 5.5 Flash. Si vous venez de la génération précédente, la présentation d’ERNIE 5.1 couvre ce qui a changé.

Limites gratuites d’ERNIE 5.5 Flash sur OpenRouter

La page du modèle d’OpenRouter affiche la variante :free à 0 $ en entrée et 0 $ en sortie, servie par un seul fournisseur, Baidu Qianfan. Les limites de débit proviennent de la documentation sur les limites d’OpenRouter et s’appliquent à tous les identifiants de modèle se terminant par :free.

Élément Valeur (vérifiée le 12/11/2026)
Identifiant du modèle baidu/ernie-5.5-flash-preview:free
Prix 0 $ en entrée, 0 $ en sortie
Fenêtre de contexte 1 024 000 tokens
Requêtes par minute 20
Requêtes par jour, moins de 10 crédits achetés au total 50
Requêtes par jour, 10 crédits ou plus achetés au total 1 000
Fournisseurs derrière le modèle 1 (Baidu Qianfan)

Deux détails comptent pour les agents. La page de tarification d’OpenRouter indique que les tentatives échouées comptent dans le plafond quotidien. Et un solde de crédits négatif bloque les modèles gratuits avec une erreur 402 jusqu’à ce que vous rechargiez votre compte.

Infographie des limites des modèles gratuits OpenRouter : 50 requêtes par jour et 20 par minute avec moins de 10 crédits achetés, 1 000 par jour et 20 par minute avec 10 crédits ou plus, et chaque appel de modèle dans une boucle d’agent compte comme une requête

Le palier de 1 000 requêtes par jour dépend des crédits que vous avez achetés, et non des crédits que vous dépensez.

Configurer ERNIE 5.5 Flash dans OpenCode

OpenCode prend nativement en charge OpenRouter, c’est donc la configuration la plus simple des deux. Vous avez besoin d’un compte OpenRouter et d’une clé API depuis votre tableau de bord OpenRouter.

  1. Installez ou mettez à jour OpenCode, puis lancez-le dans votre dossier de projet :
cd your-project
opencode
  1. Connectez OpenRouter. Dans OpenCode, exécutez /connect, choisissez OpenRouter et collez votre clé. Vous pouvez aussi l’exporter avant le lancement :
export OPENROUTER_API_KEY="sk-or-v1-..."
  1. Fixez le modèle dans opencode.json à la racine du projet. La documentation des fournisseurs d’OpenCode indique d’utiliser l’identifiant complet du modèle OpenRouter après le préfixe openrouter/ :
{
  "$schema": "https://opencode.ai/config.json",
  "model": "openrouter/baidu/ernie-5.5-flash-preview:free"
}
  1. Confirmez la sélection avec /models. Si ERNIE n’apparaît pas dans la liste, la valeur de configuration reste prioritaire : vérifiez donc l’orthographe du slug, y compris :free.

Chaque prompt est désormais envoyé à ERNIE 5.5 Flash Preview via OpenRouter. Si vous avez suivi notre guide GLM-5.3-Flash pour OpenCode ou celui sur DeepSeek V4.1 Flash, le schéma est identique : seul le slug change.

Configurer ERNIE 5.5 Flash dans Claude Code

Claude Code peut communiquer avec OpenRouter car OpenRouter expose un point de terminaison Messages compatible avec Anthropic. La page du modèle ERNIE liste POST https://openrouter.ai/api/v1/messages comme route prise en charge pour ce modèle.

Soyez d’abord clair sur le niveau de support. Le guide d’intégration de Claude Code d’OpenRouter précise que Claude Code avec OpenRouter « n’est garanti de fonctionner qu’avec le fournisseur propriétaire Anthropic » et que Claude Code « peut ne pas fonctionner correctement avec d’autres fournisseurs ». Exécuter ERNIE ici fonctionne grâce aux paramètres documentés, mais ce n’est pas une combinaison garantie.

  1. Définissez les variables de connexion dans votre profil shell, exactement comme le documente OpenRouter :
export OPENROUTER_API_KEY="sk-or-v1-..."
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""   # must be explicitly empty
  1. Fixez ERNIE pour chaque classe de modèle utilisée par Claude Code, afin qu’aucune étape ne bascule silencieusement vers un modèle Anthropic payant :
export ANTHROPIC_DEFAULT_OPUS_MODEL="baidu/ernie-5.5-flash-preview:free"
export ANTHROPIC_DEFAULT_SONNET_MODEL="baidu/ernie-5.5-flash-preview:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="baidu/ernie-5.5-flash-preview:free"

Vous pouvez placer les mêmes clés dans le bloc env de .claude/settings.json si vous souhaitez limiter la configuration à un seul projet.

  1. Rechargez le shell, lancez claude, puis exécutez /status. Vous devriez voir Auth token: ANTHROPIC_AUTH_TOKEN et Anthropic base URL: https://openrouter.ai/api. Si le système mentionne ANTHROPIC_API_KEY ou une connexion à un compte Claude, les variables n’ont pas atteint la session.
  2. Ouvrez /model pour confirmer que les classes renvoient bien vers ERNIE, puis vérifiez la colonne du modèle dans votre tableau de bord d’activité OpenRouter après votre premier prompt.
Diagramme des deux routes d’agent : OpenCode utilise OPENROUTER_API_KEY et Claude Code utilise ANTHROPIC_BASE_URL pour atteindre OpenRouter, qui transmet baidu/ernie-5.5-flash-preview:free à Baidu Qianfan

Nous détaillons la configuration générale de Claude Code dans comment utiliser Claude Code avec OpenRouter.

Une tâche de codage réelle qui tient en 50 requêtes

Avec 50 requêtes par jour, ne laissez pas un agent errer. Donnez-lui une tâche délimitée pour laquelle vous savez déjà à quoi ressemble « terminé ». En voici une qui fonctionne bien sur un petit dépôt :

In src/routes/orders.ts, GET /orders/:id returns 500 when the order
doesn't exist. Make it return 404 with {"error":"order_not_found"}.
Read only the files you need, make the smallest change, then run
the orders tests with npm test and stop. Don't refactor anything else.

Pourquoi ce format fonctionne sur le palier gratuit :

Une tâche de ce type nécessite généralement une poignée d’appels au modèle : lire la route, lire le gestionnaire d’erreurs, modifier, lancer les tests, rendre compte. Un prompt vague du type « nettoie le module orders » peut épuiser le quota d’une journée avant que quoi que ce soit ne soit livré.

La fenêtre de contexte de 1M de tokens est l’autre raison pour laquelle ERNIE convient aux agents. Vous pouvez coller une longue pile d’erreurs ou un fichier OpenAPI entier dans un seul prompt au lieu de l’étaler sur plusieurs tours. Une grande requête vaut mieux que cinq petites quand chaque requête compte.

Laissez ERNIE exécuter vos tests d’API avec Apidog CLI

Une fois que l’agent a corrigé un point de terminaison, vous voulez la preuve que l’API fonctionne toujours, pas seulement qu’un test unitaire est passé. Apidog CLI permet au même agent d’exécuter les scénarios de test que votre équipe conserve déjà dans Apidog, de lire les échecs, de corriger le code et de les relancer. Vous écrivez un prompt ; ERNIE exécute les commandes.

Installez la CLI, connectez-vous et ajoutez la compétence d’agent :

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick OpenCode or Claude Code when prompted

Donnez ensuite un prompt à votre agent :

Run the "Orders API" test scenario in Apidog project <projectId> against
the local environment. If any step fails, find the endpoint in this repo
that causes it, fix it, and rerun the scenario until it passes.
Summarize what you changed.

L’agent retrouve le scénario, l’exécute avec un rapport JSON qu’il peut analyser, puis le relance après la correction :

apidog test-scenario list --project <projectId>
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --out-dir ./apidog-reports
# agent edits the failing route, then:
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --upload-report

L’option --upload-report envoie le résumé de l’exécution à Apidog pour que votre équipe puisse le consulter dans l’application. apidog test-report list --project <projectId> récupère les exécutions passées si l’agent doit comparer.

Mais gérez votre budget. Chaque exécution de test, lecture de rapport et modification de code constitue une étape d’agent, donc une boucle correction-relance peut facilement consommer 10 requêtes au modèle. Sur le palier de 50 par jour, exécutez cette boucle une ou deux fois, pas tout l’après-midi. Le guide Apidog CLI dans Claude Code et la référence de la commande apidog run couvrent le reste des options. Le plan gratuit d’Apidog couvre les équipes jusqu’à 4 utilisateurs.

Quand la route gratuite s’effondre

Le point de terminaison gratuit est un modèle de préversion derrière un fournisseur unique. Voici à quoi vous attendre et comment réagir.

Symptôme Cause probable Solution
429 après une salve d’étapes 20 requêtes par minute Ralentissez l’agent ou attendez une minute
429 pour le reste de la journée 50 requêtes quotidiennes épuisées (les tentatives échouées comptent) Attendez la réinitialisation UTC ou achetez 10 crédits pour 1 000 par jour
402 sur un modèle gratuit Solde de compte négatif Ajoutez des crédits pour ramener le solde au-dessus de zéro
L’agent échoue sur la sortie JSON Erreurs de sortie structurée Demandez du texte brut et analysez-le vous-même
Fonctionnalités de Claude Code défaillantes Modèle non Anthropic derrière Claude Code Utilisez OpenCode pour ERNIE, ou revenez au modèle d’origine

La ligne sur la sortie structurée mérite un chiffre. Le 12 novembre 2026, la page du modèle d’OpenRouter affichait un taux d’erreur de 21,70 % pour la sortie structurée et de 1,01 % pour les appels d’outils sur ce point de terminaison. L’appel d’outils, dont dépendent les agents de codage, semble sain. Les schémas JSON stricts, non : gardez donc les flux d’agent sur les outils et le texte brut.

La vitesse diffère également des chiffres annoncés. La description de Baidu revendique plus de 200 tokens par seconde, tandis qu’OpenRouter mesurait un P50 de 79 tokens par seconde sur le point de terminaison gratuit ce jour-là.

Enfin, « Preview » figure dans le nom pour une raison. Le modèle, ses limites et la variante :free peuvent changer sans préavis. Si le slug ne se résout plus, consultez la page OpenRouter avant de déboguer votre configuration. Pour un accès payant ou direct, le guide de l’API ERNIE 5.5 Flash couvre Baidu Qianfan.

FAQ

ERNIE 5.5 Flash est-il vraiment gratuit dans OpenCode ? Oui. Le point de terminaison baidu/ernie-5.5-flash-preview:free coûte 0 $ par token d’entrée et de sortie sur OpenRouter. Vous êtes limité à 20 requêtes par minute et 50 par jour, sauf si vous avez acheté au moins 10 crédits OpenRouter.

Claude Code prend-il officiellement en charge ERNIE 5.5 Flash ? Pas officiellement. OpenRouter documente comment pointer Claude Code vers d’autres modèles, mais précise que la configuration n’est garantie qu’avec le fournisseur propriétaire Anthropic. Cela fonctionne, mais attendez-vous à quelques aspérités avec les outils. OpenCode est le choix le plus sûr pour ERNIE.

Quel est l’identifiant du modèle ERNIE 5.5 Flash sur OpenRouter ? C’est baidu/ernie-5.5-flash-preview:free pour la variante gratuite. Dans OpenCode, préfixez-le avec openrouter/. Dans Claude Code, utilisez-le tel quel dans les variables ANTHROPIC_DEFAULT_*_MODEL.

Combien de tâches de codage puis-je accomplir avec 50 requêtes par jour ? Cela dépend de la tâche. Une correction bien délimitée peut prendre 5 à 10 étapes d’agent, donc quelques tâches passent. Des refactors ouverts peuvent consommer tout le quota en une fois. Nommez les fichiers et définissez « terminé » dans votre prompt.

Puis-je utiliser gratuitement tout le contexte de 1M de tokens ? OpenRouter liste une fenêtre de contexte de 1 024 000 tokens pour la variante gratuite, la même que celle du modèle complet. Les grands prompts comptent toujours comme une seule requête chacun, ce qui rend les prompts à long contexte efficaces sur le plafond quotidien.

Existe-t-il une option gratuite sans OpenRouter ? Notre guide gratuit sur ERNIE 5.5 Flash compare toutes les routes à 0 $. Baidu a également publié ERNIE 5.5 Flash Base sur Hugging Face, que vous pouvez héberger vous-même, comme décrit dans exécuter ERNIE 5.5 Flash localement avec vLLM.

Pratiquez le Design-first d'API dans Apidog

Découvrez une manière plus simple de créer et utiliser des API