Cours Vibe coding avec Claude Code · Module 13: Clone de Twitch

Un agent à bord de la CI : @claude dans la pull request

9 min de lecture
Dans cette leçon7

La CI de la leçon précédente dit que quelque chose ne va pas, mais elle ne répare rien. Le bosco laisse dans une pull request le commentaire "ajoute un compteur de caractères sous le champ du chat", et toi, tu es à terre sans ordinateur portable, avec ton seul téléphone. Dans cette leçon, tu donnes à Claude une place à bord de la CI. Claude Code GitHub Actions est l'action officielle anthropics/claude-code-action@v1, qui lance Claude Code dans un workflow, sur une machine de GitHub. Tu écris @claude et ta demande dans un commentaire, et Claude lit le code, fait les modifications et pousse les commits. Pour la première fois, l'agent travaille sans toi au clavier : les permissions, les secrets et les coûts pèsent donc plus lourd que dans toutes les leçons précédentes.

Ce que tu vas apprendre

  • brancher l'action avec la commande /install-github-app et lire le workflow qu'elle ajoute ;
  • distinguer le mode interactif, qui attend @claude, du mode automatisation avec le champ prompt ;
  • commander une modification par un commentaire et relire le diff avant de le fusionner ;
  • limiter qui lance l'agent, combien de tours il fait et où se trouve le secret.

L'installation : /install-github-app

La documentation de Claude Code décrit une voie rapide et une voie manuelle. La voie rapide, c'est une seule commande dans une session, mais elle a trois conditions : un dépôt sur github.com, l'outil gh de la leçon 1_5 installé et connecté, et les droits d'administrateur du dépôt. Dans le dépôt de ton clone, tu les as. Dans le dossier du projet, lance claude et tape la commande :

/install-github-app

L'assistant te guide en trois étapes. D'abord, il installe l'application Claude sur GitHub. Tu donnes ton accord dans le navigateur, et la documentation prévient que l'application demande un ensemble de permissions plus large, parce qu'elle sert plusieurs fonctions de Claude, et que GitHub ne permet pas d'en accepter seulement une partie. Ensuite, l'assistant enregistre le secret. Si Claude Code a déjà une clé API, il l'utilise ; sinon, tu choisis un jeton longue durée de ton abonnement ou une clé API de la Claude Console. L'assistant l'enregistre comme secret du dépôt sous le nom CLAUDE_CODE_OAUTH_TOKEN ou ANTHROPIC_API_KEY. Enfin, il pousse une branche avec les fichiers de workflow et ouvre dans le navigateur une pull request prête à être créée. La touche Échap interrompt l'assistant : l'étape en cours se termine, la suivante ne démarre pas.

Un mot sur le compte. Le jeton d'abonnement peut aussi être créé à la main avec la commande claude setup-token, et les exécutions qui l'utilisent consomment ton abonnement au lieu d'un paiement des tokens de l'API. La documentation ajoute qu'un tel jeton est lié à l'abonnement de la personne qui l'a généré : pour un secret partagé dans une organisation, elle recommande donc une clé API de la Claude Console. Un agent lancé automatiquement est une autre façon d'utiliser ton forfait qu'une conversation à ton bureau : vérifie les conditions de ton forfait avant de bâtir un automate dessus.

Ce que l'assistant a ajouté

Avant de fusionner la pull request de l'assistant, lis le fichier. Sur GitHub, ouvre l'onglet Files changed ; dans Cursor, demande à Claude de récupérer la branche de l'assistant et de basculer dessus, puis ouvre .github/workflows/claude.yml. La documentation montre un exemple de ce genre pour le mode interactif, et ton fichier peut différer dans les détails. D'abord, les déclencheurs :

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest

Tu connais on depuis la leçon 12_5, seuls les évènements changent : un nouveau commentaire dans un ticket (issue) ou dans une pull request, et un nouveau commentaire sur une ligne de code pendant une revue. if vérifie si le commentaire contient @claude ; sinon, la machine ne démarre même pas et ne consomme pas de minutes. L'action vérifie encore une fois le mot elle-même, et la documentation précise que ce doit être le mot entier @claude : @claude-bot ou /claude ne fonctionneront donc pas. Ensuite, les permissions et les étapes :

    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

Ici, permissions est plus large que dans la CI, car Claude doit écrire : contents: write lui permet de pousser des commits, et pull-requests et issues de répondre dans les commentaires. La documentation dit que id-token: write est nécessaire à la connexion par défaut de l'action en tant qu'application Claude, et actions: read permet à Claude de lire les résultats de la CI dans la pull request. fetch-depth: 1 ne récupère que le dernier commit. Si tu as choisi le jeton d'abonnement, la dernière ligne est claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}. La version de checkout de l'exemple peut être plus ancienne que celle de ton ci.yml ; demande à Claude que les deux fichiers utilisent la même.

