Nauč sa pracovať
s Claude Code

Kompletný sprievodca pre nastavenie a používanie Claude Code pri vibe coding — od prvej inštalácie až po prácu na veľkom projekte. Aktualizované podľa oficiálnej dokumentácie (september 2026).

Čo je Claude Code?

Claude Code je agentný nástroj od Anthropic, ktorý ti umožňuje spolupracovať s AI priamo v termináli, v IDE alebo v desktop aplikácii. Nie je to len chatbot — je to plnohodnotný agent, ktorý:

• číta a píše súbory priamo do tvojho projektu
• spúšťa bash príkazy, testy a buildy
• prehľadáva kód pomocou grep, find a iných nástrojov
• spravuje git (commit, diff, branch, PR)
• spúšťa subagentov pre paralelné úlohy
• najprv plánuje (Plan mode) a každú zmenu vie vrátiť cez checkpointy (/rewind)

Prerekvizity

• OS: macOS 13+, Windows 10+ (natívne alebo WSL 2), Ubuntu 20.04+ / Debian 10+
• Účet: Claude Pro, Max, Team alebo Enterprise predplatné, alebo Claude Console (API) účet — viď Prihlásenie. Bezplatný plán Claude Code neobsahuje.
• Git (odporúčané; na Windows Git for Windows kvôli Bash nástroju)
• Node.js — potrebný iba ak inštaluješ cez npm (Node 22+). Natívny inštalátor ho nepotrebuje.

Natívny inštalátor (odporúčané)

Stiahne samostatnú binárku, ktorá sa automaticky aktualizuje na pozadí.

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

Alternatívy

# Homebrew (macOS) – neaktualizuje sa automaticky, použi brew upgrade
brew install --cask claude-code

# WinGet (Windows)
winget install Anthropic.ClaudeCode

# npm (vyžaduje Node.js 22+)
npm install -g @anthropic-ai/claude-code

Prvé spustenie

# Over inštaláciu
claude --version

# Prejdi do svojho projektu a spusti Claude Code
cd moj-projekt
claude

Pri prvom spustení sa otvorí prehliadač, kde sa prihlásiš svojím claude.ai účtom. Po správe Login successful stlačíš Enter a môžeš začať. Detaily v sekcii Prihlásenie.

Aktualizácia a diagnostika

# Natívna inštalácia sa aktualizuje sama; manuálne:
claude update

# Kontrola inštalácie, nastavení a auto-update stavu
claude doctor

# npm inštalácia (NIE npm update -g – nemusí zobrať najnovšiu verziu)
npm install -g @anthropic-ai/claude-code@latest

Kde všade Claude Code beží

Možnosť A: claude.ai predplatné (odporúčané)

1. Zaobstaraj si Pro alebo Max plán na claude.com/pricing (bezplatný plán Claude Code neobsahuje)
2. V termináli spusti claude — otvorí sa prehliadač s prihlásením
3. Prihlás sa; terminál vypíše Login successful
4. Ak sa prehliadač neotvorí (SSH, WSL2, kontajner), stlač c pre skopírovanie URL a prípadný kód vlož späť do terminálu

# Prihlásiť / odhlásiť / prepnúť účet
/login
/logout

# Ktorý účet a metóda je aktívna
/status

Možnosť B: Claude Console (API)

Pre tímy s API fakturáciou alebo ak chceš platiť za spotrebu. Kľúč vytvoríš na platform.claude.com → API Keys → Create Key (zobrazí sa iba raz).

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxx"

Claude Code sa pri štarte raz opýta, či kľúč použiť. Alternatívne sa v /login prihlásiš Console účtom aj bez vytvárania kľúča.

Možnosť C: CI / skripty

Pre GitHub Actions a automatizáciu bez prehliadača vygeneruj dlhodobý token (platí rok, vyžaduje predplatné):

claude setup-token
# → skopíruj token a nastav ho ako:
export CLAUDE_CODE_OAUTH_TOKEN="..."

Sledovanie spotreby

• /usage (alias /cost) — spotreba tokenov a limity priamo v session
• /context — vizualizácia, čo ti zaberá kontextové okno
• API účet: na platform.claude.com nastav spending limit a vytvor samostatné kľúče pre projekty

Prečo je to kľúčové?

