Panduan Lengkap Claude Code: Dari Pemasangan hingga Menyiapkan AI untuk Menyiapkan Satu Ciri Secara Autonom

Pukul sebelas malam, hanya tinggal dua orang sahaja di sebuah pejabat syarikat pemula di Neihu. Seorang jurutera menerima tugas untuk membaiki bug sebelum sistem dilancarkan pada keesokan harinya. Masalahnya berpunca daripada modul yang ditulis oleh rakan sekerja yang telah berhenti tiga tahun lalu, tanpa sebarang nota (comment) mahupun ujian (test). Dia memasukkan keperluan tersebut ke dalam terminal dan beransur untuk membancuh kopi. Apabila kembali, skrin memaparkan lima fail berkaitan, mengenal pasti punca yang berkemungkinan, membaiki salah satu bahagian, serta telah pun menjalankan ujian.

Ini bukan babak iklan, tetapi rutin harian menggunakan Claude Code pada masa kini. Namun, memandangkan ia benar-benar mengubah kod anda, kos kesilapan jika salah guna adalah jauh lebih tinggi berbanding alat AI biasa. Artikel ini merumuskan alur kerja (workflow) yang saya guna pakai sendiri, termasuk beberapa pengajaran pahit yang saya lalui.

Apakah Alat Ini: Ejen, Bukan Autolengkap

Mari kita jelaskan kedudukannya terlebih dahulu kerana ini menentukan cara anda patut menggunakannya.

Kebanyakan alat penulisan kod AI yang biasa kita kenal ialah jenis "autolengkap": anda taip, ia teka baris seterusnya, lalu anda tekan Tab untuk terima. GitHub Copilot pada peringkat awal menggunakan mod ini, di mana anda memerhatikannya sepanjang masa untuk menjimatkan masa menaip.

Claude Code pula ialah jenis "ejen". Anda beri satu matlamat—baiki bug ini, atau tambahkan penomboran halaman (pagination) pada API ini—dan ia sendiri menentukan fail mana yang perlu dibaca, arahan mana yang perlu dijalankan, serta bagaimana cara membaiki ujian yang gagal. Setelah keseluruhan kitaran selesai, tugas anda hanyalah menyemak dan menerima hasil akhirnya.

Implikasi praktikalnya ialah: Peranan anda berubah daripada "orang yang menaip" kepada "orang yang menyemak". Apa yang dijimatkan bukanlah masa menaip, tetapi masa untuk memahami kod yang tidak dikenali serta proses cuba jaya (trial and error). Bagi mereka yang kurang kemahiran menyemak, penggunaan alat ini sebenarnya membawa bahaya.

Di Mana Ia Boleh Digunakan

Antaramuka semasanya adalah lebih banyak daripada yang disangkakan oleh kebanyakan orang:

• CLI Terminal: Fungsi paling lengkap, arahan pemasangannya ialah curl -fsSL https://claude.ai/install.sh | bash
• Versi Desktop: Tersedia untuk macOS, Linux, dan Windows
• Versi Pelayar Web: claude.ai/code, tanpa perlu pasang apa-apa
• Palam Tambahan IDE: VS Code dan JetBrains
• Telefon Bimbit: Aplikasi iOS dan Android
• Bot Slack: Buka tugasan secara terus dalam perbualan
• GitHub Actions: Melakukan semakan PR automatik

Secara peribadi, saya menggunakan CLI sebagai asas dan memantau kemajuan melalui telefon bimbit. Kelebihan CLI ialah ia berada di dalam direktori projek itu sendiri, di mana pemboleh ubah persekitaran (environment variables), status git, dan arahan ujian semuanya tersedia sedia.

Cara Menggunakan: Empat Langkah

Langkah Pertama: Pasang dan Mulakan di Dalam Direktori Projek

Selepas selesai memasang, anda mesti cd ke direktori akar projek sebelum memulakannya. Ramai orang memulakannya di direktori utama (home) mereka, menyebabkan ia tidak dapat melihat struktur projek dan akhirnya hanya meneka secara membabi buta. Pelancaran kali pertama akan meminta anda log masuk; jika anda mempunyai langganan Claude, pautkan sahaja secara terus, manakala pengguna kunci API boleh mengikut kiraan token.

Langkah Kedua: Biarkan Ia Memahami Projek Dahulu, Barulah Berikan Arahan

Kesilapan paling kerap dilakukan oleh pengguna baharu ialah terus melontarkan keperluan sebaik sahaja bermula. Ayat pertama yang lebih baik ialah:

