Publikováno před 11 dny

Prvních 30 minut s Claude Code (pro lidi, co nikdy neprogramovali)

Tři nastavení, bez kterých je Claude Code jako taxikář bez adresy. Záchranná síť jménem Git, soubor CLAUDE.md, co z AI udělá snesitelného kolegu, a proč první projekt nemá být ta aplikace, o které sníte půl roku. Checklist pro první půlden.

Tři nastavení, bez kterých je Claude Code jako taxikář bez adresy. Tenhle článek je tvůj checklist pro první půlden vibecodingu: nastavíš si CLAUDE.md, zapneš Git jako záchrannou síť a naučíš se zadávat úkoly tak, aby je Claude splnil správně. Předpokládám, že Claude Code už máš nainstalovaný. Pokud ne, tady je návod na instalaci.

Jak nastavit CLAUDE.md: soubor, který změní všechno

Tohle je ta nejdůležitější věc hned na začátek.

CLAUDE.md je textový soubor, který si Claude Code přečte pokaždé, když s ním začneš pracovat. Představ si ho jako briefing, který dáš novému kolegovi první den v práci. Bez něj bude Claude předpokládat, že jsi programátor, a bude se podle toho chovat. Bude mluvit v technickém žargonu a nebude dostatečně vysvětlovat co dělá. Což je recept na katastrofu, když nerozumíš kódu.

Řekni Claude Code:

Do globálního CLAUDE.md si zapiš toto:

# Kdo jsem
Jsem neprogramátor. Neumím číst ani kontrolovat kód.
Všechna technická rozhodnutí mi vysvětli jednoduše, bez žargonu.
Když se mám rozhodnout, ukaž možnosti s pro/proti a doporuč jednu.

# Jak pracuj
- Po každé změně shrň, co jsi udělal a proč, lidsky
- Když se něco rozbije, nejdřív vysvětli co se stalo, pak navrhuj opravu
- Do kódu piš komentáře vysvětlující, co která část dělá
- Změny dělej malé, jednu po druhé

# Bezpečnost
- Neměň architekturu bez mého souhlasu
- Nemaž soubory bez ptaní
- U úkolů s víc kroky mi nejdřív ukaž plán a počkej na schválení

A průběžně si CLAUDE.md vylaďuj. Všimneš si, že Claude opakovaně dělá něco, co nechceš? Řekni mu, ať do CLAUDE.md zapíše nové pravidlo. Tenhle soubor je živý dokument, ne náhrobní kámen.

Ale měj na paměti tohle:

  • Stručnost. CLAUDE.md musí být krátký. Když napíšeš román, důležité pokyny se ztratí v šumu. Každý řádek si musí zasloužit místo. Ptej se: udělal by Claude bez tohoto řádku chybu?
  • Konkrétnost. „Buď opatrný“ Claude ignoruje. „Nemaž soubory bez ptaní“ respektuje. Piš příkazy, ne zbožná přání.

Git: Záchranná síť, bez které nezačínej

Git je věc, bez které Claude Code na Windows vůbec nefunguje. Měl by být součástí instalace, ale pokud ho ještě nemáš, vrať se k návodu na instalaci. A pak řekni Claudovi tohle:

„Inicializuj Git repozitář a po každé větší změně vytvoř commit se srozumitelnou zprávou v češtině.“

Nemusíš vědět, co je Git. Nemusíš umět žádné příkazy. Stačí vědět jedno: Git si pamatuje každou verzi tvých souborů. Je to jako nekonečné undo, ale pro celý projekt. Když Claude jednoho dne něco rozbije – a rozbije, to ti garantuju –, řekneš mu „vrať to zpátky, včera to fungovalo“ a on to vrátí.

Bez Gitu bys plakal. S Gitem řekneš „ups“ a jedeš dál.

A pokud chceš tu historii změn i vidět, ne jen vědět, že existuje, nainstaluj si GitHub Desktop. Je to aplikace, ve které přehledně uvidíš, co se kdy změnilo, a můžeš se ke starší verzi vrátit jedním kliknutím.