Každá session začína s prázdnym kontextom. CLAUDE.md je miesto, kam napíšeš to, čo by si inak vysvetľoval znova a znova:

• aký tech stack projekt používa
• aké sú konvencie písania kódu
• ako sa spúšťa projekt, testy, build
• ktoré operácie sú zakázané (napr. nemazať produkčné dáta)
• kde sú dôležité súbory a moduly

Kde môže CLAUDE.md byť

Všetky nájdené súbory sa spájajú (neprepisujú). Či sa načítali, overíš príkazom /context — hľadaj sekciu Memory files.

Príklad CLAUDE.md

# Môj Projekt – Claude Kontext

## Tech Stack
- Next.js 15 (App Router)
- TypeScript strict mode
- Tailwind CSS
- PostgreSQL + Prisma ORM
- Vitest pre testy

## Štruktúra projektu
- `src/app/` – Next.js pages (App Router)
- `src/components/` – React komponenty
- `src/lib/` – helpers a utility funkcie
- `src/server/` – server-side logika
- `prisma/` – databázové schémy

## Príkazy
- `npm run dev` – development server
- `npm run test` – spusti testy
- `npm run build` – produkčný build
- `npx prisma migrate dev` – databázová migrácia

## Konvencie
- Komponenty: PascalCase, jeden súbor = jeden komponent
- API routes: REST, JSON responses, HTTP status kódy
- Error handling: vždy try/catch s logging
- Nepoužívaj `any` v TypeScript

## Zakázané operácie
- NIKDY nemaž súbory v `prisma/migrations/`
- NIKDY nemeň `.env.production`
- Pred zmazaním dát sa vždy opýtaj

## Dôležité poznámky
- Auth cez NextAuth.js – konfig v `src/lib/auth.ts`
- Všetky DB operácie cez Prisma Client, nie raw SQL

Tipy pre dobrý CLAUDE.md

• Začni cez /init — Claude preskúma projekt a vygeneruje základ. Ak súbor už existuje, navrhne zlepšenia.
• Buď konkrétny — „2 medzery odsadenie“ namiesto „formátuj pekne“; všeobecné veci Claude vie, projekt-špecifické nie
• Drž ho pod 200 riadkov — dlhší súbor zaberá kontext a Claude sa ho drží horšie. /doctor ti navrhne, čo vyhodiť.
• Pridaj príkazy a zakázané operácie — ako spustiť testy, čo nikdy nerobiť
• Aktualizuj ho — keď Claude urobí tú istú chybu druhýkrát, patrí to do CLAUDE.md
• Nepíš, čo je vidieť z kódu — stačí to, čo nie je evidentné

Importy — @cesta

CLAUDE.md môže vložiť iné súbory syntaxou @cesta/k/suboru. Načítajú sa hneď pri štarte spolu s ním:

Prehľad projektu: @README
Dostupné npm skripty: @package.json
Git workflow: @docs/git-instructions.md

# Ak repo už používa AGENTS.md pre iné AI nástroje:
@AGENTS.md

Modulárne pravidlá — .claude/rules/

Keď CLAUDE.md narastie, rozdeľ ho do tematických súborov v adresári .claude/rules/:

.claude/
├── CLAUDE.md           # Stručný úvod
└── rules/
    ├── code-style.md   # Konvencie písania kódu (načíta sa vždy)
    ├── testing.md      # Pravidlá pre testy
    └── api.md          # Načíta sa len pri práci s src/api/ (paths:)

Pravidlo môže mať paths: frontmatter — potom sa načíta iba keď Claude pracuje so zodpovedajúcimi súbormi, čo šetrí kontext:

---
paths:
  - "src/api/**/*.ts"
---

# Pravidlá pre API

- Každý endpoint musí validovať vstup
- Používaj štandardný formát chybovej odpovede

Odporúčaná štruktúra

