Kurs vibe coding z Claude Code · Moduł 13: Klon Twitcha

Agent na pokładzie CI: @claude w pull requeście

7 min czytania
W tej lekcji7

CI z poprzedniej lekcji mówi, że coś jest nie tak, ale niczego nie naprawi. Bosman zostawia w pull requeście komentarz "dodaj licznik znaków pod polem czatu", a Ty stoisz na lądzie bez laptopa, z samym telefonem. W tej lekcji dajesz Claude miejsce na pokładzie CI. Claude Code GitHub Actions to oficjalna akcja anthropics/claude-code-action@v1, która uruchamia Claude Code w workflow, na maszynie GitHuba. Piszesz w komentarzu @claude i prośbę, a Claude czyta kod, wprowadza zmiany i wypycha commity. Po raz pierwszy agent pracuje bez Ciebie przy klawiaturze, więc uprawnienia, sekrety i koszty ważą więcej niż w każdej poprzedniej lekcji.

Czego się nauczysz

  • podłączyć akcję komendą /install-github-app i przeczytać workflow, który dopisze;
  • odróżnić tryb interaktywny, który czeka na @claude, od trybu automatyzacji z polem prompt;
  • zlecić zmianę komentarzem i przejrzeć diff, zanim go scalisz;
  • ograniczyć, kto uruchamia agenta, ile tur zrobi i gdzie leży sekret.

Instalacja: /install-github-app

Dokumentacja Claude Code opisuje drogę szybką i ręczną. Szybka to jedna komenda w sesji, ale ma trzy warunki: repozytorium na github.com, zainstalowany i zalogowany gh z lekcji 1_5 oraz uprawnienia administratora repozytorium. W swoim repozytorium klonu je masz. W folderze projektu uruchom claude i wpisz komendę:

/install-github-app

Kreator prowadzi przez trzy kroki. Najpierw instaluje aplikację Claude na GitHubie. Zgodę dajesz w przeglądarce, a dokumentacja uprzedza, że aplikacja prosi o szerszy zestaw uprawnień, bo służy kilku funkcjom Claude, i że GitHub nie pozwala przyjąć tylko części. Potem kreator zapisuje sekret. Gdy Claude Code ma już klucz API, użyje go; w przeciwnym razie wybierasz długotrwały token swojej subskrypcji albo klucz API z Claude Console. Kreator zapisuje go jako sekret repozytorium o nazwie CLAUDE_CODE_OAUTH_TOKEN albo ANTHROPIC_API_KEY. Na koniec wypycha gałąź z plikami workflow i otwiera w przeglądarce pull request gotowy do utworzenia. Klawisz Esc przerywa kreatora: krok w toku się kończy, następny już nie rusza.

Słowo o koncie. Token subskrypcji można też utworzyć ręcznie komendą claude setup-token, a przebiegi z nim zużywają Twoją subskrypcję zamiast płatności za tokeny API. Dokumentacja dodaje, że taki token jest przypisany do subskrypcji osoby, która go wygenerowała, więc dla sekretu wspólnego w organizacji zaleca klucz API z Claude Console. Agent uruchamiany automatycznie to inny sposób korzystania z planu niż rozmowa przy biurku: sprawdź warunki swojego planu, zanim postawisz na nim automat.

Co dopisał kreator

Zanim scalisz pull request od kreatora, przeczytaj plik. Na GitHubie otwórz zakładkę Files changed, a w Cursorze poproś Claude o pobranie gałęzi kreatora i przełączenie się na nią, potem otwórz .github/workflows/claude.yml. Dokumentacja pokazuje taki przykład trybu interaktywnego, a Twój plik może się różnić szczegółami. Najpierw wyzwalacze:

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

on znasz z lekcji 12_5, tylko zdarzenia są inne: nowy komentarz w zgłoszeniu (issue) albo w pull requeście i nowy komentarz przy linii kodu w recenzji. if sprawdza, czy komentarz zawiera @claude; jeśli nie, maszyna w ogóle nie startuje i nie zużywa minut. Akcja sprawdza słowo jeszcze raz sama, a dokumentacja zaznacza, że musi to być całe słowo @claude, więc @claude-bot albo /claude nie zadziała. Dalej uprawnienia i kroki:

    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 }}

Tu permissions jest szersze niż w CI, bo Claude ma pisać: contents: write pozwala wypchnąć commity, a pull-requests i issues odpowiadać w komentarzach. id-token: write dokumentacja nazywa wymaganym do domyślnego logowania akcji jako aplikacja Claude, a actions: read pozwala Claude czytać wyniki CI w pull requeście. fetch-depth: 1 pobiera tylko ostatni commit. Jeśli wybrałeś token subskrypcji, ostatnia linia brzmi claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}. Wersja checkout z przykładu może być starsza niż w Twoim ci.yml; poproś Claude, żeby oba pliki używały tej samej.

Bez prompt czeka, z prompt rusza sam

