Vibe coding: od ideje do objavljenega projekta

Kaj je vibe coding

Pojem je 6. februarja 2025 definiral Andrej Karpathy (soustanovitelj OpenAI, prej vodja AI pri Tesli) v eni objavi:

“There's a new kind of coding I call “vibe coding”, where you fully give in to the vibes, embrace exponentials, and forget that the code even exists. […] I “Accept All” always, I don't read the diffs anymore. When I get error messages I just copy paste them in with no comment, usually that fixes it. […] I'm building a project or webapp, but it's not really coding — I just see stuff, say stuff, run stuff, and copy paste stuff, and it mostly works.”

Simon Willison (soavtor ogrodja Django) je pojem razmejil od resnega dela:

“If an LLM wrote the code for you, and you then reviewed it, tested it thoroughly and made sure you could explain how it works to someone else — that's not vibe coding, it's software development.”

Za disciplinirano različico je oktobra 2025 skoval svoj izraz: vibe engineering — »seasoned professionals accelerate their work with LLMs while staying proudly and confidently accountable for the software they produce«. Ta vodič uči to: agent piše kodo, ti ostaneš odgovoren za rezultat.

Kako agent dela

Programerski agent (ang. coding agent) ni pogovorno okno, ki predlaga kodo. Je program, ki bere tvoje datoteke, jih ureja, poganja ukaze in bere lastne napake — v zanki, dokler naloga ni opravljena:

Prav ta zanka je razlog, da je metoda uporabna. Model ne ugiba, kaj bi delovalo — zažene in vidi.

Kaj lahko zgradiš in česa ne

To je najpomembnejše poglavje na strani. Če ga upoštevaš, ti bo metoda prinesla veliko koristi; če ga ne, boš izgubil čas ali objavil nekaj nevarnega.

Primer, ki pojasni razliko

FibreCalc je kalkulator za jeklena vlakna v betonu: iz površine ali prostornine plošče izračuna maso vlaken, število škatel, palet in ceno po standardu EN 14889-1. Nastal je z enim promptom. Avtorju prihrani približno deset ročnih izračunov na projekt.

Zakaj deluje: naloga ima jasno določen vhod, znano formulo in preverljiv izhod. Ni uporabniških računov, ni baze, ni osebnih podatkov. Rezultat lahko preveriš s svinčnikom. Točno to je tip naloge, pri katerem je metoda najbolj donosna.

Nasprotni primer: ista stran s prijavo strank, shranjenimi ponudbami in plačilom bi zahtevala varnostni pregled, ki ga model sam ne opravi zanesljivo. Prva različica bi verjetno delovala. Prav to je nevarno.

Kje je meja v praksi

Anketa Stack Overflow 2025 najpogosteje navaja isto težavo — 66 % razvijalcev omenja rešitve, ki so »almost right, but not quite«. Zato je preverjanje del metode in ne dodatek k njej. Kdo preverja, določa doseg: za interno orodje zadošča, da sam preveriš izhod; za javni izdelek potrebuješ nekoga, ki zna prebrati kodo.

Kaj ljudje gradijo

Po analizi objav na Redditu (r/vibecoding, r/ClaudeAI, r/ChatGPTCoding) se največ dela vrti okoli internih orodij, prototipov, predstavitvenih strani in osebnih projektov — ne okoli velikih izdelkov. Najpogosteje omenjeni orodji sta Claude Code in Cursor; pogost potek je hiter prototip v brskalniškem orodju (Lovable, Bolt), nato prehod v Claude Code ali Cursor za resnejše delo (analiza omemb).

Karpathy zgradi celo spletno aplikacijo

Avtor pojma je po metodi zgradil pravo aplikacijo MenuGen: »You take a picture of a menu and it generates images for all the menu items.« Ni spletni razvijalec; kodo sta napisala Cursor in Claude. Njegov zapis o izkušnji je koristnejši od aplikacije:

“I didn't even spend all that much work in the code editor itself. I spent most of it in the browser, moving between tabs and settings and configuring.”

Nauk: pisanje kode ni več ozko grlo. Ozko grlo je lepilno delo (ang. glue work) — prijava, plačila, ključi, domene, nastavitve. Tega model ne opravi namesto tebe, ker zahteva tvoj račun in tvojo odločitev.