moj-projekt/
├── CLAUDE.md                  # Hlavný kontext pre Claude (git)
├── CLAUDE.local.md            # Tvoje osobné poznámky (gitignore)
├── .mcp.json                  # MCP servery zdieľané s tímom (git)
├── .claude/
│   ├── settings.json          # Povolenia, hooks, pluginy (git)
│   ├── settings.local.json    # Tvoje lokálne prepisy (gitignore)
│   ├── rules/                 # Modulárne pravidlá
│   │   ├── code-style.md
│   │   └── api.md
│   ├── skills/                # Vlastné /príkazy
│   │   ├── review/
│   │   │   └── SKILL.md
│   │   └── deploy/
│   │       └── SKILL.md
│   ├── agents/                # Vlastné subagenty
│   │   └── code-reviewer.md
│   └── hooks/                 # Hook skripty
│       └── protect-files.sh
├── src/
│   └── ...
├── .env                       # Tajomstvá aplikácie (v .gitignore!)
└── .gitignore

Súbor .claude/settings.json

Hlavný konfiguračný súbor pre Claude Code v projekte. Commitni ho do gitu — zdieľa sa s celým tímom. Priorita: managed → settings.local.json → settings.json → ~/.claude/settings.json.

{
  "permissions": {
    "allow": [
      "Bash(npm run test)",
      "Bash(npm run build)",
      "Bash(git status)",
      "Bash(git diff *)"
    ],
    "ask": [
      "Bash(git push *)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push --force *)",
      "Bash(git push -f *)",
      "Read(./.env)",
      "Edit(./.env)"
    ],
    "defaultMode": "acceptEdits"
  },
  "hooks": {
    "Stop": [
      {
        "hooks": [{
          "type": "command",
          "command": "echo '✅ Claude dokončil prácu'"
        }]
      }
    ]
  }
}

Pravidlá pre Bash matchujú celý príkaz — * zastupuje ľubovoľný text. "Bash(git push --force)" bez hviezdičky by zachytilo iba príkaz bez ďalších argumentov. Viac v sekcii Plan mode & povolenia.

Git Worktrees pre paralelné úlohy

Keď chceš mať viac Claude sessions naraz na rôznych featurách, použi git worktrees — každá session pracuje vo vlastnej kópii projektu bez konfliktov.

# Najjednoduchšie: Claude Code vytvorí worktree sám
claude --worktree nova-funkcia      # alebo skrátene: claude -w nova-funkcia

# Manuálne cez git
git worktree add ../projekt-feature feature/nova-funkcia
git worktree list
git worktree remove ../projekt-feature

Slash príkazy zadávaš do chat inputu začínajúc /. Po napísaní / sa zobrazí autocomplete so všetkými dostupnými príkazmi a skillmi. Tu sú tie najužitočnejšie:

Session a kontext

Nastavenie

Rozšírenia a práca

Vlastné slash príkazy (Skills)

Vlastné /príkazy sa vytvárajú ako skilly — adresár s SKILL.md v .claude/skills/. Pozri sekciu 🎯 Skilly pre detaily.

mkdir -p .claude/skills/deploy
# Vytvor .claude/skills/deploy/SKILL.md s inštrukciami → /deploy

Ako používať Plan mode

1. Zapni ho
   Stláčaj Shift+Tab, kým sa v prompte nezobrazí plan. Alebo napíš /plan popis úlohy, alebo spusti claude --permission-mode plan.
2. Popíš úlohu
   Claude preskúma projekt, prípadne sa opýta na nejasnosti a predloží plán so zoznamom súborov a krokov.
3. Uprav a schváľ
   Ak sa ti niečo nepáči, napíš to — plán sa prepracuje. Po schválení Claude implementuje presne podľa plánu.

Permission módy

Claude Code má odstupňované povolenia. Mód prepínaš cez Shift+Tab (cykluje), nastavíš pri štarte alebo v settings:

# Pri štarte
claude --permission-mode plan
claude --permission-mode acceptEdits

# Trvalo pre projekt – .claude/settings.json
{ "permissions": { "defaultMode": "acceptEdits" } }

Pravidlá allow / ask / deny

Okrem módu môžeš definovať presné pravidlá. Keď pri otázke zvolíš „Yes, and don't ask again“, pravidlo sa uloží samo. Spravuješ ich cez /permissions alebo v settings.json (príklad v sekcii Štruktúra projektu).

Najužitočnejšie hook eventy

Celkovo je eventov vyše 30 (napr. InstructionsLoaded, WorktreeCreate, ConfigChange). Úplný zoznam: dokumentácia hooks.

Typy hook handlerov

Príklad: Notifikácia po dokončení