W kroku akcji nie ma pola prompt. Według dokumentacji to tryb interaktywny: Claude czeka na @claude w komentarzu, w recenzji albo w nowym zgłoszeniu, a postęp i wynik pokazuje w komentarzu pod tym zgłoszeniem lub pull requestem. Gdy workflow ma pole prompt, akcja przechodzi w tryb automatyzacji: rusza na każde zdarzenie z on bez żadnej wzmianki, na przykład przy każdym otwartym pull requeście, a wynik trafia domyślnie do logu przebiegu, nie do komentarza. Tak działa recenzja pull requestów, którą kreator też proponuje. Jeśli ją wybrałeś, w gałęzi jest drugi plik, claude-code-review.yml, a Claude zostawia uwagi jako komentarze przy liniach kodu.

Polecenie dla Claude Code: komentarz w pull requeście

Scal pull request kreatora: od tej chwili @claude działa w repozytorium. Poproś lokalnego Claude o gałąź z jedną drobną zmianą, na przykład nowym tekstem podpowiedzi w polu czatu, i o pull request przez gh, jak w lekcji 12_5. W tym pull requeście napisz komentarz:

Polecenie dla Claude Code (komentarz w pull requeście):

@claude w components/LiveChat.tsx dodaj pod polem wiadomości licznik
znaków w formacie 12/300, zgodny z maxLength pola. Dopisz przypadek
do components/LiveChat.test.tsx. Nie zmieniaj innych plików.

Komentarz to polecenie jak każde inne: plik, cel, granica i dowód. Claude odpowiada komentarzem w tym samym pull requeście i aktualizuje go w trakcie pracy. Według FAQ akcji przy otwartym pull requeście wypycha commity prosto na jego gałąź, a przy zgłoszeniu tworzy nową gałąź i daje link do gotowego formularza pull requesta. Niczego nie scala, nie robi rebase ani force push. Commity od aplikacji Claude uruchamiają też CI z lekcji 12_5; dokumentacja ostrzega, że nie stałoby się tak, gdyby akcja pisała domyślnym tokenem GITHUB_TOKEN.

Teraz Twoja kolej. Otwórz Files changed albo pobierz gałąź w Cursorze przez git pull i czytaj diff jak w każdej lekcji: czy zmieniły się tylko dwa pliki i czy test sprawdza licznik, a nie został poluzowany. Poczekaj na zielone CI. Scalasz Ty.

Przegląd kapitana

  1. Kto woła agenta. Według dokumentacji akcja rusza tylko dla osoby z prawem zapisu do repozytorium, a boty odrzuca, chyba że wpiszesz je do allowed_bots. Obcy w publicznym repozytorium nie wyda Twoich tokenów komentarzem. Nie luzuj tego opcją allowed_non_write_users.
  2. Minimum uprawnień. Dokumentacja radzi dać workflow tylko potrzebne uprawnienia i przeglądać zmiany Claude przed scaleniem. Przykład recenzji w dokumentacji ma contents: read, bo niczego nie wypycha.
  3. Koszty. Każdy przebieg zużywa minuty GitHub Actions oraz tokeny API albo limit subskrypcji. Konkretna prośba to mniej tur, a krótki CLAUDE.md to mniej czytania przy każdym przebiegu.
  4. Sekret. Klucz albo token mieszka tylko w sekretach repozytorium. Nigdy w komentarzu, bo komentarz w publicznym repozytorium czyta każdy.

Typowy błąd agenta przy ogólnym komentarzu, na przykład "@claude popraw czat", to wiele tur i diff w plikach, o które nie prosiłeś, czasem z testem zmienionym razem z kodem, jak w lekcji 12_1. Rozpoznasz to w Files changed po liście plików. Wtedy nie scalasz, tylko piszesz węższy komentarz.

Następny krok

Zostało założyć hamulce na koszty, które dokumentacja wymienia wprost: limit tur w claude_args i limit czasu zadania. Poproś Claude Code lokalnie:

W .github/workflows/claude.yml dodaj limit 10 tur przez claude_args
i limit czasu joba 15 minut. Pokaż diff.

W diffie szukaj dwóch nowych linii: limitu czasu przy samym zadaniu i limitu tur w kroku akcji, tak jak tutaj:

  claude:
    timeout-minutes: 15
    # if, runs-on i permissions bez zmian
    steps:
      # krok checkout bez zmian
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          claude_args: "--max-turns 10"

--max-turns znasz z claude -p: tu działa tak samo, bo claude_args przekazuje flagi wiersza poleceń do Claude Code. timeout-minutes należy do zadania, a według dokumentacji GitHuba bez niego zadanie może trwać nawet 360 minut. Commit, pull request, zielone CI i scalenie. W edytorze poniżej czeka symulator: wybierz workflow z polem prompt albo bez, wpisz komentarz, zmień autora i sprawdź, czy akcja ruszy.

Zapamiętaj: majtek na wachcie wykonuje rozkazy zapisane w dzienniku, ale kurs zatwierdza kapitan; agent w CI wypycha commity, a scalasz Ty.

