Aller au contenu principal

Claude 4 retiré de l'API Anthropic : migrer vos intégrations et adapter votre budget Agent SDK

Ce matin du 16 juin 2026, si vos appels à l'API Claude renvoient des erreurs 400, la cause est très probable : Anthropic a retiré les modèles Claude Sonnet 4 (claude-sonnet-4-20250514) et Claude Opus 4 (claude-opus-4-20250514) hier, le 15 juin, à la date annoncée depuis mai. En parallèle, le billing des usages programmatiques via l'Agent SDK a basculé vers un système de crédits séparés — un deuxième changement que beaucoup d'équipes ont manqué. Ce sont deux ruptures simultanées, deux vecteurs de panne possible : voici comment les diagnostiquer et les corriger.

Ce guide est opérationnel. Il couvre les modèles exacts à remplacer, les identifiants cibles recommandés par Anthropic, un point de vigilance sur les paramètres qui génèrent une erreur silencieuse après migration, et le fonctionnement du nouveau billing Agent SDK par plan. Quinze minutes suffisent pour remettre une intégration standard en production si vous suivez les étapes dans l'ordre.

Le double changement du 15 juin : modèles retirés et billing Agent SDK

Réponse directe : Anthropic a simultanément retiré les versions initiales de Claude Sonnet 4 et Opus 4 et a réformé la facturation des usages Agent SDK. Ces deux changements ont été annoncés en mai 2026 avec six semaines de préavis, mais dans de nombreuses équipes l'information est passée inaperçue ou la migration a été repoussée.

Les deux événements sont indépendants mais se chevauchent sur la même date, ce qui amplifie l'impact :

  • Côté modèles — les versions initiales de Claude Sonnet 4 et Opus 4, sorties en mai 2025, sont en fin de vie. Elles ont été largement surpassées par Sonnet 4.6 et Opus 4.8, disponibles depuis le début de l'année 2026. La retraite est binaire : il n'y a pas de fenêtre de transition ni de reroutage automatique vers la version courante.
  • Côté billing — l'usage via l'Agent SDK, claude -p, Claude Code dans GitHub Actions et les applications tierces construites sur le SDK ne consomment plus le quota d'usage subscription. Ces appels tirent désormais d'un pool de crédits mensuel séparé, plafonné selon le plan souscrit.

Ce qui ne change pas : les comptes consommateurs Claude.ai, Claude Code dans des environnements managés Anthropic, et les intégrations qui utilisent l'alias générique claude-sonnet-4 ou claude-opus-4 sans suffixe de version horodaté sont automatiquement reroutés vers la version courante — ce comportement d'alias est documenté dans la politique de modèles d'Anthropic.

Les deux modèles retirés : lesquels sont concernés ?

Réponse directe : les identifiants claude-sonnet-4-20250514 et claude-opus-4-20250514 retournent désormais une erreur API. Si votre code contient ces chaînes en dur dans un fichier de configuration, une variable d'environnement ou directement dans le code, il est cassé.

Les paires retiré → cible recommandée :

  • claude-sonnet-4-20250514 — retiré le 15 juin 2026 → migrer vers claude-sonnet-4-6
  • claude-opus-4-20250514 — retiré le 15 juin 2026 → migrer vers claude-opus-4-8

Les appels échouent avec un code d'erreur (typiquement 400 ou 404 selon le client SDK utilisé), sans reroutage ni dégradation gracieuse vers un modèle de substitution. Pour les environnements de production avec alerting actif, la panne est détectable immédiatement. Pour les jobs batch, les webhooks ou les automations nocturnes, elle peut passer inaperçue jusqu'au prochain run manuel.

Les modèles non affectés : claude-sonnet-4-6, claude-opus-4-8, claude-haiku-4-5, et la série Claude Fable 5. Si votre intégration utilise déjà ces identifiants, ou les alias sans version (claude-sonnet-4, claude-opus-4), vous n'avez pas de migration à faire côté modèle.

Migration : changer l'identifiant de modèle, pas seulement le numéro

Réponse directe : la migration minimale est une substitution de chaîne — remplacer claude-sonnet-4-20250514 par claude-sonnet-4-6 et claude-opus-4-20250514 par claude-opus-4-8. Mais une substitution naïve peut introduire un bug silencieux sur les paramètres de sampling, détaillé dans la section suivante.

Étape 1 — Trouver toutes les occurrences

Dans votre dépôt, lancez une recherche globale sur les deux chaînes :

  • grep -r "claude-sonnet-4-20250514" .
  • grep -r "claude-opus-4-20250514" .