{
  "hooks": {
    "Stop": [{
      "hooks": [{
        "type": "command",
        "command": "osascript -e 'display notification \"Claude dokončil prácu\" with title \"Claude Code\"'"
      }]
    }]
  }
}

Príklad: Auto-formátovanie po zápise súboru

Hook dostane na stdin JSON s tool_input.file_path — cestu vytiahneš cez jq:

#!/bin/bash
FILE_PATH=$(jq -r '.tool_input.file_path // empty')

case "$FILE_PATH" in
  *.js|*.ts|*.jsx|*.tsx|*.json|*.css)
    npx prettier --write "$FILE_PATH" 2>/dev/null ;;
esac
exit 0

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write|Edit",
      "hooks": [{
        "type": "command",
        "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/format.sh",
        "timeout": 30
      }]
    }]
  }
}

Príklad: Blokovanie nebezpečných operácií (PreToolUse)

Hook skript ulož do .claude/hooks/protect-files.sh, potom ho zaregistruj v settings:

#!/bin/bash
INPUT=$(cat)
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
PROTECTED=(".env" "package-lock.json" ".git/")

for pattern in "${PROTECTED[@]}"; do
  if [[ "$FILE_PATH" == *"$pattern"* ]]; then
    echo "Blokované: $FILE_PATH je chránený súbor" >&2
    exit 2
  fi
done
exit 0

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Edit|Write",
      "hooks": [{
        "type": "command",
        "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-files.sh"
      }]
    }]
  }
}

Príklad: HTTP hook (integrácia so službou)

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "http",
        "url": "http://localhost:8080/hooks/validate",
        "timeout": 30,
        "headers": {
          "Authorization": "Bearer $MY_TOKEN"
        },
        "allowedEnvVars": ["MY_TOKEN"]
      }]
    }]
  }
}

Dva typy podľa transportu

Pridanie cez príkazový riadok

# Remote HTTP server (prihlásenie potom cez /mcp)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# Remote server s tokenom v hlavičke
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer $GITHUB_PAT"

# Lokálny stdio server – všetko za "--" je príkaz servera
claude mcp add playwright -- npx @playwright/mcp@latest
claude mcp add -e DSN=postgresql://user:pass@localhost/db db -- npx -y @bytebase/dbhub

# Rozsah: local (default, len ty) | project (.mcp.json, tím) | user (všetky projekty)
claude mcp add --scope project --transport http notion https://mcp.notion.com/mcp

# Správa
claude mcp list              # zoznam + stav pripojenia
claude mcp get github
claude mcp remove github
claude mcp login sentry      # OAuth z terminálu (alebo /mcp v session)

Tímová konfigurácia — .mcp.json

Servery pre celý tím patria do súboru .mcp.json v koreni projektu (commitni do gitu). Pri prvom otvorení sa každý člen tímu musí potvrdiť, že serverom dôveruje.

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "db": {
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub", "--dsn", "${DATABASE_URL}"]
    },
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

Populárne MCP servery

Staršie balíky @modelcontextprotocol/server-github, server-postgres, server-slack, server-puppeteer a ďalšie sú archivované — nahradili ich oficiálne remote servery od poskytovateľov. Overené konektory nájdeš v Anthropic Directory.

Praktický príklad: GitHub MCP

1. Pridaj remote server

   bash⎘ Kopírovať

   claude mcp add --transport http github https://api.githubcopilot.com/mcp/

2. Prihlás sa cez OAuth
   V session napíš /mcp, vyber github → Authenticate. Otvorí sa prehliadač, po prihlásení sa token uloží a automaticky obnovuje. Žiadny PAT netreba.
3. Použi v Claude Code
   Teraz môžeš písať: "Vytvor PR z branchu feature/login do main s popisom zmien" alebo "Aké sú otvorené issues s labelom bug?"

Rozsah platnosti MCP serverov

Vytvorenie vlastného MCP servera

Ak potrebuješ pripojiť vlastnú internú službu, môžeš si napísať vlastný MCP server v TypeScripte alebo Pythone.

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({ name: "moj-server", version: "1.0.0" });

// Definuj nástroj
server.registerTool(
  "get_user",
  {
    description: "Vráti info o používateľovi z interného API",
    inputSchema: { userId: z.string() },
  },
  async ({ userId }) => {
    const data = await fetchFromInternalAPI(userId);
    return { content: [{ type: "text", text: JSON.stringify(data) }] };
  }
);

