AI CodeOps

Revue des pull requests de Claude Code avec des barrières qualité

Matt · · Mis à jour le · 12 min de lecture · Guides

Faites passer le travail de Claude Code par des sessions AI CodeOps sous barrières via MCP, exigez la barrière de livraison sur la PR et bloquez les pushes qui la contournent.

Pour placer les pull requests de Claude Code derrière des barrières qualité, faites démarrer à Claude Code des sessions AI CodeOps via le serveur MCP au lieu de le laisser écrire et pousser le changement lui-même, puis faites de la barrière de livraison d'AI CodeOps une vérification requise sur la pull request. La session teste et relit le changement, une deuxième personne l'approuve, et la vérification requise garde le bouton de fusion verrouillé jusqu'à ce que la barrière l'autorise.

Le problème : des PR d'agents rapides, une revue humaine lente

Claude Code excelle à transformer une phrase en diff. Entre ce diff et votre branche principale, il n'y a généralement que « un développeur le parcourt en diagonale », et cela tient jusqu'à ce que le volume augmente. Un agent peut ouvrir en une matinée plus de pull requests qu'une équipe ne peut en lire attentivement en une journée, et c'est la lecture attentive qui passe à la trappe.

Une barrière ne se fatigue pas, mais elle doit voir le changement. Il vaut la peine d'être précis ici, car une erreur sur ce point donne un faux sentiment de sécurité.

La barrière de livraison d'AI CodeOps décide sur la base de preuves qu'elle a elle-même enregistrées : la session qui a écrit le changement, la revue IA de son diff, l'exécution de tests dans son bac à sable et l'approbation. Elle retrouve ces preuves grâce à la pull request qu'a ouverte la session. La barrière ne surveille pas vos dépôts à la recherche de pull requests ouvertes ailleurs. Si Claude Code écrit un changement sur votre ordinateur et que vous le poussez puis ouvrez une pull request, AI CodeOps n'en sait donc rien. Interrogez la barrière sur cette pull request : elle répond allowed: false avec « No workflow runs found for … ». C'est la bonne réponse. Elle n'a rien à juger, donc elle refuse.

Cela détermine la conception. Si vous voulez que le travail de Claude Code passe derrière la barrière, il doit passer par une session AI CodeOps. Claude Code reste l'interface dans laquelle vous tapez. La session se charge de l'écriture, des tests et de la revue sur la plateforme, puis ouvre la pull request.

Mise en place : connecter le dépôt, choisir les barrières, exiger la vérification

Connectez le dépôt. Dans AI CodeOps, connectez votre compte GitHub sous Configure → Settings → Git Providers (Connecter GitHub) et créez un projet avec l'URL du dépôt sous Plan → Projects. Les sessions de ce projet écrivent à partir d'un instantané du dépôt et y ouvrent leurs pull requests. La page d'intégration GitHub décrit ce qu'AI CodeOps fait du dépôt.

Choisissez les barrières. Par défaut, la barrière de livraison refuse un changement si un constat high ou critical est encore ouvert, si une exécution de tests a échoué, si une session qui a modifié du code n'a pas de résultat de test avec des décomptes, si un workflow dont il dépend a échoué ou qu'aucune exécution de ce workflow n'est terminée, ou si la revue IA ne s'est pas terminée. Dans l'appel de CI, vous pouvez ajouter blockingSeverity, requiredWorkflows et minCoveragePct. Un seuil de couverture a besoin d'un chiffre de couverture : si aucune exécution de tests sur le changement n'a indiqué de couverture, la barrière refuse, car elle ne peut pas vérifier le seuil. La page Barrières qualité donne les règles complètes.

Exigez la vérification AI CodeOps. Interroger la barrière depuis Claude Code est utile, mais seulement indicatif : quelqu'un peut toujours cliquer sur Merge. L'application de la règle revient à l'hébergeur Git. Voici comment faire sur GitHub, avec un simple workflow et aucune Action supplémentaire à installer :

# .github/workflows/aicodeops-gate.yml
name: AI CodeOps gate
on:
  pull_request:

permissions:
  contents: read

