Background tasks i headless mode

Background tasks

Background tasks to możliwość uruchamiania zadań Claude Code w tle, bez blokowania bieżącego workflow.

claude --background "Uruchom testy i napraw błędy"

Zastosowania:

• Uruchamianie serwera deweloperskiego w tle
• Testy w tle podczas dalszej pracy
• Monitorowanie logów
• Długotrwałe budowanie projektu

Zabezpieczenia:

• Background tasks są zabijane, gdy output przekroczy 5GB
• Można wyłączyć: CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=true

Headless mode (--print)

Uruchomienie Claude Code bez interaktywnej sesji. Prompt wchodzi, wynik wychodzi.

# Podstawowe
claude -p "Opisz ten projekt"

# Z modelem
claude -p "Napraw bug w auth.ts" --model opus

# Z formatem wyjścia
claude -p "Opisz architekturę" --output-format json

Formaty wyjścia

Format	Opis	Użycie
text	Surowy tekst (domyślny)	Proste skrypty
json	Strukturalny JSON	Parsowanie wyników
stream-json	Tokeny w JSON Lines	Real-time processing

Pipe + headless

# Analiza logów
cat error.log | claude -p "Znajdź przyczynę błędu"

# Review kodu
git diff | claude -p "Review tych zmian" --output-format json

# Automatyczne naprawianie testów
npm test 2>&1 | claude -p "Napraw padające testy"

Integracja z GitHub Actions

claude-code-action (oficjalna)

Oficjalna GitHub Action od Anthropic. Reaguje na PR-y, issues i @claude mentions.

Krok 1: Dodaj sekret API w repozytorium: Settings → Secrets → ANTHROPIC_API_KEY

Krok 2: Stwórz workflow .github/workflows/claude-review.yml:

name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]
  issue_comment:
    types: [created]

jobs:
  claude-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

Krok 3: Każdy nowy PR automatycznie otrzyma Claude Code review.

Własny workflow headless

name: Claude Analysis
on:
  push:
    branches: [main]

jobs:
  analyze:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '22'
      - run: npm install -g @anthropic-ai/claude-code
      - name: Analyze codebase
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude -p "Przeanalizuj zmiany i wygeneruj raport" \
            --output-format json > report.json
      - uses: actions/upload-artifact@v4
        with:
          name: claude-report
          path: report.json

Pre-commit hooks z Claude

Automatyczne sprawdzanie kodu przed commitem:

# .git/hooks/pre-commit
#!/bin/bash
git diff --cached | claude -p \
  "Sprawdź te zmiany pod kątem: bugów, security issues, \
  brakujących testów. Zwróć exit code 1, jeśli znajdziesz \
  problemy krytyczne." --output-format text

if [ $? -ne 0 ]; then
  echo "Claude Code znalazł problemy. Popraw przed commitem."
  exit 1
fi

Częsty błąd: Używanie --dangerously-skip-permissions w środowisku produkcyjnym. Ta flaga wyłącza WSZYSTKIE zabezpieczenia - używaj jej TYLKO w izolowanych środowiskach CI/CD.

Podsumowanie Modułu 4

To był cały Moduł 4 - Claude Code CLI. Teraz potrafisz:

• Zainstalować i skonfigurować Claude Code
• Tworzyć CLAUDE.md z konwencjami projektu
• Używać slash commands, flag i pipe w codziennej pracy
• Konfigurować hooks, skills i permissions
• Podłączać MCP Servers (GitHub, bazy danych, Slack)
• Delegować zadania do subagentów
• Uruchamiać background tasks i integrować z CI/CD

Chcesz automatyzować więcej? Dołącz do newslettera na czechu.blog — co tydzień nowe komendy Claude Code, gotowe konfiguracje CLAUDE.md i workflow dla developerów.

W Module 5 przejdziemy do zaawansowanych zastosowań: API, automatyzacja workflow, vibe coding i bezpieczeństwo.

Ćwiczenie praktyczne: Skonfiguruj automatyczne code review:

1. Dodaj ANTHROPIC_API_KEY do sekretów repozytorium na GitHub
2. Stwórz workflow z anthropics/claude-code-action@v1
3. Otwórz testowy PR i sprawdź, czy Claude Code robi review
4. Opcjonalnie: dodaj pre-commit hook z Claude Code