Automatyzacja zadań z Claude Code

Co piątek ręcznie aktualizujesz changelog, zwiększasz wersję w trzech plikach, regenerujesz dokumentację API, uruchamiasz testy, tagujesz release i pushasz. Zabiera to 45 minut jeśli nic nie pójdzie nie tak. W zeszłym tygodniu zapomniałeś zaktualizować wersję w package.json i build Docker pobrał stary tag. Tydzień wcześniej changelog pominął dwa PR-y, bo zapomniałeś sprawdzić zakresu dat. To nie są trudne zadania — to są żmudne zadania, a w żmudnych zadaniach mieszkają błędy.

Co z tego wyniesiesz

• Workflow Claude Code do automatyzacji procesów release’owych, generowania kodu, masowych refaktorów i utrzymania projektu z terminala
• Prompty gotowe do skopiowania do budowania niestandardowych komend slash, skryptów headless i automatyzacji opartych na hookach, które działają bez nadzoru
• Praktyczne zrozumienie kiedy używać Claude Code interaktywnie a kiedy w trybie headless, oraz jak łączyć wiele operacji w łańcuch

Niestandardowe komendy slash

Claude Code wspiera niestandardowe komendy przechowywane w .claude/commands/, które wywołujesz za pomocą /. To najprostszy i najpotężniejszy punkt wejścia do automatyzacji.

Wskazówka

Prompt gotowy do skopiowania — stwórz komendę release:

Create a custom Claude Code command at .claude/commands/release.md that automates our release process: 1) determine the next semantic version by analyzing commits since the last tag (feat = minor, fix = patch, BREAKING CHANGE = major), 2) update the version in package.json, 3) generate a changelog entry from the commit messages since the last release, grouped by type (features, fixes, chores), 4) run the test suite and abort if any test fails, 5) create a git commit with message "release: vX.Y.Z", 6) create a git tag vX.Y.Z, 7) push the commit and tag. The command should accept an optional argument to override the version bump type.

Po utworzeniu komendy, wywołaj ją:

/release

Lub z nadpisaniem:

/release major

Claude Code odczytuje plik komendy, wykonuje instrukcje i realizuje każdy krok. Jeśli test suite zawiedzie na kroku 4, zatrzyma się i zgłosi błąd zamiast kontynuować tagowanie zepsutego release’u.

Tryb headless do skryptów

Do automatyzacji działających w CI lub cron jobs, tryb headless Claude Code (flaga -p) działa bez interaktywnego terminala.

# Generuj dzienny raport zależności
claude -p "Check our package.json for outdated dependencies. List any that are more than one major version behind, any with known vulnerabilities, and any where the latest version has breaking changes. Output a markdown summary."  > reports/deps-$(date +%Y-%m-%d).md

# Automatycznie napraw błędy lintera
claude -p "Run our linter and fix all auto-fixable errors. For errors that cannot be auto-fixed, add a TODO comment with the rule name."

# Generuj dokumentację API ze źródeł
claude -p "Read all our API route handlers and generate OpenAPI 3.1 specification in YAML format. Include request/response schemas inferred from the TypeScript types, path parameters, query parameters, and error responses." > docs/openapi.yml

Notatka

W trybie -p Claude Code domyślnie nadal pyta o zgodę przy każdym narzędziu. Aby pozwolić nienadzorowanej automatyzacji zapisywać pliki, nadaj jej potrzebne narzędzia jawnie przez --allowedTools (np. --allowedTools "Bash,Read,Edit") lub ustaw --permission-mode acceptEdits, aby automatycznie akceptować edycje w danym uruchomieniu. Preferuj wąską listę --allowedTools zamiast szerokiej akceptacji, tak aby skrypt mógł dotykać tylko tego, co zamierzałeś.

Hooki do automatycznych gate’ów jakości

Hooki Claude Code uruchamiają się automatycznie w określonych punktach cyklu życia. Są definiowane w .claude/settings.json i wykonują się bez pytania.

Wskazówka

Prompt gotowy do skopiowania — skonfiguruj hooki gate’ów jakości:

Create Claude Code hooks in .claude/settings.json for these lifecycle events: 1) PreToolUse for the Edit tool: before any file edit, check that the file has a corresponding test file. If not, create a stub test file first. 2) PostToolUse for the Write tool: after writing any TypeScript file, run the TypeScript compiler on that file and report errors. 3) PreToolUse for Bash: before running any bash command that includes 'rm' or 'drop', require confirmation by printing a warning. Show me the exact settings.json structure.

Hooki są szczególnie wartościowe do wymuszania standardów zespołowych. Hook, który uruchamia eslint --fix po każdej edycji pliku, oznacza, że wynik Claude Code zawsze odpowiada Twojemu stylowi kodu bez pytania.

Masowe refaktory w wielu plikach

Niektóre zadania dotykają dziesiątki lub setki plików. Claude Code obsługuje je systematycznie, gdy otrzyma jasne instrukcje.

Wskazówka

Prompt gotowy do skopiowania — masowa migracja biblioteki:

We are migrating from moment.js to date-fns across our entire codebase. For every file that imports moment: 1) replace the import with the equivalent date-fns functions, 2) update every moment() call to the date-fns equivalent (format, parse, add, subtract, diff, isAfter, isBefore), 3) update date format strings from moment format (YYYY-MM-DD) to date-fns format (yyyy-MM-dd), 4) run the tests for each modified file to verify the change. Give me a summary of all changes at the end.

Claude Code przetwarza pliki jeden po drugim, uruchamiając testy po każdej zmianie. Jeśli test zawiedzie, naprawia problem przed przejściem dalej, zamiast zepsuć dwadzieścia plików i zostawić Cię z sprzątaniem.

Pipe’owanie danych przez Claude Code

