Uvod: Koda se ne meni za vaše občutke
Pri velikih jezikovnih modelih in kodi je tako: presenetljivo so samozavestni in popolnoma ravnodušni do tega, ali se vaš program prevede. Claude Haiku 4.5 vam bo z veseljem napisal skripto Python, ki rešuje vašo težavo, plus dve, ki si jih je izmislil za zabavo. Trik – edini trik, ki šteje – je, da se naučite, kako pozvati Claude Haiku 4.5 za natančno generiranje kode na način, ki ne pušča prostora za občutke in največ prostora za resnico. Nočete proze, ki zveni kot koda. Želite kodo, ki se obnaša kot koda. Obstaja razlika.
Ljudje obravnavajo pozivanje kot mistično invokacijo – izrečete prave besede in dobite popolno aplikacijo. To je razmišljanje o kultu tovora. Koda je pogodba. Če želite natančnost od Claude Haiku, morate napisati pogodbo. »Izdelaj spletno aplikacijo« ni pogodba. »Generiraj končno točko FastAPI v Pythonu 3.12, ki sprejema JSON, potrjuje shemo s Pydantic v2 in vrača 422 ob napakah sheme z določeno obliko zapisa« je pogodba. Tako pozovete Claude Haiku 4.5 za natančno generiranje kode: določite pogodbo.
Kaj to je (in kaj ni)
- To je vodnik o tem, kako dobiti zanesljivo kodo, ki jo je mogoče testirati, od Claude Haiku 4.5.
- To ni pridiga o »AI, ki nadomešča razvijalce«. Orodja ne nadomeščajo razmišljanja.
- Osredotočeno je na praktične pozive, strukturo in varovala: dolgočasne dele, ki omogočajo, da magija deluje.
Če želite kodo, ki deluje, morate Claudeu dati delovno definicijo »deluje«. Če želite natančno generiranje kode, morate natančnost definirati v preprostih, preizkusljivih izrazih. To je celotna igra.
Definirajte natančnost kot odvetnik, ne kot pesnik
»Natančna« koda ni koda, ki »izgleda verjetno«. Natančnost je:
- Sintaktična veljavnost: se prevede ali izvaja pod tolmačem.
- Semantična zvestoba: naredi to, kar pravi specifikacija.
- Deterministično obnašanje: enaki vhodi, enaki izhodi, znotraj določenih meja napak.
- Pravilnost različice: uporablja prave SDK-je, različice API-jev in jezikovne funkcije.
Claude vam bo dal, kar boste zahtevali. Če zahtevate »funkcijo, ki razvrsti seznam«, jo boste verjetno dobili. Če zahtevate »stabilno, vmesno razvrščanje z uporabo semantike Timsort z O(1) dodatnega prostora«, je to drugačna obljuba. »Kako pozvati Claude Haiku 4.5 za natančno generiranje kode« se začne s pisanjem teh obljub v poziv.
Minimalni izvedljivi poziv, nadgrajen
Slabo: »Napišite Node API za naloge.«
Bolje: »Napišite Node 20 Express 4 API s potjo /tasks POST, ki preveri polja {title: string, dueDate: ISO 8601} in se odzove 201 z ustvarjenim objektom ali 400 s podrobnostmi o napaki.«
Pravilno: »Generiraj strežnik Node 20 Express 4 z eno samo končno točko /tasks POST. Zahteve: 1) Preveri telo z [email protected]; 2) Polja: title (neprazno niz, največ 140), dueDate (ISO 8601 prihodnji datum); 3) Ob uspehu: 201 z {id: ULID, title, dueDate}; 4) Ob neveljavnosti: 400 z {error: 'VALIDATION', details: array}; 5) Brez baze podatkov; Map v pomnilniku; 6) Vključi datoteko za testiranje Jest 29, ki pokriva veljavne, neveljavne (prazen naslov, pretekli datum); 7) Zagotovi npm skripte za testiranje in razvoj; 8) Uporabi ESM; 9) Ne vključuj odvečnih komentarjev.« Opazite obliko: različica jezika, knjižnice, omejitve, izhodi, napake, testi in celo struktura paketa. Odstranili ste dvoumnost. Claudova naloga je, da dopolni kodo, ne zahteve.
Vzorec odra: Sistem, specifikacija, testi, nato koda
Če želite natančno generiranje kode od Claude Haiku 4.5, ji morate dati vzletno stezo:
- Sistemsko uokvirjanje (kratka vrv)
- Vi: »Pišete TypeScript produkcijske kakovosti za Node 20. Izpišite samo bloke kode z imeni datotek in nič drugega.«
- Zakaj: Nadzorujete ton in obliko izhoda. Ne prepuščajte tega naključju.
- Vključite različice jezika, izbiro paketov, semantiko napak, oblike zapisa I/O, omejitve zmogljivosti in varnostne omejitve.
- Recite Claudeu, naj najprej napiše enotske teste. Testi definirajo »natančno« bolje kot pridevniki. Če vrstica kode ne služi testu, je okrasna.
- Šele po testih. Da, to je v bistvu TDD, vendar z robotom, ki se nikoli ne naveliča pisanja standardne kode.
- Navodila za ponovne izvedbe
- »Če testi ne uspejo ali se uvozi ne ujemajo, posodobite samo dele, ki ne uspejo. Ne prepišite celotnega projekta.«
Claude se dobro znajde, ko ima kontekst in vodila. Dajte mu vodila.
Pripetje različic ni izbirno
Claudovi podatki za usposabljanje so polni starih in novih dokumentov. To je vljuden način, da rečemo, da je videl veliko nasprotujočih si nasvetov. »Uporabi React Router« je nejasno. »Uporabi [email protected] s podatkovnimi usmerjevalniki« je smer. Ne zaupajte privzetim vrednostim: - Jeziki: pripnite na Python 3.12, Node 20, Go 1.22, Java 21 – karkoli dejansko poganjate.
- Okvirji: določite natančne glavne različice in vse zastavice, ki povzročajo spremembe.
- Cloud SDK-ji: pripnite različice; aws-sdk v2 proti v3 je pomembno.
- Linterji/oblikovalci: določite pravila, da se izognete »stilnemu ping-pong« prepisovanju.
Če ne pripnete, boste dobili največje uspešnice iz petih let objav na blogih. Natančno generiranje kode je alergično na nostalgijo.
Najprej shema, vedno
Ne sprašujte po strukturah »uporabniškega profila«. Definirajte sheme v pozivu in zahtevajte validacijo:
- JSON Schema ali Zod/Yup vrste v JS/TS
- Pydantic modeli v Pythonu
- Protobuf ali Avro za storitve
Nato poskrbite, da Claude uveljavlja sheme na mejah – vhodi API-ja, zapisi v bazo podatkov in čakalne vrste sporočil. Zahtevajte eksplicitne oblike zapisa in kode napak. Natančnost ljubi sheme. Dvomljivost ne.
Naj bo opazno ali pa se ne pretvarjajte, da je resnično
Recite Claudeu, naj doda beleženje, meritve in sledi, kjer jih potrebujete – in naj jih ohrani tihe, kjer jih ne potrebujete. Dober poziv vključuje:
- Politika beleženja: ravni, redakcija PII, struktura (JSON dnevniki, prosim)
- Meritve: čas na zahtevo, število napak
- Končne točke stanja: /healthz, ki dokazujejo, da so odvisnosti aktivne
Claude bo dodal, kar boste zahtevali. Če ne boste zahtevali, boste dobili izjave za tiskanje – če boste imeli srečo.
Pozivi, ki najprej testirajo, premagajo »Samo zaupajte mi«
Dober način za pozivanje Claude Haiku 4.5 za natančno generiranje kode je, da teste naredite za vir resnice. Primer:
»Napišite pytest teste za funkcijo normalize_email(s), ki:
- pretvarja male črke v lokalne in domenske dele;
- odstrani pike v lokalnem delu samo za gmail.com;
- odstrani podnaslove (+tag) samo za gmail.com;
- zavrača vhode brez enega samega @ ali s presledki;
- ohrani unicode domeno punycode kot je.
Pokrijte mejne primere. Po pisanju testov implementirajte funkcijo, da jih opravite.«
Claude bo pogosto napisal boljšo kodo, ko bo prisiljen izpolniti teste, ki ste jih opisali. Če ne, imate konkretno napako, ne pa argument o občutkih.
Brez halucinacij s konstrukcijo
Halucinacij ne morete odpraviti, lahko pa jih ogradite:
- Zahtevajte citate ali izvorne URL-je samo, ko viri obstajajo. Za metode SDK zahtevajte povezave do dokumentov in zahtevajte, da se koda ujema s temi dokumenti.
- Za zasebne API-je prilepite specifikacijo v poziv. Ne pričakujte, da bo Claude poznal vaše notranje končne točke.
- Za knjižnice z zmedenimi API-ji vključite primer iz uradnih dokumentov in recite Claudeu, naj se jih drži.
Natančna koda je večinoma natančna referenca. Dajte Claudeu reference.
Slogovni vodniki: Najmanj seksi, najbolj uporabna stvar
Claude piše kodo v slogu, ki ga sklepa. To je recept za pretok. Prilepite svoj slogovni vodnik. Določite:
- Oblikovanje (Prettier, Black, privzeto gofmt)
- Vzorci obravnavanja napak
Zahtevajte tudi kratek komentar o utemeljitvi za nejasne izbire. Prihodnji jaz vam bo hvaležen, trenutni Claude pa bo ustvaril manj popravkov PR.
Dolgi pozivi, kratki izhodi
Drug način razmišljanja o tem, kako pozvati Claude Haiku 4.5 za natančno generiranje kode: porabite svoje besede za poziv, ne za izhod. Želite:
- Izčrpne omejitve v pozivu
- Minimalna odvečna pripoved v izhodu
Recite mu, naj zatare razlage in vrne samo bloke kode z imeni datotek in kratkim README. Če želite komentar, ga zahtevajte v ločenem zagonu. Prepletanje proze in kode je način, kako se hrošči prikradejo v monoklu in cilindru.
Izboljšanje: Tesna zanka, ki dejansko deluje
Najhitrejša pot do zanesljive kode ni »prav jo zadeti že prvič«. To so kratke, popravljalne zanke:
- Generirajte teste + kodo.
- Zaženite lokalno. Prilepite neuspešne rezultate testov in napake prevajalnika nazaj v Claude natančno.
- Navodilo: »Spremenite samo najmanjše potrebno število vrstic; ne spreminjajte podpisov funkcij, razen če to zahtevajo neuspešni testi.«
- Ponovite, dokler ne postane zeleno.
Claude je odličen pri uporabi razlik, ko mu natančno poveste, kaj se je pokvarilo. Ne parafrazirajte dnevnikov napak. Prilepite jih. Dnevniki so resnica.
Varnost je funkcija, ne popravek
Ker so modeli usposobljeni na javni kodi (dobri, slabi in prekleti), želite, da je varnost prvovrstna zahteva:
- Izrecno prepovejte eval, shell=True in nizko tipkan SQL
- Zahtevajte parametrizirana poizvedovanja, zaščito CSRF in omejevanje hitrosti
- Zahtevajte pripenjanje odvisnosti plus zaklenjeno datoteko
- Zahtevajte obravnavo skrivnosti prek spremenljivk okolja ali upravitelja skrivnosti
Varnostni poziv privzeto daje varnejšo kodo. Poziv »popravili ga bomo pozneje« daje naslove.
Zmogljivost: Povejte, kaj pomeni »hitro«
»Naj bo hitro« se prevede v »naredi karkoli«. Namesto tega določite meritve:
- Cilji zakasnitve (p95 < 50 ms za pomnilnik, p95 < 300 ms za DB operacije)
- Omejitve pomnilnika (RSS < 150 MB)
- Časovna kompleksnost (mora biti O(n log n), ne O(n^2))
Claude bo izbral algoritme, ki ustrezajo proračunu, ki ste ga določili. Dajte mu proračun.
Dokumentacija: Dovolj za uvajanje tujca
Zahtevajte od Claude README, ki vključuje:
- Navodila za nastavitev z natančnimi različicami
- Ukazi za testiranje, lint, preverjanje tipa, izvajanje
- Omejitve in znana kompromisna razmerja
»Natančna koda« vključuje natančno dokumentacijo. So del dobave.
Konkretne predloge pozivov, ki jih lahko ukradete
Predloga: Zaledna končna točka
Sistem: Ste natančen inženir Python 3.12. Izpišite samo bloke kode z imeni datotek.
Uporabnik:
- Izdelajte aplikacijo FastAPI 0.111 s končno točko POST /convert.
- Zahteva: {amount: Decimal as string, from: 'USD'|'EUR', to: same}.
- Preverite s pydantic v2; vrnite obliko 422 ob napakah sheme.
- Uporabite čisto funkcijo convert(amount, from, to) s fiksnimi tečaji {USD:1, EUR:1.1}.
- Vrnite {amount: string, currency: string} z 200.
- Vključite pytest teste, ki pokrivajo veljavne, neveljavne (slaba decimalna številka, neznana koda) in rob (0).
- Zagotovite pyproject.toml s pripetimi odvisnostmi; vključite ruff in mypy konfiguracije.
- Brez omrežnih klicev, brez komentarjev.
Predloga: CLI pripomoček
Sistem: Pišete Go 1.22. Izpišite samo bloke kode z imeni datotek.
Uporabnik:
- Ustvarite CLI po imenu slugify, ki bere stdin in izpisuje URL-varne sluge.
- Pravila: male črke, samo ASCII, ločila s pomišljaji, strnitev presledkov, odstranjevanje ločil.
- Zagotovite main.go in slugify_test.go s tabelnimi testi.
- Uporabite samo Go stdlib.
- Vključite Makefile s cilji testiranja in gradnje.
Predloga: Komponenta sprednjega dela
Sistem: Ste pragmatičen inženir React, ki cilja na React 18 + TypeScript.
Uporabnik:
- Implementirajte komponento <DebouncedInput>.
- Props: value: string, onChange(value): void, delay=300.
- Uporabite useRef/useEffect; brez zunanjih kljukic.
- Vključite vitest teste z lažnimi časovniki.
- Zagotovite minimalno zgodbo Storybook.
Te predloge prikazujejo, kako pozvati Claude Haiku 4.5 za natančno generiranje kode s pripenjanjem različic, definiranjem obnašanja in zahtevanjem testov.
Zavračanje pametovanja: Kdaj reči »Ne optimizirajte«
Če ne želite prezgodnjih mikro-optimizacij (in jih ne želite), to povejte:
- »Dajte prednost berljivosti pred pametnostjo; brez zvijanja bitov, razen če to zahtevajo testi.«
- »Brez rekurzije, če je iterativno bolj jasno.«
- »Brez metaprogramiranja; eksplicitno > implicitno.«
Claude rad navdušuje. Ne dovolite mu. Naj opravi teste in naj bo berljiv. To je dovolj impresivno.
Sider.AI v poteku dela, kjer dejansko pomaga Videl sem ljudi, kako žonglirajo s pozivi v naključnih zavihkih za klepet, kot da je to produktivni ritual. Uporabite delovni prostor, ki razume kontekst kode. Sider.AI je na primer zgrajen okoli ohranjanja vaše specifikacije, kode, razlik in dnevnikov testov v pogledu, tako da je zanka »prilepi napako, popravi vrstico« dejansko tesna. To ni čarovnija; to je dolgočasen oder, ki vam preprečuje, da bi izgubili rdečo nit. Če vaše orodje ohranja pogodbo, teste in kodo v istem pogovoru – ne da bi vas nadlegovalo s konfeti – ga uporabite. Sider to počne. Kako odpravljati napake s Claudom kot soigralcem, ne kot prerokom
- Prilepite izpis neuspešnega testa natančno tak, kot je. Ne povzemajte.
- Zahtevajte razliko: »Odgovorite z enotno razliko samo v datoteki X.«
- Za napake pri izvajanju dodajte najmanjši ponovljiv izrezek in zahtevajte razlago plus popravek.
- Za napake knjižnice prilepite izrezek dokumenta, za katerega menite, da velja, in vprašajte: »Ali je to pravi API za različico X? Če ne, posodobite kodo in navedite pravilen izrezek.«
Cilj je, da se Claude prepira z dokazi. Vi prinesete dokaze.
Parad napak (in kako se mu izogniti)
- Past »najnovejšega« API-ja: Ne recite »uporabite najnovejše«. Recite »uporabite različico X.Y« in se je držite.
- Prazna testna datoteka: Če ne zahtevate testov, jih ne boste dobili.
- Zmota enega poskusa: Načrtujte dve ali tri kratke izboljšave. To je hitreje kot en napihnjen poziv.
- Nejasna politika napak: Določite kode stanja in oblike zapisa. »Vrniti napako« ne pomeni nič.
- Neobvladovana odvisnost: Če se koda zanaša na storitev, ki je ne morete nadzorovati, jo nadomestite. Zahtevajte lažne podatke.
Vaš kontrolni seznam pozivov (prilepite to blizu monitorja)
- Različica jezika in izvajalnega okolja pripeta
- Različice knjižnic pripete
- Podatkovne sheme definirane
- Semantika napak definirana (kode, oblike)
- Varnostne omejitve eksplicitne
- Proračuni zmogljivosti navedeni
- Slog in struktura določena
- Oblika zapisa izhoda omejena (imena datotek, bloki kode, razlike)
- Kratka zanka izboljšav s prilepljenimi dnevniki
Če zadenete vseh deset, Claude Haiku 4.5 na splošno ustvari natančno generiranje kode, ki preživi dnevno svetlobo.
Obdelan primer: Od nejasnega do preverjenega
Nejasen poziv: »Napišite funkcijo za varno razčlenjevanje CSV.«
Rezultat: Verjetno v redu, morda narobe, zagotovo nepreizkušeno.
Natančen poziv:
»Pišete Python 3.12. Izpišite samo bloke kode z imeni datotek.
Ustvarite csvsafe/init.py in csvsafe/reader.py s funkcijo read_rows(path: Path) -> list[dict[str,str]]. Zahteve: uporabite csv.DictReader z newline='' in encoding='utf-8'; prepovejte ničelne bajte; zavrnite datoteke >10MB; omejite stolpce na 100; odstranite BOM; obravnavajte prazne celice kot prazne nize; sprožite ValueError s kodami sporočil {FILE_TOO_LARGE, NULL_BYTE, TOO_MANY_COLUMNS}. Vključite teste v tests/test_reader.py s pytest, ki pokriva srečno pot, ničelni bajt, datoteko 11MB, 101 stolpec in obravnavo BOM. Zagotovite pyproject.toml s pripetimi odvisnostmi in konfiguracijo black.«
Dobili boste kodo, teste in obravnavo robnih primerov. Nato zaženete teste, prilepite napake in ponavljate z minimalnimi razlikami. To je natančno generiranje kode v praksi.
O »ustvarjalnosti« in drugih marketinških besedah
Ne potrebujem »ustvarjalne« kode. Potrebujem pravilno kodo. Prihranite ustvarjalnost za poimenovanje svoje mačke. Pri pozivanju Claudea je ustvarjalnost naravni stranski produkt trdnih omejitev. Pravi testi in jasne specifikacije prinašajo elegantne rešitve. Napačen poziv ustvari »na novo izumljen base64 z emojiji«. Ne skušajte ga.
Ne skrivna skrivnost
Način pozivanja Claude Haiku 4.5 za natančno generiranje kode je dolgočasen: zapišite, kaj potrebujete, pripnite različice, definirajte sheme, zahtevajte teste in ponavljajte z dejanskimi napakami. To je to. Brez misticizma. Samo inženirska disciplina z modelom, ki lahko zelo hitro tipka in mu ne moti pisanje petnajstih skoraj enakih testnih primerov.
In to je preobrat: natančnost je nebleščeča. Pozivi, ki delujejo, so videti kot kontrolni seznam TSA. Koda, ki se pošilja, je videti, kot da jo je napisal človek, ki mu je mar. Oboje dobite tako, da model obravnavate kot mlajšega inženirja, ki uspeva ob jasnih zahtevah in ovene ob nejasnih navodilih. Dajte mu pogodbo. Naj opravi teste. Potem mu morda lahko zaupate – z zaupanjem, ki ga dajete orodju, ne preroku.
Sklep: Manj čarovništva, več garancije
Če želite čarovništvo, pojdite na čarovniško predstavo. Če želite programsko opremo, ki se prevede in obnaša, napišite pozive, ki delujejo kot garancije. Kako pozvati Claude Haiku 4.5 za natančno generiranje kode, ne gre za cvetlično besedilo ali skrivne ključne besede. Gre za omejitve, teste, različice in povratne zanke. Naredite te štiri stvari in dobili boste kodo, ki deluje. Izpustite jih in dobili boste lepo oblikovano fikcijo.
Kodo se ne briga za vaše občutke. Na srečo se tudi testi ne.
Pogosta vprašanja
V1: Kakšen je najenostavnejši način za pozivanje Claude Haiku 4.5 za natančno generiranje kode?
Oglejte si ga kot pogodbo: določite različice, definirajte sheme, specificirajte formate napak in najprej zahtevajte teste. Bolj jasne so omejitve, bolj natančna je koda.
V2: Kako zmanjšam halucinacije, ko Claude piše kodo?
Prilepite verodostojno dokumentacijo ali specifikacije in zahtevajte natančno upoštevanje teh API-jev. Za zasebne končne točke vključite lastno specifikacijo – ne pričakujte, da bo ugibal.
V3: Naj Claude prosim za teste ali jih napišem sam?
Prosite Claudea, da najprej ustvari teste, nato pa implementirajte kodo, ki jih bo zadovoljila. Testi definirajo natančnost bolje kot pridevniki in ohranjajo model pošten.
V4: Kako natančno mora biti določanje različic v pozivih?
Zelo natančno: izvajalni čas jezika, glavna/manjša različica ogrodja in različice SDK. »Najnovejše« vabi k nasprotujočim si vzorcem; natančnost je odvisna od stabilnih ciljev.
V5: Kje se Sider.AI prilega pozivanju za natančno kodo?
Uporabite Sider.AI, da ohranite specifikacije, kodo, razlike in dnevnike testov v eni zanki. Ne izvaja magije – samo ohranja kontekst, tako da Claudove popravke sledijo vašim dejanskim napakam. 
