Kurs vibe coding z Claude Code · Moduł 13: Klon Twitcha
Agent na pokładzie CI: @claude w pull requeście
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-appi przeczytać workflow, który dopisze; - odróżnić tryb interaktywny, który czeka na
@claude, od trybu automatyzacji z polemprompt; - 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-appKreator 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-lateston 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
- 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. - 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. - 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.mdto mniej czytania przy każdym przebiegu. - 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. Workflow z akcją anthropics/claude-code-action nie ma pola prompt. Co robi akcja?
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:
Zadania po tej lekcji
- PytanieQuiz: akcja bez pola prompt
- Ułóż w kolejnościSortowanie: zlecenie przez komentarz
- PytanieQuiz: gdzie bypassPermissions
- PytanieQuiz: automat bez nadzoru
- Ułóż w kolejnościSortowanie: reguła deny dla Dockera
- PytanieQuiz: odpowiedź w JSON z claude -p
- PytanieQuiz: token w sekretach, nie w poleceniu
- PytanieQuiz: kto może wywołać @claude
- Projekt do wysłaniaWyślij Live from the Deck do mentora
- WideoPodsumowanie modułu