227 orodij Simona Willisona

Willison javno vzdržuje zbirko tools.simonwillison.net: 227 majhnih spletnih orodij, skoraj vsa zgrajena z LLM. Najbolj poučen je kolofon (ang. colophon, seznam nastanka): pri vsakem orodju so navedena sporočila commitov, mnoga pa povezujejo na cel prepis pogovora z modelom. Koda je odprta na GitHubu. Če hočeš videti, kako je stvar v resnici nastala, je to najboljši prosto dostopen material.

Uradni katalog primerov uporabe

Za nekodirna opravila je hitrejša pot kot ugibanje katalog primerov uporabe po vlogah (inženiring, podatki, raziskave, marketing, finance, kadri, pravo). Primeri kot »Build a daily briefing across your tools«, »Analyze patterns in user feedback« in »Forecast & scenario modeling« so opisani s koraki.

Avtorjevi projekti

Vse spodnje je zgradil strojni inženir (ne poklicni programer), večinoma s programerskimi agenti. Povezave so žive — odpri in preizkusi.

FibreCalc — kalkulator, ki se je izplačal v eni uri

fibrecalc.com · Iz površine ali prostornine betonske plošče izračuna maso jeklenih vlaken, število škatel in palet ter ceno, po standardu EN 14889-1. Deluje brez prijave in tudi brez povezave. Preveden je v štiri jezike.

Zgrajen z enim promptom. Nadomesti približno deset ročnih izračunov na projekt. Najbolj poveden podatek: naloga je bila povsem določena že pred pisanjem — formula je znana, vhodi so števila, izhod je preverljiv.

Clay Studio — generativno oblikovanje za 3D-tisk gline

gcode.pages.dev · Parametrično oblikovanje posod (ang. generative design): premer, višina in valovitost stene se nastavljajo z drsniki, orodje pa izpiše G-kodo — ukazni jezik, ki ga tiskalnik neposredno bere. Namenjeno velikemu glinenemu tiskalniku Delta WASP 40100.

Zanimivo, ker rezultat ni spletna stran, ampak fizičen, žgan predmet. Napaka v kodi se pokaže kot padla posoda, ne kot sporočilo v konzoli.

DK Lab — osem orodij, vsako en popoldan

claudeartifacts.pages.dev · Zbirka majhnih spletnih aplikacij: dostop do senzorjev telefona, prenos slike prek WebRTC (neposredna povezava med brskalnikoma), jezikovna in referenčna orodja.

Praktičen dokaz teze iz poglavja o dosegu: osem uporabnih malenkosti je lažje in bolj donosno kot en velik izdelek.

Board Game Rules — pravila s QR-kodo na škatli

boardgamerules.pages.dev · Dvojezičen arhiv pravil za 24 predelanih namiznih iger. Vsaka škatla nosi QR-kodo, ki odpre svoja pravila. Digitalni del je povezan s fizično izdelavo — pravila, tisk in škatla so en projekt.

Ljubljana Bulletin — dnevnik, ki izhaja sam

ljubljana.pages.dev · Turistični bilten v slogu starega časopisa. Sam pobere dogodke z izbranih strani (ang. scraping), jih uredi in objavi vsak dan brez ročnega koraka.

Nastal je iz enega prompta — natisnjen je v poglavju Načini dela. Najboljši primer prehoda z naročila po urniku na samostojen izdelek.

Nightona US&A — arkadna dirkalna igra

nightona.pages.dev · Dirkanje v brskalniku na Three.js (3D-grafika v brskalniku): nagnjen oval, proceduralno generirane proge, AI-vozniki. Gradnja se je začela z enim avtom in merilcem kroga; promet je bil dodan v paketih, ob merjenju hitrosti sličic.

Šolski primer postopne gradnje: najprej najtežji del (vožnja, ki je prijetna), šele nato obseg.

TileGroove — glasbilo iz natisnjenih ploščic

tilegroove.pages.dev · Kamera prepoznava natisnjene oznake (ang. computer vision); vrsta ploščice izbere zanko ali efekt, njen položaj, zasuk in prekritost pa spreminjajo zvok v brskalniku.

Dobra šola dela z agentom, ker je povratna zanka takojšnja: premakneš ploščico in takoj slišiš, ali koda dela.

