Comment exécuter des tests d’API avec Claude Code ? Une commande Apidog, validée uniquement si le code de sortie est 0

Note de l’auteur : intégrez la commande d’exécution de scénario Apidog dans CLAUDE.md pour que Claude Code lance les tests d’API automatisés à partir des scénarios existants, détermine le résultat via le code de sortie et, en prenant l’interface vidéo Seedance comme exemple, conçoive des assertions liées à la facturation et à la modération.

Si vous utilisez déjà Claude Code pour écrire du code d’API, vous avez probablement rencontré ce cas : après avoir modifié un champ, il faut encore basculer sur Apidog pour lancer manuellement un scénario, puis revenir annoncer le résultat à Claude Code. La méthode présentée ici consiste à inscrire la commande d’exécution de scénario d’Apidog CLI dans CLAUDE.md, afin que Claude Code exécute lui-même les tests et lise lui-même le code de sortie, transformant ainsi les tests d’API automatisés avec Claude Code en une boucle fermée.

Ce n’est pas un énième article d’initiation à Claude Code. Les étapes Apidog décrites ici proviennent du tutoriel officiel publié par l’éditeur Apidog, et les règles de facturation et de modération de Seedance proviennent de la documentation originale d’APIYI ; les deux sources seront clairement citées dans le corps de l’article pour que vous puissiez les vérifier vous-même.

L’essentiel : à la fin de cet article, vous saurez comment inscrire durablement la commande d’exécution dans CLAUDE.md, pourquoi valider ou non à partir du code de sortie plutôt que de la conclusion verbale du modèle, où placer le jeton, et quelles assertions réellement pertinentes écrire pour une interface vidéo asynchrone.

claude-code-api-automated-testing-apidog-fr-image-0


Claude Code Tests d’API automatisés : points clés d’Apidog

Avant de passer à l’action, commençons par décomposer l’ensemble de la solution en quelques décisions clés. Le tableau ci-dessous récapitule les contraintes essentielles, issues du tutoriel de l’éditeur et de la documentation APIYI, qui concernent cette approche — chacune d’elles influence directement la capacité du test à se reproduire de façon stable.

Point clé Explication Intérêt
Écrire la commande d’exécution dans CLAUDE.md Claude Code lit le fichier CLAUDE.md à la racine du dépôt ; le format de la commande est apidog run -t ID_de_scénario -e ID_d_environnement -r cli Chaque session exécute la même commande, sans dépendre de la mémoire
Déterminer le résultat par le code de sortie Un code de sortie 0 signifie que toutes les assertions passent ; un code non nul indique qu’il y a des échecs Éviter le cas où le modèle « dit que c’est bon » alors que ça ne passe pas en réalité
Copier les ID depuis la page CI/CD L’ID de scénario et l’ID d’environnement se récupèrent sur la page CI/CD de ce scénario dans Apidog Empêcher le modèle d’inventer des ID, ce qui rendrait le scénario introuvable
Ne pas mettre le jeton dans un fichier En local, on se connecte avec apidog login, et on n’écrit pas --access-token dans CLAUDE.md Éviter la fuite du jeton lors du commit du dépôt
Séparer les deux types de points de terminaison Le modèle texte qui pilote Claude Code et l’interface vidéo testée ne sont pas le même point de terminaison Configuration claire, facturation traçable

Comment Claude Code lit CLAUDE.md

D’après le tutoriel de l’éditeur Apidog, l’outil lui-même est le paquet npm apidog-cli, et Claude Code lit CLAUDE.md à la racine du dépôt au démarrage comme documentation du projet. Autrement dit, la commande d’exécution, les règles de décision et les interdictions que vous écrivez dans ce fichier deviennent le contexte de chaque session de Claude Code. Si vous n’êtes pas sûr des fichiers d’instructions réellement chargés pour cette session, vous pouvez exécuter /memory dans Claude Code pour les consulter.

C’est ce point qui détermine la stabilité de la solution. Plutôt que de répéter « aide-moi à lancer le scénario Apidog » à chaque conversation, mieux vaut figer la commande une bonne fois pour toutes. Une fois le code modifié, Claude Code appelle apidog run conformément aux instructions de CLAUDE.md, puis décide, à partir de la sortie du terminal, de continuer à corriger ou de terminer la tâche.