jobs:
  gate:
    if: startsWith(github.head_ref, 'codeops/run-')
    runs-on: ubuntu-latest
    steps:
      - name: Ask the AI CodeOps release gate
        env:
          AICODEOPS_API_KEY: ${{ secrets.AICODEOPS_API_KEY }}
          PR_URL: ${{ github.event.pull_request.html_url }}
        run: |
          jq -n --arg pr "$PR_URL" '{pullRequestURL: $pr}' > request.json
          curl -sS --fail-with-body -X POST "https://console.aicodeops.dev/api/release/check" \
            -H "Authorization: Bearer $AICODEOPS_API_KEY" \
            -H "Content-Type: application/json" \
            --data @request.json -o gate.json
          jq -r '.summary' gate.json
          jq -r '.reasons[]' gate.json
          jq -e '.allowed == true' gate.json > /dev/null

Ajoutez la clé comme secret de dépôt nommé AICODEOPS_API_KEY. Utilisez une clé distincte pour la CI, pas celle de votre éditeur. La vérification n'a besoin que de workspace:read, et lorsque votre offre inclut la limitation du périmètre des clés, vous pouvez limiter la clé à la vérification de la barrière de livraison.

Quelques détails comptent ici :

  • Lisez allowed, pas le code de statut. Le point de terminaison répond 200 pour les deux verdicts. La dernière ligne fait échouer l'étape sauf si allowed vaut true.
  • Elle reste fermée en cas d'erreur. Une clé absente ou erronée reçoit un 401 ou un 403, et --fail-with-body en fait une étape échouée. Si l'évaluation elle-même échoue, l'API répond allowed: false avec « Evaluation failed ». Au-delà de 60 vérifications par minute pour l'espace de travail, la réponse est un 429, qui fait aussi échouer l'étape : relancez-la.
  • jq et curl sont déjà là. L'image de runner ubuntu-latest de GitHub contient les deux : il n'y a rien à installer.

La ligne if: est un choix à faire en connaissance de cause. Elle n'exécute la barrière que sur les branches ouvertes par AI CodeOps. La page de dépannage des vérifications requises de GitHub indique qu'un job ignoré par une condition au niveau du job rapporte « Success ». La pull request d'une personne fusionne donc toujours selon vos règles habituelles, et une pull request AI CodeOps ne peut pas être fusionnée tant que la barrière ne l'a pas laissée passer. Ne remplacez pas le if: par un filtre de branches sous on:. La même page indique que les vérifications ignorées à cause d'un filtre de branches ou de chemins restent « Pending » et bloquent la fusion.

Si vous supprimez complètement le if:, chaque pull request doit avoir une session AI CodeOps derrière elle. C'est une politique valable pour un dépôt que seuls des agents doivent modifier, mais elle bloque toutes les pull requests humaines : décidez-le en connaissance de cause.

Enfin, rendez la vérification obligatoire. Dans la règle de protection de branche ou le ruleset de main, exigez que les vérifications de statut réussissent et sélectionnez la vérification gate. Exigez aussi une pull request avant la fusion, pour que rien n'atteigne main sans passer par l'une d'elles. Les rulesets GitHub pour les agents IA couvre le reste du ruleset.

Utiliser le serveur MCP d'AI CodeOps depuis Claude Code

AI CodeOps exploite un serveur MCP distant à l'adresse https://console.aicodeops.dev/mcp. Il utilise le transport Streamable HTTP et accepte une clé API de l'espace de travail comme token Bearer.

Créez une clé sous Configure → API Keys. Elle commence par sk- et n'est affichée qu'une fois. Deux outils exigent plus qu'un accès en lecture, et une clé sans périmètre défini n'y a pas accès par défaut :

  • start_session consomme du budget de modèles : il ne fonctionne donc qu'avec une clé dont le périmètre le mentionne. Choisissez Scope sur la clé et cochez Start sessions from the MCP server (/mcp).
  • get_evidence_pack exporte l'enregistrement d'audit : il faut donc aussi cocher Evidence packs from the MCP server (/mcp).

Les sept autres outils (list_projects, get_session, check_release_gate, list_findings, list_builds, get_build, list_saved_builds) ne font que lire. Une clé agit toujours au nom du membre qui l'a créée, avec le rôle actuel de ce membre. La clé d'un Viewer peut lire, et rien de plus, quel que soit son périmètre.

Ajoutez ensuite le serveur. Voici la commande du guide Le serveur MCP d'AI CodeOps, dans la syntaxe que donne la documentation MCP de Claude Code pour un serveur HTTP distant avec un en-tête (vérifiée le 24 octobre 2026) :