ScalePrint AR — predogled tiska v naravni velikosti

view3d.pages.dev · Naloži datoteko STL ali 3MF in jo prek WebXR (obogatena resničnost v brskalniku) postavi v prostor v pravem merilu. Odgovori na vprašanje »ali bo to sploh šlo skozi vrata«, preden porabiš filament.

Triviador — platforma za pub kviz

triviador.pages.dev · Banka vprašanj in sinhronizirani podkvizi, ki tečejo na statičnem gostovanju — brez strežnika in baze. Primer, kako se z omejitvijo doseže preprostost in ničelen strošek.

XIANO — sintetizator z lastnim vezjem

GitHub · Kompakten elektro-mehanski sintetizator. Lastno tiskano vezje (ang. PCB) s kapacitivno klaviaturo — tipke zaznavajo dotik prek spremembe kapacitivnosti, brez mehanskih stikal. Strojna programska oprema (ang. firmware) teče na mikrokontrolerju Seeed XIAO.

Pokaže, da agent ni omejen na splet: piše tudi kodo za branje senzorjev in generiranje zvoka v realnem času na napravi z nekaj kilobajti pomnilnika.

Marine Aid — varnost na morju z eno kamero

GitHub · Sistem na Raspberry Pi, ki z eno samo kamero nadzoruje okolico plovila. Sliko obdela s segmentacijo (ang. single-camera segmentation) — vsak slikovni element se uvrsti v razred (voda, obala, plovilo, ovira) — in na podlagi tega opozarja.

Najzahtevnejši projekt v zbirki: združuje strojno opremo, računalniški vid in obveščanje. Hkrati najlepši primer internega orodja, kjer si sam uporabnik, sam preizkuševalec in sam odgovoren.

Uporaba v službi

Vsi primeri sodijo v kategorije, ki jih dokumentira Claude Academy: podatki, inženiring, raziskave, avtomatizacija, metrike.

• Gradnja tujih programov. Agent prenese odprtokodno orodje, ga prevede (ang. compile) in doda tvoj popravek (ang. patch). Delo, ki je prej pomenilo teden branja tujih navodil za gradnjo.
• Firmware. »ESP32 naj bere senzor vsakih 10 s in shrani meritve v CSV« je rutina, vključno z vezavo pinov (ang. pinout).
• Pregled literature (ang. literature review). Sito po člankih, izvlečki metod in rezultatov, primerjalne tabele s citati. Citate odpri in preveri.
• Meritve in poročila. Skripta očisti surove CSV-je, izriše grafe in napiše osnutek komentarja. Sklep potrdiš ti.
• Skripte za drobna opravila. Preimenovanje 400 datotek po vzorcu, združevanje PDF-jev, Excelove formule in makri, pretvorbe formatov.
• Enonamenske aplikacije. Klikač-števec (ang. tally counter) za štetje dogodkov med meritvijo, obrazec za vnos vzorcev, časovnik protokola. Pol ure dela.
• Metrike. Skripta prebere tedenski izvoz in izriše ključne kazalnike (ang. KPI) na eno stran.

Orodja, ki jih agent že pozna: DuckDB (analitični SQL nad lokalnimi datotekami, brez strežnika), Polars ali pandas za tabele, Jupyter za raziskovanje, Streamlit za vmesnik za sodelavce.

Začetek: tri odločitve

To je najkrajša pot od nič do prvega delujočega rezultata. Vse ostalo v tem vodiču je podrobnost k tem trem korakom.

1. Izberi ponudnika

   Preizkusi ChatGPT, Claude in Gemini na treh ali štirih svojih nalogah: eno pisanje, ena naloga s podatki, en dokument ali posnetek zaslona in ena majhna programerska naloga. Uporabi brezplačne različice (ang. free tier).

   Izberi tistega, čigar odgovore najpogosteje obdržiš brez večjih popravkov. Ne odločaj se po lestvicah — glej Izbira modela.

2. Izberi način dela

   Za vprašanja in kratke preobrazbe uporabi pogovor. Za nalogo nad več datotekami Work/Cowork. Za projekt, ki ga je treba urejati in poganjati, programerskega agenta. Za ponavljajoča se opravila urnik.

   Podrobno v poglavju Načini dela in orodja.

