Sissejuhatus: Koodile ei oma rolli, milline sinu vibratsioon on
Suurte keelemudelite ja koodi puhul on asi selles: nad on hämmastavalt kindlad ja täiesti ükskõiksed selle suhtes, kas sinu programm kompileerub. Claude Haiku 4.5 kirjutab meeleldi Python skripti, mis lahendab sinu probleemi, ja veel kaks, mille ta lihtsalt leiutas nalja pärast. Trikk — ainus oluline trikk — on õppida, kuidas Claude Haiku 4.5 õiget koodi genereerimiseks promteerida nii, et vibratsioonidele ei jää ruumi ja tõele jääks maksimaalne ruum. Sa ei taha proosat, mis kõlab nagu kood. Sa tahad koodi, mis käitub nagu kood. Sellel on vahe.
Inimesed käsitlevad promptingut kui müstilist loitsu — ütle õiged sõnad, saa täiuslik rakendus. See on kaubakultuse mõtlemine. Kood on leping. Kui tahad Claude Haiku'l täpsust, pead lepingu kirja panema. „Ehita veebirakendus“ ei ole leping. „Genereeri Python 3.12 FastAPI endpoint, mis aktsepteerib JSONi, valideerib skeemi Pydantic v2-ga ja tagastab skeemivea korral 422 konkreetse laadiga vastuse“ on ... Lepingu kirjelduseks. Sellega promptid Claude Haiku 4.5 täpse koodi genereerimiseks: sul on vaja leping paika panna.
Mis see on (ja mis mitte)
- See on praktiline juhend, kuidas saada Claude Haiku 4.5-st usaldusväärset ja testitavat koodi.
- See ei ole kõnekus “AI asendab arendajaid”. Tööriistad ei asenda mõtlemist.
- See keskendub praktilistele promptidele, struktuurile ja ohjetele: igavatele osadele, mis teevad võlu töökindlaks.
Kui tahad, et kood töötaks, pead Claude'ile andma toimiva definitsiooni, mida tähendab “töötab”. Kui tahad täpset koodi genereerimist, pead täpsustama täpsuse lihtsate, testitavate tingimustega. See on mängu alus.
Defineeri täpsus nagu jurist, mitte luuletaja
“Täpsus” koodis ei ole “näeb usutav välja”. Täpsus tähendab:
- Süntaktiline kehtivus: kood kompileerub või töötab interpreteerijal.
- Sisemine täpsus: kood teeb täpselt, mida spetsifikatsioon nõuab.
- Deterministlik käitumine: samade sisendite puhul tuleb samad väljundid, lubatud vea piirides.
- Versiooni õigsus: kasutab õigeid SDKsid, API versioone ja keelespetsiifilisi omadusi.
Claude annab sulle seda, mida sa küsid. Kui küsid „funktsioon, mis sorteerib listi“, saad selle tõenäoliselt. Kui küsid „stabiilset, kohapealset sorteerimist Timsorti semantika ja O(1) lisa-ruumiga“, on see teine lubadus. „Kuidas promptida Claude Haiku 4.5 täpseks koodi genereerimiseks“ algab sellest, et need lubadused pannakse prompti kirja.
Vajalik miinimum-prompt, uuendatud
Halb: „Kirjuta Node API ülesannete jaoks.“
Parem: „Kirjuta Node 20 Express 4 API, millel on /tasks POST-rada, mis valideerib väljad {title: string, dueDate: ISO 8601} ja vastab 201 loodud objektiga või 400 veateabega.“
Õige: „Genereeri Node 20 Express 4 server, millel on üks /tasks POST-endpoint. Nõuded: 1) valideeri keha [email protected]; 2) väljad: title (mitte tühi string, max 140), dueDate (ISO 8601 tulevikukuupäev); 3) edukuse korral 201 koos {id: ULID, title, dueDate}; 4) vigase sisendi korral 400 koos {error: 'VALIDATION', details: massiiv}; 5) pole andmebaasi, vaid in-memory Map; 6) lisa Jest 29 testifail, mis katab vigased ja õiged juhtumid (puuduv pealkiri, minevikku kuupäev); 7) paku npm skriptid testimiseks ja arenduseks; 8) kasuta ESM; 9) ära lisa üleliigset kommentaari.” Pane tähele vormi: keele versioon, raamatukogud, piirangud, väljundid, vead, testid ja isegi paketi struktuur. Sa eemaldasid ebamäärasuse. Claude ülesanne on täita koodi, mitte nõudeid.
Tugistruktuuri muster: Süsteem, spetsifikatsioon, testid, siis kood
Kui tahad täpset koodi Claude Haiku 4.5-ga, anna talle stardiraja pikkus:
- Süsteemi raam (lühike rihm)
- Sina: „Sa kirjutad tootmiskvaliteediga TypeScripti Node 20-le. Väljasta ainult koodiplokid koos failinimedega, mitte midagi muud.“
- Miks: Sa kontrollid tooni ja väljundit. Ära jäta seda juhuse hooleks.
- Spetsifikatsioon (leping)
- Lisa keele versioonid, paketivalikud, veasemantika, sisendi/väljundi formatid, jõudluspiirangud ja turvanõuded.
- Ütle Claude'ile esmalt kirjutada üksustestid. Testid määratlevad täpsuse paremini kui omadussõnad. Kui koodijupp testile ei vasta, on see vaid kaunistus.
- Alles pärast testide valmimist. Jah, see on põhimõtteliselt testide esmane arendamine (TDD), kuid robotiga, kes ei väsi samade vormistustega tegelemisest.
- „Kui testid ebaõnnestuvad või importimised ei klapi, uuenda ainult veaallikat, ära kogu projekti ümber kirjuta.“
Claude töötab hästi konteksti ja raamides. Anna talle raamid.
Versioonide lukustamine pole valikuline
Claude treeningandmed sisaldavad nii vanu kui uusi dokumente. See tähendab, et ta on näinud palju vastuolulist nõuannet. „Kasuta React Routerit“ on ebamäärane. „Kasuta [email protected] koos data routers“ on juhis. Ära usalda vaikimisi väärtusi: - Keeled: lukusta Python 3.12, Node 20, Go 1.22, Java 21 jms täpsetele versioonidele, mida tõesti kasutad.
- Raamistikud: täpsusta peatustera versioonid ja muudatuslülitid.
- Pilvesdkd: lukusta versioonid; näiteks aws-sdk v2 versus v3 on oluline.
- Linters ja formatterid: täpsusta reeglid stiilimuutmiste vältimiseks.
Kui sa ei lukusta, saad viis aastat vana blogi parimate pala kokteili. Täpne koodi genereerimine ei talu nostalgiat.
Alusta skeemist, alati
Ära küsi „kasutajaprofiili“ struktuuri. Määra skeemid promptis ja nõua valideerimist:
- JSON Schema või Zod/Yup JS/TS jaoks
- Pydantic mudelid Pythonis
- Protobuf või Avro teenuste jaoks
Seejärel järgi, et Claude rakendaks skeeme servapunktides — API sisendid, andmebaasi kirjed ja sõnumi järjekorrad. Küsid selgelt vigade laadid ja koodid. Täpsus armastab skeeme. Ebamäärasus ei meeldi.
Tee see jälgitavaks või ära teeselda, et see on päris
Ütle Claude'ile lisada logimine, mõõdikud ja jäljed sinna, kus vajad, ja hoida need vaiksed seal, kus mitte. Heas promptis on:
- Logipoliitika: tasemed, PII anonümiseerimine, struktuur (eelistatult JSON-logid)
- Mõõdikud: päringu aeg, veateated
- Tervise-teeninduspunktid: /healthz, mis tõendab, et sõltuvused töötavad
Claude lisab, mida palud. Kui sa ei küsi, saad print-lauseid - kui õnnestub.
Testi-eesmärk on parem kui „lihtsalt usalda mind“
Hea meetod promteerimiseks on muuta testid tõepõhiseks lähtepunktiks. Näide:
„Kirjuta pytest testid normalize_email(s) funktsioonile, mis:
- teeb väikeste tähtedega nii kohalikku kui domeeniosa;
- eemaldab punktid lokaalses osas ainult gmail.com puhul;
- eemaldab alamadressid (+tag) ainult gmail.com puhul;
- kehitab sissekanded, kus puudub '@' või on tühikuid;
- säilitab unicode domeeni punykoodi muutmata.
Kata servajuhtumid. Pärast testide kirjutamist realiseeri funktsioon, mis testid läbib.”
Claude kirjutab tihti parema koodi, kui peab testidele vastama. Kui ei vasta, on see konkreetne viga, mitte vaid tunnetuslik vaidlus.
Hallutsinatsioonide vältimine konstruktsioonis
Sa ei suuda hallutsinatsioone täielikult elimineerida, kuid saad nad piirata:
- Nõua allikate või URL-de viited ainult kui need on olemas. SDK meetodite puhul nõua dokumentatsiooni linke ning nõua, et kood langeks dokumentidega kokku.
- Privaatsete API-de puhul kleebi spetsifikatsioon prompti. Ära eelda, et Claude teab sinu sisemisi lõpp-punkte.
- Segaste API-dega raamatukogude puhul lisa ametlikust dokumendist näidistõmmis ja käsu järgi halda seda.
Täpsus on peamiselt täpsed viited. Anna Claude'ile viited.
Stiilijuhised: kõige vähem glamuurikas, aga kasulikum
Claude kirjutab koodi stiilis, mida ta tuvastab. See tekitab arenduses võitlusi. Kleebi oma stiilijuhend. Määra:
- Formatiseerimine (Prettier, Black, gofmt vmt)
- Vigade käsitsemise mustrid
Nõua ka lühike põhjendus ebaselgete valikute kohta. Tulevane sina tänab sind, praegune Claude teeb vähem parandavaid PR-e.
Pikad promptid, lühikesed väljundid
Teine mõtteviis, kuidas promteerida Claude Haiku 4.5 täpseks koodiks: kuluta sõnad promptile, mitte väljundile. Sa tahad:
- Laiad ja ammendavad piirangud promptis
- Minimaalne üleliigne jutustamine väljundis
Ütle, et summutagu selgitused ja tagastagu ainult koodiplokid koos failinimedega ja lühikese README-ga. Kui tahad kommentaare, palu neid eraldi. Proosa ja koodi segamine on see, kuidas vead salaja sisse hiilivad, kandmaks monoklit ja ülikonda.
Täiendamine: Kitsas tsükkel, mis tõesti töötab
Kiireim tee usaldusväärse koodini ei ole „saada kohe esimesel korral õige“. See on lühikesed, parandavad tsüklid:
- Käivita kohapeal. Kleebi vea testiväljund ja kompilaatori vead täpselt Claude'i juurde.
- Juhenda: „Muuda ainult miinimum vajalikul määral; ära muuda funktsioonide signatuure, kui testid ei ebaõnnestu seda nõudes.“
- Korda, kuni kõik testid läbivad.
Claude on suurepärane diffe rakendamisel, kui sa ütled täpselt, mis katki on. Ära parafraaseeri logisid. Kleebi täpselt. Logid on tõde.
Turvalisus on funktsioon, mitte järelsõna
Kuna mudelid on treenitud avalikus koodis (heas, halvas ja halval moel), tee turvalisusest esmaklassiline nõue:
- Keela otseselt eval, shell=True ja käsitsi koostatud SQL
- Nõua parameetriseeritud päringuid, CSRF kaitset ja kiiruse piiramist
- Küsi sõltuvuste versioonide lukustamist ja lukufaili
- Nõua salajaste võtmete haldust keskkonnamuutujate või saladuse halduri kaudu
Turvalisuse vaikeseaded annavad turvalisema koodi. „Parandame hiljem“ promtiga saad ajalehti, mille pealkirjad tekitavad peavalu.
Jõudlus: määra, mida tähendab “kiire”
„Tee see kiireks“ tõlgitakse sageli kui „tee mida iganes“. Selle asemel täpsusta mõõdikuid:
- Latentsuse eesmärgid (p95 < 50ms sisemälus, p95 < 300ms andmebaasi operatsioonidel)
- Mälu piirangud (RSS < 150MB)
- Aja keerukus (peab olema O(n log n), mitte O(n^2))
Claude valib algoritmid vastavalt rahalisele piirangule. Sea piir.
Dokumentatsioon: piisav võõra kasutamaõppimiseks
Küsi Claude'ilt README-d, mis sisaldab:
- Seadistuse juhiseid täpsete versioonidega
- Käske testimiseks, lintimiseks, tüübikontrolliks, käivitamiseks
- Näidispäringuid ja -vastuseid
- Piiranguid ja tuntud kompromisse
“Täpses koodis” on ka täpne dokumentatsioon. See on osa tulemusest.
Konkreetsed prompti mallid, mida saad kasutada
Mall: Tagapõhja (backend) lõpp-punkt
Süsteem: Sa oled täpne Python 3.12 insener. Väljasta ainult koodiplokid failinimedega.
Kasutaja:
- Ehita FastAPI 0.111 rakendus, millel on POST /convert lõpp-punkt.
- Päring: {amount: stringina esitatud Decimal, from: 'USD'|'EUR', to: sama}.
- Valideeri pydantic v2-ga; vea korral tagasta 422 kujul vorm.
- Kasuta puhast funktsiooni convert(amount, from, to fikseeritud kurssidega {USD:1, EUR:1.1}.
- Vasta 200 koos {amount: string, currency: string} objektiga.
- Lisa pytest testid, mis katavad õiged ning vead (valed decimal, teadmata kood) ja piiri (0) juhtumid.
- Paku pyproject.toml koos lukustatud sõltuvustega; lisa ruff ja mypy konfiguratsioonid.
- Pole võrgukõnesid, pole kommentaare.
Mall: CLI tööriist
Süsteem: Sa kirjutad Go 1.22. Väljasta ainult koodiplokid failinimedega.
Kasutaja:
- Loo CLI nimega slugify, mis loeb stdin ja prindib URL-sõbralikke sluge.
- Reeglid: väiketähed, ainult ASCII, sidekriips eraldajana, mahuta tühikud, eemalda kirjavahemärgid.
- Paku main.go ja slugify_test.go koos tabelitestidega.
- Kasuta ainult Go standardraamatukogu.
- Lisa Makefile testide ja ehituse sihtmärkidega.
Mall: Esiotsa (frontend) komponent
Süsteem: Sa oled pragmaatiline React insener, kasutad React 18 + TypeScripti.
Kasutaja:
- Rakenda <DebouncedInput> komponent.
- Propsid: value: string, onChange(value): void, delay=300.
- Kasuta useRef/useEffect; ära kasuta kolmanda osapoole hooke.
- Lisa vitest testid koos võltsitud taimeritega.
- Paku minimaalne Storybook lugu.
Need mallid näitavad, kuidas promptida Claude Haiku 4.5 täpseks koodi genereerimiseks, lukustades versioonid, määratledes käitumised ja nõudes teste.
Kui mitte olla liiga nutikas: millal öelda „ära optimeeri“
Kui sa ei taha varajasi mikro-optimisatsioone (ja tavaliselt sa ei taha), ütle nii:
- „Eelista loetavust lahendustele; ära tee haruldasi bititöötlemisi, kui testid seda ei nõua.“
- „Ära kasuta rekursiooni, kui iteratiivne on selgem.“
- „Pole meta-programmeerimist; selge > kaudne.“
Claude tahab näidata osavust. Ära lase tal seda teha. Pane ta testid läbima ja loetav olema. See on juba piisavalt muljetavaldav.
Sider.AI töövoos, kus see tegelikult aitab Olen näinud inimesi juhitamas promte juhuslikes vestlusakendes nagu see oleks tootlikkusrituaal. Kasuta tööruumi, mis mõistab koodi konteksti. Näiteks Sider.AI on loodud selleks, et hoida kokku sinu spetsifikatsioon, kood, diffid ja testilogid samas vaates, nii et “kleebi viga, paranda rida” tsükkel on kerge ja lühike. See ei ole võlu, vaid igav tugistruktuur, mis hoiab sind peategelaseks. Kui su tööriist hoiab lepingut, testimisi ja koodi ühes vestluses – ilma sind konfettiga tüütamast – kasuta seda. Sider teeb seda. Kuidas kasutada Claudet kaaslasena, mitte oraaklina vigu siludes
- Kleebi vea testiväljund täpselt nii nagu see on. Ära kokkuvõta.
- Palun tee diff: „Vasta ainult faili X ühtsustatud diffiga.“
- Käivitusvead: lisa võimalikult väike korratavatest juhtumitest koos nõudega seletuse ja paranduse kohta.
- Raamatukoguvead: kleebi dokumentide lõik, mis arvad, et sobib ja küsi: „Kas see on õige API versiooni X jaoks? Kui ei, uuenda koodi ja lisa õige dokumentatsiooni lõigu viide.“
Eesmärk on panna Claude vastu vaidlema tõendusmaterjalide põhjal. Sina tood tõed ette.
Vead ja nende vältimine
- „Latest“ API lõks: ära ütle „kasuta latest“. Ütle „kasuta versiooni X.Y“ ja pea sellest kinni.
- Tühi testifail: kui sa ei küsi teste, sa ei saa neid.
- Ühekordse päästiku lõks: planeeri paar lühikest parandamist. See on kiirem kui üks mahukas prompt.
- Ebamäärane veapoliitika: määratle staatuskoodid ja veavormid. „Tagasta viga“ ei tähenda midagi.
- Halva haldamisega sõltuvus: kui kood sõltub teenusest, mida sa ei kontrolli, tee valed/tonoonid. Küsi võltsinguid.
Sinu prompti kontrollnimekiri (kleepige see monitori äärde)
- Keele ja runtime versiooni lukustus
- Raamatukogude versioonide lukustus
- Veasemantika määratlus (koodid, struktuur)
- Jõudluspiirangud määratletud
- Stiil ja struktuur määratletud
- Väljundi formaat kontrollitud (failinimed, koodiplokid, diffid)
- Lühike paranduste tsükkel koos logidega
Kui täidad kõik kümme, toob Claude Haiku 4.5 tavaliselt välja täpse koodi, mis toimib väljas valguses.
Töö näide: ebaselgest kontrollitud versioonini
Ebaselge prompt: „Kirjuta funktsioon, mis turvaliselt analüüsib CSV-d.“
Tulemus: tõenäoliselt okei, aga võib viga sisaldada, kindlasti katsetamata.
Täpsustatud prompt:
„Sa kirjutad Python 3.12. Väljasta ainult koodiplokid failinimedega.
Loo csvsafe/init.py ja csvsafe/reader.py koos funktsiooniga read_rows(path: Path) -> list[dict[str,str]]. Nõuded: kasuta csv.DictReaderit newline='' ja encoding='utf-8'; nullbaitide keelamine; keela failid >10MB; piirda veerge 100-ga; eemalda BOM; tühjad lahtrid loe tühjadeks stringideks; viska ValueError koodidega {FILE_TOO_LARGE, NULL_BYTE, TOO_MANY_COLUMNS}. Lisa testid tests/test_reader.py koos pytestiga, mis katavad õnneliku tee, nullbaidi, 11MB faili, 101 veeru ja BOM käsitluse. Paki pyproject.toml koos lukustatud sõltuvustega ja black konfiguratsiooniga.”
Sa saad koodi, teste ja servajuhtumite käsitluse. Siis käivitad testid, kleebid vead ja iteratsioonid minimaalse kodeerimisega algavad. See on täpne koodi genereerimine praktikas.
„Loomingulisuse“ ja turundussõnade kohta
Mul ei ole vaja „loomingulist“ koodi. Ma vajan korrektset koodi. Loo loomingulisus oma kassi nime jaoks. Claude'i promteerimisel on loomingulisus loomulik kõrvalprodukt tugevatest piirangutest. Õiged testid ja selged spetsifikatsioonid viivad elegantsete lahendusteni. Vale prompt toob „uuesti leiutatud base64 emotikonidega“. Ära kiusa teda.
Päris saladus pole saladus
Kuidas promteerida Claude Haiku 4.5 täpseks koodi genereerimiseks on igav: kirjuta täpselt, mida vajad, lukusta versioonid, määra skeemid, nõua teste ja tee iteratsioon konkreetsete vigade põhjal. See on kõik. Mitte mingit müstikat. Lihtsalt insenerduskord, mudel, mis tüüpiliselt kirjutab väga kiiresti ja ei pahanda, kui tuleb kirjutada viisteist peaaegu identset testi.
Ja siin on käänak: täpsus on armetult igav. Töötavad promptid loevad nagu TSA kontrollnimekiri. Personaalselt valmiv kood loeb nagu inimene, kes hoolib. Sa saad mõlemad, kui kohtled mudelit nagu noort inseneri, kes õitseb selgetest nõuetest ja laksub uduste käsutuste eemale. Anna talle leping. Pane ta testid läbima. Alles siis võid ehk usaldada — nagu tööriista, mitte prohvetit.
Kokkuvõte: vähem võlu, rohkem garantii
Kui tahad võlurit, mine mustkunsti etendusele. Kui tahad tarkvara, mis kompileerub ja toimib, kirjuta promptid, mis toimivad nagu garantii. Kuidas promptida Claude Haiku 4.5 täpseks koodi genereerimiseks ei ole lillelise stiiliga ega salajaste võtmesõnadega seotud. See puudutab piiranguid, teste, versioone ja tagasiside tsükleid. Tee need neli asja ja saad koodi, mis töötab. Kui neid ignoreerid, saad ilusat vormindatud ilukirjandust.
Kood ei hooli sinu tunnetest. Õnneks ei tee seda ka testid.
KKK
K1: Milline on lihtsaim viis Claude Haiku 4.5 täpseks koodigeneratsiooniks kutsumiseks?
Kohtu sellega nagu lepinguga: lukusta versioonid, määra skeemid, täpsusta veavormingud ja nõua esmalt teste. Mida selgemad piirangud, seda täpsem kood.
K2: Kuidas vähendada valeinformatsiooni, kui Claude kirjutab koodi?
Kleebi autoriteetsed dokumendid või spetsifikatsioonid ning nõua täpset vastavust nende API-dele. Privaatsete lõpp-punktide puhul lisa oma spetsifikatsioon – ära eelda, et ta suudab ära arvata.
K3: Kas peaksin Claude’lt testide kirjutamist küsima või tegema need ise?
Palu esmalt Claude’l genereerida testid, seejärel loo kood, mis need rahuldab. Testid määratlevad täpsust paremini kui omadussõnad ja hoiavad mudeli ausana.
K4: Kui täpne peaks versioonide lukustamine kutsetes olema?
Väga täpne: programmeerimiskeele jooksuaeg, raamistiku suuremad ja väiksemad versioonid ning SDK versioonid. „Viimane“ toob kaasa vastuolulisi mustreid; täpsus sõltub stabiilsetest sihtmärkidest.
K5: Kuidas Sider.AI sobitub täpse koodikutsumise protsessi?
Kasuta Sider.AI, et hoida spetsifikatsioone, koodi, erinevusi ja testilogisid ühes tsüklis. See ei tee imesid – lihtsalt säilitab konteksti, nii et Claude’i parandused jälgivad sinu tegelikke vigu. 
