Blog

Laman Astro melalui Claude Code: daripada Folder hingga Penerbitan

Markdown

Panduan langkah demi langkah: cara membina laman dengan Astro melalui Claude Code tanpa perlu tahu pengaturcaraan. Perkara yang perlu dipasang, arahan untuk mencipta projek dan cara menerbitkannya secara percuma.

Baca artikel penuh

Seseorang yang tidak pernah menulis satu baris kod pun boleh membina laman dengan Astro melalui Claude Code. Saya sudah lama tidak menulis kod secara manual; saya melakukan semuanya dengan kata-kata melalui AI, dan membina laman dengan Astro berfungsi dengan cara yang sama: terangkan perkara yang anda perlukan, dan Claude akan menulis kod untuk anda.

Biasanya, masalahnya bukan pada proses membina itu sendiri, tetapi pada laluan yang terbahagi kepada beberapa bahagian. Satu artikel menerangkan pemasangan, satu lagi membincangkan arahan, dan satu lagi tentang penerbitan, lalu keseluruhan langkahnya tidak dapat difahami dengan jelas. Di sini, saya akan membawa anda daripada folder kosong kepada laman yang boleh dibuka di Internet melalui pautan: perkara yang perlu dipasang, arahan untuk memulakan projek, cara membina halaman melalui Claude Code dan cara menerbitkan hasilnya secara percuma. Saya merujuk dokumentasi rasmi Astro.

Tentang cara menggunakan perkhidmatan ini — dalam dokumentasi Ailoot.

Apakah yang diperlukan sebelum bermula?

Intipati utama

Tiga perkara pada komputer anda: versi Node.js yang terkini, editor kod dan terminal. Node.js ialah persekitaran tempat alat-alat ini dijalankan; pada tarikh penulisan, dokumentasi Astro memerlukan versi 22.12.0 atau lebih baharu dan memberi amaran bahawa versi bernombor ganjil seperti 23 tidak disokong. Editor yang biasanya digunakan ialah VS Code, tempat Claude Code juga boleh digunakan. Terminal ialah tetingkap hitam untuk memasukkan arahan; ia sudah tersedia dalam VS Code. Anda tidak perlu memasang semua ini secara berasingan untuk Astro: jika anda pernah membina sesuatu dengan Claude Code, persekitaran anda sudah sedia.

Anda tidak perlu memuat turun Astro terlebih dahulu — ia akan dimuat turun melalui arahan dalam langkah seterusnya. Namun, anda memerlukan persekitaran untuk menjalankan semuanya. Astro menerangkan bahawa anda memerlukan tiga perkara untuk bermula:

Node.js — versi v22.12.0 atau lebih baharu. Versi bernombor ganjil seperti v23 tidak disokong. Editor teks — kami mengesyorkan VS Code dengan sambungan rasmi Astro kami. Terminal — Astro diurus melalui baris arahan.

— Dokumentasi Astro, bahagian pemasangan, https://docs.astro.build/en/install-and-setup/

Mari kita lihat maksud setiap perkara ini dalam amalan:

  1. Node.js — program yang diperlukan untuk menjalankan Astro dan kebanyakan alat vibe-coding. Muat turunnya daripada nodejs.org dan pasangkannya seperti aplikasi biasa. Nombor versi dalam dokumentasi berubah dari semasa ke semasa, jadi sebelum bermula, lawati halaman pemasangan Astro dan semak keperluannya. Anda memerlukan versi bernombor genap (22, 24); sebaik-baiknya elakkan versi bernombor ganjil (23, 25).
  2. VS Code — editor percuma daripada Microsoft. Buka folder projek di dalamnya dan jalankan Claude Code di situ juga; Claude akan menulis kod.
  3. Terminal — tetingkap untuk memasukkan arahan. Anda tidak perlu memasangnya secara berasingan: buka melalui menu dalam VS Code dan masukkan semua arahan di bawah di situ.

Jika anda sudah memasang Claude Code dan pernah membina apa-apa dengannya, semua ini sudah tersedia dan anda boleh melangkau langkah ini. Jika belum, saya ada panduan berasingan tentang cara memasang Claude Code.

Bagaimanakah cara mencipta projek Astro dengan satu arahan?

Intipati utama

Projek baharu dicipta melalui terminal dengan arahan npm create astro@latest. Satu wizard akan bermula dan bertanya beberapa soalan (lokasi pemasangan, templat yang hendak digunakan dan sama ada kebergantungan perlu dipasang), kemudian menyediakan rangka asas projek untuk anda. Jika folder projek belum wujud, wizard akan menciptanya. Selepas itu, masuk ke folder projek dengan arahan cd dan anda boleh mula bekerja. Anda tidak perlu mencipta folder kosong terlebih dahulu.