Sila lihat struktur projek ini terlebih dahulu, beritahu saya timbunan teknologi (tech stack), cara modul utama dibahagikan, dan bagaimana ujian dijalankan. Jangan ubah apa-apa lagi buat masa ini.

Ayat "Jangan ubah apa-apa lagi buat masa ini" adalah amat penting—ia mempunyai sifat lalai yang agresif, di mana ia mungkin terus bertindak jika anda tidak menghalangnya. Selepas mengesahkan ia tidak salah faham, barulah bergerak ke langkah seterusnya.

Langkah Ketiga: Tulis CLAUDE.md, Langkah Paling Kritikal untuk Seluruh Alat Ini

Letakkan fail CLAUDE.md di direktori akar projek, dan tuliskan peraturan projek di dalamnya. Ia akan membaca fail ini setiap kali dimulakan. Kualiti fail inilah yang menentukan sama ada pengalaman penggunaan anda lancar atau mendatangkan kemarahan.

Apa yang sebenarnya perlu ditulis:

Konvensyen Projek

• Bahagian hadapan (Frontend) menggunakan TypeScript + React, bahagian belakang (Backend) Node.js
• Ujian menggunakan vitest, arahan pelaksanaan npm run test
• Mesej commit menggunakan Bahasa Cina (atau Inggeris ikut kesesuaian), format: jenis: penerangan

Had Penting

• Hanya lakukan perkara yang saya minta secara jelas. Jangan buat penstrukturan semula (refactoring) sendiri atau tambah lapisan abstrak yang tidak diminta.
• Jangan tambah pakej pihak ketiga melainkan saya memintanya terlebih dahulu.
• Kod di bawah src/legacy/ jangan disentuh, itu adalah sistem lama yang akan digantikan.
• Selepas selesai mengubah, pastikan npm run test dijalankan; jika ujian gagal, jangan katakan ia sudah siap.

Peraturan "Hanya lakukan perkara yang saya minta secara jelas" adalah peraturan yang paling wajib ditulis pada pandangan saya. Apabila anda menyuruhnya membaiki satu bug, ia mungkin secara spontan menyusun semula tiga fail, menambah pengendalian ralat, dan melengkapkan jenis data (types). Secara individu mungkin ia tidak salah, tetapi semakan kod (code review) anda akan menjadi satu bencana kerana anda tidak dapat membezakan bahagian mana yang wajib diubah untuk membaiki bug dan bahagian mana yang ditambah sendiri olehnya.

Langkah Keempat: Berikan Tugasan, Kemudian Buat Semakan

Lebih spesifik penerangan tugasan, lebih baik hasilnya. Contoh soalan yang lemah dan baik:

• ❌ "Tolong optimumkan kod ini" — Ia tidak tahu apa yang anda mahu optimumkan, sama ada prestasi atau kebolehbacaan.
• ✅ "Fungsi ini mengalami masa tamat (timeout) apabila jumlah data melebihi 10,000 rekod. Cari punca kesesakan dan baikinya tanpa mengubah antaramuka luarannya. Jalankan ujian selepas selesai."

Cara penulisan kedua memberikan matlamat, batasan, serta kriteria penerimaan hasil kepada AI tersebut.

Teknik Lanjutan

Gunakan /clear untuk memotong konteks. Apabila beralih ke tugasan lain tanpa mengosongkannya, konteks tugasan sebelumnya akan mengganggu penilaian. Pastikan satu tugasan menggunakan satu perbualan yang bersih.

Manfaatkan mod pelan (plan mode). Apabila berdepan dengan perubahan besar, minta ia "cadangkan pelan sahaja, jangan buat apa-apa lagi". Luluskan pelan tersebut sebelum membenarkannya bertindak; ia jauh lebih menjimatkan masa daripada membaiki semula kod yang sudah salah diubah.

Biarkan ia melihat sendiri mesej ralat. Anda tidak perlu menyalin dan melekat (copy-paste) ralat tersebut; terus arahkan ia menjalankan ujian, dan ia akan membaca output serta membaikinya sendiri.

Pengurusan Kuota. Pelan Pro (kira-kira $17–$20 sebulan) untuk penstrukturan semula berskala besar amat mudah menghabiskan kuota dalam masa beberapa jam. Pengguna tegar biasanya perlu dinaik taraf kepada Max 5x ($100) atau Max 20x ($200). Adalah disyorkan untuk mencuba pelan Pro selama sebulan terlebih dahulu, catat kekerapan anda mencapai had maksimum sebelum membuat keputusan.