Začni s něčím malým, ne s aplikací snů

Vím, je to lákavé. Máš k dispozici mocný nástroj a chceš rovnou postavit web nebo aplikaci, o které přemýšlíš už půl roku. Ale stejně jako bys poprvé za volantem nejel rovnou na dálnici, začni na parkovišti.

Tři skvělé první úkoly:

Organizace souborů:

„Přejmenuj všechny fotky v téhle složce podle data pořízení, formát YYYY-MM-DD.“

Analýza dat:

„Otevři tenhle CSV soubor a řekni mi, kolik je tam unikátních emailových adres a které se opakují nejčastěji.“

Jednoduchá automatizace:

„Projdi tuhle složku, všechny PDF slouč do jednoho souboru, seřazené podle názvu.“

Proč zrovna tohle? Protože u malých úkolů okamžitě vidíš výsledek. Fotky se přejmenovaly? Funguje. CSV má 342 emailů? Můžeš si to ověřit ručně. Tohle je tvůj kalibrační test. Zjistíš, jak Claude přemýšlí, jak reaguje na tvoje instrukce a jak moc musíš kontrolovat výsledek.

(Spoiler: kontrolovat musíš vždycky. Ale o tom za chvíli.)

Víc ukázek najdeš v článku Co všechno umí Claude Code, zdaleka to není jen programování.

Jak Claudovi zadávat úkoly, aby je splnil správně

Stačí jeden vzorec:

Co chci + Proč to chci + Jaká mám omezení

Špatně:

„Udělej mi web.“

Dobře:

„Chci jednoduchou stránku pro mou cukrárnu, protože zákazníci pořád volají a ptají se na ceny, místo aby se podívali online. Úvodní strana s fotkami dortů, ceník a kontaktní formulář. Použij čisté HTML, CSS a JavaScript, žádné frameworky. Design světlý, moderní, přizpůsobený mobilům.“

První zadání je jako říct taxikáři „jeď“. Druhé mu dává adresu, kudy nechceš jet, a že máš alergii na osvěžovač ve tvaru stromečku.

Pár tipů, co fungují:

  • Říkej proč, ne jen co. „Přidej kontrolu toho políčka“ je horší než „Přidej kontrolu telefonního čísla, protože lidi píšou nesmysly a pak se diví, že jim nepřišla odpověď.“ Když Claude zná důvod, udělá lepší rozhodnutí.
  • Jeden úkol = jedna konverzace. Nemíchej „oprav formulář“ s „a taky změň barvy a přidej blog“. Když do jedné konverzace nacpeš všechno, Claude se v tom začne motat jako turista v pražských uličkách. Nemusíš kvůli tomu Claude Code zavírat a spouštět znovu – stačí napsat /clear a začneš s čistým stolem.
  • Když nerozumíš, ptej se. „Vysvětli mi to jednoduše a doporuč, co mám vybrat.“ Nemusíš rozumět kódu. Musíš rozumět rozhodnutím, která se dělají.

Jakou technologii zvolit, když budeš stavět web

Když vibecoduješ, AI generuje dramaticky lepší kód pro některé technologie než pro jiné, prostě proto, že se na nich víc naučila. Tahle volba má obrovský dopad na výsledek a neprogramátor ji nemůže udělat informovaně. Tak tady je tahák:

Jednoduchý web bez přihlašování (vizitka, portfolio, landing page):

→ „Použij čisté HTML, CSS a JavaScript. Bez buildování, žádný npm.“
→ Výsledek hostuj zdarma na Netlify. Nula konfigurace, nula korun.

Interaktivní nástroj jen pro sebe (dashboard, kalkulačka, zpracování dat):

→ „Použij Python.“
→ Python je nejčitelnější programovací jazyk a AI v něm generuje skvělý kód. Pro osobní nástroje úplně stačí. Claude ti vytvoří skript, který spustíš jedním příkazem.
→ Řekni Claude Code: „Nainstaluj mi nejnovější Python a nastav ho tak, aby fungoval s češtinou.“ Claude pozná tvůj operační systém a nainstaluje ho správně.