Di sinilah projek bermula, dan anda hanya memerlukan satu arahan. Buka terminal dan masukkan:

npm create astro@latest

Wizard pemasangan akan bermula. Inilah yang dinyatakan dalam dokumentasi tentangnya:

Anda boleh menjalankan arahan create astro di mana-mana lokasi pada komputer anda, jadi anda tidak perlu mencipta folder projek kosong terlebih dahulu. Jika folder itu belum wujud, wizard akan membantu menciptanya secara automatik.

— Dokumentasi Astro, bahagian pemasangan, https://docs.astro.build/en/install-and-setup/

Wizard akan membimbing anda melalui langkah-langkahnya dan bertanya beberapa soalan: nama folder projek, templat permulaan dan sama ada kebergantungan perlu dipasang serta-merta. Anda boleh memilih pilihan lalai bagi setiap soalan — templat kosong atau ringkas sesuai untuk laman pertama anda. Jika anda menjawab “tidak” kepada soalan tentang pemasangan kebergantungan, pasangkannya secara manual kemudian dengan menjalankan arahan npm install di dalam folder projek.

Apabila wizard selesai, ia akan memaklumkan bahawa projek telah dicipta dan mencadangkan langkah seterusnya — masuk ke folder projek:

cd your-project-name

Itu sahaja untuk mencipta projek. Di dalamnya sudah tersedia rangka asas laman yang berfungsi: beberapa fail dan folder untuk membina halaman. Anda tidak perlu mengeditnya secara manual, tetapi ada baiknya mengetahui kandungannya. Astro hanya mewajibkan satu folder:

src/pages — subfolder projek yang wajib. Tanpanya, laman tidak akan mempunyai halaman atau laluan.

— Dokumentasi Astro, bahagian struktur projek, https://docs.astro.build/en/basics/project-structure/

Dengan kata lain, src/pages ialah folder yang mengandungi halaman laman: halaman utama, “tentang kami” dan halaman hubungan. Biasanya, src/components (bahagian yang boleh digunakan semula seperti pengepala dan butang), src/layouts (rangka halaman yang dikongsi) dan folder public untuk imej serta fail terletak berdekatan. Anda tidak perlu menghafal strukturnya — cukup ingat bahawa halaman berada dalam src/pages, dan sebutkannya apabila meminta Claude: “tambahkan halaman hubungan.”

Bagaimanakah cara membina laman itu sendiri melalui Claude Code?

Intipati utama

Buka folder projek dalam VS Code, lancarkan Claude Code, kemudian terangkan dengan kata-kata perkara yang anda perlukan pada laman. Claude akan mengedit sendiri fail dalam src/pages dan folder bersebelahan. Hasil terbaik diperoleh dengan tugasan kecil dan jelas: “buat halaman utama dengan tajuk, penerangan ringkas dan butang,” kemudian “tambahkan halaman perkhidmatan,” dan selepas itu “tukar warna kepada warna gelap.” Selepas setiap permintaan, lihat hasilnya dalam pelayar dan berikan penjelasan lanjut jika perlu. Anda tidak perlu mengatur cara ini dengan kod. Tugas anda ialah memberikan arahan yang jelas dan menyemak hasilnya.

Rangka asas sudah sedia; sekarang laman anda dibina daripadanya dan Claude Code akan menguruskannya. Buka folder projek dalam VS Code, lancarkan Claude Code dan terangkan dengan kata-kata perkara yang anda perlukan. Claude sendiri akan mengedit fail dalam src/pages dan folder berdekatan — anda hanya perlu memberikan tugasan dan melihat hasilnya.

Berdasarkan pengalaman saya, cara terbaik ialah bekerja dalam langkah-langkah kecil. Satu permintaan besar seperti “buatkan laman web syarikat” biasanya menghasilkan sesuatu yang berserabut dan sukar dibaiki. Jadi, pecahkannya kepada tugasan pendek dan jelas, kemudian berikan satu demi satu:

  1. “Buat halaman utama: tajuk besar, beberapa ayat tentang kerja saya dan butang yang memaut ke halaman hubungan.”
  2. “Tambahkan halaman perkhidmatan dengan senarai tiga bahagian.”
  3. “Tambahkan halaman hubungan dengan nombor telefon dan pautan ke Telegram.”
  4. “Tukar gayanya: latar belakang cerah dan fon besar yang mudah dibaca.”