Ne limitez pas la recherche au code source : vérifiez également les fichiers de configuration, les variables d'environnement (.env), les scripts CI/CD, les JSON de configuration de workflows, les fichiers Terraform ou IaC, et les éventuelles couches d'abstraction SDK maison.

Étape 2 — Substituer les identifiants

Les cibles recommandées par Anthropic :

  • claude-sonnet-4-20250514 → claude-sonnet-4-6 (meilleure balance coût/performance pour la plupart des cas d'usage)
  • claude-opus-4-20250514 → claude-opus-4-8 (modèle le plus capable avant Fable 5 — voir notre comparatif Fable 5 vs Opus 4.8)

Étape 3 — Tester les outputs

Un changement de version n'est pas neutre. Sonnet 4.6 et Opus 4.8 sont plus capables que leurs prédécesseurs, mais peuvent produire des outputs légèrement différents en format, longueur ou structuration. Si votre pipeline attend un format de réponse précis (JSON, liste d'items, tableau), rejouez quelques cas de test représentatifs avant de déployer en production. Si vous envisagez de basculer directement sur Claude Fable 5 pour bénéficier des dernières capacités, notre guide d'adoption Fable 5 en 6 étapes couvre le choix du bon modèle selon les cas d'usage et le budget.

Point de vigilance : les paramètres qui cassent sur Opus 4.7 et supérieur

Réponse directe : si vous migrez vers Opus 4.8, les paramètres temperature, top_p et top_k ne sont plus acceptés. Toute valeur non-défaut retournera une erreur 400 — même une valeur apparemment neutre comme temperature=1.0. Ce comportement s'applique à Opus 4.7 et toutes les versions supérieures.

C'est le piège le plus fréquent des migrations rapides. Un simple remplacement d'identifiant ne suffit pas si votre code initialise explicitement ces paramètres :

  • temperature — supprimez le paramètre ou ne le définissez pas. La valeur par défaut d'Anthropic est appliquée automatiquement.
  • top_p — idem.
  • top_k — idem.

Cette contrainte s'applique uniquement à Opus 4.7+ (dont Opus 4.8 et Fable 5 côté API). Elle ne s'applique pas à Sonnet 4.6 : si vous migrez exclusivement vers Sonnet 4.6, vos paramètres de sampling existants sont conservés sans modification.

Conseil pratique avant de pousser la migration : cherchez toutes les initialisations de ces trois paramètres dans votre code, et soit conditionnez-les à l'identifiant de modèle utilisé, soit supprimez-les globalement au profit des valeurs par défaut — qui couvrent la majorité des usages applicatifs sans dégradation observable.

Nouveau billing Agent SDK : pools de crédits séparés par plan

Réponse directe : depuis le 15 juin 2026, les usages programmatiques via l'Agent SDK, claude -p, Claude Code en GitHub Actions et les applications tierces construites sur le SDK tirent d'un pool de crédits mensuel séparé — pas inclus dans le quota d'usage standard de votre subscription. Le montant du pool dépend de votre plan.

Les montants de crédits Agent SDK par plan :

  • Pro — 20 $ de crédits / mois
  • Max 5x — 100 $ de crédits / mois
  • Max 20x — 200 $ de crédits / mois
  • Enterprise standard — 0 $ de crédits inclus (usage facturé aux tarifs API standards dès le premier appel)

Ces crédits sont opt-in (à activer dans la console Anthropic) et non reconductibles : ils ne se cumulent pas d'un mois sur l'autre. La deadline d'activation pour le cycle de juin était le 15 juin. Si vous n'avez pas activé avant cette date, les crédits s'appliqueront à partir du prochain cycle mensuel.

Ce qui se passe quand les crédits sont épuisés :

  • Si les crédits d'usage standard sont activés sur votre compte : les appels Agent SDK continuent et sont facturés aux tarifs API (pas d'interruption de service).
  • Si les crédits d'usage ne sont pas activés : les appels Agent SDK s'arrêtent jusqu'au renouvellement mensuel du pool.

Le contexte de ce changement : le même jour qu'Anthropic annonçait cette réforme de billing (en mai 2026), OpenAI proposait deux mois gratuits de Codex aux équipes qui quittaient Anthropic. Ce mouvement tactique illustre que la structure tarifaire des agents est devenue un champ de bataille commercial aussi important que les benchmarks de performance. Pour maîtriser la facture sur le long terme, notre article sur le prompt caching et la réduction des coûts LLM reste la lecture la plus actionnable.

Checklist de remise en production