Sans prompt elle attend, avec prompt elle part seule

Dans l'étape de l'action, il n'y a pas de champ prompt. Selon la documentation, c'est le mode interactif : Claude attend @claude dans un commentaire, une revue ou un nouveau ticket, et montre sa progression et son résultat dans un commentaire sous ce ticket ou cette pull request. Quand le workflow a un champ prompt, l'action passe en mode automatisation : elle démarre à chaque évènement de on sans aucune mention, par exemple à chaque pull request ouverte, et le résultat va par défaut dans le journal de l'exécution, pas dans un commentaire. C'est ainsi que fonctionne la revue des pull requests, que l'assistant propose aussi. Si tu l'as choisie, la branche contient un second fichier, claude-code-review.yml, et Claude laisse ses remarques sous forme de commentaires sur les lignes de code.

Demande pour Claude Code : un commentaire dans la pull request

Fusionne la pull request de l'assistant : à partir de ce moment, @claude fonctionne dans le dépôt. Demande au Claude local une branche avec une petite modification, par exemple un nouveau texte d'indication dans le champ du chat, et une pull request avec gh, comme dans la leçon 12_5. Dans cette pull request, écris le commentaire :

Demande pour Claude Code (commentaire dans la pull request) :

@claude dans components/LiveChat.tsx, ajoute sous le champ du message
un compteur de caractères au format 12/300, cohérent avec le maxLength
du champ. Ajoute un cas à components/LiveChat.test.tsx. Ne modifie
pas d'autres fichiers.

Un commentaire est une demande comme une autre : un fichier, un but, une limite et une preuve. Claude répond par un commentaire dans la même pull request et le met à jour pendant son travail. Selon la FAQ de l'action, sur une pull request ouverte, il pousse les commits directement sur sa branche, et sur un ticket, il crée une nouvelle branche et donne un lien vers un formulaire de pull request prêt à remplir. Il ne fusionne rien et ne fait ni rebase ni force push. Les commits de l'application Claude déclenchent aussi la CI de la leçon 12_5 ; la documentation prévient que ce ne serait pas le cas si l'action écrivait avec le jeton par défaut GITHUB_TOKEN.

À toi maintenant. Ouvre Files changed ou récupère la branche dans Cursor avec git pull, et lis le diff comme dans chaque leçon : est-ce que seuls deux fichiers ont changé, et est-ce que le test vérifie le compteur au lieu d'avoir été assoupli ? Attends que la CI soit verte. C'est toi qui fusionnes.

La revue du capitaine

  1. Qui appelle l'agent. Selon la documentation, l'action ne démarre que pour une personne qui a le droit d'écriture sur le dépôt, et elle refuse les bots, sauf si tu les inscris dans allowed_bots. Un inconnu ne dépensera pas tes tokens avec un commentaire dans un dépôt public. N'assouplis pas cela avec l'option allowed_non_write_users.
  2. Le minimum de permissions. La documentation conseille de ne donner au workflow que les permissions nécessaires et de relire les modifications de Claude avant la fusion. L'exemple de revue de la documentation a contents: read, car il ne pousse rien.
  3. Les coûts. Chaque exécution consomme des minutes de GitHub Actions ainsi que des tokens de l'API ou la limite de l'abonnement. Une demande précise, c'est moins de tours, et un CLAUDE.md court, c'est moins de lecture à chaque exécution.
  4. Le secret. La clé ou le jeton ne vit que dans les secrets du dépôt. Jamais dans un commentaire, car dans un dépôt public, tout le monde lit les commentaires.

L'erreur typique d'un agent face à un commentaire trop général, par exemple "@claude améliore le chat", ce sont de nombreux tours et un diff dans des fichiers que tu n'as pas demandés, parfois avec un test modifié en même temps que le code, comme dans la leçon 12_1. Tu le reconnais dans Files changed à la liste des fichiers. Dans ce cas, tu ne fusionnes pas : tu écris un commentaire plus étroit.

Étape suivante

Il reste à poser sur les coûts les freins que la documentation cite explicitement : une limite de tours dans claude_args et une limite de temps pour la tâche. Demande à Claude Code en local :

Dans .github/workflows/claude.yml, ajoute une limite de 10 tours via
claude_args et une limite de temps du job de 15 minutes. Montre le diff.