Semak setiap langkah sebelum meneruskan — lebih mudah untuk mengesan kesilapan dan kembali membetulkannya. Sebab tugasan kecil lebih boleh diharap dan cara memastikan AI kekal pada landasan yang betul merupakan sebahagian daripada kejuruteraan konteks: semakin jelas tugasan dan struktur projek, semakin mudah hasilnya dijangka.

Astro menyediakan struktur yang mudah untuk digunakan oleh AI: kandungan halaman diasingkan daripada penggayaan dan halaman dibina mengikut peraturan yang sama. Dengan struktur ini, Claude kurang keliru dan kurang berkemungkinan merosakkan bahagian berdekatan apabila mengedit satu tempat. Jika Claude tiba-tiba tidak dapat melihat fail anda atau memberikan jawapan yang tidak berkaitan, lihat panduan tentang sebab Claude Code tidak dapat melihat fail projek.

Astro hanyalah satu komponen dalam kerja menggunakan AI. Untuk membantu Claude membina perkara yang anda perlukan secara konsisten tanpa bergantung pada tekaan yang kelihatan munasabah, persediaan lengkap untuk projek anda merangkumi: Klon AI + Otak Kedua + Kejuruteraan Konteks.

Bagaimanakah cara melihat pratonton laman sebelum diterbitkan?

Intipati utama

Untuk melihat laman sebelum ia tersedia dalam talian, Astro menyediakan pelayan pembangunan. Masukkan arahan npm run dev dalam terminal di dalam folder projek, dan Astro akan memulakan pratonton setempat — biasanya pada localhost di port 4321. Buka alamat ini dalam pelayar untuk melihat laman anda secara langsung. Perubahan yang Claude lakukan pada fail akan dipaparkan semasa anda bekerja: ubah sedikit teks dan halaman akan dikemas kini sendiri. Pelayan ini hanya boleh dilihat oleh anda pada komputer sendiri; ia tidak menerbitkan laman ke Internet.

Sebelum memperkenalkan laman kepada orang ramai, lihat pratontonnya pada komputer sendiri. Astro menyediakan pelayan pembangunan untuk tujuan ini — ia memaparkan laman secara langsung pada komputer anda. Mulakannya dengan arahan dalam terminal, di dalam folder projek:

npm run dev

Astro akan memulakan pratonton setempat dan memaparkan alamatnya dalam terminal. Secara lalai, alamatnya ialah localhost:4321. Salin alamat itu, buka dalam pelayar dan anda akan melihat laman anda. Buat masa ini, hanya anda boleh membuka alamat ini — orang lain tidak boleh mengaksesnya; inilah draf anda.

Pratonton ini dikemas kini secara langsung: Claude mengedit fail dan halaman dalam pelayar dikemas kini sendiri; anda tidak perlu memuat semula secara manual. Prosesnya pantas — minta Claude melakukan sesuatu, lihat hasilnya dalam pelayar, buat pembetulan dan lihat semula. Pada peringkat inilah anda memperkemas laman. Apabila anda berpuas hati dengan hasilnya, terbitkannya dalam talian.

Bagaimanakah cara menerbitkan laman Astro dalam talian secara percuma?

Intipati utama

Cara percuma yang paling mudah ialah melalui GitHub. Mula-mula, muat naik projek ke repositori di GitHub (repositori kod dalam talian). Kemudian sambungkan perkhidmatan pengehosan yang boleh membina laman Astro: Netlify, Vercel atau GitHub Pages sendiri. Perkhidmatan pengehosan akan mengenali Astro, membina laman dengan arahan binaan dan menerbitkannya pada alamatnya sendiri. Setiap kali anda menghantar perubahan baharu ke repositori, laman akan dibina semula dan dikemas kini secara automatik. Claude Code juga boleh membantu anda menyediakan semuanya melalui arahan dalam kata-kata.