Détails du code de sortie et du format de rapport de l’API CLI d’Apidog

Le tutoriel de l’éditeur insiste sur le fait que le format de rapport -r cli doit être conservé, car Claude Code s’appuie sur la sortie du terminal pour décider de l’action suivante. Si vous voulez aussi un rapport ouvrable dans un navigateur, vous pouvez ajouter html au paramètre -r ; le fichier généré se trouve dans le répertoire ./apidog-reports. Attention : il s’agit d’un « ajout », pas d’un « remplacement » — supprimer le rapport cli ferait perdre à Claude Code la base pour lire le résultat.

Le code de sortie est l’arbitre de toute la solution. L’ordre de vérification donné par le tutoriel mérite d’être repris tel quel : d’abord, confirmer que la commande apidog run apparaît bien dans le terminal ; ensuite, regarder le code de sortie, et lorsque celui-ci contredit la conclusion orale du modèle, c’est le code de sortie qui fait foi ; si le message indique que le scénario est introuvable, revenir à CLAUDE.md pour vérifier que l’ID est correct.

claude-code-api-automated-testing-apidog-fr-image-1


Prise en main rapide des tests automatisés d’API avec Claude Code

Cette section suit l’ordre « préparer l’environnement → écrire CLAUDE.md → configurer les permissions → lancer le premier essai ». Comme il s’agit d’un tutoriel en ligne, toutes les commandes sont fournies en code inline : vous pouvez les copier une par une dans le terminal pour les exécuter.

Étape 1 : configurer l’adresse d’accès au modèle de Claude Code

Faire tourner Claude Code consomme déjà des tokens, et l’appel ultérieur à l’interface vidéo testée en coûtera une autre pelletée : commençons donc par bien distinguer les deux types d’adresses d’accès. Quand vous passez par APIYI, Claude Code utilise le protocole natif d’Anthropic et l’adresse est https://api.apiyi.com — n’ajoutez surtout pas /v1 derrière, sinon ça se retrouve collé en /v1/v1/messages et la requête échoue. Ce n’est que pour les clients au protocole compatible OpenAI que l’adresse est https://api.apiyi.com/v1.

Concrètement, il suffit de définir des variables d’environnement dans le shell qui lance Claude Code : ANTHROPIC_BASE_URL sur l’adresse native d’Anthropic, et ANTHROPIC_AUTH_TOKEN sur le jeton que vous avez créé sur la plateforme. Pour les modèles de la série Claude, mieux vaut placer le jeton dans le groupe ClaudeCode, afin de le gérer séparément de celui qu’utilisera plus tard l’interface vidéo.

🚀 Démarrage rapide : la méthode officiellement recommandée consiste à créer, dans la console APIYI apiyi.com, un jeton distinct pour Claude Code et un autre pour l’interface testée. Les nouveaux utilisateurs bénéficient d’un crédit de test gratuit, largement de quoi faire tourner le premier scénario avant de décider quel modèle utiliser sur le long terme.

Étape 2 : écrire les instructions de test dans CLAUDE.md

Selon le tutoriel de l’éditeur, le contenu lié aux tests dans CLAUDE.md devrait inclure les points suivants, chacun formulé en une phrase claire :

  1. Commande d’exécution : les tests de régression utilisent apidog run -t <场景ID> -e <环境ID> -r cli, où les deux ID sont à remplir directement avec les valeurs réelles copiées depuis la page CI/CD d’Apidog.
  2. Règle de verdict : le résultat est déterminé par le code de sortie de la commande — 0 signifie que tout est passé, une valeur non nulle indique au moins un échec. On ne conclut pas à partir d’un résumé en langage naturel.
  3. Interdictions : ne pas inventer ni modifier les ID de scénario ou d’environnement ; ne pas ajouter --access-token dans la commande.
  4. Exigences de rapport : conserver -r cli ; si un rapport navigateur est souhaité, ajouter html. Les artefacts se trouvent dans ./apidog-reports.
  5. Remarque régionale : si le projet est déployé dans la région européenne d’Apidog, la commande doit ajouter --api-base-url api.eu.apidog.com. Il s’agit de l’adresse régionale propre à Apidog, sans lien avec l’adresse d’accès au modèle.