Kod do tej lekcji: App.tsx
// Symulator akcji Claude Code w GitHub Actions: czy ruszy i gdzie pokaże wynik
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: bez pola prompt',
    on: 'comment',
    lines: ['on:', '  issue_comment:', '    types: [created]', "if: contains(github.event.comment.body, '@claude')", 'with:', '  anthropic_api_key: (sekret)'],
  },
  automation: {
    label: 'review.yml: z polem prompt',
    on: 'pr_opened',
    lines: ['on:', '  pull_request:', '    types: [opened, synchronize]', 'with:', '  anthropic_api_key: (sekret)', '  prompt: "Zrób recenzję zmian"'],
  },
};

const EVENT_LABEL: Record<GitHubEvent, string> = {
  comment: 'Nowy komentarz w pull requeście',
  pr_opened: 'Otwarcie pull requesta',
};

// Akcja szuka @claude jako całego słowa: @claude-bot ani /claude nie pasują
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 nie pracuje w tym przebiegu' };
  };

  if (WORKFLOWS[workflow].on !== event) {
    return stop('Workflow nie startuje: tego zdarzenia nie ma w sekcji on');
  }
  checks.push({ ok: true, text: 'Zdarzenie jest w sekcji on, workflow startuje' });

  if (workflow === 'interactive') {
    if (!comment.includes('@claude')) return stop('if: w komentarzu nie ma @claude, maszyna nie startuje i nie zużywa minut');
    checks.push({ ok: true, text: 'if: komentarz zawiera @claude, maszyna startuje' });
  }

  if (author === 'bot') return stop('Akcja odrzuca bota, którego nie ma w allowed_bots: przebieg kończy się błędem');
  if (author === 'no_write') return stop('Autor nie ma prawa zapisu do repozytorium: akcja przerywa przebieg');
  checks.push({ ok: true, text: 'Autor ma prawo zapisu do repozytorium' });

  if (workflow === 'interactive') {
    if (!hasTriggerWord(comment)) return stop('Akcja sama sprawdza słowo @claude: to nie jest całe słowo, Claude nie odpowiada');
    checks.push({ ok: true, text: 'Tryb interaktywny: brak pola prompt, więc Claude wykonuje prośbę z komentarza' });
    return {
      runs: true,
      checks,
      result: 'Claude odpowiada komentarzem w pull requeście i wypycha commity na jego gałąź. Diff czytasz i scalasz Ty.',
    };
  }

  checks.push({ ok: true, text: 'Tryb automatyzacji: pole prompt uruchamia Claude bez żadnej wzmianki' });
  return {
    runs: true,
    checks,
    result: 'Wynik trafia domyślnie do logu przebiegu; komentarz pojawi się tylko wtedy, gdy prompt każe go napisać, a Claude ma do tego narzędzie.',
  };
}

export default function App() {
  const [workflow, setWorkflow] = useState<Workflow>('interactive');
  const [event, setEvent] = useState<GitHubEvent>('comment');
  const [comment, setComment] = useState('@claude dodaj licznik znaków pod polem czatu');
  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">Agent na pokładzie CI: czy akcja ruszy?</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">
            Zdarzenie na GitHubie
            <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">
            Treść komentarza
            <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">
            Kto to zrobił
            <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">Ty (prawo zapisu)</option>
              <option value="no_write">Obcy w publicznym repozytorium (bez prawa zapisu)</option>
              <option value="bot">Bot spoza 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 ? 'Tak' : 'Stop'}</strong> {check.text}
              </li>
            ))}
          </ol>
          <p role="status" className={outcome.runs ? 'font-semibold text-emerald-400' : 'font-semibold text-amber-400'}>
            {outcome.runs ? 'Akcja pracuje' : 'Akcja nie pracuje'}
          </p>
          <p className="text-zinc-300">{outcome.result}</p>
          <p className="text-zinc-500">Spróbuj: komentarz bez @claude, z @claude-bot, obcy autor, workflow z polem prompt.</p>
        </section>
      </div>
    </div>
  );
}

Widzisz błąd w tej lekcji?

Sprawdź się

Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.

  1. 1. Workflow z akcją anthropics/claude-code-action nie ma pola prompt. Co robi akcja?

  2. 2. Gdzie według dokumentacji Claude Code wolno włączyć tryb bypassPermissions?

To 2 z 6 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

Zadania praktyczne w grze

  • Układanie w pionie

    Uporządkuj zlecenie zmiany przez komentarz w otwartym pull requeście:

  • Układanie w poziomie

    Ułóż w jednej linii regułę z .claude/settings.json, która zabrania Claude uruchamiać docker system prune z dowolnymi opcjami:

  1. PytanieQuiz: akcja bez pola prompt
  2. Ułóż w kolejnościSortowanie: zlecenie przez komentarz
  3. PytanieQuiz: gdzie bypassPermissions
  4. PytanieQuiz: automat bez nadzoru
  5. Ułóż w kolejnościSortowanie: reguła deny dla Dockera
  6. PytanieQuiz: odpowiedź w JSON z claude -p
  7. PytanieQuiz: token w sekretach, nie w poleceniu
  8. PytanieQuiz: kto może wywołać @claude
  9. Projekt do wysłaniaWyślij Live from the Deck do mentora
  10. WideoPodsumowanie modułu

Przydatne artykuły