claude mcp add --transport http aicodeops https://console.aicodeops.dev/mcp \
  --header "Authorization: Bearer $AICODEOPS_API_KEY"

Cette commande enregistre le serveur avec la portée par défaut, local, dans ~/.claude.json, pour le projet en cours uniquement. Pour une équipe, un .mcp.json à portée projet dans le dépôt est préférable, car Claude Code développe les variables d'environnement dans les champs url et headers d'un serveur distant. Tout le monde commite le même fichier et garde sa propre clé dans son shell :

{
  "mcpServers": {
    "aicodeops": {
      "type": "http",
      "url": "https://console.aicodeops.dev/mcp",
      "headers": { "Authorization": "Bearer ${AICODEOPS_API_KEY}" }
    }
  }
}

Claude Code demande à chaque personne d'approuver les serveurs à portée projet issus de .mcp.json avant de les utiliser. Lancez /mcp dans Claude Code : aicodeops doit apparaître comme connecté, avec neuf outils.

Pas à pas : une pull request, du prompt à la fusion

Supposons que vous tapiez : « Ajoute une limitation de débit au point de terminaison de connexion du projet api, puis dis-moi quand la PR est prête à être fusionnée. » Voici ce qui se passe, outil par outil.

list_projects renvoie les projets de l'espace de travail et leurs dépôts. Claude Code choisit l'id de projet de api.

start_session démarre une session avec votre tâche et ce projet. Sans argument workflow, elle exécute plan-build-review-test. Vous pouvez en nommer un autre, comme security-sensitive-change, qui ajoute une analyse de risques avant le changement et un audit du diff après. L'appel renvoie un id de session et un lien vers la session dans la console. Il est aussi décompté du budget de l'espace de travail et de la limite de travaux en cours des agents, exactement comme une session démarrée dans le navigateur.

À partir de là, le travail se fait sur la plateforme, pas sur votre ordinateur :

  1. Des agents planifient et écrivent le changement à partir d'un instantané du dépôt, chaque étape transmettant sa sortie à la suivante (le guide Schémas multi-agents : pipelines, revues parallèles et débat explique ces passages de relais).
  2. L'étape verify (vérification) exécute les tests de votre projet sur l'arbre proposé, dans un bac à sable isolé. Les dépendances existantes du dépôt sont d'abord installées. Le bac à sable est ensuite coupé du réseau, et alors seulement les modifications de l'IA sont écrites et exécutées. Si l'isolement réseau du bac à sable ne peut pas être confirmé, le changement n'est pas exécuté du tout. Si le changement a touché un manifeste de dépendances, l'installation est relancée avec le réseau toujours coupé : un package absent jusque-là ne peut donc pas être téléchargé, et la suite est enregistrée comme ignorée plutôt qu'exécutée.
  3. Un relecteur IA lit le diff et enregistre des constats avec une gravité. Une réponse qui n'est pas une liste lisible compte comme une revue échouée, et la barrière retient le changement.
  4. Une approbation s'ouvre sous Review & Gate → Approvals.

get_session est ce que Claude Code interroge régulièrement. Il renvoie le statut, les étapes et, dès qu'ils existent, la pull request et son enregistrement de changement.

L'approbation est l'étape que l'on saute dans d'autres configurations : elle mérite donc d'être détaillée. La session a été démarrée avec votre clé : c'est donc vous qui l'avez lancée. Dès que l'espace de travail compte une deuxième personne habilitée à approuver, votre propre approbation ne compte pas. Quelqu'un d'autre doit examiner le diff. Lorsque cette personne approuve, AI CodeOps vérifie le changement au regard de la barrière qualité et ouvre la pull request sur une branche nommée codeops/run-<id>. Le rejet est toujours permis, et un seul rejet arrête le changement.

check_release_gate indique si la pull request peut être livrée, avec les motifs. C'est la même vérification que celle du workflow de CI ci-dessus, avec les mêmes valeurs par défaut et les mêmes options.

get_evidence_pack renvoie l'enregistrement signé du changement : le prompt, le modèle, les exécutions, les constats, les tests et les approbations, signé avec Ed25519 et vérifiable sur /evidence/verify. Son export est lui-même consigné dans le journal d'audit.

L'intérêt : Claude Code peut vous dire « la barrière refuse, voici pourquoi » avec de vrais motifs, au lieu de vous affirmer que les tests passent parce qu'il le croit.

Conseils

