Pengenalan: Kod Tidak Peduli Tentang 'Vibe' Anda
Inilah hakikat tentang model bahasa besar dan kod: ia sangat yakin dan sama sekali tidak peduli sama ada program anda berjaya dikompilasi atau tidak. Claude Haiku 4.5 dengan senang hati akan menulis skrip Python yang menyelesaikan masalah anda, ditambah dua lagi yang diciptanya untuk suka-suka. Caranya—satu-satunya cara yang penting—adalah belajar cara memberi arahan () kepada Claude Haiku 4.5 untuk penjanaan kod yang tepat dengan cara yang tidak meninggalkan ruang untuk 'vibe' dan memaksimumkan ruang untuk kebenaran. Anda tidak mahu prosa yang kedengaran seperti kod. Anda mahukan kod yang bertindak seperti kod. Ada perbezaan.
Orang ramai menganggap pemberian arahan () seperti jampi mistik—sebut perkataan yang betul, dapat aplikasi yang sempurna. Itu adalah pemikiran 'cargo cult'. Kod adalah kontrak. Jika anda mahukan ketepatan daripada Claude Haiku, anda perlu menulis kontrak tersebut. “Bina aplikasi web” bukanlah kontrak. “Jana titik akhir () FastAPI dalam Python 3.12 yang menerima JSON, mengesahkan skema dengan Pydantic v2, dan mengembalikan 422 jika terdapat ralat skema dengan format muatan () yang khusus” adalah kontrak. Begitulah cara memberi arahan () kepada Claude Haiku 4.5 untuk penjanaan kod yang tepat: anda tetapkan kontrak tersebut.
Apa Ini (dan Bukan)
- Ia adalah panduan cara untuk mendapatkan kod yang boleh dipercayai dan boleh diuji daripada Claude Haiku 4.5.
- Ia bukan syarahan tentang “AI menggantikan pembangun perisian.” Alat tidak menggantikan pemikiran.
- Ia berfokus pada arahan () praktikal, struktur, dan rel panduan: bahagian-bahagian yang membosankan yang membuatkan keajaiban itu berfungsi.
Jika anda mahukan kod yang berfungsi, anda perlu memberikan Claude definisi yang berfungsi tentang “berfungsi.” Jika anda mahukan penjanaan kod yang tepat, anda perlu mentakrifkan ketepatan dalam istilah yang jelas dan boleh diuji. Itulah keseluruhan permainannya.
Takrifkan Ketepatan Seperti Seorang Peguam, Bukan Seorang Penyair
Kod yang “tepat” bukanlah kod yang “kelihatan munasabah.” Ketepatan adalah:
- Kesahan sintaks: ia berjaya dikompilasi atau berfungsi di bawah pentafsir ().
- Kesetiaan semantik: ia melakukan apa yang dinyatakan dalam spesifikasi.
- Tingkah laku deterministik: input yang sama, output yang sama, dalam had ralat yang ditetapkan.
- Ketepatan versi: ia menggunakan SDK, versi API, dan ciri bahasa yang betul.
Claude akan memberikan anda apa yang anda minta. Jika anda meminta “fungsi yang menyusun senarai,” anda mungkin akan mendapatkannya. Jika anda meminta “isihan stabil di tempat menggunakan semantik Timsort dengan ruang tambahan O(1),” itu adalah janji yang berbeza. “Cara memberi arahan () kepada Claude Haiku 4.5 untuk penjanaan kod yang tepat” bermula dengan menulis janji-janji tersebut ke dalam arahan ().
Arahan () Minimum Boleh Laksana, Dinaik Taraf
Buruk: “Tulis API Node untuk tugasan.”
Lebih Baik: “Tulis API Node 20 Express 4 dengan laluan () POST /tasks yang mengesahkan medan {title: string, dueDate: ISO 8601} dan membalas 201 dengan objek yang dicipta atau 400 dengan butiran ralat.”
Betul: “Jana pelayan Node 20 Express 4 dengan satu titik akhir () POST /tasks. Keperluan: 1) Sahkan badan () dengan [email protected]; 2) Medan: title (rentetan bukan kosong, maks 140), dueDate (tarikh masa depan ISO 8601); 3) Jika berjaya: 201 dengan {id: ULID, title, dueDate}; 4) Jika tidak sah: 400 dengan {error: 'VALIDATION', details: array}; 5) Tiada pangkalan data; Peta dalam ingatan; 6) Sertakan fail ujian Jest 29 yang meliputi kes yang sah, tidak sah (tajuk kosong, tarikh lalu); 7) Sediakan skrip npm untuk ujian dan pembangunan; 8) Gunakan ESM; 9) Jangan sertakan ulasan yang tidak berkaitan.” Perhatikan bentuknya: versi bahasa, pustaka, kekangan, output, ralat, ujian, dan juga struktur pakej. Anda telah menghapuskan kekaburan. Tugas Claude adalah untuk mengisi kod, bukan keperluan.
Pola Perancah: Sistem, Spesifikasi, Ujian, Kemudian Kod
Jika anda mahukan penjanaan kod yang tepat daripada Claude Haiku 4.5, anda perlu memberikannya landasan:
- Pembingkaian sistem (tali pendek)
- Anda: “Anda menulis TypeScript berkualiti pengeluaran untuk Node 20. Hanya keluarkan blok kod dengan nama fail dan tiada yang lain.”
- Kenapa: Anda mengawal nada dan format output. Jangan serahkan kepada peluang.
- Sertakan versi bahasa, pilihan pakej, semantik ralat, format I/O, had prestasi, dan kekangan keselamatan.
- Beritahu Claude untuk menulis ujian unit terlebih dahulu. Ujian mentakrifkan “tepat” lebih baik daripada kata sifat. Jika baris kod tidak memenuhi ujian, ia bersifat hiasan.
- Hanya selepas ujian. Ya, ini pada dasarnya TDD, tetapi dengan robot yang tidak pernah bosan menulis 'boilerplate'.
- Arahan untuk larian semula
- “Jika ujian gagal atau import tidak sepadan, kemas kini hanya bahagian yang gagal. Jangan tulis semula keseluruhan projek.”
Claude berfungsi dengan baik apabila ia mempunyai konteks dan rel. Berikannya rel.
Penyematan Versi Bukan Pilihan
Data latihan Claude penuh dengan dokumen lama dan baharu. Itu adalah cara sopan untuk mengatakan bahawa ia telah melihat banyak nasihat yang bercanggah. “Gunakan React Router” adalah kabur. “Gunakan [email protected] dengan penghala data” adalah arahan. Jangan percayai lalai: - Bahasa: sematkan kepada Python 3.12, Node 20, Go 1.22, Java 21—apa sahaja yang anda jalankan.
- Rangka kerja: nyatakan versi utama yang tepat dan sebarang bendera perubahan yang merosakkan.
- SDK Awan: sematkan versi; aws-sdk v2 berbanding v3 adalah penting.
- Linters/formatters: nyatakan peraturan untuk mengelakkan penulisan semula “ping-pong gaya”.
Jika anda tidak menyemat, anda akan mendapat gabungan 'greatest-hits' daripada lima tahun catatan blog. Penjanaan kod yang tepat alergi kepada nostalgia.
Skema Dahulu, Sentiasa
Jangan minta struktur “profil pengguna”. Tentukan skema dalam arahan () dan perlukan pengesahan:
- Skema JSON atau jenis Zod/Yup dalam JS/TS
- Model Pydantic dalam Python
- Protobuf atau Avro untuk perkhidmatan
Kemudian, pastikan Claude menguatkuasakan skema di sempadan—input API, penulisan pangkalan data, dan barisan mesej. Minta muatan () dan kod ralat yang eksplisit. Ketepatan sukakan skema. Kekaburan tidak.
Jadikannya Boleh Diperhatikan, atau Jangan Berpura-pura Ia Nyata
Beritahu Claude untuk menambah pengelogan, metrik, dan kesan () di tempat yang anda perlukannya—dan untuk memastikan ia senyap di tempat yang anda tidak perlukannya. Arahan () yang baik termasuk:
- Dasar pengelogan: tahap, penapisan PII, struktur (log JSON, sila)
- Metrik: masa setiap permintaan, kiraan ralat
- Titik akhir () kesihatan: /healthz yang membuktikan kebergantungan telah tersedia
Claude akan menambah apa yang anda minta. Jika anda tidak meminta, anda akan mendapat pernyataan cetakan—jika anda bernasib baik.
Arahan () 'Uji Dahulu' Lebih Baik Daripada 'Percayalah Pada Saya'
Cara yang baik untuk memberi arahan () kepada Claude Haiku 4.5 untuk penjanaan kod yang tepat adalah dengan menjadikan ujian sebagai sumber kebenaran. Contoh:
“Tulis ujian pytest untuk fungsi normalize_email(s) yang:
- menukarkan bahagian tempatan dan domain kepada huruf kecil;
- membuang titik dalam bahagian tempatan hanya untuk gmail.com;
- membuang subalamat (+tag) hanya untuk gmail.com;
- menolak input tanpa @ tunggal atau dengan ruang;
- mengekalkan punycode domain unicode seperti sedia ada. Liputan kes ekstrem. Selepas menulis ujian, laksanakan fungsi untuk meluluskannya.”
Claude selalunya akan menulis kod yang lebih baik apabila dipaksa untuk memenuhi ujian yang anda terangkan. Jika tidak, anda mempunyai kegagalan yang konkrit, bukan hujah 'vibe'.
Tiada Halusinasi dengan Pembinaan
Anda tidak boleh menghapuskan halusinasi, tetapi anda boleh mengepungnya:
- Minta petikan atau URL sumber hanya apabila sumber wujud. Untuk kaedah SDK, tuntut pautan dokumen dan minta kod itu sepadan dengan dokumen tersebut.
- Untuk API peribadi, tampal spesifikasi dalam arahan (). Jangan harapkan Claude mengetahui titik akhir () dalaman anda.
- Untuk pustaka dengan API yang mengelirukan, sertakan coretan contoh daripada dokumen rasmi dan beritahu Claude untuk mematuhinya.
Kod yang tepat kebanyakannya adalah rujukan yang tepat. Berikan Claude rujukan tersebut.
Panduan Gaya: Perkara Paling Tidak Menarik, Paling Berguna
Claude menulis kod dalam gaya apa sahaja yang disimpulkannya. Itu adalah resipi untuk 'churn'. Tampal panduan gaya anda. Nyatakan:
- Pemformatan (Prettier, Black, lalai gofmt)
Juga, tuntut ulasan rasional pendek untuk pilihan yang tidak jelas. Anda pada masa hadapan akan berterima kasih, dan Claude semasa akan menghasilkan PR “pembaikan” yang lebih sedikit.
Arahan () Panjang, Output Pendek
Satu lagi cara untuk berfikir tentang cara memberi arahan () kepada Claude Haiku 4.5 untuk penjanaan kod yang tepat: luangkan perkataan anda pada arahan (), bukan output. Anda mahu:
- Kekangan yang lengkap dalam arahan ()
- Penceritaan yang tidak berkaitan yang minimum dalam output
Beritahu ia untuk menyekat penjelasan dan hanya mengembalikan blok kod dengan nama fail dan README pendek. Jika anda mahukan ulasan, minta ia dalam larian yang berasingan. Menyelitkan prosa dan kod adalah cara pepijat menyelinap masuk memakai 'monocle' dan topi tinggi.
Penambahbaikan: Gelung Ketat Yang Benar-benar Berfungsi
Laluan terpantas ke kod yang boleh dipercayai bukanlah “dapatkan ia betul pada percubaan pertama.” Ia adalah gelung pembetulan yang pendek:
- Jalankan secara tempatan. Tampal output ujian yang gagal dan ralat pengkompil kembali ke dalam Claude secara 'verbatim'.
- Arahkan: “Ubah suai hanya baris yang paling diperlukan; jangan ubah tandatangan fungsi kecuali diperlukan oleh ujian yang gagal.”
Claude sangat baik dalam menggunakan 'diffs' apabila anda memberitahunya dengan tepat apa yang rosak. Jangan parafrasa log kegagalan. Tampal ia. Log adalah kebenaran.
Keselamatan Adalah Ciri, Bukan Catatan Tambahan
Oleh kerana model dilatih pada kod awam (baik, buruk, dan terkutuk), anda ingin menjadikan keselamatan sebagai keperluan kelas pertama:
- Larang secara jelas eval, shell=True, dan SQL berjenis rentetan
- Perlukan pertanyaan berparameter, perlindungan CSRF, dan pengehadan kadar
- Minta penyematan kebergantungan serta fail kunci
- Tuntut pengendalian untuk rahsia melalui pemboleh ubah persekitaran atau pengurus rahsia
Arahan () selamat secara lalai menghasilkan kod yang lebih selamat. Arahan () “kami akan tampal kemudian” menghasilkan tajuk utama.
Prestasi: Katakan Apa Yang Dimaksudkan Dengan “Pantas”
“Jadikannya pantas” diterjemahkan kepada “lakukan apa sahaja.” Sebaliknya, nyatakan metrik:
- Sasaran kependaman (p95 < 50ms untuk dalam ingatan, p95 < 300ms untuk operasi DB)
- Kerumitan masa (mestilah O(n log n), bukan O(n^2))
Claude akan memilih algoritma untuk menyesuaikan belanjawan yang anda tetapkan. Berikan ia belanjawan.
Dokumentasi: Cukup untuk Mengintegrasikan Orang Asing
Minta Claude untuk README yang termasuk:
- Arahan persediaan dengan versi yang tepat
- Perintah untuk ujian, lint, typecheck, jalankan
- Contoh permintaan/respons
- Had dan pertukaran yang diketahui
“Kod yang tepat” termasuk dokumen yang tepat. Ia adalah sebahagian daripada hasil yang boleh dihantar.
Templat Arahan () Konkrit Yang Anda Boleh Curi
Templat: Titik Akhir () Belakang
Sistem: Anda seorang jurutera Python 3.12 yang teliti. Hanya keluarkan blok kod dengan nama fail.
Pengguna:
- Bina aplikasi FastAPI 0.111 dengan titik akhir () POST /convert.
- Permintaan: {amount: Decimal sebagai rentetan, from: 'USD'|'EUR', to: sama}.
- Sahkan dengan pydantic v2; kembalikan bentuk 422 jika terdapat ralat skema.
- Gunakan fungsi tulen convert(amount, from, to) dengan kadar tetap {USD:1, EUR:1.1}.
- Kembalikan {amount: string, currency: string} dengan 200.
- Sertakan ujian pytest yang meliputi kes yang sah, tidak sah (perpuluhan buruk, kod tidak diketahui), dan ekstrem (0).
- Sediakan pyproject.toml dengan kebergantungan yang disematkan; sertakan konfigurasi ruff dan mypy.
- Tiada panggilan rangkaian, tiada ulasan.
Templat: Utiliti CLI
Sistem: Anda menulis Go 1.22. Hanya keluarkan blok kod dengan nama fail.
Pengguna:
- Cipta CLI bernama slugify yang membaca stdin dan mencetak 'slugs' selamat URL.
- Peraturan: huruf kecil, ASCII sahaja, pemisah sempang, runtuhkan ruang putih, buang tanda baca.
- Sediakan main.go dan slugify_test.go dengan ujian jadual.
- Gunakan Go stdlib sahaja.
- Sertakan Makefile dengan sasaran ujian dan bina.
Templat: Komponen Frontend
Sistem: Anda seorang jurutera React pragmatik yang menyasarkan React 18 + TypeScript.
Pengguna:
- Laksanakan komponen <DebouncedInput>.
- Props: value: string, onChange(value): void, delay=300.
- Gunakan useRef/useEffect; tiada 'hooks' pihak ketiga.
- Sertakan ujian vitest dengan pemasa palsu.
- Sediakan cerita Storybook yang minimum.
Templat ini menunjukkan cara memberi arahan () kepada Claude Haiku 4.5 untuk penjanaan kod yang tepat dengan menyematkan versi, mentakrifkan tingkah laku, dan memerlukan ujian.
Enggan Menjadi Pintar: Bila Perlu Berkata “Jangan Optimumkan”
Jika anda tidak mahukan pengoptimuman mikro pramatang (dan anda tidak mahu), katakan demikian:
- “Utamakan kebolehbacaan berbanding kepintaran; tiada 'bit-twiddling' kecuali ujian memerlukannya.”
- “Tiada rekursi jika iteratif lebih jelas.”
- “Tiada metaprogramming; eksplisit > implisit.”
Claude suka menarik perhatian. Jangan biarkannya. Pastikan ia lulus ujian dan boleh dibaca. Itu sudah cukup mengagumkan.
Sider.AI dalam Aliran Kerja, Di Mana Ia Benar-benar Membantu Saya telah melihat orang ramai mengurus arahan () dalam tab sembang rawak seperti ia adalah ritual produktiviti. Gunakan ruang kerja yang memahami konteks kod. Sider.AI, contohnya, dibina untuk memastikan spesifikasi, kod, 'diffs', dan log ujian anda kelihatan, jadi gelung “tampal ralat, betulkan baris” benar-benar ketat. Ia bukan sihir; ia adalah perancah yang membosankan yang menghalang anda daripada kehilangan plot. Jika alat anda menyimpan kontrak, ujian, dan kod dalam perbualan yang sama—tanpa mengganggu anda dengan 'confetti'—gunakannya. Sider melakukannya. Cara Menyahpepijat Dengan Claude Sebagai Rakan Sepasukan, Bukan 'Oracle'
- Tampal output ujian yang gagal dengan tepat seperti sedia ada. Jangan rumuskan.
- Minta 'diff': “Balas dengan 'unified diff' terhadap fail X sahaja.”
- Untuk pepijat masa jalan, tambahkan coretan boleh dihasilkan semula yang terkecil dan tuntut penjelasan serta tampalan.
- Untuk ralat pustaka, tampal petikan dokumen yang anda fikirkan berkenaan dan tanya: “Adakah ini API yang betul untuk versi X? Jika tidak, kemas kini kod dan petik petikan yang betul.”
Matlamatnya adalah untuk membuat Claude berhujah dengan bukti. Anda membawa bukti.
Perarakan Perangkap (dan Cara Mengelakkannya)
- Perangkap API “terkini”: Jangan katakan “gunakan terkini.” Katakan “gunakan versi X.Y” dan kekalkan dengannya.
- Fail ujian kosong: Jika anda tidak menuntut ujian, anda tidak akan mendapatkannya.
- Kekeliruan 'one-shot': Rancang dua atau tiga penambahbaikan pendek. Ia lebih pantas daripada satu arahan () yang kembung.
- Dasar ralat yang kabur: Tentukan kod status dan muatan (). “Kembalikan ralat” tidak bermakna apa-apa.
- Kebergantungan yang tidak dimiliki: Jika kod bergantung pada perkhidmatan yang anda tidak boleh kawal, 'stub'kannya. Minta palsu.
Senarai Semak Arahan () Anda (Lekatkan Ini Berdekatan Monitor Anda)
- Versi bahasa dan masa jalan disematkan
- Semantik ralat ditakrifkan (kod, bentuk)
- Ujian dahulu, kemudian kod
- Kekangan keselamatan eksplisit
- Belanjawan prestasi dinyatakan
- Gaya dan struktur dinyatakan
- Format output dikekang (nama fail, blok kod, 'diffs')
- Gelung penambahbaikan pendek dengan log yang ditampal
Jika anda mencapai kesemua sepuluh, Claude Haiku 4.5 secara amnya menghasilkan penjanaan kod yang tepat yang bertahan dalam siang hari.
Contoh Yang Berfungsi: Daripada Kabur kepada Disahkan
Arahan () kabur: “Tulis fungsi untuk menghurai CSV dengan selamat.”
Hasil: Mungkin okay, mungkin salah, pastinya tidak diuji.
Arahan () yang tepat:
“Anda menulis Python 3.12. Hanya keluarkan blok kod dengan nama fail.
Cipta csvsafe/init.py dan csvsafe/reader.py dengan fungsi read_rows(path: Path) -> list[dict[str,str]]. Keperluan: gunakan csv.DictReader dengan newline='' dan encoding='utf-8'; larang bait nol; tolak fail >10MB; hadkan lajur kepada 100; buang BOM; anggap sel kosong sebagai rentetan kosong; naikkan ValueError dengan kod mesej {FILE_TOO_LARGE, NULL_BYTE, TOO_MANY_COLUMNS}. Sertakan ujian dalam tests/test_reader.py dengan pytest yang meliputi laluan gembira, bait nol, fail 11MB, 101 lajur, dan pengendalian BOM. Sediakan pyproject.toml dengan kebergantungan yang disematkan dan konfigurasi hitam.”
Anda akan mendapat kod, ujian, dan pengendalian kes ekstrem. Kemudian anda menjalankan ujian, menampal kegagalan, dan berulang dengan 'diffs' yang minimum. Itulah penjanaan kod yang tepat dalam amalan.
Tentang “Kreativiti” dan Perkataan Pemasaran Lain
Saya tidak memerlukan kod yang “kreatif”. Saya memerlukan kod yang betul. Simpan kreativiti untuk menamakan kucing anda. Apabila memberi arahan () kepada Claude, kreativiti adalah hasil semula jadi daripada kekangan yang kukuh. Ujian yang betul dan spesifikasi yang jelas menghasilkan penyelesaian yang elegan. Arahan () yang salah menghasilkan “base64 yang dicipta semula dengan emoji.” Jangan menggodanya.
Rahsia Bukan Rahsia
Cara untuk memberi arahan () kepada Claude Haiku 4.5 untuk penjanaan kod yang tepat adalah membosankan: tuliskan apa yang anda perlukan, sematkan versi, tentukan skema, tuntut ujian, dan berulang dengan kegagalan sebenar. Itu sahaja. Tiada mistik. Hanya disiplin kejuruteraan, dengan model yang boleh menaip dengan sangat pantas dan tidak keberatan menulis lima belas kes ujian yang hampir sama.
Dan itulah kelainannya: ketepatan tidak menarik. Arahan () yang berfungsi dibaca seperti senarai semak TSA. Kod yang dihantar dibaca seperti ia ditulis oleh manusia yang mengambil berat. Anda mendapat kedua-duanya dengan melayan model seperti jurutera junior yang berkembang maju di bawah keperluan yang jelas dan layu di bawah arahan yang kabur. Berikan ia kontrak. Pastikan ia lulus ujian. Kemudian, mungkin, anda boleh mempercayainya—dengan jenis kepercayaan yang anda berikan kepada alat, bukan nabi.
Kesimpulan: Kurang Ilmu Sihir, Lebih Jaminan
Jika anda mahukan ilmu sihir, pergi ke pertunjukan silap mata. Jika anda mahukan perisian yang berjaya dikompilasi dan berkelakuan, tulis arahan () yang berfungsi seperti jaminan. Cara memberi arahan () kepada Claude Haiku 4.5 untuk penjanaan kod yang tepat bukanlah tentang ungkapan berbunga-bunga atau kata kunci rahsia. Ia adalah tentang kekangan, ujian, versi, dan gelung maklum balas. Lakukan empat perkara itu, dan anda akan mendapat kod yang berfungsi. Langkau mereka, dan anda akan mendapat fiksyen yang diformat dengan indah.
Kod tidak peduli dengan suasana hati anda. Mujurlah, ujian juga tidak peduli.
Soalan Lazim
S1: Apakah cara paling mudah untuk memberitahu Claude Haiku 4.5 supaya menghasilkan kod yang tepat?
Anggap ia seperti kontrak: tetapkan versi, tentukan skema, nyatakan format ralat, dan minta ujian dahulu. Semakin jelas kekangan, semakin tepat kodenya.
S2: Bagaimana saya boleh mengurangkan khayalan apabila Claude menulis kod?
Tampal dokumen atau spesifikasi yang sah dan tuntut kepatuhan kepada API tersebut dengan tepat. Untuk titik akhir peribadi, sertakan spesifikasi anda sendiri—jangan harap ia boleh meneka.
S3: Patutkah saya minta Claude buat ujian atau tulis sendiri?
Minta Claude hasilkan ujian dahulu, kemudian tulis kod untuk memenuhi ujian itu. Ujian lebih tepat menentukan ketepatan berbanding deskripsi dan memastikan model jujur.
S4: Sejauh mana penetapan versi perlu spesifik dalam arahan?
Sangat spesifik: masa jalan bahasa, versi utama/kecil kerangka kerja, dan versi SDK. "Terbaharu" mengundang corak bercanggah; ketepatan bergantung kepada sasaran yang stabil.
S5: Di manakah Sider.AI sesuai dalam arahan untuk kod tepat?
Gunakan Sider.AI untuk menyimpan spesifikasi, kod, perbezaan, dan log ujian dalam satu kitaran. Ia bukan sihir—ia hanya mengekalkan konteks supaya pembetulan Claude mengesan kegagalan sebenar anda. 