Cokoliv s uživateli, platbami nebo citlivými daty:

→ Najmi vývojáře. Vážně. Tohle není oblast na experimenty.

Kdy to můžeš dát na internet – a kdy radši ne

Tady přichází otázka, která odděluje nevinné hraní od reálného průšvihu: používá tvoje aplikace databázi?

Pokud všechna data žijí v prohlížeči (na počítači toho, kdo aplikaci otevře), nemáš se čeho bát. Nikdo cizí se k nim nedostane, protože nikde jinde nejsou. Osobní web, portfolio, kalkulačka, plánovač, poznámkovník, to všechno klidně hoď na internet. I kdyby kód nebyl dokonalý, nejhorší, co se stane, je, že stránka bude ošklivá.

Jakmile ale do hry vstoupí databáze (a tím myslím jakýkoliv server, kam se ukládají data od uživatelů), situace se radikálně mění. Databáze je sejf. A stavět sejf bez toho, abys rozuměl bezpečnosti, je jako hrát si se střelným prachem podle návodu na YouTube.

Co se může stát? Nic teoretického. Seznamovací aplikace Tea byla vytvořená neprogramátory. Únik 72 000 fotek občanských průkazů skončil na 4chanu. Sociální síť Moltbook se chlubila tím, že „nezapsali jediný řádek kódu“. Přístupový klíč k databázi byl viditelný přímo ve zdrojovém kódu stránky. Stačilo zmáčknout F12.

Takže jednoduchý tahák:

Klidně dej online:

  • Osobní web, portfolio, blog
  • Kalkulačka, plánovač, poznámky, cokoliv, kde data zůstávají v prohlížeči
  • Prototyp pro ověření nápadu (ale ne pro ostrý provoz s reálnými uživateli)

Tady potřebuješ vývojáře:

  • Cokoliv s přihlašováním uživatelů
  • Cokoliv s platbami
  • Cokoliv, kde ukládáš data cizích lidí do databáze
  • Cokoliv, co chceš prodávat jako službu

Máš nápad na aplikaci s databází? Skvělé. Navibecoduj si prototyp, ukaž ho lidem, ověř, jestli o to někdo stojí. A pak si najdi vývojáře, který z toho udělá bezpečný produkt. Prototyp ti ušetří měsíce vysvětlování a spoustu peněz. Ale nikdy ho nenasazuj do ostrého provozu tak, jak vypadl z AI.

Kolik to stojí a může mi to rozbít počítač?

Peníze. Claude Code funguje v rámci předplatného Claude, což je konkurent ChatGPT. Základní plán Pro za 20 dolarů měsíčně ti dá prostor to osahat. Přihlásíš se a jedeš. Když začneš stavět něco většího, narazíš na strop, ale neboj, Claude ti řekne něco jako „pokračujeme za dvě hodiny“ a po pauze jedeš dál. Pokud ti čekání nevyhovuje, je tu tarif Max za 100 dolarů. Pořád nic oproti sazbám programátorů.

Bezpečnost tvého počítače. Claude Code pracuje přímo s tvými soubory, to je fakt. Než udělá cokoliv destruktivního, ukáže ti, co chce provést, a čeká na tvoje schválení. Ale to neznamená, že můžeš odklikávat všechno poslepu. Čti, co ti navrhuje. Nerozumíš tomu? Zeptej se ho, co přesně ta změna udělá.

David Grudl Programátor, blogger a AI evangelista. Vytvořil Nette Framework používaný statisíci webů. Píše na Uměligence o umělé inteligenci a phpFashion o webovém vývoji. Každý týden moderuje Tech Guys a učí lidi pracovat s ChatGPT a dalšími AI nástroji. Fascinují ho technologie, které mění náš svět, a rád je přibližuje široké veřejnosti.