Anda perlu meletakkan laman yang siap di suatu tempat supaya orang lain boleh membukanya melalui pautan. Cara percuma yang paling mudah ialah melalui GitHub: mula-mula muat naik kod projek ke repositori, kemudian sambungkan perkhidmatan pengehosan yang membina dan menerbitkan laman. Inilah urutannya:

  1. Cipta repositori di GitHub. Repositori ialah tempat simpanan kod dalam talian untuk menghantar fail projek. Claude Code boleh membantu melalui arahan bahasa semula jadi: minta “muat naik projek ke repositori GitHub baharu,” dan ia akan mencadangkan arahan. Jika anda belum pernah menggunakan GitHub, sediakan panduan untuk mendaftar dan log masuk.
  2. Sambungkan pengehosan. Pergi ke salah satu perkhidmatan (Netlify, Vercel), log masuk melalui akaun GitHub dan pilih repositori anda. Dokumentasi Astro menerangkan kaedah ini begini: perkhidmatan pengehosan memantau repositori anda, membina laman dan menerbitkannya.
  3. Semak tetapan binaan. Biasanya, perkhidmatan pengehosan akan mengenali Astro dan mengisi perkara yang diperlukan. Jika anda diminta memasukkannya secara manual, arahan binaan dalam dokumentasi ialah astro build (atau npm run build), dan laman yang siap diletakkan dalam folder dist.
  4. Klik “Terbitkan.” Perkhidmatan itu akan membina laman dan memberikan pautan seperti site-name.netlify.app. Sesiapa sahaja boleh membuka laman pada alamat tersebut.

Inilah kata-kata tepat dokumentasi tentang menyambungkan repositori kepada perkhidmatan pengehosan:

Banyak perkhidmatan pengehosan popular akan mengenali projek anda sebagai laman Astro dan memilih tetapan binaan serta penerapan yang sesuai secara automatik. Perkhidmatan pengehosan akan memantau cabang utama repositori anda, membina semula laman dan menerapkannya semula setiap kali ada perubahan baharu.

— Dokumentasi Astro, bahagian penerapan, https://docs.astro.build/en/guides/deploy/

Selepas itu, penerbitan berlaku secara automatik: hantar perubahan baharu ke repositori dan laman akan dibina semula serta dikemas kini sendiri; anda tidak perlu mengklik apa-apa lagi.

Ada juga pilihan percuma kedua — GitHub Pages, tempat laman diterbitkan terus daripada repositori menggunakan alat GitHub sendiri. Astro menyediakan templat permulaan rasmi untuknya:

Astro menyokong GitHub Action rasmi untuk menerapkan projek ke GitHub Pages dengan hampir tiada konfigurasi, dan ini ialah cara yang disyorkan untuk menerapkan ke GitHub Pages.

— Dokumentasi Astro, bahagian penerapan di GitHub Pages, https://docs.astro.build/en/guides/deploy/github/

Dengan pilihan ini, laman boleh dibuka pada alamat seperti your-name.github.io/repository-name, dan anda boleh menyambungkan domain sendiri kemudian. Anda juga boleh mengurus penyediaannya melalui Claude Code: terangkan tugas itu dengan kata-kata, dan ia akan menyediakan fail yang diperlukan.

Berapakah kos untuk membina laman Astro?

Intipati utama

Astro sendiri percuma dan sumber terbuka — tiada bayaran untuk menggunakannya. Pengehosan asas juga boleh percuma: GitHub Pages serta pelan permulaan daripada Netlify dan Vercel, yang mencukupi untuk laman Astro yang ringan. Perbelanjaan sebenar ialah alat AI yang anda gunakan untuk membina laman (Claude) dan, jika mahu, domain sendiri sebagai ganti alamat percuma daripada perkhidmatan pengehosan. Jadi, laluan minimum untuk “membina dan menerbitkan laman” boleh dilakukan tanpa membayar pengehosan: anda hanya membayar AI.

Sekarang, mari kita bincangkan kos. Astro sendiri ialah alat percuma dan sumber terbuka; tiada harga berasingan untuknya. Perkhidmatan pengehosan asas juga menawarkan pilihan percuma: GitHub Pages serta pelan permulaan daripada Netlify dan Vercel, yang biasanya mencukupi untuk laman Astro yang ringan (pelan percuma mempunyai had trafik, tetapi biasanya mencukupi untuk laman kad perniagaan yang ringkas atau halaman pendaratan).

Dalam amalan, ada dua perkara yang mungkin perlu dibayar, dan itu pun tidak semestinya. Yang pertama ialah alat AI yang anda gunakan untuk membina laman. Yang kedua ialah domain sendiri sebagai ganti alamat seperti name.netlify.app; pilihan ini tidak wajib dan kosnya rendah setahun. Anda boleh melengkapkan proses “bina laman dan terbitkan dalam talian” dengan hanya membayar Claude.

Apakah soalan lain tentang laman Astro dan Claude Code?

Intipati utama