Perkara Yang Perlu Diberi Perhatian

Ia boleh menghasilkan kod yang kelihatan betul tetapi sebenarnya salah. Kod yang ditulisnya mempunyai sintaks yang betul, gaya yang konsisten, dan kelihatan sangat profesional, tetapi logiknya mungkin salah, terutamanya pada keadaan sempadan (edge cases) dan isu keserentakan (concurrency). Anda mesti mempunyai keupayaan untuk menyemak outputnya, ini bukan pilihan.

Isu kebocoran data perlu disahkan terlebih dahulu. Kod akan dihantar ke model awan. Bagi projek kewangan, perubatan, dan projek yang terikat dengan perjanjian kerahwasaan, pastikan anda menyemak dasar syarikat dan terma kontrak sebelum membawanya masuk—kebanyakan pasukan di Taiwan menggunakannya dahulu sebelum teringat mengenainya, urutan langkah yang salah.

Jangan biarkan ia menyentuh migrasi pangkalan data dan pelancaran persekitaran produksi (production deployment). Operasi sebegini adalah tidak boleh balik (irreversible), dan kos kesilapan adalah jauh lebih tinggi daripada masa yang dijimatkan. Prinsip saya ialah: Perkara yang boleh ditarik balik, biarkan ia buat; perkara yang tidak boleh ditarik balik, lakukan sendiri.

Jangan harapkan ia menggantikan pemikiran arkitek anda. Ia sangat cekap dalam melaksanakan tugas, tetapi keputusan seperti "adakah ciri ini perlu dibuat, perlukah kita memecahkan servis, bagaimana reka bentuk model data" masih merupakan tugas anda. Untuk perbandingan Silang, anda boleh padankan dengan penyelesaian penyepaduan editor seperti Cursor.

Alur Kerja yang Sesuai Dipadankan

Rima kerja saya ialah: pada waktu pagi, berikan tugasan berskop jelas untuk ia jalankan sementara saya menguruskan bahagian yang memerlukan pertimbangan manusia, dan pada waktu petang barulah saya menyemak secara menyeluruh semua diff yang dihasilkannya. Untuk lebih banyak kaedah menyelitkan AI ke dalam kerja harian, anda boleh merujuk kepada Panduan Tugasan AI atau Pustaka Templat Prompt.

Ulasan TheAI學院

Sejujurnya, saya agak kurang bersetuju dengan tanggapan "AI akan menggantikan jurutera", tetapi selepas menggunakannya selama beberapa bulan, saya akui isi kandungan kerja jurutera sememangnya sedang berubah. Perubahannya bukanlah pada "sama ada kita masih memerlukan jurutera", tetapi nilai telah beralih daripada "menulis kod" kepada "menilai sama ada kod itu betul atau tidak".

Ulasan: Claude Code ialah ejen pengekodan AI yang paling matang setakat ini, tetapi apa yang ia perbesarkan ialah keupayaan penilaian sedia ada anda—sesiapa yang mempunyai daya penilaian yang kuat akan berlipat ganda produktivitinya, manakala mereka yang lemah daya penilaiannya hanya akan menghasilkan hutang teknikal (technical debt) dengan lebih pantas.

Cadangan khusus untuk pembaca: Jurutera yang mempunyai pengalaman lebih tiga tahun patut memasukkannya ke dalam alur kerja sekarang juga, bermula dengan "menulis ujian" dan "membaiki bug yang jelas"—ia memberikan pulangan pelaburan (ROI) yang paling tinggi dan risiko paling rendah. Bagi pendatang baharu dalam industri pula, saya menyarankan agar anda menulis sendiri terlebih dahulu, kemudian barulah bandingkannya dengan hasil AI, jangan pintas fasa pembinaan daya penilaian tersebut. Bagi pengambilan di peringkat pasukan, biarkan seorang atau dua orang jurutera kanan mencubanya selama sebulan, dan hitung ROI berdasarkan jam kerja yang dijimatkan; ia adalah jauh lebih tepat daripada membaca sebarang ulasan.

Sumber Rujukan

• Halaman Produk Rasmi Claude Code (Cara pemasangan, platform disokong, pelan)

Disusun berdasarkan maklumat awam, tertakluk kepada maklumat rasmi. Fungsi sebenar dan harga mungkin berubah mengikut versi.