Étape 3 : connexion et configuration des permissions

La gestion des jetons est le point le plus susceptible de poser problème. Le tutoriel de l’éditeur recommande d’exécuter une fois apidog login en local pour se connecter, et de ne surtout pas écrire le jeton dans CLAUDE.md, ni faire apparaître --access-token dans ce fichier. CLAUDE.md est généralement commité avec le dépôt : y inscrire un jeton revient à le rendre public.

Par défaut, Claude Code demande confirmation avant d’exécuter une commande Bash. Si vous souhaitez qu’il lance les tests automatiquement, vous pouvez ajouter Bash(apidog run *) à la liste des permissions allow dans .claude/settings.json, afin de n’autoriser que ce type de commande. Le tutoriel rappelle également que --dangerously-skip-permissions ne convient qu’aux environnements jetables de type CI, pas à une machine locale utilisée quotidiennement.

Élément de configuration Bonne pratique Pratique déconseillée Source
Connexion Apidog apidog login en local écrire --access-token dans CLAUDE.md Tutoriel de l’éditeur
Autorisation de commande allow Bash(apidog run *) --dangerously-skip-permissions activé en permanence en local Tutoriel de l’éditeur
ID de scénario copié depuis la page CI/CD laisser le modèle le deviner ou le générer Tutoriel de l’éditeur
Adresse de Claude Code ANTHROPIC_BASE_URL sans /v1 avec /v1, ce qui duplique le chemin Documentation APIYI
Groupe de jetons ClaudeCode pour Claude, SeeDance2 pour la vidéo un seul jeton mélangeant tous les groupes Documentation APIYI

Étape 4 : effectuer le premier passage et vérifier

Une fois la configuration terminée, demandez à Claude Code d’exécuter un test de régression. En suivant l’ordre de vérification indiqué dans le tutoriel du fournisseur, vous devez confirmer de visu trois éléments : le terminal affiche bien la commande complète apidog run ; la commande renvoie un code de sortie explicite ; et, en cas d’échec, la sortie du terminal indique précisément quelle assertion a échoué. Ce n’est qu’à ces trois conditions que la boucle est réellement en place.

💡 Conseil technique : lors du premier passage, vous pouvez volontairement mettre une valeur attendue erronée dans une assertion, puis vérifier que le code de sortie devient non nul et que Claude Code poursuit le diagnostic à partir de là. Cela permet de confirmer que la règle « le code de sortie fait foi » fonctionne réellement.


Mise en pratique des tests automatisés d’API avec Claude Code : conception des assertions pour l’API vidéo Seedance

Les tests d’API textuelles sont assez intuitifs ; ce sont les API vidéo asynchrones qui mettent vraiment à l’épreuve la conception des assertions. Dans cette section, nous prenons la gamme Seedance déjà disponible sur APIYI comme exemple pour expliquer quelles assertions prévoir, et lesquelles éviter, dans un scénario Apidog.

Modèles, groupes et tarifs Seedance

D’après la documentation APIYI, les ID de modèles disponibles pour Seedance sont doubao-seedance-2-5-260628, doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128 et doubao-seedance-2-0-mini-260615. Le jeton utilisé pour appeler ces modèles doit appartenir au groupe SeeDance2, sinon l’API renvoie « 该模型无可用渠道 » (« aucun canal disponible pour ce modèle »). L’interface vidéo testée et le modèle texte qui pilote Claude Code sont deux endpoints différents : il ne suffit pas de modifier le champ model pour les rendre interchangeables. Dans Apidog, il faut configurer séparément les requêtes de soumission et de consultation conformément à la documentation Seedance.

Le tableau ci-dessous reprend les tarifs à l’usage du tableau récapitulatif des prix (mis à jour le 2026-11-16), en dollars pour 1 million de tokens. Les modèles et les prix de référence sont ceux indiqués dans la liste des modèles de la plateforme.