// Spusti server
await server.connect(new StdioServerTransport());

Inštalácia

1. Otvor plugin manažér
   V session napíš /plugin → záložka Discover. Pri každom plugine vidíš, čo obsahuje a koľko kontextu zaberie. Katalóg je aj na claude.com/plugins.
2. Nainštaluj

   v Claude Code⎘ Kopírovať

   /plugin install github@claude-plugins-official
   /plugin install typescript-lsp@claude-plugins-official

3. Vyber rozsah
   User = pre teba vo všetkých projektoch · Project = pre celý tím (zapíše sa do .claude/settings.json) · Local = pre teba len v tomto repe.

Odporúčané pluginy pre vibe coding

Správa

/plugin list
/plugin disable nazov@marketplace
/plugin enable nazov@marketplace
/plugin uninstall nazov@marketplace
/reload-plugins                    # po zmene mimo /plugin menu

# Ďalšie marketplaces (komunitný, vlastný)
/plugin marketplace add anthropics/claude-plugins-community
/plugin marketplace add moja-firma/claude-plugins

Štruktúra skillov

# Projekt-level (commitni do gitu, zdieľaš s tímom)
.claude/skills/
├── review/
│   └── SKILL.md        # /review
├── deploy/
│   ├── SKILL.md        # /deploy
│   └── checklist.md    # podporný súbor
└── fix-issue/
    └── SKILL.md        # /fix-issue

# Personal-level (pre všetky projekty)
~/.claude/skills/
└── summarize-changes/
    └── SKILL.md        # /summarize-changes

Názov príkazu je názov adresára. Zmeny v SKILL.md sa prejavia okamžite — bez reštartu session.

Formát SKILL.md — frontmatter

Každý SKILL.md má YAML frontmatter na začiatku a potom inštrukcie:

---
name: deploy
description: Pripraví a otestuje aplikáciu pred releasom. Použi keď chceš vydať novú verziu.
disable-model-invocation: true
allowed-tools: Bash(npm *) Bash(git *)
---

Priprav release:

1. Spusti `npm run test` — ak niečo failuje, zastav a reportuj
2. Spusti `npm run build` — over že build prebehne čisto
3. Skontroluj `git status` — nesmú byť necommitnuté zmeny
4. Navrhni verziu podľa semver (patch/minor/major)
5. Opýtaj sa či môžem pokračovať s tagom a pushom

Kľúčové frontmatter polia

Príklad: skill /review

---
description: Code review aktuálnych zmien. Použi pred každým commitom alebo merge.
allowed-tools: Bash(git diff *) Bash(git status) Bash(npm run test)
---

Vykonaj kompletný code review aktuálnych zmien:

1. Spusti `git diff` a preskúmaj všetky zmenené súbory
2. Skontroluj:
   - Logické chyby a edge cases
   - Bezpečnostné problémy (SQL injection, XSS, citlivé dáta)
   - Výkon (N+1 dotazy, chýbajúce indexy)
   - Dodržanie konvencií z CLAUDE.md
3. Spusti `npm run test`
4. Zhrň nálezy:
   - ✅ Čo je dobré
   - ⚠️ Čo treba zlepšiť
   - ❌ Čo je kritické (blokuje merge)

Príklad: skill s argumentom

---
name: fix-issue
description: Opraví GitHub issue podľa čísla
argument-hint: "[issue-number]"
disable-model-invocation: true
---

Oprav GitHub issue #$ARGUMENTS:

1. Načítaj detaily issue pomocou GitHub MCP nástroja
2. Analyzuj ktoré súbory treba zmeniť
3. Implementuj fix
4. Napíš test pokrývajúci tento bug
5. Vytvor commit: "fix: resolve issue #$ARGUMENTS"

Zavolaj ho ako: /fix-issue 142. Pri viacerých argumentoch použi $0, $1… (napr. /fix-issue 142 hotfix → $0 = 142, $1 = hotfix). Cestu k adresáru skillu dáva ${CLAUDE_SKILL_DIR} — hodí sa na odkazovanie podporných skriptov.

Dynamický kontext — !`príkaz`

Špeciálna syntax !`príkaz` spustí bash príkaz pred tým ako Claude skill dostane — výstup sa vloží priamo do promptu:

