Claude Code jesienią 2025 — hooks, MCP, sub-agents w produkcji

Claude Code od września 2025 stał się dla polskich zespołów deweloperskich nie ciekawostką, ale stałym elementem stack-u. Trzy mechanizmy decydują o produkcyjnej wartości: hooks (akcje na zdarzeniach), MCP servers (integracje z firmowymi systemami), sub-agents (delegowanie zadań do wyspecjalizowanych instancji). W tym artykule pokazujemy konkretne konfiguracje na realnym polskim projekcie.

Hooks — automatyzacja zdarzeń

Hooks to skrypty uruchamiane przed/po określonych akcjach Claude Code. Pre-commit linter, post-edit formatter, pre-tool-use audit. To nie magia — to ujarzmianie agenta.

Przykład 1 — auto-format po edycji

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "if [[ \"$CLAUDE_FILE_PATHS\" =~ \\.php$ ]]; then php-cs-fixer fix --quiet $CLAUDE_FILE_PATHS; fi"
          }
        ]
      }
    ]
  }
}

Przykład 2 — pre-commit linter z blokadą

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "if [[ \"$CLAUDE_BASH_COMMAND\" == *'git commit'* ]]; then phpstan analyse --level=6 || exit 1; fi"
          }
        ]
      }
    ]
  }
}

MCP — Model Context Protocol

MCP to standard od Anthropic łączący Claude z zewnętrznymi systemami. Zamiast pisać własne integracje, podpinasz MCP server i Claude widzi narzędzia. Dla polskiej firmy to mostek do Jiry, GitLaba, GUS-u, CEIDG, wewnętrznych baz.

Lista najużyteczniejszych MCP serverów dla polskiego stack-u

• filesystem — czytanie/zapis plików projektu, fundament.
• postgres / mysql — direct query do firmowej bazy.
• jira / gitlab / github — workflow developerski.
• gus-api (custom, pisany u nas) — weryfikacja kontrahentów po NIP.
• slack / mattermost — notyfikacje, status updates.

Konfiguracja MCP servera dla GUS

{
  "mcpServers": {
    "gus": {
      "command": "node",
      "args": ["/opt/mcp/gus-server/index.js"],
      "env": {
        "GUS_API_KEY": "${env:GUS_API_KEY}",
        "GUS_BASE_URL": "https://wl-api.mf.gov.pl"
      }
    }
  }
}

Sub-agents — delegowanie zadań

Sub-agent to wyspecjalizowana instancja Claude z własnym promptem systemowym, własnym kontekstem i ograniczonym zestawem narzędzi. Główny Claude może delegować zadania ("zrób review tego PR"), a sub-agent działa w izolowanym kontekście.

Dlaczego to ważne

• Główny kontekst się nie zaśmieca — sub-agent zwraca tylko wynik.
• Specjalizacja — security review, perf-review, doc-update mają osobne prompty.
• Bezpieczeństwo — sub-agent z ograniczonymi narzędziami nie zrobi czego nie powinien.

Przykład sub-agenta "code-reviewer"

# .claude/agents/code-reviewer.md
---
name: code-reviewer
description: Senior PHP reviewer dla projektów Laravel/raw PHP
tools: Read, Grep, Bash
---

Jesteś senior PHP developerem. Twoje zadanie:
1. Czytasz tylko pliki .php zmienione w ostatnim commicie.
2. Identyfikujesz: bugi, SQL injection, XSS, niespójności z resztą kodu.
3. Zwracasz raport markdown z sekcjami: Critical / Important / Style.
4. Nie modyfikujesz plików — tylko raportujesz.

Pomiary z polskiego projektu

Wdrożyliśmy hooks + MCP + sub-agents w polskim zespole 12 deweloperów (Symfony 7.x, MariaDB, serwowanie z PHP-FPM). Pomiary po 6 tygodniach:

Metryka	Przed	Po 6 tyg.
Tasks zakończone / sprint	32	48
Code review-y poprawione	14% PR-ów	4% PR-ów
Bugi wymagające follow-up	2,8/sprint	1,1/sprint
Czas onboardingu nowego dev (h)	32	11
Komendy git ręczne / dzień	~ 28	~ 9

Pułapki, które poznaliśmy w boju

1. Hooks można nadużyć — 14 hooków = chaos. Zaczynaj od 3-4 najważniejszych.
2. MCP servers mają state — pamiętaj o cleanup, nie zostawiaj wycieków pamięci.
3. Sub-agents kosztują tokeny — każdy nowy kontekst to kolejna instancja Claude.
4. Permissions to nie żart — sub-agent z `Write` na produkcji = wybuch.
5. Audyt logów — wszystkie tool-use musi być logowane do firmowego SIEM.

Rekomendacja dla polskiego zespołu

Start: trzy hooks (formatter, linter, audit-log). Dwa MCP servery (filesystem + git). Jeden sub-agent (code-reviewer). To wystarcza na 80% wartości. Dalej rozbudowujesz wg potrzeb — nie wcześniej.

Podsumowanie

Claude Code jesienią 2025 to dorosłe narzędzie. Hooks, MCP i sub-agents — trzy filary produkcyjnego użycia. W polskim zespole dobrze wdrożony zwraca się w pierwszym miesiącu. Pokażemy wam konfigurację dopasowaną do waszego stack-u — Symfony, Laravel, raw PHP, FastAPI, cokolwiek.