Modèle Entrée Sortie Lecture du cache Plateformes disponibles
doubao-seedance-2-5-260628 70 70 Aucune APIYI apiyi.com
doubao-seedance-2-0-260128 46 46 Aucune APIYI
doubao-seedance-2-0-fast-260128 37 37 Aucune APIYI
doubao-seedance-2-0-mini-260615 23 23 Aucune APIYI

La documentation donne aussi un exemple de conversion pour une vidéo 720p de 5 secondes : environ 1.3721 USD pour la version 2.5, et environ 0.9074 USD pour la version standard 2.0. Il faut insister sur un point : il ne s’agit là que d’un exemple de conversion du prix par million de tokens en coût par vidéo ; ce ne sont pas deux grilles tarifaires différentes par rapport au tableau récapitulatif.

Cinq assertions recommandées

Les cinq assertions ci-dessous s’appuient directement sur le texte de la documentation et peuvent être reprises telles quelles dans un scénario Apidog :

  • La tâche possède un ID : après une soumission réussie, la réponse doit contenir un ID de tâche, car le polling ultérieur en dépend. Sans ID, on considère que la requête a échoué.
  • La durée est transmise explicitement : la documentation précise que la valeur par défaut de duration pour la version 2.5 est -1. La requête de test doit donc transmettre explicitement la durée, sinon les coûts des différents essais ne sont pas comparables.
  • Une erreur de paramètre n’est pas facturée : la documentation indique qu’une erreur HTTP 400 liée aux paramètres n’est pas facturée. On peut construire une requête à laquelle il manque un champ obligatoire, vérifier que le code de statut est 400 et confirmer dans les logs qu’aucun débit n’a eu lieu.
  • Un blocage par modération n’est pas facturé : la documentation indique que les erreurs préfixées par PUBLIC_ correspondent à un blocage par la modération de contenu côté fournisseur et ne sont pas facturées non plus. L’assertion se charge seulement d’identifier ce type de code d’erreur et de le distinguer d’une erreur de paramètre comme deux échecs différents.
  • La somme des deux journaux donne le prix total : la documentation indique qu’une vidéo génère deux lignes de facturation dans les logs : un débit provisoire à la soumission, puis un ajustement à l’achèvement, avec remboursement du surplus ou complément si nécessaire. Le coût total est la somme des deux.

Concernant le montant du débit provisoire, la documentation indique environ 0,09 USD/seconde pour la série 2.0 et 0,135 USD/seconde pour la version 2.5, puis un règlement final basé sur les tokens réellement consommés. L’assertion de coût ne doit donc pas se limiter au premier journal : ce n’est que la valeur provisoire.

claude-code-api-automated-testing-apidog-fr-image-2

Quels éléments ne doivent pas devenir des cas de test

Le blocage par modération est une limite de conformité, pas un cas de test dont l’objectif serait de « forcer » la limite. La documentation recommande explicitement, en cas d’échec de modération, de ne pas réessayer en boucle avec la même invite ; les scénarios ne doivent donc pas non plus prévoir d’étapes de nouvelle tentative en boucle ni de sondage des règles de modération. De même, les images de référence contenant un visage humain réel sont rejetées par le service en amont : il faut d’abord les importer dans la bibliothèque d’assets, puis les référencer via asset://. C’est une condition préalable de conformité, à documenter dans les instructions de préparation des données de test, et non à transformer en cas de test.

📊 Note sur les données : les règles de facturation et de modération de Seedance ci-dessus sont extraites telles quelles de la documentation APIYI. Vous pouvez vérifier la description la plus récente sur la page Seedance du centre de documentation apiyi.com avant de les figer dans les assertions.


Choix du modèle qui pilote Claude Code et coûts

Faire tourner les tests avec Claude Code consomme aussi des tokens, et le modèle choisi a un impact direct sur les coûts quotidiens. Le tableau ci-dessous reprend les tarifs de trois modèles Claude issus du tableau tarifaire global ; l’unité est également le dollar par million de tokens, et tous prennent en charge les points de terminaison chat et messages.