Claude Code integruje się z pipe’ami Unix, czyniąc go częścią Twojego zestawu narzędzi powłoki.

# Analizuj błędy buildu
npm run build 2>&1 | claude -p "Explain each error, suggest a fix, and apply the fixes to the source files"

# Konwertuj CSV na SQL inserts
cat users.csv | claude -p "Convert this CSV data to SQL INSERT statements for a users table with columns: id, email, name, created_at. Use parameterized values for safety." > seed.sql

# Podsumuj zmiany git na standup
git log --oneline --since="yesterday" | claude -p "Summarize these commits as 3-5 bullet points suitable for a standup update. Group related changes."

Wzorzec pipe’owania jest potężny, ponieważ możesz łączyć Claude Code ze standardowymi narzędziami Unix. Wejście to kontekst, prompt to transformacja, a wyjście można przechwycić lub dalej pipe’ować.

Zaplanowane automatyzacje

Połącz tryb headless Claude Code z cron dla powtarzających się zadań.

# Dodaj do crontab: tygodniowe sprawdzanie zależności co poniedziałek o 9 rano
0 9 * * 1 cd /path/to/project && claude -p "Check for outdated dependencies and security vulnerabilities. If any critical vulnerabilities are found, create a GitHub issue with the details and tag it 'security'." --output-format json >> /var/log/claude-audit.log

Wskazówka

Prompt gotowy do skopiowania — automatyczny bot do review PR:

Create a shell script that runs in our CI pipeline on every PR. It should: 1) use claude -p to analyze the PR diff (piped from git diff main...HEAD), 2) check for: missing tests for new functions, TODO comments without issue links, console.log statements, hardcoded secrets, and API endpoints without error handling, 3) output the review as a JSON object with findings categorized by severity, 4) post the review as a PR comment using the GitHub CLI (gh pr comment). Make the script exit 0 even if findings exist (advisory, not blocking).

Dla zespołów już używających Claude Code GitHub Actions, claude-code-action zapewnia bardziej zintegrowane podejście:

.github/workflows/claude-review.yml

name: Claude Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Review this PR for security issues, missing tests, and code quality. Be specific about file and line numbers."
          claude_args: "--max-turns 5"

Budowanie bota do utrzymania projektu

Połącz wiele automatyzacji w jedną komendę utrzymaniową, która utrzymuje Twój projekt w zdrowiu.

Wskazówka

Prompt gotowy do skopiowania — cotygodniowa komenda utrzymaniowa:

Create a custom command at .claude/commands/maintain.md that performs weekly project maintenance: 1) check for and update patch-level dependency versions, 2) regenerate TypeScript types from our database schema, 3) update the API documentation from source code, 4) find and remove unused imports and dead code, 5) check for TODOs older than 30 days and list them, 6) run the full test suite, 7) generate a maintenance report with a summary of changes made. Commit all changes as "chore: weekly maintenance".

Gdy to się psuje

Tryb headless wprowadza niechciane zmiany. Gdy uruchamiasz claude -p z --permission-mode acceptEdits (lub szeroką listą --allowedTools), Claude może edytować pliki, których nie zamierzałeś. Ogranicz automatyzację ściśle: “Only modify files in the src/api/ directory. Do not touch tests, config, or documentation.” Dla dodatkowego bezpieczeństwa, uruchamiaj automatyzacje headless w git worktree lub na branchu, żebyś mógł przejrzeć zmiany przed mergem.

Hook uruchamia się przy każdej edycji i spowalnia sesję. Hooki, które uruchamiają linting lub type-checking przy każdej edycji pliku, dodają opóźnienie. Używaj warunkowych hooków: “Only run the TypeScript check hook on files that end in .ts or .tsx, and skip files in the node_modules or dist directories.”

Masowy refaktor wprowadza subtelne bugi. Wielkoskalowe find-and-replace w wielu plikach może wytworzyć kod, który się kompiluje, ale zachowuje się inaczej. Zawsze włączaj “run the tests for each modified file” w promptach do masowego refaktoru. Jeśli Twoje pokrycie testami jest niskie, poproś Claude o wygenerowanie testów najpierw: “Before migrating moment.js to date-fns, generate test cases for every function that uses moment. Then do the migration and verify the tests pass.”

Zadanie cron zawodzi po cichu. Headless Claude Code stosuje się do konwencji Unix: zwraca niezerowy kod wyjścia przy twardych błędach (a --max-turns kończy się błędem, gdy limit zostanie osiągnięty). Ale uruchomienie nadal może “powieść się” z kodem wyjścia 0, produkując niekompletny lub niechciany wynik. Sprawdzaj oba sygnały: bramkuj na kodzie wyjścia oraz uruchamiaj z --output-format json i kontroluj pole result pod kątem faktycznego rezultatu. Jako zabezpieczenie na wszelki wypadek, niech automatyzacja zapisuje plik markera sukcesu i alarmuje, jeśli nie zostanie zaktualizowany.

Nazwy niestandardowych komend kolidują. Niestandardowa komenda może przesłonić — lub zostać przesłonięta przez — komendę pluginu lub umiejętności o tej samej nazwie, więc generyczna nazwa jak /review może nie uruchomić tego, czego oczekujesz. Preferuj konkretne nazwy jak /release-prep lub /weekly-audit i weryfikuj, co jest faktycznie dostępne, wpisując / w REPL (lub uruchamiając /help).

Co dalej

Konfiguracja pipeline CI/CD Zintegruj swoje automatyzacje Claude Code w formalny pipeline CI/CD

Automatyzacja wdrożeń Rozszerz automatyzację, aby pokryć pełny proces wdrożenia

Integracje z narzędziami zewnętrznymi Automatyzuj workflow obejmujące wiele usług zewnętrznych