Dans le diff, cherche deux nouvelles lignes : la limite de temps sur la tâche elle-même et la limite de tours dans l'étape de l'action, comme ici :

  claude:
    timeout-minutes: 15
    # if, runs-on et permissions inchangés
    steps:
      # étape checkout inchangée
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          claude_args: "--max-turns 10"

Tu connais --max-turns depuis claude -p : ici, il fonctionne de la même façon, car claude_args transmet des options de ligne de commande à Claude Code. timeout-minutes appartient à la tâche, et selon la documentation de GitHub, sans lui une tâche peut durer jusqu'à 360 minutes. Commit, pull request, CI verte et fusion. Dans l'éditeur ci-dessous t'attend un simulateur : choisis un workflow avec ou sans champ prompt, écris un commentaire, change l'auteur et vérifie si l'action démarre.

Retiens ceci : le mousse de quart exécute les ordres écrits dans le journal de bord, mais c'est le capitaine qui valide le cap ; l'agent dans la CI pousse des commits, et c'est toi qui fusionnes.

Code de cette leçon : App.tsx
// Simulateur de l'action Claude Code dans GitHub Actions : démarre-t-elle et où montre-t-elle le résultat
import { useState } from 'react';

type Workflow = 'interactive' | 'automation';
type GitHubEvent = 'comment' | 'pr_opened';
type Author = 'write' | 'no_write' | 'bot';

interface Check {
  ok: boolean;
  text: string;
}

interface Outcome {
  runs: boolean;
  checks: Check[];
  result: string;
}

const WORKFLOWS: Record<Workflow, { label: string; on: GitHubEvent; lines: string[] }> = {
  interactive: {
    label: 'claude.yml : sans champ prompt',
    on: 'comment',
    lines: ['on:', '  issue_comment:', '    types: [created]', "if: contains(github.event.comment.body, '@claude')", 'with:', '  anthropic_api_key: (secret)'],
  },
  automation: {
    label: 'review.yml : avec champ prompt',
    on: 'pr_opened',
    lines: ['on:', '  pull_request:', '    types: [opened, synchronize]', 'with:', '  anthropic_api_key: (secret)', '  prompt: "Fais une revue des modifications"'],
  },
};

const EVENT_LABEL: Record<GitHubEvent, string> = {
  comment: 'Nouveau commentaire dans la pull request',
  pr_opened: "Ouverture d'une pull request",
};

// L'action cherche @claude comme mot entier : ni @claude-bot ni /claude ne correspondent
export function hasTriggerWord(comment: string): boolean {
  return /(^|\s)@claude(?![\w-])/.test(comment);
}

export function simulate(workflow: Workflow, event: GitHubEvent, comment: string, author: Author): Outcome {
  const checks: Check[] = [];
  const stop = (text: string): Outcome => {
    checks.push({ ok: false, text });
    return { runs: false, checks, result: 'Claude ne travaille pas pendant cette exécution' };
  };

  if (WORKFLOWS[workflow].on !== event) {
    return stop("Le workflow ne démarre pas : cet évènement n'est pas dans la section on");
  }
  checks.push({ ok: true, text: "L'évènement est dans la section on, le workflow démarre" });

  if (workflow === 'interactive') {
    if (!comment.includes('@claude')) return stop('if: le commentaire ne contient pas @claude, la machine ne démarre pas et ne consomme pas de minutes');
    checks.push({ ok: true, text: 'if: le commentaire contient @claude, la machine démarre' });
  }

  if (author === 'bot') return stop("L'action refuse un bot absent de allowed_bots : l'exécution se termine en erreur");
  if (author === 'no_write') return stop("L'auteur n'a pas le droit d'écriture sur le dépôt : l'action interrompt l'exécution");
  checks.push({ ok: true, text: "L'auteur a le droit d'écriture sur le dépôt" });

  if (workflow === 'interactive') {
    if (!hasTriggerWord(comment)) return stop("L'action vérifie elle-même le mot @claude : ce n'est pas le mot entier, Claude ne répond pas");
    checks.push({ ok: true, text: 'Mode interactif : pas de champ prompt, donc Claude exécute la demande du commentaire' });
    return {
      runs: true,
      checks,
      result: "Claude répond par un commentaire dans la pull request et pousse des commits sur sa branche. Le diff, c'est toi qui le lis et qui fusionnes.",
    };
  }

  checks.push({ ok: true, text: 'Mode automatisation : le champ prompt lance Claude sans aucune mention' });
  return {
    runs: true,
    checks,
    result: "Le résultat va par défaut dans le journal de l'exécution ; un commentaire n'apparaît que si le prompt demande de l'écrire et que Claude a l'outil pour le faire.",
  };
}