---
description: Zhrnie necommitnuté zmeny a upozorní na riziká.
---

## Aktuálne zmeny

!`git diff HEAD`

## Inštrukcie

Zhrň zmeny v 2-3 bodoch. Vypíš riziká (chýbajúce error handling,
hardcoded hodnoty, testy ktoré treba aktualizovať).

Claude dostane skill s reálnym git diff už vloženým — nepotrebuje ho načítavať sám. Ak príkaz môže skončiť nenulovým kódom, pridaj || true, inak sa skill nespustí.

Kde skill uložiť — rozsah platnosti

Vstavané skilly (bundled)

Claude Code obsahuje hotové skilly dostupné vo všetkých projektoch:

Toto je jedna z najčastejšie mätúcich vecí v Claude Code. Všetky tri rozširujú schopnosti Claudu, ale každé inak.

Prehľad rozdielov

Vizuálne vysvetlenie

Rozhodovací strom — čo použiť?

Potrebujem rozšíriť schopnosti Claudu...

→ Claude opakovane robí tú istú chybu / nepozná konvenciu?
    ÁNO → napíš to do CLAUDE.md (alebo .claude/rules/)

→ Je to opakovateľný workflow alebo referenčný materiál?
    ÁNO → použi SKILL (/review, /deploy, /fix-tests)

→ Potrebujem prístup k externej službe (GitHub, DB, Sentry)?
    ÁNO → použi MCP SERVER (alebo plugin, ktorý ho obsahuje)

→ Úloha zahltí kontext veľa súbormi alebo chcem paralelizovať?
    ÁNO → použi SUBAGENT (Explore, Plan, vlastný)

→ Musí sa to stať VŽDY, bez výnimky (lint, blokovanie, notifikácia)?
    ÁNO → použi HOOK

→ Rovnaké nastavenie potrebujem aj v ďalšom repe?
    ÁNO → zabaľ to ako PLUGIN

Kombinovanie všetkých troch

V praxi ich kombinuješ. Príklad komplexného workflow:

---
description: Kompletný release review pred merge do main.
disable-model-invocation: true
---

Vykonaj kompletný release review:

1. Spusti EXPLORE SUBAGENTA, ktorý preskúma všetky
   zmenené súbory a identifikuje potenciálne problémy

2. Pomocou GitHub MCP nástrojov načítaj otvorené issues
   a over či zmeny riešia nejaký z nich

3. Spusti testy a build

4. Zhrň výsledky a navrhni či je kód pripravený na merge

Keď zavoláš /full-review, Claude: vykoná skill → spustí subagenta → použije MCP nástroj — všetko automaticky.

Vstavané typy agentov

Vlastné subagenty — .claude/agents/

Môžeš si definovať vlastných agentov ako Markdown súbory s YAML frontmatter. Claude ich použije automaticky podľa description, alebo ich explicitne zavoláš. Povinné sú len name a description.

---
name: code-reviewer
description: Expertný code reviewer pre kvalitu a bezpečnosť. Použi proaktívne po každej väčšej zmene.
tools: Read, Grep, Glob, Bash
model: sonnet
---

Si senior code reviewer. Fokusuj sa na:
- Kvalitu kódu a čitateľnosť
- Bezpečnostné zraniteľnosti
- Výkonnostné problémy
- Pokrytie testami

Vždy uveď konkrétny súbor a riadok pre každý nález.

Projekt-level: .claude/agents/ (commitni do gitu) · Personal: ~/.claude/agents/ (všetky projekty). Zmeny v súboroch sa prejavia bez reštartu; interaktívne ich vytvoríš aj cez /agents.

Ďalšie užitočné frontmatter polia

Ako subagenta zavolať

# Prirodzeným jazykom – Claude rozhodne
Použi code-reviewer subagenta na kontrolu zmien v auth module

# @-mention – garantuje, že agent pobeží
@agent-code-reviewer pozri sa na zmeny v auth

# Paralelne
Preskúmaj auth, databázu a API moduly paralelne v samostatných subagentoch

# Použiť agenta ako hlavného pre celú session
claude --agent code-reviewer

# Jednorazový agent bez súboru (skripty, CI)
claude --agents '{
  "debugger": {
    "description": "Debugging specialist pre chyby a failing testy.",
    "prompt": "Si expert debugger. Analyzuj chyby a navrhni opravy.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  }
}'

