02 - Kod Claude'a: Rozwój agenta z terminala
W panoramie narzędzi programistycznych wspomaganych sztuczną inteligencją Claude Code zajmuje wyjątkową pozycję: i jeden Agentowy interfejs wiersza polecenia który mieszka w terminalu, czyta twoją bazę kodu, wykonuje polecenia, edytuj pliki i zarządzaj złożonymi przepływami pracy bez otwierania IDE. To nie jest chatbot z dostępem do kodu: jest to autonomiczny agent, który działa w Twoim środowisku programistycznym z tą samą naturalnością z którym starszy kolega będzie pracował razem z Tobą.
Ten artykuł zawiera szczegółowe omówienie Claude Code: od instalacji po konfigurację zaawansowane, od architektury wewnętrznej po praktyczne przepływy pracy, od systemu uprawnień po kreację niestandardowych agentów. Niezależnie od tego, czy jesteś doświadczonym programistą, który chce zmaksymalizować korzyści produktywność lub lider zespołu oceniający narzędzia agenta, znajdziesz tutaj wszystko, czego potrzebujesz opanować to narzędzie.
Czego się nauczysz
- Czym jest Claude Code i czym różni się od tradycyjnych asystentów AI
- Instalacja, konfiguracja i struktura katalogów
.claude/ - Architektura wewnętrzna: wywoływanie narzędzi, okno kontekstowe, model uprawnień
- Wszystkie dostępne narzędzia: Odczyt, Zapis, Edycja, Bash, Grep, Glob, Zadanie, WebSearch
- System uprawnień i mechanizm hooków
- Jak napisać skuteczny plik CLAUDE.md, aby kierować zachowaniem agenta
- Podagenci, wykonywanie równoległe i drzewa robocze izolacji
- Integracja MCP (Model Context Protocol) z przeglądarkami, bazami danych i usługami zewnętrznymi
- Praktyczne przepływy pracy: TDD, przegląd kodu, debugowanie, automatyczne zatwierdzanie
- Porównanie z Cursor, GitHub Copilot i innymi narzędziami opartymi na IDE
- Najlepsze praktyki, znane ograniczenia i strategie obejścia
Co to jest Kod Claude'a: paradygmat agenta w terminalu
Claude Code i oficjalny Anthropic CLI do tworzenia agentów. W odróżnieniu od tradycyjne chatboty, w których kopiujesz i wklejasz kod pomiędzy oknem czatu a edytorem, Claude'a Koda mieszka w twoim terminalu i ma bezpośredni dostęp do systemu plików, może wykonywać polecenia powłoki, czytać i modyfikować pliki, wyszukiwać wzorce w bazie kodu i koordynuj wieloetapowe przepływy pracy bez ręcznej interwencji.
Termin agent i ma fundamentalne znaczenie dla zrozumienia natury instrumentu. Agent AI nie tylko odpowiada na pytania: dzieje. Claude Code analizuje kontekście projektu, planuje niezbędne zmiany, wdraża je seriami wywołań narzędzi, sprawdź wyniki i wykonuj iteracje, aż zadanie zostanie ukończone. I różnica pomiędzy pytaniem kogoś „jak zrobić X?” i powiedz „zrób X” kompetentnemu współpracownikowi.
Chatbot kontra agent: podstawowa różnica
Un chatboty generuje tekst w odpowiedzi na monit. A agent ma dostęp do narzędzi i może wykonywać czynności w świecie rzeczywistym: czytać pliki, wykonywać polecenia, edytuj kod, przeglądaj sieć. Claude Code jest agentem, który pracuje u Ciebie środowisko programistyczne z ciągłym cyklem obserwacji-rozumowania-działania aż do zrealizowanie celu.
Claude Code i zasilany przez model Claude (obecnie Opus 4.6, Sonnet 4.6 i warianty) i łączy się z bazą kodu poprzez zestaw specjalnie zaprojektowanych narzędzi natywnych do operacji związanych z tworzeniem oprogramowania. W lutym 2026 r. GitHub zintegrował Claude Code z platformą Platforma Agent HQ, konsolidująca swoją rolę agenta referencyjnego w ekosystemie rozwoju zawodowego.
Instalacja i konfiguracja
Instalacja Claude Code jest bezpośrednia i wymaga Node.js 18+ i npm. Proces obejmuje trzy fazy: instalacja pakietu, konfiguracja uwierzytelniania i dostosowywanie środowiska.
Podstawowa instalacja
# Installazione globale
npm install -g @anthropic-ai/claude-code
# Verifica installazione
claude --version
# Primo avvio - si apre il browser per l'autenticazione
claude
# Oppure con API key diretta
export ANTHROPIC_API_KEY=sk-ant-...
claudePrzy pierwszym uruchomieniu Claude Code oferuje uwierzytelnianie poprzez przeglądarkę (OAuth) lub przez Bezpośredni klucz API. Do użytku osobistego wystarczy klucz API; dla zespołów i organizacji e Zalecany jest dostęp za pośrednictwem Anthropic Console ze scentralizowanym zarządzaniem danymi uwierzytelniającymi.
Katalog .claude/
Po inicjalizacji Claude Code tworzy katalog .claude/ w korzeniu
projektu (oraz opcjonalnie w katalogu domowym użytkownika w przypadku konfiguracji globalnych).
Ten katalog jest centralnym punktem konfiguracji.
.claude/
├── settings.json # Configurazione permessi e tool
├── agents/ # Definizioni agenti personalizzati
│ ├── planner.md
│ ├── code-reviewer.md
│ └── security-reviewer.md
├── commands/ # Comandi slash personalizzati
│ └── review.md
├── hooks/ # Hook pre/post tool execution
│ └── pre-commit-check.sh
├── rules/ # Regole di comportamento
│ └── coding-style.md
├── skills/ # Skill personalizzate
│ └── angular-patterns.md
└── README.md # Documentazione localePlik Settings.json
Plik settings.json sprawdź uprawnienia, autoryzowane narzędzia i
globalne zachowanie agenta. I pierwszy plik do skonfigurowania pod kątem doświadczenia
produktywny.
{
"permissions": {
"allow": [
"Read",
"Glob",
"Grep",
"Edit",
"Write",
"Bash(npm run lint)",
"Bash(npm run test)",
"Bash(npm run build)",
"Bash(git status)",
"Bash(git diff)",
"Bash(git log)"
],
"deny": [
"Bash(rm -rf *)",
"Bash(git push --force)",
"Bash(git reset --hard)"
]
},
"alwaysThinkingEnabled": true,
"model": "claude-opus-4-6"
}Bezpieczeństwo konfiguracji
Sekcja deny i krytyczne dla bezpieczeństwa projektu. Blokuj polecenia
niszczycielskie jak rm -rf, git push --force e
git reset --hard zapobiega przypadkowym uszkodzeniom lub uszkodzeniom spowodowanym halucynacjami
modelu. Dobrą praktyką jest dodanie dowolnego polecenia, które może spowodować odmowę
nieodwracalna utrata danych.
CLAUDE.md: Instrukcje dla agenta
Plik CLAUDE.md i serce personalizacji autorstwa Claude Code. Umieszczony
w katalogu głównym projektu zawiera instrukcje, które agent automatycznie odczytuje przy każdym z nich
sesja. Pomyśl o tym jako o dokument wprowadzający nowego członka zespołu:
opisuje projekt, konwencje, architekturę i oczekiwania.
Struktura skutecznego CLAUDE.md
# CLAUDE.md
## Project Overview
Questo e un portfolio Angular 21 con SSR.
Stack: Angular 21, TypeScript 5.9, Express, Firebase Hosting.
## Architecture
- Standalone components (no modules)
- Signals per state management
- OnPush change detection
- Component-scoped CSS
## Coding Standards
- TypeScript strict mode
- Immutable data patterns
- File max 800 righe
- Funzioni max 50 righe
- kebab-case per file, PascalCase per classi
## Commands
- `npm start` - Dev server
- `npm run build` - Production build con SSR
- `npm test` - Run tests
- `npm run deploy` - Deploy Firebase
## Important Patterns
- Ogni articolo blog = 4 file (IT/EN component + template)
- Registrazione in src/app/articles/index.ts
- Blog entries in src/app/services/blog.service.ts
- Angular template: escape { } con HTML entities nei code block
## Do NOT
- Non modificare file di configurazione Firebase
- Non committare direttamente su main
- Non usare NgModules (solo standalone)
- Non usare subscribe() - preferire async pipe o toSignal()Dobrze napisany plik CLAUDE.md radykalnie zmniejsza liczbę błędów agenta i poprawia jakość wyjścia. Najważniejsze sekcje to: Przegląd projektu (kontekst ogólne), Architektura (decyzje techniczne), Standardy kodowania (konwencje) mi NIE (jawne ograniczenia).
Katalog reguł: Reguły modułowe
Oprócz CLAUDE.md, Claude Code obsługuje katalogi .claude/rules/ gdzie
wstaw reguły uporządkowane według domeny. To modułowe podejście jest preferowane w przypadku
złożone projekty.
# Coding Style Rules
## Immutability (CRITICAL)
ALWAYS create new objects, NEVER mutate existing ones.
Use spread operator, Object.assign(), or immutable libraries.
## File Organization
- Many small files > few large files
- 200-400 lines typical, 800 max
- Extract utilities from large modules
- Organize by feature/domain, not by type
## Error Handling
- Handle errors explicitly at every level
- Provide user-friendly messages in UI code
- Log detailed context server-side
- Never silently swallow errorsSystem pamięci
Claude Code ma mechanizm trwała pamięć pomiędzy sesjami.
Plik MEMORY.md w katalogu .claude/ jest aktualizowany
automatycznie przez agenta na podstawie wniosków wyciągniętych podczas sesji roboczych: wzór
odkrycia, typowe błędy, konfiguracje specyficzne dla projektu i decyzje architektoniczne.
# Project Memory
## Angular Template Gotchas
- Curly braces in code blocks: wrap in ngNonBindable
AND escape { with { and } with }
- <T> generic types: escape < with < and > with >
- @ decorators in code: escape with @
## Blog Article Pattern
- Each article = 4 files: IT component + template, EN component + template
- Registration in src/app/articles/index.ts
- Blog entries in src/app/services/blog.service.ts
- Max ID: 288 (as of April 2026)Architektura i funkcjonowanie wewnętrzne
Zrozumienie, jak Claude Code działa wewnętrznie, jest niezbędne, aby móc z niego efektywnie korzystać. Architektura opiera się na trzech filarach: cykl agenta, il system narzędzi e la zarządzanie oknami kontekstowymi.
Cykl agenta
Kiedy wysyłasz wiadomość do Claude Code, system wchodzi w pętlę, która powtarza się do po wykonaniu zadania:
- Przyjęcie - Agent otrzymuje Twoją wiadomość z całym zgromadzonym kontekstem
- Rozumowanie - Model analizuje żądanie i planuje niezbędne działania (myślenie rozszerzone)
- Wezwanie narzędzia - Agent wywołuje jedno lub więcej narzędzi (Odczyt, Edycja, Bash itp.)
- Obserwacja - Wyniki narzędzi są dodawane do kontekstu
- Iteracja - Model ocenia wyniki i decyduje, czy potrzebne są dalsze działania
- Odpowiedź - Po zakończeniu zadania agent przedstawia podsumowanie
Cykl ten może powtarzać się dziesiątki razy w przypadku jednego złożonego zadania. Na przykład wdrożenie nowej funkcji może wymagać: odczytu istniejących plików (Odczyt), wyszukiwania wzór (Grep/Glob), utwórz nowe pliki (Zapisz), zmodyfikuj istniejące pliki (Edytuj), wykonaj przetestuj (Bash), napraw błędy i powtórz.
Zarządzanie oknem kontekstowym
Okno kontekstowe to ilość informacji, które model może przetworzyć w jednym oknie interakcja. Claude Code inteligentnie radzi sobie z kontekstem w kilku obszarach mechanizmy:
- Ładowanie selektywne - Nie ładuje całej bazy kodu do pamięci. Użyj Glob i Grep, aby znaleźć odpowiednie pliki i Czytaj, aby przeczytać tylko te niezbędne.
- Automatyczne zagęszczanie - Kiedy kontekst zbliża się do kresu, Claude Kod zagęszcza rozmowę, zachowując najbardziej istotne informacje i odrzucając je nieaktualne szczegóły.
- Subagenci - Do złożonych zadań wymagających dużego kontekstu, Claude Code może delegować podzadania pod-agentom w izolowanym kontekście (narzędzie zadań).
- Rozszerzone myślenie - Model rezerwuje do 31 999 tokenów dla rozumowanie wewnętrzne, oddzielone od kontekstu rozmowy.
Zagęszczanie: kiedy i jak to się dzieje
Zagęszczanie i proces, dzięki któremu Claude Code podsumowuje rozmowę w kontekście robi się za duży. Jest to automatyczna operacja, która zachowuje: instrukcje CLAUDE.md, podjęte decyzje architektoniczne, modyfikacje plików i ich aktualny stan oraz błędy spotkałem. Jednakże określone szczegóły z poprzednich iteracji mogą zostać utracone. W przypadku bardzo długich zadań lepiej jest podzielić pracę na krótsze sesje skupić się.
Główne narzędzia
Claude Code posiada zestaw natywnych narzędzi zaprojektowanych tak, aby obejmowały całe spektrum działalność deweloperska. Każde narzędzie ma określoną rolę i dokładne zasady użycia.
Narzędzie do czytania i wyszukiwania
| Narzędzia | Funkcjonować | Kiedy go używać |
|---|---|---|
| Czytać | Odczytuje zawartość określonego pliku | Gdy znasz dokładną ścieżkę pliku |
| Glob | Wyszukaj pliki według wzoru nazwy | Aby znaleźć pliki: **/*.ts, src/**/*.spec.ts |
| Grep | Wyszukuje zawartość w plikach | Aby znaleźć wzorce, funkcje, klasy w bazie kodu |
Narzędzie do pisania i edycji
| Narzędzia | Funkcjonować | Kiedy go używać |
|---|---|---|
| Pisać | Tworzy lub zastępuje cały plik | W przypadku nowych plików lub całkowitego przepisania |
| Redagować | Zastępuje określone części pliku | Do chirurgicznych modyfikacji istniejących plików |
Narzędzie do wykonania
| Narzędzia | Funkcjonować | Kiedy go używać |
|---|---|---|
| Grzmotnąć | Wykonuj polecenia powłoki w terminalu | Kompiluj, testuj, git, npm, dowolne polecenie CLI |
| Zadania | Uruchom podagentów z izolowanym kontekstem | Do złożonych zadań wymagających dedykowanego kontekstu |
Narzędzia sieciowe i wyszukiwania
| Narzędzia | Funkcjonować | Kiedy go używać |
|---|---|---|
| Wyszukiwarka internetowa | Przeprowadź wyszukiwanie w Internecie | Dokumentacja, aktualizacje i najlepsze praktyki |
| WebFetch | Pobierz i przeanalizuj zawartość adresu URL | Aby przeczytać dokumentację, odniesienia do API, artykuły |
Praktyczny przykład: pełny cykl użycia narzędzia
# L'utente chiede: "Aggiungi un nuovo campo 'priority' al modello Task"
# 1. Claude Code cerca il modello esistente
Glob: src/app/models/**/*.ts
# Risultato: src/app/models/task.model.ts
# 2. Legge il file del modello
Read: src/app/models/task.model.ts
# Risultato: export interface Task { id: string; title: string; }
# 3. Modifica il modello aggiungendo il campo
Edit: src/app/models/task.model.ts
# old_string: "title: string;"
# new_string: "title: string;\n priority: 'low' | 'medium' | 'high';"
# 4. Cerca tutti i file che usano il modello
Grep: pattern "Task" in src/app/**/*.ts
# Risultato: 5 file trovati
# 5. Legge e aggiorna ogni file che crea oggetti Task
# ... (ciclo di Read + Edit per ogni file)
# 6. Esegue i test per verificare
Bash: npm run test
# Risultato: 2 test falliti
# 7. Corregge i test che falliscono
# ... (ciclo di Read + Edit per i test)
# 8. Riesegue i test
Bash: npm run test
# Risultato: All tests passedSystem zezwoleń
System uprawnień Claude Code został zaprojektowany zgodnie z zasadą najmniejszy przywilej: agent może robić tylko to, co wyraźnie robi autoryzowany. Jest to istotne ze względu na bezpieczeństwo, szczególnie w przypadku agenta działa na bazie kodu produkcyjnego.
Trzy sposoby zezwolenia
| Tryb | Zachowanie | Przypadek użycia |
|---|---|---|
| Umożliwić | Narzędzie działa bez pytania o potwierdzenie | Bezpieczne operacje: odczyt plików, wyszukiwanie |
| Zapytać | Claude Code prosi o potwierdzenie przed wykonaniem | Wartość domyślna dla większości operacji |
| Zaprzeczyć | Narzędzie jest całkowicie zablokowane | Niebezpieczne operacje: usuwanie, wymuszenie wypchnięcia |
Uprawnienia można skonfigurować na trzech poziomach: światowy
(~/.claude/settings.json), projekt
(.claude/settings.json) I sesja (poprzez monit
interaktywne). Uprawnienia projektu zastępują uprawnienia globalne i
sesja nadpisuje te projektu.
Szczegółowe uprawnienia dla Bash
Narzędzie Bash obsługuje szczegółowe uprawnienia w oparciu o konkretne polecenie. To pozwala autoryzować bezpieczne polecenia, blokując niebezpieczne.
{
"permissions": {
"allow": [
"Bash(npm run lint)",
"Bash(npm run test)",
"Bash(npm run build)",
"Bash(git status)",
"Bash(git diff)",
"Bash(git log *)",
"Bash(git add *)",
"Bash(git commit *)"
],
"deny": [
"Bash(rm -rf *)",
"Bash(git push --force *)",
"Bash(git reset --hard *)",
"Bash(git clean -f *)",
"Bash(git branch -D *)"
]
}
}Zasada obrony w głębi
Nie polegaj wyłącznie na uprawnieniach. Połącz: (1) restrykcyjne uprawnienia w pliku settings.json, (2) wyraźne instrukcje w CLAUDE.md dotyczące tego, czego NIE robić, (3) haki sprawdzające poprawność operacje przed wykonaniem i (4) standardowe hooki git (pre-commit, pre-push) jako ostatnia linia obrony. Bezpieczeństwo jest wielowarstwowe.
System haków
Haki Claude Code to skrypty, które uruchamiają się automatycznie jako pierwsze (Użycie narzędzia wstępnego) lub po (Użycie narzędzia PostTool) wywołanie a narzędzia lub po zakończeniu sesji (Zatrzymywać się). Są najbardziej mechanizmem Potężne możliwości dostosowywania i kontrolowania zachowania agentów.
Typy haków
| Hak | Kiedy aktywowano | Typowy przypadek użycia |
|---|---|---|
| Użycie narzędzia wstępnego | Przed uruchomieniem narzędzia | Walidacja parametrów, blokowanie warunkowe, logowanie |
| Użycie narzędzia PostTool | Po uruchomieniu narzędzia | Automatyczne formatowanie, linting, weryfikacja wyników |
| Zatrzymywać się | Kiedy sesja się zakończy | Ostateczna weryfikacja, sprzątanie, generowanie raportu |
Przykład: Hook do automatycznego formatowania
{
"hooks": {
"PostToolUse": [
{
"tool": "Edit",
"command": "npx prettier --write $CLAUDE_FILE_PATH",
"description": "Auto-format dopo ogni modifica"
},
{
"tool": "Write",
"command": "npx prettier --write $CLAUDE_FILE_PATH",
"description": "Auto-format dopo creazione file"
}
],
"PreToolUse": [
{
"tool": "Bash",
"command": "echo 'Executing: $CLAUDE_TOOL_INPUT'",
"description": "Log ogni comando Bash"
}
],
"Stop": [
{
"command": "npm run lint",
"description": "Lint finale prima di chiudere"
}
]
}
}
Hooki otrzymują informacje kontekstowe poprzez zmienne środowiskowe, takie jak
$CLAUDE_FILE_PATH (plik, nad którym pracujesz) e
$CLAUDE_TOOL_INPUT (parametry narzędzia). Dzięki temu możesz tworzyć
zaawansowana logika warunkowa.
Zaawansowany hak: zapobieganie krytycznym modyfikacjom plików
Hak PreToolUse może uniemożliwić modyfikację wrażliwych plików (takich jak konfiguracje
plik produkcyjny lub plik uwierzytelniający), sprawdzając ścieżkę pliku przed zezwoleniem
operację edycji lub zapisu. Jeśli ścieżka pasuje do zabronionego wzorca (np.
**/production.config.*), hak zwraca błąd i blokuje operację.
Agenci i subagenci: orkiestracja wielozadaniowa
Jedna z najpotężniejszych umiejętności Claude'a Code'a Narzędzia zadań, co pozwala aby uruchomić subagentów z izolowanym kontekstem. Każdy subagent działa w osobnej „piaskownicy”, z własnym kontekstem i zwraca wyniki do głównego procesu.
Kiedy używać subagentów
- Niezależne zadania równoległe - Jednocześnie analizuj bezpieczeństwo, wydajność i dostępność komponentu
- Izolowany kontekst - Gdy podzadanie wymaga określonego kontekstu co nie spełnia głównego zadania
- Analiza wieloperspektywiczna - Sprawdź ten sam kod z „perspektywy” inny (ekspert ds. bezpieczeństwa, inżynier wydajności, recenzent UX)
- Długotrwałe zadania - Deleguj długie operacje w trakcie procesu główne kontynuuj z kolejnymi
Przykład: przegląd kodu z wielu perspektyw
# Prompt al task principale:
"Fai una code review completa del componente
src/app/components/payment-form/"
# Claude Code lancia 3 subagenti in parallelo:
# Subagente 1: Security Review
Task: "Analizza il componente payment-form per
vulnerabilità di sicurezza: XSS, injection,
gestione dati sensibili, CSRF."
# Subagente 2: Performance Review
Task: "Analizza le performance del componente
payment-form: change detection, memory leaks,
ottimizzazione rendering, lazy loading."
# Subagente 3: Accessibility Review
Task: "Verifica l'accessibilità del componente
payment-form: ARIA labels, keyboard navigation,
focus management, color contrast."
# I 3 risultati vengono combinati nel report finaleAgenci niestandardowi
Katalog .claude/agents/ umożliwia zdefiniowanie wyspecjalizowanych agentów za pomocą
szczegółowe instrukcje i osobowości. Każdy plik Markdown w tym katalogu staje się plikiem
wywoływalny agent.
# Code Reviewer Agent
## Role
Sei un senior code reviewer con 15 anni di esperienza.
Sei rigoroso ma costruttivo.
## Review Checklist
Per ogni file analizzato, verifica:
1. Naming: variabili, funzioni e classi hanno nomi chiari
2. Complexity: nessuna funzione > 50 righe
3. Immutability: nessuna mutazione di stato
4. Error handling: tutti gli errori gestiti
5. Types: nessun `any`, tipi specifici ovunque
6. Security: input validati, nessun dato hardcoded
## Output Format
Classifica ogni issue trovata:
- CRITICAL: bug o vulnerabilità (blocca il merge)
- HIGH: problemi architetturali (da risolvere)
- MEDIUM: miglioramenti di qualità (consigliati)
- LOW: suggerimenti stilistici (opzionali)Drzewo pracy izolacji
Do zadań wymagających eksperymentalnych zmian bez ryzykowania obecnej gałęzi, Claude
Kod obsługuje m.in git drzewo robocze. Narzędzie EnterWorktree tworzy drzewo pracy
izolowany w .claude/worktrees/ z nowym oddziałem opartym na HEAD.
Po zakończeniu sesji użytkownik może zachować lub usunąć drzewo robocze.
Integracja MCP: Protokół kontekstu modelu
Il Modelowy protokół kontekstowy (MCP) oraz otwarty standard, który pozwala a Claude Code do komunikacji z usługami zewnętrznymi za pośrednictwem serwera MCP. To się rozciąga znacznie zwiększa możliwości agenta wykraczające poza lokalny system plików.
Architektura MCP
Architektura MCP opiera się na modelu klient-serwer, w którym Claude Code pełni rolę klienta i i Serwery MCP udostępniają dodatkowe narzędzia. Serwer MCP może zapewniać dostęp do: przeglądarek internetowych, bazy danych, zewnętrzne API, usługi w chmurze, systemy CI/CD i wiele więcej.
Typowe przypadki użycia MCP
| Serwer MCP | Funkcjonalność | Przykład użycia |
|---|---|---|
| Automatyzacja przeglądarki | Przeglądanie stron internetowych, kliknięcia, zrzuty ekranu, wypełnianie formularzy | Testowanie E2E, scraping, automatyzacja przepływu pracy |
| Bazy danych | Zapytania SQL/NoSQL, eksploracja schematów | Debugowanie danych, migracja schematu |
| GitHub | PR, problemy, recenzje kodu, działania | Automatyzacja przepływu pracy w GitHub |
| Figma | Czytanie projektu, ekstrakcja komponentów | Generowanie kodu z projektu |
{
"mcpServers": {
"browser": {
"command": "npx",
"args": ["@anthropic-ai/claude-code-mcp-browser"],
"description": "Browser automation server"
},
"postgres": {
"command": "npx",
"args": ["@modelcontextprotocol/server-postgres"],
"env": {
"DATABASE_URL": "postgresql://user:pass@localhost:5432/mydb"
}
}
}
}MPK i bezpieczeństwo
Każdy serwer MCP ma dostęp do skonfigurowanych dla niego zasobów. Serwer bazy danych ma dostęp do bazy danych, przeglądarka serwera może przeglądać sieć. Koniecznie zastosować zasada najmniejszych uprawnień również dla serwerów MCP: używaj danych uwierzytelniających tylko do odczytu, gdzie Jeśli to możliwe, ogranicz dostęp do programistycznych baz danych i nie ujawniaj poświadczeń produkcyjnych.
Niestandardowe umiejętności i polecenia
System Umiejętności autorstwa Claude Code pozwala zdefiniować możliwości wyspecjalizowane ustawienia, które agent może wywołać podczas sesji. W przeciwieństwie do agentów (które definiują osobowość i podejście), definiują umiejętności procedury specyfikacje do powtarzających się zadań.
Niestandardowe polecenia ukośnika
Polecenia z ukośnikiem to skróty, które można wywołać za pomocą składni /nomecomando
podczas sesji. Są one zdefiniowane jako pliki Markdown w katalogu
.claude/commands/.
# /review Command
Esegui una code review completa dei file modificati
nell'ultimo commit.
## Steps
1. Esegui `git diff HEAD~1` per ottenere le modifiche
2. Per ogni file modificato:
a. Leggi il file completo per contesto
b. Analizza le modifiche per:
- Bug potenziali
- Violazioni degli standard di coding
- Problemi di sicurezza
- Opportunità di miglioramento
3. Genera un report con severity levels:
CRITICAL, HIGH, MEDIUM, LOW
4. Suggerisci fix specifici per issues CRITICAL e HIGHUmiejętności niestandardowe
Umiejętności w katalogu .claude/skills/ są bardziej skomplikowane niż polecenia
i może obejmować kontekst techniczny, przykłady i procedury wieloetapowe.
# Angular Blog Article Creation Skill
## Context
Questo progetto usa Angular 21 con articoli blog
che richiedono 4 file per articolo (IT + EN).
## Procedure
1. Crea il component TypeScript (IT):
src/app/articles/{series}/{name}.component.ts
2. Crea il template HTML (IT):
src/app/articles/{series}/{name}.component.html
3. Crea il component TypeScript (EN):
src/app/articles/{series}/{name}.en.component.ts
4. Crea il template HTML (EN):
src/app/articles/{series}/{name}.en.component.html
5. Registra in src/app/articles/index.ts
6. Aggiungi BlogPost in blog.service.ts
## Template Rules (CRITICAL)
- Escape { } nei code block con HTML entities
- Wrap code blocks in ngNonBindable
- Escape <T> generics con < >
- Escape @ decorators con @Praktyczne przepływy pracy z Claude Code
Teoria jest ważna, ale prawdziwa wartość Claude Code ujawnia się w codziennej pracy. Zobaczmy, jak go używać do najczęstszych zadań związanych z tworzeniem oprogramowania.
1. Rozwój oparty na testach (TDD)
# Prompt:
"Implementa un servizio UserService con TDD.
Deve supportare: getById, create, update, delete.
Usa il pattern Repository per l'accesso ai dati."
# Claude Code:
# 1. Crea i test PRIMA dell'implementazione (RED)
Write: src/app/services/user.service.spec.ts
# Test per getById, create, update, delete
# 2. Esegue i test - devono FALLIRE
Bash: npm run test -- --filter=UserService
# Risultato: 4 test FAILED (come previsto)
# 3. Implementa il servizio (GREEN)
Write: src/app/services/user.service.ts
# Implementazione minima per far passare i test
# 4. Esegue i test - devono PASSARE
Bash: npm run test -- --filter=UserService
# Risultato: 4 test PASSED
# 5. Refactoring (IMPROVE)
Edit: src/app/services/user.service.ts
# Migliora la struttura mantenendo i test verdi
# 6. Verifica copertura
Bash: npm run test -- --coverage2. Interaktywne debugowanie
# Prompt:
"Il componente Dashboard non renderizza i dati.
La console mostra 'Cannot read properties of undefined'.
Trova e correggi il bug."
# Claude Code:
# 1. Cerca il componente
Glob: src/**/dashboard*
# 2. Legge il componente e il template
Read: src/app/components/dashboard/dashboard.component.ts
Read: src/app/components/dashboard/dashboard.component.html
# 3. Cerca il servizio che fornisce i dati
Grep: pattern "DashboardService" in src/
# 4. Legge il servizio
Read: src/app/services/dashboard.service.ts
# 5. Identifica il problema: la risposta API ha una
# struttura diversa da quella attesa
# 6. Corregge il mapping dei dati
Edit: src/app/services/dashboard.service.ts
# 7. Aggiunge null check nel template
Edit: src/app/components/dashboard/dashboard.component.html
# 8. Verifica la build
Bash: npm run build3. Przebieg automatycznego zatwierdzania
Claude Code ma wbudowany przepływ pracy służący do tworzenia zatwierdzeń Git, które analizują zmiany, generuje komunikat opisowy i zarządza przemieszczaniem plików.
# Prompt:
"Committa le modifiche correnti"
# Claude Code:
# 1. Analizza lo stato del repository
Bash: git status
Bash: git diff
Bash: git log --oneline -5
# 2. Identifica i file rilevanti da committare
# 3. Aggiunge i file specifici (mai git add -A)
Bash: git add src/app/services/user.service.ts
Bash: git add src/app/services/user.service.spec.ts
# 4. Crea il commit con messaggio descrittivo
Bash: git commit -m "feat: add UserService with
Repository pattern and full CRUD operations"
# 5. Verifica il risultato
Bash: git status4. Refaktoryzacja z przewodnikiem
# Prompt:
"Il file src/app/components/mega-form.component.ts
ha 1200 righe. Scomponilo in componenti più piccoli
seguendo il Single Responsibility Principle."
# Claude Code:
# 1. Analizza il file monolitico
Read: src/app/components/mega-form.component.ts
# 2. Identifica le responsabilità distinte
# 3. Crea componenti separati:
Write: src/app/components/form-header/form-header.component.ts
Write: src/app/components/form-fields/form-fields.component.ts
Write: src/app/components/form-validation/form-validation.component.ts
Write: src/app/components/form-submit/form-submit.component.ts
# 4. Aggiorna il componente originale come orchestratore
Edit: src/app/components/mega-form.component.ts
# 5. Aggiorna i test
# 6. Verifica la build e i test
Bash: npm run build && npm run testKod Claude vs kursor vs drugi pilot GitHub
Wybór odpowiedniego narzędzia zależy od kontekstu, rodzaju zadania i specyfiki osobiste preferencje. Claude Code, Cursor i GitHub Copilot nie są alternatywami wzajemnie się wykluczają: są uzupełniający.
| Czekam | Claude'a Koda | Kursor | Drugi pilot GitHuba |
|---|---|---|---|
| Interfejs | Interfejs wiersza polecenia/Terminal | IDE (rozwidlenie kodu VS) | Wtyczki IDE |
| Tryb | Agent (autonomiczny) | Agent + inline | Asystent + agent |
| Autonomia | Wysoka (cykle autonomiczne) | Średnio-wysoki | Przeciętny |
| Kontekst | Cały system plików | Otwórz projekt | Otwórz pliki + indeks |
| Wykonanie narzędzia | Pełna skorupa | Zintegrowany terminal | Ograniczony |
| Wsparcie MCP | Rodzinny | Utrzymany | Poprzez rozszerzenia |
| Personalizacja | CLAUDE.md + zasady + haki | .kursory | Instrukcje drugiego pilota |
| Idealny dla | Złożone zadania, automatyzacja, CI/CD | Codzienny rozwój | Uzupełnienie, fragment |
| Koszt | Płatność za użycie (API) lub plan Max | 20 USD miesięcznie | 10-19 dolarów miesięcznie |
Kiedy używać jakiego narzędzia
- Claude'a Koda - Złożone, kompleksowe zadania (implementacja kompletnej funkcji, refaktoryzacja 20 plików, konfiguracja CI/CD), operacje terminalowe, automatyzacja przepływ pracy, praca na zdalnych serwerach poprzez SSH.
- Kursor - Codzienny rozwój, interaktywna edycja, kiedy tylko chcesz je zobaczyć edycja w czasie rzeczywistym w edytorze, programowanie w parach z AI, szybkie prototypowanie.
- Drugi pilot GitHuba - Szybkie autouzupełnianie podczas pisania, Szybkie generowanie fragmentów, gdy jesteś już w trakcie kodowania i potrzebujesz sugestii wbudowane.
Najbardziej produktywną kombinacją dla wielu programistów jest: Kursor za to codzienny interaktywny rozwój, Drugi pilot do uzupełniania inline szybko i Claude'a Koda do złożonych zadań, automatyzacji i operacji z terminal. Są to narzędzia, które działają na różnych poziomach i uzupełniają się.
Najlepsze praktyki dotyczące skutecznego stosowania
Po miesiącach intensywnego używania Claude Code w rzeczywistych projektach, oto praktyki, które: robią różnicę między frustrującym doświadczeniem a wysoce produktywnym.
1. Napisz szczegółowy plik CLAUDE.md
CLAUDE.md to inwestycja o najwyższym ROI. Dobrze napisany plik zmniejsza liczbę błędów agenta rzędu 50-70%. Zawsze uwzględniaj: przegląd projektu, stos technologii, konwencje kodowania, polecenia kompilacji/testowania, wzorce architektoniczne i sekcja Wyraźne „NIE” z ograniczeniami.
2. Używaj konkretnych i kontekstowych podpowiedzi
# VAGO (risultato imprevedibile):
"Migliora il componente form"
# SPECIFICO (risultato prevedibile):
"Nel componente src/app/components/contact-form/:
1. Aggiungi validazione email con regex
2. Aggiungi campo telefono opzionale
3. Mostra errori inline sotto ogni campo
4. Usa il pattern reactive forms di Angular
5. Mantieni lo stile CSS esistente"3. Pracuj w sesjach skupionych
Unikaj zbyt długich sesji, które prowadzą do zagęszczenia kontekstu. Ty wolisz 15-30-minutowe sesje skupione na jednym celu. Gdy zadanie jest złożone, podziel je na podzadania i zajmij się nimi w oddzielnych sesjach.
4. Zawsze sprawdzaj kompilację
Po każdym znaczącym cyklu zmian poproś Claude’a Code o uruchomienie kompilacji i testy. Nie zakładaj, że zmiany są prawidłowe: model może zostać zatwierdzony Subtelne błędy, które pojawiają się dopiero w czasie kompilacji lub w czasie wykonywania.
5. Korzystaj z systemu reguł dla złożonych projektów
W przypadku projektów o wielu konwencjach użyj katalogu .claude/rules/ z plikami
oddzielone domeną: coding-style.md, security.md,
testing.md, git-workflow.md. Jest to łatwiejsze w utrzymaniu niż a
pojedynczy CLAUDE.md monolityczny.
6. Skonfiguruj hooki do automatyzacji
PostToolUżyj haków do automatycznego formatowania (Prettier, ESLint) usuń całą kategorię błędów stylistycznych. PreToolUse hooks do sprawdzania poprawności uniemożliwia operacje niebezpieczne. Zainwestowanie 10 minut w konfigurację haków pozwala zaoszczędzić godziny poprawek podręczniki.
Ograniczenia i obejścia
Claude Code nie jest doskonały. Zrozumienie ograniczeń jest niezbędne do zarządzania nimi oczekiwań i przyjąć strategie łagodzące.
Ograniczenie 1: Okno kontekstowe
Kontekst ma ustalone granice. W przypadku bardzo dużych projektów model nie „widzi” całą bazę kodu jednocześnie. Automatyczne zagęszczanie pomaga, ale może być nieszczelne ważne szczegóły.
Obejścia: Podziel zadania na szczegółowe podzadania. Użyj CLAUDE.md aby zapewnić kontekst architektoniczny, który nie wymaga czytania plików. Skorzystaj z subagentów (Narzędzie zadań) do delegowania równoległych analiz.
Ograniczenie 2: Halucynacje
Model może wygenerować kod, który wydaje się poprawny, ale zawiera subtelne błędy logiczne, odniesienia do nieistniejących interfejsów API lub wzorców nieobsługiwanych przez konkretną wersję pliku a ramy.
Obejścia: Zawsze sprawdzaj podczas kompilacji i testu. Określ w pliku CLAUDE.md dokładne wersje frameworków. Podczas pracy z zewnętrznymi interfejsami API należy dostarczyć dokumentację poprzez WebFetch lub dołącz działające przykłady.
Ograniczenie 3: Operacje interaktywne
Claude Code nie obsługuje poleceń interaktywnych wymagających wprowadzania danych z klawiatury
(jak git rebase -i lub monit o potwierdzenie). Polecenia muszą być
nieinteraktywne.
Obejścia: Jeśli są dostępne, używaj nieinteraktywnych flag
(-y, --yes). W przypadku git użyj zamiast tego określonych poleceń
interaktywne.
Ograniczenie 4: Pliki binarne i obrazy
Claude Code może czytać obrazy (i multimodalnie), ale nie może ich generować ani modyfikować pliki binarne, takie jak obrazy, filmy lub pliki PDF.
Obejścia: Do operacji na obrazach użyj poleceń CLI, takich jak ImageMagick lub ffmpeg za pomocą narzędzia Bash.
Ograniczenie 5: Koszt
Korzystanie z interfejsu API może być kosztowne w przypadku długich i intensywnych sesji. Każdy Pętla agentyczna zużywa tokeny zarówno na potrzeby rozumowania, jak i wyników narzędzi.
Obejścia: Skorzystaj z planu Max ze stałym miesięcznym kosztem, jeśli z niego korzystasz i częste. Optymalizuj podpowiedzi, aby były szczegółowe (mniej iteracji). Skorzystaj z subagentów zrównoleglić, jeśli to możliwe (szybciej = mniej tokenów ogółem).
Częsty błąd: ślepe zaufanie wynikom
Najczęstszym błędem Claude Code jest akceptowanie wszystkich wyników bez weryfikacji. Szablon może: tworzyć pliki w niewłaściwych katalogach, używać błędnych importów, wprowadzać regresje w plikach niezwiązanych bezpośrednio z modyfikacją lub wygeneruj kod, który kompiluje się, ale zawiera błędy logiczne. Zawsze sprawdzaj podczas kompilacji i testu. Czyste kodowanie wibracyjne dla prototypów; W przypadku kodu produkcyjnego konieczna jest weryfikacja ręczna.
Wnioski
Claude Code stanowi jakościowy skok w sposobie interakcji programistów z AI. To nie jest po prostu chatbot, który sugeruje kod: to jest agent autonomiczny który działa w Twoim środowisku programistycznym, rozumie kontekst projektu i potrafi nim zarządzać złożone zadania typu end-to-end.
Siła narzędzia wynika z połączenia: bezpośredniego dostępu do systemu plików i Shell, szczegółowy system uprawnień, haki do niestandardowej automatyzacji, subagenci do zadań równoległych i integracji MCP w celu rozszerzenia możliwości poza lokalną bazę kodu. Wszystko to kontrolowane jest przez plik CLAUDE.md, który pełni funkcję odprawy dla współpracownika ekspert.
Ale władza wiąże się z odpowiedzialnością. Claude Code działa najlepiej, gdy jest programistą zachowuje aktywną rolę nadzorca i orkiestrator: określa cele oczyścić, ustawić odpowiednie poręcze, zweryfikować wyniki i interweniować, jeśli to konieczne. To nie jest narzędzie typu „ustaw i zapomnij”: to narzędzie zwiększające produktywność dla tych, którzy wiedzą prowadź to.
Następne artykuły z serii
- 03 — Przepływy pracy agenta: Jak rozkładać złożone problemy dla agentów Sztuczna inteligencja, wieloetapowa orkiestracja i skuteczne wzorce delegowania
- 04 - Systemy wieloagentowe: Architektury współpracy pomiędzy agentów, protokołów komunikacyjnych i przypadków użycia w przedsiębiorstwie
- 05 - Testowanie kodu wygenerowanego przez sztuczną inteligencję: TDD, strategie oparte na nieruchomościach testowanie i walidacja jakości kodu generowanego przez sztuczną inteligencję
Kluczowe punkty do zapamiętania
- Claude Code to agent CLI działający w terminalu z dostępem do systemu plików, powłoki i narzędzia programistyczne
- CLAUDE.md jest najważniejszą inwestycją: wyznacza kierunek zachowań agenta i redukuje błędy o 50-70%
- System uprawnień (zezwól/zapytaj/odmów) realizuje zasadę najmniejszych uprawnień aby chronić bazę kodu
- Haki PreToolUse/PostToolUse automatyzują sprawdzanie poprawności i formatowanie
- Subagenci (narzędzia zadań) umożliwiają równoległe wykonywanie i analizę z wielu perspektyw
- MCP rozszerza możliwości agenta na przeglądarki, bazy danych i usługi zewnętrzne
- Claude Code, Cursor i Copilot uzupełniają się, a nie alternatywy
- Zawsze sprawdzaj kompilacje i testy: kodowanie w formie czystego wibracji, a w przypadku prototypów – produkcja wymaga nadzoru człowieka
- Krótkie, skoncentrowane sesje (15–30 minut) dają lepsze rezultaty niż sesje długie i ogólne