02 - Claude Code: Vývoj agentů z Terminálu
V panoramatu vývojových nástrojů s podporou AI zaujímá Claude Code jedinečnou pozici: a jeden Agentní CLI který žije v terminálu, čte vaši kódovou základnu, provádí příkazy, upravovat soubory a spravovat složité pracovní postupy bez otevření IDE. Není to chatbot s přístupem ke kódu: je to autonomní agent, který funguje ve vašem vývojovém prostředí se stejnou přirozeností se kterým by vedle vás pracoval starší kolega.
Tento článek je kompletní podrobný popis Claude Code: od instalace po konfiguraci pokročilé, od interní architektury po praktické pracovní postupy, od systému povolení po tvorbu přizpůsobených agentů. Ať už jste zkušený vývojář, který chce maximalizovat produktivita nebo vedoucí týmu, který vyhodnocuje nástroje agentů, zde najdete vše, co potřebujete zvládnout tento nástroj.
Co se naučíte
- Co je Claude Code a jak se liší od tradičních asistentů AI
- Instalace, konfigurace a struktura adresářů
.claude/ - Vnitřní architektura: volání nástroje, kontextové okno, model oprávnění
- Všechny dostupné nástroje: Čtení, Zápis, Úpravy, Bash, Grep, Glob, Task, WebSearch
- Systém povolení a mechanismus háčků
- Jak napsat efektivní CLAUDE.md pro řízení chování agenta
- Subagenti, paralelní provádění a izolační pracovní stromy
- Integrace MCP (Model Context Protocol) pro prohlížeče, databáze a externí služby
- Praktické pracovní postupy: TDD, kontrola kódu, ladění, automatické potvrzení
- Srovnání s Cursorem, GitHub Copilot a dalšími nástroji založenými na IDE
- Osvědčené postupy, známá omezení a strategie řešení
Co je Claude Code: The Agentic Paradigm in the Terminal
Claude Code a oficiální Anthropic CLI pro vývoj agentů. Na rozdíl od tradiční chatboti, kde kopírujete a vkládáte kód mezi oknem chatu a editorem, Claude Code žije ve vašem terminálu a má přímý přístup k souborovému systému, může spouštět příkazy shellu, číst a upravovat soubory, hledat vzory v kódové základně a zorganizovat vícekrokové pracovní postupy bez ručního zásahu.
Termín agentní a zásadní pro pochopení povahy nástroje. Agent AI nejen odpovídá na otázky: akty. Claude Code analyzuje kontextu projektu, plánuje potřebné změny, realizuje je prostřednictvím série volání nástrojů, zkontrolujte výsledky a opakujte, dokud nebude úloha dokončena. A ten rozdíl mezi tím, když se někoho ptáte: „Jak mám udělat X?“ a řekněte „udělejte X“ kompetentnímu spolupracovníkovi.
Chatbot vs Agent: zásadní rozdíl
Un chatboty generuje text jako odpověď na výzvu. A činidlo má přístup k nástrojům a může provádět akce v reálném světě: číst soubory, spouštět příkazy, upravovat kód, procházet web. Claude Code je agent, který pracuje ve vašem vývojové prostředí s nepřetržitým cyklem pozorování-uvažování-akce až do dokončení cíle.
Claude Code a poháněný modelem Claude (aktuálně Opus 4.6, Sonnet 4.6 a varianty) a rozhraní s kódovou základnou prostřednictvím sady speciálně navržených nativních nástrojů pro operace vývoje softwaru. V únoru 2026 GitHub integroval Claude Code do Platforma Agent HQ, která upevňuje svou roli referenčního agenta v ekosystému profesního rozvoje.
Instalace a konfigurace
Instalace Claude Code je přímá a vyžaduje Node.js 18+ a npm. Proces zahrnuje tři fáze: instalace balíčku, nastavení ověřování a přizpůsobení životního prostředí.
Základní instalace
# 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-...
claude
Při prvním spuštění nabízí Claude Code ověření přes prohlížeč (OAuth) nebo přes Přímý klíč API. Pro osobní použití stačí API klíč; pro týmy a organizace e Doporučuje se přístup přes Anthropic Console s centralizovanou správou přihlašovacích údajů.
Adresář .claude/
Po inicializaci vytvoří Claude Code adresář .claude/ in the root
projektu (a volitelně v domovském adresáři uživatele pro globální konfigurace).
Tento adresář je nervovým centrem konfigurace.
.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 locale
Soubor settings.json
Soubor settings.json zkontrolujte oprávnění, autorizované nástroje a
globální chování agenta. A první soubor pro konfiguraci pro zážitek
produktivní.
{
"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"
}
Zabezpečení konfigurace
Sekce deny a zásadní pro bezpečnost projektu. Blokovat příkazy
destruktivní jako rm -rf, git push --force e
git reset --hard zabraňuje náhodnému poškození nebo poškození způsobenému halucinacemi
modelu. Je dobrým zvykem přidat jakýkoli příkaz, který by mohl způsobit odmítnutí
nevratná ztráta dat.
CLAUDE.md: Pokyny pro agenta
Soubor CLAUDE.md a srdce přizpůsobení Claude Code. Umístěno
v kořenovém adresáři projektu obsahuje pokyny, které agent automaticky čte u každého z nich
zasedání. Představte si to jako a vstupní dokument pro nového člena týmu:
popisuje projekt, konvence, architektury a očekávání.
Struktura efektivního 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()
Dobře napsaný CLAUDE.md dramaticky snižuje chyby agentů a zlepšuje kvalitu výstupu. Nejdůležitější sekce jsou: Přehled projektu (kontext obecné), Architektura (technická rozhodnutí), Kódovací standardy (konvence) e NE (výslovná omezení).
Adresář pravidel: Modulární pravidla
Kromě CLAUDE.md podporuje Claude Code adresář .claude/rules/ kde
vložit pravidla organizovaná podle domény. Tento modulární přístup je výhodnější
komplexní 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 errors
Systém paměti
Claude Code má mechanismus trvalá paměť mezi relacemi.
Soubor MEMORY.md v adresáři .claude/ je aktualizován
automaticky agentem s lekcemi získanými během pracovních setkání: vzor
objevy, běžné chyby, konfigurace specifické pro projekt a architektonická rozhodnutí.
# 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 a vnitřní fungování
Pochopení toho, jak Claude Code interně funguje, je nezbytné pro jeho efektivní používání. Architektura je založena na třech pilířích: agentní cyklus, The nástrojový systém e la správa kontextových oken.
Agentský cyklus
Když odešlete zprávu Claude Code, systém vstoupí do smyčky, která se opakuje do po dokončení úkolu:
- Recepce - Agent obdrží vaši zprávu se všemi nashromážděnými souvislostmi
- Uvažování - Model analyzuje požadavek a naplánuje potřebné akce (rozšířené myšlení)
- Volání nástroje - Agent vyvolá jeden nebo více nástrojů (Číst, Upravit, Bash atd.)
- Pozorování - Výsledky nástroje jsou přidány do kontextu
- Opakování - Model vyhodnotí výsledky a rozhodne, zda je zapotřebí další akce
- Odpověď - Po dokončení úkolu agent poskytne shrnutí
Tento cyklus se může opakovat desítkykrát pro jeden komplexní úkol. např. implementace nové funkce může vyžadovat: čtení existujících souborů (Read), vyhledávání vzor (Grep/Glob), vytvořit nové soubory (Write), upravit existující soubory (Edit), spustit otestujte (Bash), opravte chyby a opakujte.
Správa kontextových oken
Kontextové okno je množství informací, které může model zpracovat v jednom okně interakce. Claude Code inteligentně zpracovává kontext napříč několika mechanismy:
- Selektivní zatížení - Nenačte celou kódovou základnu do paměti. Použijte Glob a Grep pro vyhledání relevantních souborů a Read pro čtení pouze těch nezbytných.
- Automatické zhutňování - Když se kontext blíží limitu, Claude Kód komprimuje konverzaci tím, že uchovává nejrelevantnější informace a zahazuje je zastaralé detaily.
- Subagenti - Pro složité úkoly, které vyžadují hodně kontextu, Claude Code může delegovat dílčí úkoly na dílčí agenty s izolovaným kontextem (nástroj Task).
- Rozšířené myšlení - Model si vyhrazuje až 31 999 žetonů vnitřní úvaha, oddělená od kontextu rozhovoru.
Zhutňování: Kdy a jak se to děje
Zhutnění a proces, kterým Claude Code shrnuje konverzaci v kontextu stává se příliš velkým. Je to automatická operace, která zachovává: instrukce CLAUDE.md, učiněná architektonická rozhodnutí, upravené soubory a jejich aktuální stav a chyby setkal. Konkrétní detaily z předchozích iterací však mohou být ztraceny. U velmi dlouhých úkolů je vhodnější rozdělit práci na kratší sezení zaměření.
Hlavní nástroje
Claude Code má sadu nativních nástrojů navržených tak, aby pokryly celé spektrum vývojové operace. Každý nástroj má specifickou roli a přesná pravidla použití.
Nástroj pro čtení a vyhledávání
| Nástroje | Funkce | Kdy jej použít |
|---|---|---|
| Číst | Přečte obsah konkrétního souboru | Když znáte přesnou cestu k souboru |
| Zeměkoule | Vyhledávání souborů podle vzoru názvu | Chcete-li najít soubory: **/*.ts, src/**/*.spec.ts |
| Grep | Vyhledává obsah v souborech | Chcete-li najít vzory, funkce, třídy v kódové základně |
Nástroj pro psaní a úpravy
| Nástroje | Funkce | Kdy jej použít |
|---|---|---|
| Napsat | Vytvoří nebo přepíše celý soubor | Pro nové soubory nebo kompletní přepsání |
| Upravit | Nahrazuje určité části souboru | Pro chirurgické úpravy stávajících souborů |
Prováděcí nástroj
| Nástroje | Funkce | Kdy jej použít |
|---|---|---|
| Bash | Spouštějte příkazy shellu v terminálu | Build, test, git, npm, jakýkoli příkaz CLI |
| Úkoly | Spusťte subagenty s izolovaným kontextem | Pro složité úkoly, které vyžadují vyhrazený kontext |
Web a vyhledávací nástroje
| Nástroje | Funkce | Kdy jej použít |
|---|---|---|
| WebSearch | Provádějte vyhledávání na webu | Pro dokumentaci, aktualizace, osvědčené postupy |
| WebFetch | Stáhněte a analyzujte obsah adresy URL | Chcete-li číst dokumentaci, odkazy na API, články |
Praktický příklad: Kompletní cyklus použití nástroje
# 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 passed
Systém povolení
Systém povolení Claude Code je navržen podle principu nejmenší privilegium: agent může dělat pouze to, co výslovně dělá oprávněný. To je nezbytné pro bezpečnost, zvláště když agent funguje na produkční kódové základně.
Tři režimy povolení
| Režim | Chování | Use Case |
|---|---|---|
| Povolit | Nástroj běží bez požadavku na potvrzení | Zabezpečené operace: čtení souborů, vyhledávání |
| Požádat | Claude Code požádá o potvrzení před provedením | Výchozí pro většinu operací |
| Odmítnout | Nástroj je zcela zablokován | Nebezpečné operace: smazat, vynutit zatlačení |
Oprávnění lze konfigurovat na třech úrovních: globální
(~/.claude/settings.json), projekt
(.claude/settings.json) A zasedání (přes výzvu
interaktivní). Oprávnění projektu přepisují globální oprávnění a
session přepsat ty projektové.
Granulovaná oprávnění pro Bash
Nástroj Bash podporuje podrobná oprávnění na základě konkrétního příkazu. To umožňuje autorizovat bezpečné příkazy a zároveň blokovat ty nebezpečné.
{
"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 *)"
]
}
}
Princip obrany do hloubky
Nespoléhejte pouze na oprávnění. Kombinovat: (1) omezující oprávnění v souboru settings.json, (2) explicitní instrukce v CLAUDE.md o tom, co NEDĚLAT, (3) háčky, které ověřují operace před provedením a (4) standardní git hooky (pre-commit, pre-push) jako poslední obranná linie. Zabezpečení je vrstvené.
Systém háčků
Claude Code hook jsou skripty, které se spouštějí automaticky jako první (PreToolUse) nebo po (PostToolUse) vyvolání a nástroj nebo když relace skončí (Zastávka). Jsou nejvíce mechanismem Výkonný pro přizpůsobení a kontrolu chování agentů.
Typy háčků
| Háček | Při aktivaci | Typický případ použití |
|---|---|---|
| PreToolUse | Před spuštěním nástroje | Validace parametrů, podmíněné blokování, logování |
| PostToolUse | Po spuštění nástroje | Automatické formátování, lining, ověření výsledků |
| Zastávka | Když relace skončí | Finální ověření, vyčištění, generování reportů |
Příklad: Zavěšení pro automatické formátování
{
"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"
}
]
}
}
Háky přijímají kontextové informace prostřednictvím proměnných prostředí, jako je např
$CLAUDE_FILE_PATH (soubor, na kterém pracujete) e
$CLAUDE_TOOL_INPUT (parametry nástroje). To vám umožní tvořit
sofistikovaná podmíněná logika.
Advanced Hook: Prevence změn kritických souborů
Hák PreToolUse může zabránit úpravám citlivých souborů (jako jsou konfigurace
produkční nebo pověření) tak, že před povolením zkontrolujete cestu k souboru
operace Edit nebo Write. Pokud se cesta shoduje se zakázaným vzorem (např.
**/production.config.*), hák vrátí chybu a zablokuje operaci.
Agenti a subagenti: Multi-Task Orchestration
Jedna z nejmocnějších schopností Claude Code a Úkolové nástroje, která umožňuje ke spuštění subagentů s izolovaným kontextem. Každý subagent pracuje v samostatném „pískovišti“, s vlastním kontextem a vrátí výsledky do hlavního procesu.
Kdy použít subagenty
- Nezávislé paralelní úlohy - Současně analyzovat bezpečnost, výkon a dostupnost součásti
- Izolovaný kontext - Když dílčí úkol vyžaduje specifický kontext která neslouží hlavnímu úkolu
- Multiperspektivní analýza - Nechte stejný kód prozkoumat "perspektivami" různé (bezpečnostní expert, výkonnostní inženýr, UX recenzent)
- Dlouhotrvající úkoly - Delegujte dlouhé operace během procesu hlavní pokračovat s více
Příklad: Multi-Perspective Code Review
# 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 finale
Vlastní agenti
Adresář .claude/agents/ umožňuje definovat specializované agenty s
konkrétní pokyny a osobnosti. Každý soubor Markdown v tomto adresáři se stane a
vyvolatelný 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)
Izolační pracovní strom
Pro úkoly, které vyžadují experimentální změny bez riskování současné větve, Claude
Kód podporuje i pracovní strom git. Nástroj EnterWorktree vytvoří pracovní strom
izolovaný v .claude/worktrees/ s novou větví založenou na HEAD.
Po skončení relace se uživatel může rozhodnout pracovní strom ponechat nebo odstranit.
Integrace MCP: Protokol kontextu modelu
Il Kontextový protokol modelu (MCP) a otevřený standard, který umožňuje a Claude Kód pro komunikaci s externími službami prostřednictvím serveru MCP. Toto se rozšiřuje výrazně zlepšuje schopnosti agenta mimo lokální souborový systém.
architektura MCP
Architektura MCP sleduje model klient-server, kde Claude Code vystupuje jako klient a i Servery MCP nabízejí další nástroje. Server MCP může poskytovat přístup k: webovým prohlížečům, databáze, externí API, cloudové služby, CI/CD systémy a mnoho dalšího.
Běžné případy použití MCP
| Server MCP | Funkčnost | Příklad použití |
|---|---|---|
| Automatizace prohlížeče | Prohlížení webu, kliknutí, snímky obrazovky, vyplňování formulářů | E2E testování, scraping, automatizace workflow |
| Databáze | SQL/NoSQL dotazy, průzkum schémat | Ladění dat, migrace schémat |
| GitHub | PR, záležitosti, recenze kódu, akce | Automatizace pracovních postupů GitHub |
| Figma | Čtení návrhu, extrakce komponent | Generování kódu z designu |
{
"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"
}
}
}
}
MCP a zabezpečení
Každý server MCP má přístup ke zdrojům, které jsou pro něj nakonfigurovány. Databázový server má přístup k databázi, serverový prohlížeč může procházet web. Zásadní je aplikovat zásada nejmenšího oprávnění také pro servery MCP: kde používat přihlašovací údaje pouze pro čtení Pokud je to možné, omezte přístup k vývojovým databázím a nezveřejňujte produkční přihlašovací údaje.
Vlastní dovednosti a příkazy
Systém Dovednosti by Claude Code umožňuje definovat schopnosti specializovaná nastavení, která může agent vyvolat během relací. Na rozdíl od agentů (které definují osobnost a přístup), definují dovednosti postupy specifikace pro opakující se úkoly.
Vlastní příkazy lomítka
Příkazy lomítka jsou zkratky, které lze vyvolat pomocí syntaxe /nomecomando
během relace. Jsou definovány jako soubory Markdown v adresáři
.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 HIGH
Vlastní dovednosti
Dovednosti v adresáři .claude/skills/ jsou propracovanější než příkazy
a může zahrnovat technický kontext, příklady a vícekrokové postupy.
# 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 @
Praktické pracovní postupy s Claude Code
Teorie je důležitá, ale skutečná hodnota Claude Code se objevuje v každodenních pracovních postupech. Podívejme se, jak jej používat pro nejběžnější úlohy vývoje softwaru.
1. Testem řízený vývoj (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 -- --coverage
2. Interaktivní ladění
# 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 build
3. Pracovní postup automatického potvrzení
Claude Code má vestavěný pracovní postup pro vytváření potvrzení Git, který analyzuje změny, generuje popisnou zprávu a řídí přípravu souborů.
# 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 status
4. Řízený refaktoring
# 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 test
Claude Code vs Cursor vs GitHub Copilot
Výběr správného nástroje závisí na kontextu, typu úkolu a osobní preference. Claude Code, Cursor a GitHub Copilot nejsou alternativy vzájemně se vylučují: jsou komplementární.
| čekám | Claude Code | Kurzor | GitHub Copilot |
|---|---|---|---|
| Rozhraní | CLI / Terminál | IDE (VS Code fork) | IDE pluginy |
| Režim | Agent (autonomní) | Agent + inline | Asistent + agent |
| Autonomie | Vysoká (autonomní cykly) | Středně vysoká | Průměrný |
| Kontext | Celý souborový systém | Otevřete projekt | Otevřít soubory + index |
| Provedení nástroje | Plná skořápka | Integrovaný terminál | Omezený |
| Podpora MCP | Rodák | Podporováno | Přes rozšíření |
| Přizpůsobení | CLAUDE.md + pravidla + háčky | .kurzorová pravidla | Pokyny pro druhého pilota |
| Ideální pro | Komplexní úlohy, automatizace, CI/CD | Každodenní vývoj | Dokončení, úryvek |
| Náklady | Pay-per-use (API) nebo Max plán | 20 $ měsíčně Pro | 10-19 $ měsíčně |
Kdy použít který nástroj
- Claude Code - Komplexní úlohy typu end-to-end (implementujte kompletní funkci, refaktor 20 souborů, konfigurace CI/CD), terminálové operace, automatizace workflow, práce na vzdálených serverech přes SSH.
- Kurzor - Každodenní vývoj, interaktivní úpravy, kdykoli je chcete vidět editace v reálném čase v editoru, párové programování s AI, rychlé prototypování.
- GitHub Copilot - Rychlé automatické dokončování při psaní, Rychlé generování úryvků, když už jste v toku kódování a chcete návrhy inline.
Nejproduktivnější kombinace pro mnoho vývojářů je: Kurzor za to každodenní interaktivní vývoj, Druhý pilot pro inline dokončení rychlé a Claude Code pro složité úkoly, automatizaci a operace z terminál. Jsou to nástroje, které fungují na různých úrovních a vzájemně se doplňují.
Nejlepší postupy pro efektivní použití
Po měsících intenzivního používání Claude Code na skutečných projektech jsou zde postupy, které dělají rozdíl mezi frustrujícím zážitkem a vysoce produktivním zážitkem.
1. Napište podrobný CLAUDE.md
CLAUDE.md je investice s nejvyšší návratností investic. Dobře napsaný soubor snižuje chyby činidla v řádu 50-70 %. Vždy zahrňte: přehled projektu, zásobník technologií, konvence kódování, příkazy sestavení/testování, architektonické vzory a sekce Explicitní „NE“ s omezeními.
2. Použijte specifické a kontextové výzvy
# 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. Práce v soustředěných relacích
Vyhněte se příliš dlouhým relacím, které vedou ke komprimaci kontextu. Dáváte přednost 15-30 minutové sezení zaměřené na jeden cíl. Když je úkol složitý, rozdělit to na dílčí úkoly a řešit je v samostatných relacích.
4. Vždy zkontrolujte sestavení
Po každém cyklu významných změn nechte Claude Code spustit sestavení a testy. Nepředpokládejte, že změny jsou správné: model se může odevzdat Drobné chyby, které se objevují pouze v době kompilace nebo za běhu.
5. Použijte systém pravidel pro složité projekty
Pro projekty s mnoha konvencemi použijte adresář .claude/rules/ se soubory
odděleno doménou: coding-style.md, security.md,
testing.md, git-workflow.md. To je udržitelnější než a
singl CLAUDE.md monolitický.
6. Nakonfigurujte háky pro automatizaci
PostToolUse háčky pro automatické formátování (Prettier, ESLint) odstraní celou kategorii stylových chyb. PreToolUse háky pro ověření zabraňují operacím nebezpečné. Investice 10 minut do konfigurace háčků ušetří hodiny oprav příručky.
Omezení a náhradní řešení
Claude Code není dokonalý. Pochopení omezení je nezbytné pro jejich zvládnutí očekávání a přijmout zmírňující strategie.
Omezení 1: Kontextové okno
Kontext má pevný limit. U velmi velkých projektů model nemůže „vidět“ celou kódovou základnu současně. Automatické zhutňování pomáhá, ale může být netěsné důležité detaily.
zástupná řešení: Rozdělte úkoly na cílené dílčí úkoly. Použijte CLAUDE.md poskytnout architektonický kontext, který nevyžaduje čtení souborů. Použijte podagenty (nástroj úloh) k delegování paralelních analýz.
Omezení 2: Halucinace
Model může generovat kód, který se jeví jako správný, ale obsahuje jemné logické chyby, odkazy na neexistující rozhraní API nebo vzory, které konkrétní verze a rámec.
zástupná řešení: Vždy ověřte pomocí sestavení a testování. Zadejte v souboru CLAUDE.md přesné verze rámců. Při práci s externími rozhraními API poskytněte dokumentaci přes WebFetch nebo připojte funkční příklady.
Omezení 3: Interaktivní operace
Claude Code nezvládá interaktivní příkazy, které vyžadují vstup z klávesnice
(jak git rebase -i nebo výzva k potvrzení). Příkazy musí být
neinteraktivní.
zástupná řešení: Pokud jsou k dispozici, použijte neinteraktivní příznaky
(-y, --yes). Pro git použijte místo toho specifické příkazy
interaktivních.
Omezení 4: Binární soubory a obrázky
Claude Code umí číst obrázky (a multimodální), ale nemůže je generovat ani upravovat binární soubory, jako jsou obrázky, videa nebo PDF.
zástupná řešení: Pro operace s obrázky použijte příkazy CLI jako ImageMagick nebo ffmpeg pomocí nástroje Bash.
Omezení 5: Cena
Použití založené na rozhraní API může být drahé pro dlouhé a intenzivní relace. Každý Agentická smyčka spotřebovává tokeny jak pro uvažování, tak pro výsledky nástroje.
zástupná řešení: Pokud jej používáte, použijte plán Max za fixní měsíční náklady a časté. Optimalizujte výzvy, aby byly konkrétní (méně iterací). Použijte podagenty paralelizovat, kde je to možné (rychlejší = méně celkových tokenů).
Častá chyba: Slepá důvěra ve výstup
Nejčastější chybou u Claude Code je přijetí veškerého výstupu bez ověření. Šablona může: vytvářet soubory ve špatných adresářích, používat nesprávné importy, zavádět regrese v souborech, které přímo nesouvisejí s modifikací, nebo generují kód, který kompiluje, ale má logické chyby. Vždy ověřte sestavením a testem. Kódování čisté atmosféry pro prototypy; Pro produkční kód je nutná lidská kontrola.
Závěry
Claude Code představuje kvalitativní skok ve způsobu interakce vývojářů s AI. Není to jen chatbot, který navrhuje kód: je to a autonomní agent který funguje ve vašem vývojovém prostředí, rozumí kontextu projektu a umí spravovat komplexní end-to-end úkoly.
Síla nástroje vyplývá z kombinace: přímého přístupu k souborovému systému a shell, podrobný povolovací systém, háčky pro vlastní automatizaci, subagenti pro paralelní úlohy a integraci MCP pro rozšíření schopností mimo místní kódovou základnu. To vše je řízeno souborem CLAUDE.md, který funguje jako briefing pro spolupracovníka odborník.
Ale moc přináší zodpovědnost. Claude Code funguje nejlépe, když vývojář udržuje aktivní roli vedoucí a orchestrátor: definuje cíle vyčistit, nastavit vhodné mantinely, ověřit výsledky a v případě potřeby zasáhnout. Není to nástroj „nastav a zapomeň“: je to multiplikátor produktivity pro ty, kteří to vědí vést to.
Další články v seriálu
- 03 - Pracovní postupy agentů: Jak rozložit složité problémy pro agenty AI, vícekroková orchestrace a efektivní vzory delegování
- 04 - Multi-Agent Systems: Architektury spolupráce mezi agenti, komunikační protokoly a případy podnikového použití
- 05 - Testování kódu generovaného AI: TDD, strategie založené na vlastnostech testování a ověřování kvality kódu generovaného AI
Klíčové body k zapamatování
- Claude Code je agent CLI, který pracuje v terminálu s přístupem k souborovému systému, shell a vývojové nástroje
- CLAUDE.md je nejdůležitější investice: řídí chování agenta a snižuje chyby o 50-70%
- Systém oprávnění (allow/ask/deny) implementuje princip nejmenšího oprávnění k ochraně kódové základny
- Háčky PreToolUse/PostToolUse automatizují ověřování a formátování
- Subagenti (nástroje úloh) umožňují paralelní provádění a multiperspektivní analýzu
- MCP rozšiřuje možnosti agenta na prohlížeče, databáze a externí služby
- Claude Code, Cursor a Copilot se doplňují, nikoli alternativy
- Vždy si zkontrolujte sestavení a testy: kódování čisté atmosféry a u prototypů výroba vyžaduje lidský dohled
- Krátká soustředěná sezení (15–30 minut) přinášejí lepší výsledky než relace dlouhé a obecné