3. Začni z delom

   Napiši jasno, kaj hočeš in na kakšen način. To je edina veščina, ki jo moraš zares obvladati. Dobra prva zahteva odgovori na štiri vprašanja:

   • Kaj naj naredi — funkcija v enem stavku.
   • Kaj gre noter in kaj ven — vhodi, izhodi, enote, formati.
   • Kako naj izgleda in se obnaša — brez prijave, deluje na telefonu, brez povezave.
   • Česa naj ne počne — brez baze, brez zunanjih knjižnic, brez uporabniških računov.

   Primer take zahteve — po njej je nastal FibreCalc:

   Naredi spletni kalkulator za jeklena vlakna v betonu.
   
   Vhod:  površina plošče (m2) ali prostornina (m3), debelina,
          doziranje (kg/m3), masa škatle, cena na kg.
   Izhod: skupna masa vlaken, število škatel, število palet, cena.
          Preračun sproti, brez gumba "izračunaj".
   
   Ena stran, brez prijave in brez baze.
   Mora delati na telefonu in brez povezave.
   Poimenovanje po standardu EN 14889-1.
   Število škatel zaokroži navzgor na celo škatlo.

   Nato preveri rezultat. Pri kalkulatorju izračunaj en primer na roko. Pri obdelavi podatkov primerjaj nekaj vrstic z znanim odgovorom. Če izhoda ne moreš preveriti, naloga še ni pravilno zastavljena.

Brezplačni uradni tečaji, če imaš raje voden pouk: Claude Academy (Claude 101 → Claude Code in Action), OpenAI Academy, Google AI Essentials, GitHub Skills.

Načini dela in orodja

Isti model dobiš skozi štiri različne vmesnike. Izbira vmesnika vpliva na rezultat bolj kot izbira modela.

Zakaj je lokalni agent drugačen

Claude Code in Codex sta programa, ki ju poženeš v terminalu v mapi svojega projekta. To ni kozmetična razlika:

• Vidi resnične datoteke. Ne ugiba po opisu — prebere, kar dejansko imaš.
• Poganja tvoje ukaze. Gradnjo, teste, skripte. In prebere, kar mu vrnejo.
• Popravlja lastne napake. Zanka teče brez tebe, dokler test ne uspe.
• Podatki ostanejo pri tebi. V oblak gre le tisto, kar agent dejansko prebere, ne cela mapa.
• Dela z Gitom. Vidi zgodovino, ustvarja commite, primerja različice.
• Vključen je v naročnino. Ne plačaš ga posebej — glej Naročnina proti API.

Anthropic priporoča, da agentu daš preverjanje, ki ga lahko požene sam — test, gradnjo, posnetek zaslona za primerjavo: »It's the difference between a session you watch and one you walk away from.« (Claude Code best practices)

Veščine (ang. skills)

Ko istega navodila ne želiš znova lepiti v pogovor, ga shraniš kot veščino: mapa z datoteko SKILL.md, v kateri je postopek zapisan enkrat za vselej. Agent jo uporabi, ko je potrebna, ali pa jo pokličeš sam z /ime-veščine.

Prednost pred pisanjem vsega v CLAUDE.md: vsebina veščine se naloži šele ob uporabi, zato dolga navodila ne zasedajo konteksta, dokler jih ne potrebuješ (dokumentacija). Tipične veščine: postopek objave, kontrolni seznam pregleda, hišna pravila za sloge, format poročila.

Opravilo po urniku brez kode

Najhitrejši donos za nekoga, ki ne programira. Opravilo samo opišeš — surovo, brez leporečja:

every day at 8.00 search bolha for e-mtb and give me a curated list
of current best offers, what makes them stand out and what I should
be careful about and how they compare to other current and past offers

Vzorec deluje za Bolho, Avto.net, nepremičnine, razpise in letalske karte. Drugi resnični prompt, iz katerega je nastal Ljubljana Bulletin:

create a retro-looking ljubljana bulletin for tourist in style of
new york times that scrapes events from xx.dsd, yy.com, ztz.com websites,
curates them and publishes them daily

Anthropic isto načelo priporoča tudi razvijalcem: »find the simplest solution possible, and only increasing complexity when needed« (Building effective agents). Aplikacijo gradi šele, ko opravilo po urniku ne zadošča.