Modèle Entrée Sortie Lecture du cache Groupe
claude-opus-5-5 4 20 0.2 ClaudeCode, Claude_Reverse, Claude_Enterprise, Default, SVIP
claude-sonnet-5-5 2 10 0.1 Idem
claude-haiku-5-5 0 à 100 000 tokens : 0.1 ; au-delà : 0.5 0.5 0.01 ClaudeCode, Claude_Enterprise, Default, SVIP

À noter : la ligne Haiku n’a pas le groupe Claude_Reverse ; si votre jeton est uniquement rattaché à ce groupe, le passage à Haiku n’aura aucun canal disponible. Une approche courante consiste à utiliser un modèle plus léger pour les tâches structurées du quotidien — lancer les régressions avec Claude Code, lire les codes de sortie — puis à basculer vers un modèle plus puissant lorsqu’un échec complexe nécessite une analyse approfondie.

💰 Optimisation des coûts : comme le modèle qui pilote et l’interface testée sont tous deux facturés, je vous recommande de consulter les journaux d’utilisation dans la console APIYI en filtrant par jeton, de mesurer séparément la consommation de Claude Code et celle de Seedance, puis de déterminer de quel côté se concentre principalement le coût des tests.


FAQ – Questions fréquentes

Q1 : Qu’est-ce que le dispositif Apidog pour les tests automatisés d’API avec Claude Code ?

Il s’agit d’écrire la commande d’exécution de scénario d’Apidog CLI dans le fichier CLAUDE.md à la racine du dépôt, pour que Claude Code lance lui-même `apidog run` après avoir modifié le code, puis détermine si les tests passent d’après le code de sortie. Résultat : plus besoin de cliquer manuellement sur « Exécuter ».

Q2 : Pourquoi se fier au code de sortie plutôt qu’à la conclusion de Claude Code ?

Le résumé en langage naturel du modèle peut être biaisé, tandis que le code de sortie est le résultat déterministe fourni par l’outil de test. Le tutoriel de l’éditeur l’indique clairement : en cas de divergence, c’est le code de sortie qui fait foi. 0 signifie que tout passe, une valeur non nulle signifie qu’il y a des échecs.

Q3 : Faut-il ajouter /v1 à l’adresse d’accès de Claude Code ?

Non. Claude Code utilise le protocole natif d’Anthropic, l’adresse est `https://api.apiyi.com` ; ajouter `/v1` donnerait `/v1/v1/messages`. Seuls les clients compatibles OpenAI utilisent une adresse avec `/v1`.

Q4 : Où faut-il placer le jeton Apidog ?

En local, il suffit de se connecter avec `apidog login`. Le tutoriel de l’éditeur demande explicitement de ne pas écrire `–access-token` dans CLAUDE.md, ni de mettre le jeton dans ce fichier, pour éviter qu’il ne fuite avec le dépôt de code.

Q5 : Comment commencer à invoquer Seedance pour tester l’API vidéo ?

Après vous être inscrit sur APIYI apiyi.com, créez un jeton appartenant au groupe `SeeDance2`, configurez les requêtes de soumission et d’interrogation selon la documentation Seedance, et ajoutez dans le scénario Apidog des assertions comme l’ID de tâche, la durée explicite, la classification des codes d’erreur et les deux journaux de facturation. Le crédit d’essai gratuit réservé aux nouveaux utilisateurs permet de faire tourner le premier scénario.

Q6 : Que faire si Claude Code indique qu’il ne trouve pas le scénario ?

Commencez par vérifier la commande réellement exécutée dans le terminal, puis revenez à CLAUDE.md pour contrôler l’ID de scénario et l’ID d’environnement : recopiez-les impérativement depuis la page CI/CD de ce scénario dans Apidog, sans laisser le modèle deviner. Pour les projets en zone Europe, vérifiez aussi si l’option `–api-base-url api.eu.apidog.com` a bien été ajoutée.

Q7 : Quelles sont les limites de cette approche ?

Premièrement, la double facturation : Claude Code et l’interface testée consomment chacun des tokens. Deuxièmement, il faut rester sobre dans les autorisations, en n’autorisant localement que `Bash(apidog run *)`. Troisièmement, le blocage par modération et les images de référence de visages réels relèvent des limites de conformité : on peut seulement les identifier et les traiter en amont, sans les concevoir comme des cas d’usage de contournement.