Kedy použiť subagentov?

• Skenovanie kódu — Explore agent prehľadá 50 súborov, tebe vráti 10 riadkov zhrnutia
• Hlučné úlohy — spustenie test suite, kde ťa zaujímajú len failujúce testy
• Paralelné úlohy — napísanie testov + dokumentácia súčasne
• Špecializované role — security reviewer, migration expert s vlastným promptom a lacnejším modelom

Dva systémy pamäte

Auto memory

Claude Code počas práce automaticky ukladá poznatky — keď ho opravíš, potvrdíš prístup alebo mu povieš niečo o projekte, čo nie je v kóde. Nemusíš nič robiť. Ukladá štyri typy poznámok:

• user — tvoja rola, expertíza, pracovné preferencie
• feedback — opravy, ktoré si mu dal, a potvrdené postupy
• project — rozpracované veci, termíny, rozhodnutia mimo kódu
• reference — kde nájsť veci mimo projektu (issue tracker, dashboard)

Preskakuje všetko, čo sa dá odvodiť z kódu, a všetko, čo už je v CLAUDE.md.

~/.claude/projects/<projekt>/memory/
├── MEMORY.md            # Index – jeden riadok na spomienku, načíta sa každú session
├── user_role.md         # Jedna spomienka (načíta sa až keď je potrebná)
├── feedback_testing.md
└── ...

Do session sa načíta iba prvých 200 riadkov / 25 KB súboru MEMORY.md. Detaily sú v samostatných súboroch, ktoré Claude číta podľa potreby. Všetky worktrees toho istého repa zdieľajú jednu pamäť; pamäť je lokálna na tomto počítači.

Vypnutie / presmerovanie auto memory

Najjednoduchšie cez /memory → prepínač auto memory. Alebo v settings:

// Vypnúť auto memory (pre tento projekt)
{ "autoMemoryEnabled": false }

// Vlastná cesta pre ukladanie
{ "autoMemoryDirectory": "~/my-custom-memory-dir" }

// Alebo env premenná: CLAUDE_CODE_DISABLE_AUTO_MEMORY=1

Formát súboru spomienky

Spomienky sú obyčajný markdown — môžeš ich čítať, upravovať aj mazať:

---
name: project-launch
description: Cieľ a termín projektu
metadata:
  type: project
---

E-shop platforma, launch plánovaný na Q1 2027.
Prioritou je checkout flow, admin sa rieši až po launchi.

**Prečo:** Marketing má kampaň naviazanú na termín.
**Ako aplikovať:** Pri návrhoch preferuj rýchle riešenia pre checkout, admin nezdržuj.

MEMORY.md – index spomienok

- [Project launch](project_launch.md) — e-shop, launch Q1 2027, checkout má prioritu
- [User preferences](user_prefs.md) — preferuje krátke odpovede, slovenčina
- [Testing feedback](feedback_testing.md) — vždy spúšťať testy pred commitom, používať pnpm

Vrátenie zmien — /rewind

1. Stlač Esc dvakrát alebo napíš /rewind
   Zobrazí sa zoznam tvojich správ (checkpointov).
2. Vyber bod, kam sa chceš vrátiť
   Napr. správu pred tým, ako Claude začal refaktor, ktorý sa nepodaril.
3. Zvoľ, čo vrátiť
   Kód aj konverzáciu (typické), len kód (Claude si pamätá, čo skúsil) alebo len konverzáciu (zmeny ostanú, kontext sa vyčistí).

Pokračovanie v konverzácii

# Pokračuj v poslednej session v tomto adresári
claude --continue        # alebo: claude -c

# Vyber si zo starších sessions
claude --resume          # alebo: claude -r, alebo /resume v session

# Jednorazový prompt bez interaktívnej session (skripty, CI)
claude -p "Zhrň zmeny v poslednom commite"

V session: /resume otvorí zoznam konverzácií, /fork rozvetví aktuálnu do novej (paralelný experiment), /export uloží prepis do súboru.

Správa kontextu

Keď sa kontext blíži k limitu, Claude Code spustí kompakciu automaticky. CLAUDE.md sa po kompakcii znovu načíta z disku — inštrukcie zadané len v chate sa ale môžu stratiť, preto trvalé veci patria do CLAUDE.md.