Empêchez l'agent local de contourner la barrière. La dernière faille, c'est Claude Code lui-même. Dans une session ordinaire sur votre ordinateur, il peut exécuter git push et gh pr create comme vous. S'il le fait, vous obtenez exactement la pull request hors barrière que cette configuration doit éviter.

Les règles de permission de Claude Code peuvent refuser ces commandes. Commitez ceci dans .claude/settings.json, dans le dépôt :

{
  "permissions": {
    "deny": ["Bash(git push *)", "Bash(gh pr create *)", "Bash(gh pr merge *)"]
  }
}

La documentation indique que les règles sont évaluées dans l'ordre deny, puis ask, puis allow, et qu'un deny dans n'importe quel fichier de settings l'emporte sur un allow dans n'importe quel autre. Les règles deny du fichier de projet partagé s'appliquent aussi immédiatement, sans attendre que chaque personne ait accordé sa confiance au dossier.

Soyez lucide sur ce que c'est (documentation vérifiée le 24 octobre 2026). La même documentation indique qu'une règle Bash correspond au texte de la commande qu'écrit Claude : Bash(git push *) ne correspond donc pas à git -C . push, et elle affirme clairement qu'une telle règle « n'est pas une frontière de sécurité autour du programme ». Considérez la liste deny comme une ceinture de sécurité pour le cas courant. La frontière se trouve sur l'hébergeur Git : un main protégé, une pull request obligatoire, des revues obligatoires pour les pull requests humaines et la vérification gate obligatoire pour celles d'AI CodeOps.

Sachez ce que cette configuration ne fait pas.

  • Elle ne relit pas les pull requests qu'AI CodeOps n'a pas ouvertes. Un changement que vous avez écrit en local avec Claude Code et poussé vous-même est votre changement. Votre revue humaine habituelle s'y applique, et la barrière n'a pas d'avis.
  • Elle n'utilise pas les trailers de commit comme signal. Claude Code peut ajouter une ligne d'attribution aux commits et aux pull requests, mais son réglage permet de la modifier ou de la masquer. Une règle fondée sur un trailer est une règle qu'un agent peut désactiver.
  • Elle ne rend pas la revue IA infaillible. La revue, c'est un modèle qui lit un diff. C'est pourquoi elle s'ajoute à de vraies exécutions de tests et à une deuxième personne, sans les remplacer.

Utilisez une deuxième clé pour la CI. La clé de l'éditeur peut démarrer des sessions ; la clé de CI n'a besoin que de lire la barrière. Si l'une fuit, vous la révoquez sans casser l'autre.

L'autre sens, connecter vos propres serveurs MCP aux sessions, est décrit sur la page d'intégration MCP.

À retenir

  • La barrière d'AI CodeOps ne juge que les changements réalisés par une session AI CodeOps : faites donc passer le travail de Claude Code par des sessions via MCP.
  • Faites de la barrière de livraison une vérification requise sur main, et ne l'exécutez que sur les branches codeops/run- grâce à un if: au niveau du job.
  • Lisez allowed dans la réponse de la barrière, pas le statut HTTP, et laissez chaque erreur faire échouer l'étape.
  • La personne qui a démarré une session ne peut pas l'approuver seule dès que quelqu'un d'autre peut relire.
  • Les règles deny de Claude Code sont une ceinture de sécurité ; la protection de branche et la vérification requise sont la frontière.

Questions fréquentes

AI CodeOps peut-il soumettre à ses barrières une pull request que Claude Code a poussée depuis mon ordinateur ?

Non. La barrière de livraison juge des preuves issues des sessions AI CodeOps : une pull request qu'aucune session n'a ouverte reçoit donc allowed false avec « No workflow runs found ». Demandez plutôt à Claude Code de démarrer une session au lieu de pousser lui-même le changement.

Une personne relit-elle encore les pull requests de Claude Code ?

Oui. Dès que l'espace de travail compte une deuxième personne habilitée à approuver, la personne qui a démarré la session ne peut pas émettre le vote d'approbation : quelqu'un d'autre lit donc le diff avant l'ouverture de la pull request.

Les règles deny de Claude Code bloquent-elles tous les git push ?

Non. Une règle Bash correspond au texte de la commande qu'écrit Claude : une autre façon d'écrire le push n'est donc pas reconnue. Considérez la liste deny comme une ceinture de sécurité et comptez sur la protection de branche et la vérification requise pour tracer la véritable frontière.