Izbira modela

Ne izbiraj po lestvicah (ang. benchmarks). Sestavi lasten testni komplet iz dela, ki ga zares opravljaš, in primerjaj izide. Spodnje razlike so povzetek objavljenih primerjav in izkušenj skupnosti.

Velika trojica v praksi

Katera stopnja modela

Vsak ponudnik ima tri stopnje. Razlika v ceni med njimi je petkratna ali večja:

• Hitri/mali model (Haiku, mini) — povzetki, klasifikacija, preproste pretvorbe. Za kodo prešibak.
• Privzeti model (Sonnet, glavni GPT, Gemini Pro) — tu opravi delo velika večina uporabnikov. Začni tu in ostani, dokler ni razloga za drugače.
• Vrhunski model (Fable/Opus, Deep Think) — velike migracije, težko sklepanje, naloge, pri katerih privzeti večkrat zaporedoma odpove. Bistveno počasnejši; pri naročnini porabi omejitve približno petkrat hitreje.

Celoten pregled trga

Cene: EU, avgust 2026, približne in brez DDV. Pred plačilom odpri povezani cenik.

Namenska orodja: Perplexity (iskanje s citati; citate odpri in preveri), NotebookLM (odgovori izključno iz naloženih virov), Elicit in Consensus (znanstvena literatura), Lovable in Bolt (prototip v brskalniku, brez namestitve).

Naročnina proti API

Najdražja začetniška napaka ni izbira napačnega modela. Je plačevanje API-ja za delo, ki sodi v naročnino.

Pogosta zmota: »plačujem ChatGPT Plus, torej je moja integracija brezplačna«. Ni. To sta ločena računa in ločena obračuna. Naročnina ne pokriva API-ja.

Druga zmota: »Claude Code je dodatno plačljiv«. Ni — Claude Code in Codex delujeta v okviru navadne naročnine (Pro, Max, Plus). Prav zato je naročnina za večino ljudi pravi odgovor.

Kontekstno okno

Če razumeš samo eno tehnično stvar iz tega vodiča, naj bo to. Skoraj vse dobre prakse so posledica te ene omejitve:

“Most best practices are based on one constraint: Claude's context window fills up fast, and performance degrades as it fills.”

Kontekstno okno (ang. context window) je vse, kar model pri trenutni nalogi hkrati upošteva: tvoja sporočila, njegovi odgovori, vsebina prebranih datotek in izpisi ukazov. Meri se v žetonih (ang. tokens) — koščkih besedila, približno tri četrtine besede.

Ni pomnilnik, ki bi se praznil sam. Med pogovorom samo raste. Ena sama seja razhroščevanja lahko porabi deset tisoče žetonov. Ko se okno polni, model začne pozabljati zgodnja navodila in delati več napak — dolgo za tem, ko ti misliš, da je vse v redu.

Kako z njim ravnati

• Ne vleci pogovorov predolgo. Ko je naloga opravljena, začni novo sejo. Dolg pogovor ni prihranek — je breme, ki ga model nosi pri vsakem naslednjem odgovoru.
• Naredi čim več v enem promptu. Preglej rezultat v celoti, zberi vse, kar te moti, in pošlji naenkrat. Deset sporočil po eno pripombo stane bistveno več žetonov kot eno sporočilo z desetimi pripombami — vsako namreč znova vleče s seboj vso dosedanjo zgodovino.
• Stalna pravila zapiši v datoteko. AGENTS.md ali CLAUDE.md namesto ponavljanja v vsakem promptu. Daljše postopke shrani kot veščino, ki se naloži šele ob uporabi.
• Pošiljaj izseke, ne celote. Razliko (ang. diff), ime datoteke in neuspeli del dnevnika — ne celega projekta in ne 20.000 vrstic izpisa.
• Med nepovezanimi nalogami počisti. V Claude Code je to /clear; drugod nov pogovor.
• Uporabi podagente za raziskovanje. Podagent (ang. subagent) prebere sto datotek v svojem kontekstu in ti vrne le povzetek. Tvoje okno ostane prazno za delo.

Naročniški paketi štejejo porabo v žetonih, zato je varčevanje s kontekstom hkrati varčevanje z omejitvami. Nered v kontekstu je najpogostejši razlog, da agent »nenadoma postane neumen«.