Práca na pozadí

• Ctrl+B — presunie bežiaci príkaz alebo subagenta na pozadie, ty pracuješ ďalej
• /tasks — prehľad všetkého, čo beží na pozadí
• /loop 10m /code-review — opakované spúšťanie v intervale
• Správy môžeš písať aj kým Claude pracuje — zaradia sa do fronty

Ako formulovať úlohy

Zlaté pravidlá vibe codingu

1. Začni s Plan mode
   Pre každú väčšiu zmenu najprv nechaj Claudu naplánovať — až potom implementovať. Prepni Shift+Tab na plan alebo napíš /plan. Viď Plan mode & povolenia.
2. Malé kroky, časté potvrdenia
   Nechaj Claudu robiť malé zmeny, nie celý refactor naraz. Po každom kroku over výsledok a commitni.
3. /code-review pred každým commitom
   Príkaz /code-review spustí review aktuálnych zmien — Claude sám nájde problémy. Pre citlivý kód pridaj /security-review.
4. Keď sa to pokazí — Esc Esc
   Nesnaž sa opravovať zlý refaktor ďalšími promptmi. Vráť sa cez /rewind na checkpoint pred ním a zadaj úlohu lepšie.
5. Buď explicitný ohľadom kontextu
   Povedz mu čo si práve videl, aká je chyba, aký je cieľ. Súbory vkladaj cez @cesta, chybové výstupy cez !príkaz, screenshoty vlož zo schránky (Ctrl+V).
6. Používaj CLAUDE.md
   Keď Claude urobí tú istú chybu druhýkrát, zapíš to do CLAUDE.md. Je to tvoj najvýkonnejší nástroj.
7. Nech si Claude výsledok sám overí
   Pýtaj: „spusti testy“, „otvor stránku a over, že formulár funguje“ (/verify, Playwright MCP alebo Chrome). Claude s možnosťou overenia robí výrazne menej chýb.

Efektívne prompty — šablóny

Pridanie novej funkcie

Pridaj funkciu [POPIS] do [SÚBOR/MODUL].
Požiadavky:
- [Požiadavka 1]
- [Požiadavka 2]
Neupravuj iné súbory ako [zoznam povolených].
Na záver spusti testy.

Oprava bugu

V súbore @[SÚBOR] na riadku [ČÍSLO] sa vyskytuje chyba:
[CHYBOVÁ SPRÁVA]

Reprodukcia: [kroky na reprodukciu]
Očakávané správanie: [čo má robiť]
Aktuálne správanie: [čo robí]
Najprv napíš test, ktorý bug reprodukuje, potom ho oprav.

Refaktorovanie

Refaktoruj [SÚBOR/FUNKCIA] pre lepšiu [čitateľnosť/výkon/testovateľnosť].
Zachovaj rovnaké API a správanie.
Nepridávaj nové funkcie.
Over, že všetky existujúce testy prechádzajú.

Klávesové skratky v Claude Code

Skratky si vieš prispôsobiť cez /keybindings.

Chyby pri nastavení

Chyby pri používaní

Cost management

• Sleduj spotrebu cez /usage, obsah kontextu cez /context
• Používaj /compact pri dlhých sessionách a /clear pri novej úlohe
• Pre skenovanie kódu používaj Explore subagentov — nezaťažujú tvoj kontext
• Prepínaj model podľa úlohy: /model haiku pre jednoduché, sonnet na bežný vývoj, opus na náročné; /effort low pre triviálne úlohy
• Subagentom daj lacný model cez model: haiku vo frontmatteri
• Skilly so side-efektmi označ disable-model-invocation: true — ich popis potom nezaberá kontext
• API účet: nastav spending limit na platform.claude.com

Keď niečo nefunguje

# Verzia a stav inštalácie, auto-update, chyby v settings
claude --version
claude doctor

# Aktualizácia na najnovšiu verziu
claude update

# Spustenie s debug logom (log: ~/.claude/debug/<session-id>.txt)
claude --debug

V session: /status (účet, model, adresár), /doctor (diagnostika + návrhy opráv), /mcp (stav serverov), /context (či sa načítal CLAUDE.md), /bug (nahlásenie chyby Anthropicu).