Réponse directe : cinq vérifications pour remettre votre intégration Claude en production après le 15 juin.

  1. Grep sur les modèles retirés — confirmer l'absence de claude-sonnet-4-20250514 et claude-opus-4-20250514 dans le code, les configs, les variables d'environnement et les scripts CI/CD.
  2. Supprimer temperature/top_p/top_k si la cible est Opus 4.8 — ces paramètres génèrent une erreur 400 sur Opus 4.7 et supérieur. La suppression est non régressive sur la qualité des sorties dans la grande majorité des cas.
  3. Rejouer les cas de test critiques — en particulier si votre pipeline attend un format de réponse structuré (JSON, liste, tableau structuré). Les modèles 4.6/4.8 produisent des outputs légèrement différents de leurs prédécesseurs.
  4. Vérifier le billing Agent SDK — se connecter à la console Anthropic, confirmer que le pool de crédits Agent SDK est activé si votre plan y donne droit, activer les crédits d'usage standard en complément pour éviter toute interruption de service en cas de dépassement.
  5. Monitorer les erreurs post-déploiement 24h — les erreurs 400 liées aux paramètres dépréciés peuvent apparaître sur des chemins d'exécution peu couverts par les tests automatisés (cas limites, workflows nocturnes, webhooks rarement déclenchés).

Si vous manquez de ressources pour gérer cette migration en urgence ou pour évaluer l'opportunité de basculer sur Claude Fable 5, notre équipe développement sur mesure peut intervenir rapidement. Contactez-nous pour un diagnostic en 48 h.

FAQ — Claude 4 retiré de l'API Anthropic : migrer vos intégrations et adapter votre budget Agent SDK

Ma production est cassée ce matin avec des erreurs 400 sur Claude — quelle est la priorité absolue ?

Vérifiez en premier si vos appels utilisent les identifiants claude-sonnet-4-20250514 ou claude-opus-4-20250514. Si c'est le cas, remplacez-les par claude-sonnet-4-6 ou claude-opus-4-8 respectivement, déployez et relancez vos tests. Si l'erreur persiste après la substitution, vérifiez que vous n'envoyez pas de paramètre temperature, top_p ou top_k : ces paramètres ne sont plus acceptés sur Opus 4.7 et supérieur et génèrent eux aussi une erreur 400.

Est-ce que Claude.ai et Claude Code managé sont affectés par la dépréciation du 15 juin ?

Non. La dépréciation du 15 juin affecte uniquement les intégrations API qui utilisent les identifiants de modèle versionnés et horodatés (20250514). Les comptes consommateurs Claude.ai, Claude Code dans un environnement managé Anthropic, et les intégrations qui utilisent les alias sans version (claude-sonnet-4, claude-opus-4) sont automatiquement reroutés vers la version courante — aucune action requise de votre côté.

Comment activer les crédits Agent SDK si j'ai raté la deadline du 15 juin ?

Connectez-vous à la console Anthropic (console.anthropic.com), allez dans les paramètres de billing et activez le pool de crédits Agent SDK. L'activation après le 15 juin prend effet au prochain cycle mensuel — les appels Agent SDK émis avant l'activation et après épuisement des crédits auront soit été facturés aux tarifs API standard (si vous avez les crédits d'usage activés), soit échoué. Activez également les crédits d'usage standard en complément pour éviter toute interruption future.

Que se passe-t-il si je mets à jour l'identifiant de modèle vers Opus 4.8 mais que je garde temperature=0 dans mon code ?

Sur Opus 4.7 et versions supérieures (dont Opus 4.8 et Fable 5), les paramètres temperature, top_p et top_k sont dépréciés. Toute valeur non-défaut, y compris temperature=0 ou temperature=1, retourne une erreur 400. Vous devez supprimer ces paramètres de votre code ou ne pas les définir — Anthropic applique ses valeurs par défaut internes, adaptées à la grande majorité des usages.

Dois-je migrer vers Claude Fable 5 plutôt que vers Sonnet 4.6 ou Opus 4.8 ?

Pas nécessairement dans l'urgence. Sonnet 4.6 et Opus 4.8 sont des modèles solides et largement supérieurs aux versions 20250514 retirées. Claude Fable 5 est plus performant mais coûte environ le double d'Opus 4.8 — il se justifie sur les tâches longues et complexes à forte valeur (migration de codebase, analyse financière senior, recherche), pas sur la classification, l'extraction ou les chatbots standards. Résolvez d'abord la panne, évaluez ensuite si Fable 5 apporte un ROI positif sur vos cas d'usage spécifiques.

Sources