Workflow

Postopek, ki preživi prvi demo. Prvi trije koraki so priprava in o rezultatu odločijo bolj kot vsi ostali skupaj.

1. Opis na eno stran

   Zapiši uporabnika, problem, vhode, izhod, omejitve in merila končanosti (ang. definition of done). Dodaj, kaj je izrecno zunaj obsega. Predloga: PROJECT-BRIEF.md.

2. Skica toka

   Skiciraj zaslone in tok podatkov v Excalidrawu. Arhitekturo zapiši besedilno z Mermaidom, da živi v projektu in se spreminja s kodo.

3. Navodila projektu

   Napiši kratek AGENTS.md ali CLAUDE.md: tehnologije, ukazi, ključne datoteke, prepovedi. Vključi samo tisto, česar model ne more razbrati iz kode.

4. Načrt pred posegom

   Anthropic priporoča štiri faze: razišči → načrtuj → izvedi → commitaj. Agent najprej samo bere in odgovarja, brez sprememb. Šele potrjen načrt sproži pisanje. Izjema: »If you could describe the diff in one sentence, skip the plan.«

5. Ena cela pot

   Zgradi eno celotno pot skozi sistem — od vhoda do izhoda — z resničnimi podatki. Resnični CSV ima tri formate datuma in decimalno vejico; testni jih nima.

6. Zaženi in preveri

   Agent požene gradnjo in teste. Izhod preveri sam: posnetki zaslona za vmesnik, znani odgovori za podatke, en ročni izračun za kalkulator.

7. Revizija po deltah

   Povej, kaj je narobe, kaj mora ostati nespremenjeno in kako se uspeh preveri. Ne reci samo »naredi lepše«.

8. Shrani delujoče stanje

   Naredi commit pred tveganim posegom in po vsaki delujoči funkciji. Brez Gita naredi datirano kopijo mape.

9. Objavi zgodaj

   Objava razkrije napake, ki jih lokalni razvoj skrije: okoljske spremenljivke, poti, mobilna postavitev, pravice.

10. Primopredaja

    Zapiši, kaj dela, kaj ostaja in kako se požene (ang. handoff). Novo sejo začni s tem zapisom, ne z vlečenjem izčrpanega pogovora.

Prompti in dobre prakse

Dober prompt je kratko inženirsko naročilo, ne čarobna fraza:

Kontekst   - kaj obstaja, kdo uporablja, katere datoteke štejejo
Cilj       - konkreten izid te naloge
Omejitve   - tehnologija, slog, zasebnost, česa ne spreminjati
Merila     - preverljivi pogoji končanosti
Postopek   - najprej preglej, načrt, samo relevantne datoteke, poženi teste

Revizija

Šibka: »Še vedno grdo, polepšaj.« — model na novo interpretira celotno zasnovo. Uporabna:

Ohrani vse besedilo in povezave. Odstrani kartice in prelive.
En stolpec 760 px, bel fon, modra samo za povezave.
Pri 390 px brez vodoravnega prelivanja (izjema: tabela).
Poženi in pokaži spremenjene datoteke.

Dobre prakse

• Ne vleci pogovorov predolgo. Kontekstno okno samo raste, kakovost pa z njim pada. Po opravljeni nalogi začni novo sejo.
• Zberi pripombe in pošlji naenkrat. Preglej rezultat v celoti in v enem promptu opiši vse, kar te moti. Vsako dodatno sporočilo znova vleče s seboj vso zgodovino pogovora — deset kratkih sporočil stane veliko več od enega dolgega.
• Stalna pravila v datoteke, ne v prompte. Ukazi, konvencije in arhitektura sodijo v AGENTS.md ali veščino.
• Zahtevaj pregled pred urejanjem. To prepreči kodo za datoteke in vmesnike, ki ne obstajajo.
• Pošiljaj razlike in izseke napak, ne celega projekta. Dnevnike skrajšaj na neuspeli del.
• Dragi model šele po neuspehu privzetega na jasno zastavljeni nalogi — nato se vrni nazaj.
• Testi so trajne zahteve. En test pove pravilo vsaki naslednji seji brez odstavka razlage.
• Ob napačni predpostavki zgodaj razveljavi (ang. revert). Dodatni žetoni na napačni predpostavki kupijo le bolj dodelano napako.