Jawapan ringkas kepada soalan lazim. Anda tidak perlu tahu pengaturcaraan: Claude menulis kod, manakala anda memberikan tugasan dengan kata-kata dan menyemak hasilnya. Laman yang siap kekal sebagai fail anda dan boleh ditempatkan pada mana-mana perkhidmatan pengehosan; anda tidak terkunci pada platform orang lain. Astro sesuai untuk laman kandungan — laman kad perniagaan, halaman pendaratan, blog atau pameran; untuk bahagian akaun peribadi yang kompleks, lebih baik gunakan alat lain. Anda juga boleh menerbitkan laman yang siap secara percuma melalui GitHub.

Soalan lazim

Adakah anda perlu tahu pengaturcaraan untuk membina laman dengan Astro melalui Claude Code?

Tidak. Saya sudah lama berhenti menulis kod secara manual; saya melakukan semuanya melalui AI. Berikan tugasan dalam kata-kata — “buat halaman utama dengan tajuk seperti ini” — dan Claude Code akan menulis serta mengedit fail untuk anda. Anda tidak perlu tahu sintaks. Anda perlu memahami jenis laman yang anda inginkan dan menyemak hasilnya dalam pelayar.

Adakah anda perlu mencipta folder projek terlebih dahulu?

Tidak. Arahan npm create astro@latest memulakan wizard yang akan mencipta folder itu jika belum wujud. Anda boleh menjalankan arahan tersebut di mana-mana lokasi pada komputer. Selepas folder dicipta, masuk ke folder projek dengan arahan cd dan bekerja di dalamnya.

Bagaimanakah cara melihat pratonton laman sebelum ia tersedia dalam talian?

Jalankan arahan npm run dev di dalam folder projek. Astro akan memulakan pratonton setempat, biasanya pada localhost:4321, dan anda boleh membuka laman dalam pelayar pada komputer sendiri. Hanya anda boleh melihat pratonton ini; perubahan akan dipaparkan semasa anda bekerja dan anda tidak perlu memuat semula halaman secara manual.

Bolehkah laman Astro diterbitkan secara percuma?

Ya. Cara paling mudah ialah memuat naik projek ke repositori GitHub dan menyambungkan pengehosan percuma: GitHub Pages, Netlify atau Vercel. Perkhidmatan pengehosan akan membina laman dan menerbitkannya pada alamatnya sendiri. Anda tidak perlu membayar secara berasingan untuk mengehos laman yang ringan; kos hanya timbul jika anda mahukan domain sendiri.

Adakah Astro sesuai untuk semua jenis laman?

Astro direka untuk laman kandungan: laman kad perniagaan, halaman pendaratan, blog, portfolio dan pameran kedai dalam talian. Di situlah kelebihannya. Jika teras projek ialah aplikasi web yang kompleks dengan bahagian akaun peribadi dan banyak tindakan pada setiap butang, bahagian itu biasanya dibina menggunakan alat lain. Saya membincangkan kelebihan dan kekurangan Astro dengan lebih terperinci dalam artikel tentang maksud Astro.

Apakah kelebihan Astro berbanding pembina laman seperti Tilda untuk vibe-coding?

Perbezaannya terletak pada apa yang anda miliki selepas itu. Laman Astro terdiri daripada fail anda sendiri yang disimpan bersama anda dan boleh diterbitkan pada mana-mana perkhidmatan pengehosan; tiada perkhidmatan pihak ketiga menyimpannya. Jika mahu berpindah atau membuat perubahan enam bulan kemudian, anda boleh membuka semuanya dengan mana-mana alat. Pilihan antara Astro dan alat lain bergantung pada pendekatan umum terhadap vibe-coding: pilih alat mengikut tugas. Peta alat tersedia dalam panduan alternatif kepada Claude Code.

Persediaan lengkap untuk vibe-coding: Klon AI + Otak Kedua + Kejuruteraan Konteks.

Kenali Ailoot.

Butiran lanjut

Soalan lazim: Laman Astro melalui Claude Code: daripada Folder hingga Penerbitan

Adakah pratonton Astro setempat menerbitkan laman dalam talian?

Tidak. Menjalankan npm run dev memulakan pratonton pembangunan setempat dan mencetak alamatnya, biasanya localhost:4321. Penerbitan ialah langkah berasingan melalui perkhidmatan pengehosan atau workflow penggunaan GitHub Pages.

Tetapan binaan manakah patut diperiksa dengan hos Astro?

Untuk laluan laman statik diterangkan, pastikan hos menggunakan astro build atau npm run build dan menerbitkan direktori dist. Selepas penggunaan, buka URL awam hos dan sahkan halaman di situ; pratonton setempat sahaja tidak mengesahkan penerbitan.

Semua artikel