Cas d’usage · Claude Code

Les tests QA avec Claude Code et Playwright

Claude Code peut tester votre app de deux façons : en écrivant et en lançant des tests Playwright dans votre dépôt, et en pilotant un vrai navigateur via le serveur MCP Playwright pour vérifier un changement comme le ferait une personne. Cette page couvre la configuration des deux, des règles QA qui l’obligent à être honnête sur les échecs et comment lancer la suite sans vous.

Ce que Claude Code fait pour les tests QA

  • Il écrit des tests end-to-end pour les parcours qui comptent : inscription, paiement, écrans principaux.
  • Il lance la suite, lit les échecs et corrige le test ou le code, en disant lequel.
  • Il pilote un vrai navigateur pour vérifier un changement à la main, et signale les bugs avec les étapes et des captures d’écran.
  • Il repère les tests instables et les met en quarantaine avec un ticket, au lieu de relancer jusqu’à ce qu’ils passent.

Les fonctionnalités de Claude Code pour les tests QA

FonctionnalitéCe qu’elle faitPour commencer
Serveur MCP PlaywrightPilote un vrai navigateur : clique, tape, lit la page et prend des captures d’écranclaude mcp add playwright npx @playwright/mcp@latest
Tests PlaywrightÉcrit et corrige des tests dans votre dépôt et les lance comme n’importe quelle commandenpx playwright test
claude -pLance la suite et corrige les échecs sans l’interface interactive--allowedTools "Bash,Read,Edit"
Sous-agentsTestent des parcours séparés en parallèle et rendent compteDéfinissez un testeur dans .claude/agents/

Comment configurer Claude Code pour les tests QA

  1. Connectez les outils

    Ajoutez le serveur MCP Playwright pour que Claude Code puisse ouvrir votre app dans un navigateur. Pour une suite de tests dans le dépôt, installez Playwright comme d’habitude ; Claude la lance comme n’importe quelle autre commande.

    # Un vrai navigateur pour des vérifications exploratoires
    claude mcp add playwright npx @playwright/mcp@latest
    
    # Une suite de tests, si vous n’en avez pas encore
    npm init playwright@latest
  2. Écrivez les règles dans CLAUDE.md

    Claude Code lit CLAUDE.md au début de chaque session, y compris lors des exécutions claude -p. Mettez-y les règles de la tâche, ou dans une skill sous .claude/skills/ si elles sont longues. Voir le guide de CLAUDE.md.

    ## Règles QA
    - Teste sur l’app locale ou de staging, jamais sur la production.
    - Utilise les comptes de test de .env.example, jamais de vrais comptes.
    - Un test qui échoue est un résultat : dis si c’est le test ou le code
      qui est faux avant de modifier l’un ou l’autre.
    - Chaque rapport de bug : étapes, résultat attendu, résultat obtenu,
      une capture d’écran et le commit testé.
    - Ne supprime ni ne saute aucun test pour faire passer la suite.
  3. Lancez-le sans l’interface interactive

    claude -p exécute une tâche puis s’arrête : cron, la CI ou un autre outil peut donc le lancer. Choisissez ce qu’il peut faire sans demander avec --allowedTools ou --permission-mode ; --output-format json renvoie le résultat avec son coût.

    # Lancer la suite et corriger les échecs, depuis la CI ou cron
    claude -p "Lance npx playwright test et corrige les échecs en suivant CLAUDE.md" \
      --allowedTools "Bash,Read,Edit"
  4. Planifiez-le

    Faites-en une tâche planifiée dans le cloud avec /schedule (Pro, Max, Ultra, Team et Enterprise), une tâche planifiée de bureau, ou utilisez /loop tant qu’une session reste ouverte. Voir comment rendre Claude Code proactif.

Source : documentation de Claude Code

Limites et sécurité

  • Il teste ce qu’il peut atteindre : une app locale ou de staging avec des données de test, pas la production.
  • Une suite qui passe ne couvre que les parcours pour lesquels quelqu’un a écrit des tests. Demandez-lui la liste de ce qui n’est pas couvert.
  • Les exécutions dans le navigateur sont lentes et consomment davantage votre abonnement. Lancez la suite complète selon un planning, et un smoke test à chaque changement.
  • Depuis Claude Code v2.1.302, claude -p démarre en mode manuel (Manual) : une action qui demande une validation est refusée, sauf si une règle l’autorise. N’autorisez que les outils dont la tâche a besoin.

Claude Code ou Codex pour les tests QA ?

Les règles se transposent. Écrivez-les une fois dans AGENTS.md et mettez @AGENTS.md dans CLAUDE.md : les deux agents lisent alors le même fichier.

Pas à pas pour l’autre agent : les tests QA avec Codex.

Claude CodeCodex
Fichier de règlesCLAUDE.mdAGENTS.md
Connecter des outilsclaude mcp addcodex mcp add ou config.toml
Tourner sans vousclaude -pcodex exec
Planification/schedule, tâches planifiées de bureau, /loopTâches planifiées dans l’app ChatGPT, cron
Intégré pour les tests QAMCP Playwright, sous-agentsMCP Playwright, stdin vers codex exec
Avec Crewmark

Confiez les tests QA à quelqu’un dont c’est le travail

Les commandes tournent quand quelqu’un pense à les lancer. Crewmark transforme votre propre Claude Code en employé IA doté d’un rôle, d’un objectif chiffré, d’horaires de travail et d’une pulsation : le travail se fait selon un planning et apparaît sur un tableau.

  1. Partez du rôle

    Prenez l’ingénieur logiciel IA et mettez ces règles dans sa fiche de poste.

  2. Mettez le travail sur son tableau

    Ajoutez la tâche comme ticket récurrent. L’employé se réveille au rythme de sa pulsation, l’accomplit et rend compte dans un commentaire.

  3. À voir aussi

    Les issues GitHub couvrent ce que deviennent les bugs qu’il signale.

FAQ

Claude Code peut-il utiliser Playwright ?

Oui. Ajoutez le serveur MCP Playwright avec claude mcp add playwright npx @playwright/mcp@latest pour qu’il pilote un navigateur ; il peut aussi écrire et lancer des tests Playwright dans votre dépôt.

Claude Code doit-il corriger les tests qui échouent ?

Seulement après avoir dit pourquoi ils échouent. Mettez la règle dans CLAUDE.md : un échec est un résultat, et il dit si c’est le test ou le code qui est faux avant de modifier l’un ou l’autre.

Claude Code peut-il faire de la QA selon un planning ?

Oui. Lancez la suite avec claude -p depuis la CI ou cron, utilisez une tâche planifiée, ou confiez-la à un employé Crewmark comme ticket récurrent.

Vérifié dans la documentation de Claude Code et la documentation Codex d’OpenAI le 13 novembre 2026.

Confiez les tests QA à un employé IA sur Claude Code.

Crewmark transforme les sessions Claude Code et Codex en employés IA avec des rôles, des objectifs, des horaires de travail et une pulsation.