Kontrolni seznam za pregled: REVISION-CHECKLIST.md. Vodiči ponudnikov: Anthropic, Google, Prompting Guide.

Pet pogostih napak

Povzeto po razdelku Avoid common failure patterns v Claude Code best practices. Vse naštete stanejo čas.

1. Seja z vsemi opravili hkrati

   Začneš z eno nalogo, vmes vprašaš nekaj nepovezanega, nato se vrneš. Kontekst je poln nepomembnega. Rešitev: /clear med nepovezanimi nalogami.

2. Popravljanje v krogu

   Model naredi napačno, popraviš, spet napačno. Kontekst je onesnažen z neuspelimi poskusi. Rešitev: po dveh neuspešnih popravkih začni znova z boljšim promptom.

3. Predolg CLAUDE.md

   Če je datoteka z navodili predolga, model polovico prezre. Test za vsako vrstico: »Would removing this cause Claude to make mistakes?« Če ne, jo zbriši.

4. Vrzel med zaupanjem in preverjanjem

   Model vrne verjetno videti rešitev, ki ne pokriva robnih primerov. Rešitev in najkrajše pravilo v vsem vodiču: »If you can't verify it, don't ship it.«

5. Neskončno raziskovanje

   Naročiš »preglej projekt« brez omejitve. Model prebere sto datotek in napolni kontekst. Rešitev: ozko zastavi nalogo ali uporabi podagenta.

Git: neobvezen, a najcenejši undo

Git beleži zgodovino projekta lokalno. GitHub hrani oddaljeno kopijo. Git ni pogoj — mapa z datotekami je veljaven projekt. Je pa najhitrejša pot nazaj, ko agent v napačno smer »izboljša« pol projekta.

Pojmi: commit je poimenovan posnetek stanja. Veja (ang. branch) je vzporedna linija dela. Push in pull sinhronizirata z oddaljeno kopijo (več o vejah).

• git statusspremenjene in nesledene datoteke
• git diffpreglej spremembe pred commitom
• git add .pripravi spremembe
• git commit -m "..."obnovitvena točka
• git pushpošlji na oddaljeno kopijo

Commitaj pred tveganim posegom in po vsaki delujoči funkciji. Grafični vmesnik: GitHub Desktop. Učenje: Learn Git Branching, GitHub Skills.

Objava na splet

Privzeta pot — tako je objavljena ta stran in vsi projekti zgoraj: potisni repozitorij na GitHub (lahko je zaseben). V Cloudflare Pages poveži repozitorij. Nastavi predlogo None, prazen ukaz gradnje, izhod /. Vsak push sproži novo objavo, vsaka veja dobi predogledni URL (ang. preview deployment). Naslov *.pages.dev deluje takoj; lastna domena je opcijska.

Občutljivi podatki

Najmočnejša zaščita je lokalni model brez povezave v oblak. Zagon: Ollama ali LM Studio. Nižji nivo: llama.cpp. Brskalniški vmesnik: Open WebUI.

Manjši lokalni model zadošča za klasifikacijo, izvlečke in povzetke. Za težko sklepanje in dolgo agentsko delo oblak ostaja bistveno boljši. Oznaki »lokalno« ne verjemi na besedo: lokalni vmesnik lahko še vedno kliče spletno iskanje, oblačne vložitve ali telemetrijo. Preveri nastavitve in omrežni promet.

Slovarček

LLM (ang. large language model)

Velik jezikovni model. Nevronska mreža, ki generira besedilo iz naučenih vzorcev in konteksta. Ne bere iz tabele dejstev — zato preverjaj.

Žeton (ang. token)

Košček besedila, približno tri četrtine besede. Enota, v kateri se meri poraba.

Kontekstno okno (ang. context window)

Vse, kar model trenutno upošteva: sporočila, datoteke, izpise ukazov. Med pogovorom samo raste. Glej poglavje.

Programerski agent (ang. coding agent)

Program, ki lokalno bere in ureja datoteke, poganja ukaze in popravlja lastne napake — Claude Code, Codex.

Veščina (ang. skill)

Shranjen postopek v datoteki SKILL.md, ki se naloži šele ob uporabi.