export default function App() {
  const [workflow, setWorkflow] = useState<Workflow>('interactive');
  const [event, setEvent] = useState<GitHubEvent>('comment');
  const [comment, setComment] = useState('@claude ajoute un compteur de caractères sous le champ du chat');
  const [author, setAuthor] = useState<Author>('write');
  const outcome = simulate(workflow, event, comment, author);

  return (
    <div className="min-h-screen space-y-4 bg-zinc-950 p-4 text-zinc-100">
      <h1 className="text-xl font-bold">Un agent à bord de la CI : l&apos;action démarre-t-elle ?</h1>
      <div className="grid gap-4 md:grid-cols-2">
        <section className="space-y-3 text-sm">
          <label className="block">
            Workflow
            <select value={workflow} onChange={(e) => setWorkflow(e.target.value as Workflow)} className="mt-1 block w-full rounded bg-zinc-800 p-2">
              {(Object.keys(WORKFLOWS) as Workflow[]).map((key) => (
                <option key={key} value={key}>
                  {WORKFLOWS[key].label}
                </option>
              ))}
            </select>
          </label>
          <pre className="rounded bg-zinc-900 p-2 font-mono text-xs">{WORKFLOWS[workflow].lines.join('\n')}</pre>
          <label className="block">
            Évènement sur GitHub
            <select value={event} onChange={(e) => setEvent(e.target.value as GitHubEvent)} className="mt-1 block w-full rounded bg-zinc-800 p-2">
              {(Object.keys(EVENT_LABEL) as GitHubEvent[]).map((key) => (
                <option key={key} value={key}>
                  {EVENT_LABEL[key]}
                </option>
              ))}
            </select>
          </label>
          <label className="block">
            Texte du commentaire
            <input
              value={comment}
              onChange={(e) => setComment(e.target.value)}
              disabled={event !== 'comment'}
              className="mt-1 block w-full rounded bg-zinc-800 p-2 disabled:opacity-50"
            />
          </label>
          <label className="block">
            Qui l&apos;a fait
            <select value={author} onChange={(e) => setAuthor(e.target.value as Author)} className="mt-1 block w-full rounded bg-zinc-800 p-2">
              <option value="write">Toi (droit d&apos;écriture)</option>
              <option value="no_write">Un inconnu dans un dépôt public (sans droit d&apos;écriture)</option>
              <option value="bot">Un bot absent de allowed_bots</option>
            </select>
          </label>
        </section>
        <section className="space-y-2 text-sm">
          <ol className="space-y-1">
            {outcome.checks.map((check) => (
              <li key={check.text}>
                <strong className={check.ok ? 'text-emerald-400' : 'text-red-400'}>{check.ok ? 'Oui' : 'Stop'}</strong> {check.text}
              </li>
            ))}
          </ol>
          <p role="status" className={outcome.runs ? 'font-semibold text-emerald-400' : 'font-semibold text-amber-400'}>
            {outcome.runs ? "L'action s'exécute" : "L'action ne s'exécute pas"}
          </p>
          <p className="text-zinc-300">{outcome.result}</p>
          <p className="text-zinc-500">Essaie : un commentaire sans @claude, avec @claude-bot, un auteur inconnu, un workflow avec champ prompt.</p>
        </section>
      </div>
    </div>
  );
}

Tu as repéré une erreur dans cette leçon ?

Teste tes connaissances

Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.

  1. 1. Le workflow avec l'action anthropics/claude-code-action n'a pas de champ prompt. Que fait l'action ?

  2. 2. Selon la documentation de Claude Code, où peut-on activer le mode bypassPermissions ?

Voici 2 des 6 questions de cette leçon. Réponds aux autres dans le jeu.

Tâches pratiques dans le jeu

  • Tri vertical

    Ordonne une demande de modification par commentaire dans une pull request ouverte :

  • Tri horizontal

    Ordonne sur une ligne la règle de .claude/settings.json qui interdit à Claude de lancer docker system prune avec n'importe quelles options :

  1. QuestionQuiz : l'action sans champ prompt
  2. Remets dans l'ordreTri : une demande par commentaire
  3. QuestionQuiz : où activer bypassPermissions
  4. QuestionQuiz : un automate sans surveillance
  5. Remets dans l'ordreTri : la règle deny pour Docker
  6. QuestionQuiz : la réponse en JSON de claude -p
  7. QuestionQuiz : le jeton dans les secrets, pas dans la demande
  8. QuestionQuiz : qui peut appeler @claude
  9. Projet à envoyerEnvoie le Direct du Pont au mentor
  10. VidéoRésumé du module

Articles utiles