Tests automatisés de l’API Claude Code — points clés à retenir

  • Figer les commandes : inscrivez apidog run -t -e -r cli dans CLAUDE.md et exécutez la même commande à chaque session.
  • Le code de sortie comme arbitre : 0 pour un succès, toute valeur non nulle pour un échec. En cas de conflit avec une conclusion orale, c’est le code de sortie qui fait foi.
  • Isolation des jetons : connectez-vous en local avec apidog login ; le jeton et --access-token ne doivent jamais figurer dans CLAUDE.md.
  • Moindre privilège : n’autorisez que Bash(apidog run *) ; les paramètres qui contournent les permissions sont réservés à la CI.
  • Bien distinguer les URL : Claude Code utilise l’URL native sans /v1 ; seule la compatibilité OpenAI passe par /v1.
  • Assertions vidéo : ID de tâche, durée explicite, code 400 et catégorie PUBLIC_, prix total des deux lignes de journal.
  • Pour démarrer : sur APIYI, créez séparément des jetons de groupe ClaudeCode et SeeDance2, puis validez le premier scénario avec le quota gratuit.

Résumé

L’automatisation des tests de l’API Claude Code avec Apidog tient à trois points :

  1. Mettre les commandes et les règles dans des fichiers : CLAUDE.md porte la commande d’exécution, les règles de décision et les interdictions ; les jetons, eux, passent par apidog login.
  2. Laisser le code de sortie trancher : conservez la sortie de -r cli et vérifiez, dans l’ordre indiqué par le tutoriel du fournisseur, la commande, le code de sortie et l’ID.
  3. Des assertions au plus près de la facturation réelle : pour une API vidéo asynchrone, vérifiez l’état de la tâche, distinguez une erreur de paramètre d’un blocage par la modération, additionnez les deux lignes de facturation et transmettez explicitement la durée.

Conseil : commencez par le scénario d’API texte le plus simple pour valider la boucle complète, puis ajoutez progressivement les assertions propres aux API asynchrones comme Seedance.

Recommandation : via APIYI apiyi.com, gérez avec un seul compte les jetons et la consommation de Claude Code et des modèles testés. Les coûts des deux côtés se lisent d’un coup d’œil, ce qui facilite l’optimisation continue des dépenses de test.


📚 Références

  1. Tutoriel de l’éditeur Apidog : utiliser Apidog CLI dans Claude Code : auteur crédité INEZA Felin-Michel, date de version selon ce qui est affiché sur le site
  2. Lien : apidog.com/blog/apidog-cli-in-claude-code
  3. Description : source pour la rédaction du CLAUDE.md, les règles de codes de sortie, la configuration des permissions et l’ordre de vérification

  4. Présentation officielle d’Apidog CLI : positionnement du CLI pour les agents et la CI, ainsi que les paramètres régionaux

  5. Lien : docs.apidog.com/en/introduction-to-apidog-cli-605134m0
  6. Description : inclut l’explication du paramètre --api-base-url pour la région européenne

  7. Documentation APIYI Seedance 2 : ID de modèle, groupes, facturation et règles de modération

  8. Lien : docs.apiyi.com/api-capabilities/seedance2/overview
  9. Description : base sur laquelle repose la conception des assertions vidéo de cet article

  10. Grille tarifaire complète des modèles APIYI : prix à l’usage et groupes pour chaque modèle

  11. Lien : docs.apiyi.com/models
  12. Description : les modèles et les prix suivent le contenu le plus récent de cette page

  13. Documentation des protocoles APIYI : différence entre les adresses natives Anthropic et compatibles OpenAI

  14. Lien : docs.apiyi.com/llms.txt
  15. Description : explique pourquoi l’adresse de Claude Code ne peut pas contenir /v1

Auteur : équipe technique APIYI
Échanges techniques : contactez-nous via la page d’accueil du site APIYI ; pour plus de ressources, consultez le centre de documentation docs.apiyi.com

Laisser un commentaire