Podagent (ang. subagent)

Ločena seja z lastnim kontekstom, ki opravi raziskovanje in vrne le povzetek.

Prompt

Naročilo modelu. Dober prompt je kratek inženirski opis naloge, ne fraza.

Razlika (ang. diff)

Izpis sprememb med dvema različicama datoteke. To pregledaš, preden potrdiš.

Multimodalnost (ang. multimodality)

Vhod in izhod poleg besedila: slike, PDF, zvok, video.

Orkestracija (ang. orchestration)

Dovoljenja, spomin, ponovni poskusi in usklajevanje več agentov okoli modela.

Naročnina proti API

Naročnina plača človeka v aplikaciji, API klice tvoje kode po porabi. Glej poglavje.

Viri in nadaljnje branje

Vsi viri so povezani tudi sproti v besedilu. Preverjeno avgusta 2026. Cene in imena se spreminjajo; avtoriteta je stran ponudnika.

Tečaji (brezplačni, uradni)

• Claude Academy Claude 101 → Claude Code in Action; primeri uporabe po vlogah na academy.claude.com/use-cases.
• OpenAI Academy Enako za ChatGPT in Codex.
• Google AI Essentials Za ne-razvijalce.
• GitHub Skills Git in pull requesti v resničnem repozitoriju.
• DeepLearning.AI Kratki tečaji: prompti, agenti, RAG (ang. retrieval-augmented generation).
• Generative AI for Beginners Odprtokodni tečaj z izvedljivimi zvezki.

Delo z agenti in veščinami

• Claude Code best practices Vir za faze razišči–načrtuj–izvedi–commitaj, pravilo o preverjanju, ravnanje s kontekstom in pet pogostih napak.
• Claude Code: skills Kako shraniti postopek v SKILL.md, da se naloži šele ob uporabi.
• Codex best practices Enaka pravila pri drugem ponudniku.
• Effective context engineering Zakaj AGENTS.md in zgoščevanje konteksta.
• Building effective agents »Find the simplest solution possible« — preprosti vzorci pred ogrodji.
• Anthropic prompting / Google prompting / Prompting Guide / OpenAI Cookbook Tehnike in izvedljivi recepti.

Cene, paketi in izbira

• Claude Code Pricing: Subscriptions vs API Vir za razmerje 15–30× in za primer 200 $ naročnine proti 1.588 $ po ceniku API.
• CloudZero: Claude Code pricing Neodvisen izračun prelomnih točk med paketi.
• Claude / ChatGPT / Gemini Uradni ceniki — edini zavezujoč vir.
• Analiza objav na Redditu Kaj skupnost dejansko uporablja in gradi; štetje omemb orodij.

Pojem in izkušnje iz prve roke

• Karpathy, 6. 2. 2025 Izvirna objava, ki je skovala pojem.
• Karpathy: Vibe coding MenuGen Avtor pojma zgradi celo spletno aplikacijo in odkrito popiše, kaj je bilo težko (ne koda).
• Willison: Not all AI-assisted programming is vibe coding Razmejitev pojma. Arhiv za tekoče stanje.
• Willison: Vibe engineering Disciplinirana različica: testi, načrt vnaprej, dokumentacija, pregled.
• tools.simonwillison.net — kolofon 227 orodij s povezavami na prepise pogovorov z modelom. Koda.
• Pragmatic Engineer Pogled profesionalne ekipe.

Meritve

• Stack Overflow Developer Survey 2025: AI 66 % navaja rešitve »almost right, but not quite« kot glavno težavo.
• DORA 2025 Googlova panožna raziskava: 90 % uporaba; AI kot ojačevalnik obstoječih navad ekipe.
• METR (2025) Randomizirano kontrolirano preskušanje: izkušeni razvijalci so bili 19 % počasnejši, čeprav so ocenili 20 % prihranka. Članek: arXiv:2507.09089.

Orodja

• Cloudflare Pages / Workers / Cron Triggers Objava in urniki.
• About Git / Learn Git Branching / GitHub Actions Zgodovina, veje, avtomatizacija.
• DuckDB / Polars / uv / Mermaid Analitika, okolja, diagrami v repozitoriju.
• Ollama / LM Studio / llama.cpp / Open WebUI Lokalni modeli.