Ringkasan Pantas: Claude Code ialah pembantu pengekodan AI berasaskan terminal daripada Anthropic yang memerlukan pemasangan melalui pengurus pakej seperti npm atau Homebrew, diikuti dengan pengesahan dengan kunci API Anthropic. Selepas persediaan, pembangun boleh menggunakan arahan bahasa semula jadi untuk melaksanakan tugasan pengekodan, daripada menyahpepijat dan refaktoring kepada aliran kerja git dan edit berbilang fail. Alat ini berintegrasi secara langsung dengan projek sedia ada dan menyokong penyesuaian melalui cangkuk, plugin dan fail konfigurasi.
Claude Code ialah alat pengekodan agenik yang dibina oleh Anthropic yang hidup terus di dalam terminal. Ia bukan lanjutan IDE atau antara muka awan — ia adalah pembantu baris arahan yang memahami pangkalan kod, melaksanakan tugasan rutin dan mengendalikan segala-galanya daripada penyahpepijatan kepada aliran kerja git melalui bahasa semula jadi.
Tidak seperti pembantu pengekodan tradisional, Claude Code beroperasi secara autonomi. Ia boleh membaca fail, melaksanakan arahan dan membuat edit berbilang fail dengan campur tangan manusia yang minimum. Kualiti outputnya bergantung sepenuhnya pada persediaan dan pengurusan konteks yang betul.
Panduan ini merangkumi segala-galanya daripada pemasangan melalui aliran kerja pertama. Tiada pengisian, hanya langkah praktikal yang benar-benar penting.
Keperluan Sistem dan Prasyarat
Sebelum memulakan proses pemasangan, sahkan sistem memenuhi keperluan asas. Claude Code berfungsi pada macOS, Linux dan Windows 10/11 melalui WSL2.
Berikut ialah apa yang diperlukan:
- Alih keluar keperluan ini atau lembutkan kepada 'Node.js mungkin diperlukan untuk kaedah pemasangan tertentu' – bahan sumber tidak menyatakan Node.js 18 sebagai keperluan sistem
- Git dipasang dan dikonfigurasikan
- Akses terminal dengan kebenaran shell
- Sambungan internet yang stabil untuk panggilan API
- Akaun Anthropic dengan akses API
Bagi pengguna Windows secara khusus, Claude Code tidak boleh dijalankan secara asli pada Windows. Alat ini memerlukan Windows Subsystem for Linux 2 (WSL2) untuk mencipta persekitaran Linux di mana Claude Code beroperasi dengan berkesan. Windows 10 Versi 1903 atau lebih baharu (Build 18362+) diperlukan untuk pemasangan WSL2.
Jumlah saiz muat turun semasa persediaan biasanya berjalan di bawah 1GB, termasuk WSL2 pada Windows (kira-kira 500MB), Node.js (kira-kira 30MB), dan Claude Code dengan kebergantungan (kira-kira 50MB).
Cari Kredit Alatan AI Sebelum Anda Bermula
Memulakan dengan Claude Code selalunya bermakna memilih alatan AI lain di sekelilingnya. Dapatkan Perks AI membantu dengan itu dengan mengumpul kredit permulaan dan diskaun perisian untuk alatan AI dan awan di satu tempat. Platform ini merangkumi 200+ perks, dengan tawaran daripada Claude, Anthropic, OpenAI, Gemini, ElevenLabs, Intercom, dan lain-lain, bersama-sama dengan syarat dan langkah untuk menuntutnya.
Mencari Kredit AI Sebelum Anda Memohon?
Semak Dapatkan Perks AI untuk:
- layari tawaran Claude dan alatan AI lain
- lihat perks mana yang sesuai dengan syarikat anda
- ikuti panduan untuk menuntut kredit yang tersedia
👉 Lawati Dapatkan Perks AI untuk membandingkan perks perisian AI yang tersedia.
Memasang Claude Code
Proses pemasangan berbeza sedikit mengikut sistem operasi tetapi mengikut corak umum yang sama.
Pemasangan pada macOS dan Linux
Bagi pengguna macOS dengan Homebrew dipasang, prosesnya adalah mudah:
| brew install –cask claude-code |
Tanpa Homebrew, gunakan npm:
| npm install -g @anthropic-ai/claude-code atau gunakan kaedah pemasangan yang disyorkan (curl atau brew) |
Pengguna Linux boleh mengikuti pendekatan npm yang sama. Bendera pemasangan global (-g) memastikan Claude Code tersedia di seluruh sistem dan bukannya khusus projek.
Pemasangan pada Windows Melalui WSL2
Pemasangan Windows memerlukan persediaan WSL2 terlebih dahulu. Buka PowerShell sebagai Pentadbir dan jalankan:
| wsl –install |
Arahan ini memasang WSL2 bersama Ubuntu secara lalai. Selepas pemasangan selesai, mulakan semula sistem. Semasa but semula, Ubuntu dilancarkan secara automatik untuk melengkapkan persediaan dengan penciptaan nama pengguna dan kata laluan.
Di dalam persekitaran Linux WSL2, pasang Node.js:
| curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash – sudo apt-get install -y nodejs |
Kemudian pasang Claude Code menggunakan npm seperti yang ditunjukkan di atas.
Sahkan pemasangan dengan menjalankan:
| claude –version |
Arahan itu sepatutnya mengembalikan nombor versi semasa. Jika tidak, laluan pemasangan mungkin tidak berada dalam pemboleh ubah PATH sistem.
Pengesahan dan Persediaan Akaun
Claude Code memerlukan pengesahan dengan kunci API Anthropic sebelum ia boleh berfungsi.
Mendapatkan Kunci API
Navigasi ke Konsol Anthropic di console.anthropic.com dan buat akaun atau log masuk. Dalam bahagian API, jana kunci API baharu. Salin kunci ini serta-merta—ia tidak akan dipaparkan semula selepas meninggalkan halaman.
Akses API beroperasi dengan asas bayar-sebagai-guna. Menurut dokumentasi rasmi, penetapan harga beroperasi pada model setiap token dengan kadar yang berbeza untuk model Claude yang berbeza. Kekalkan seperti asal — disahkan dalam bahan sumber rasmi yang menyatakan 'Pembelian minimum: $5' dan 'Disyorkan: $20-30 untuk ujian dan projek awal'
Menyambung Claude Code kepada API
Jalankan Claude Code buat kali pertama dalam mana-mana direktori projek:
| claude |
Alat ini meminta pengesahan. Ia membuka tetingkap penyemak imbas untuk log masuk atau menyediakan URL untuk tampal secara manual. Selepas mengesahkan melalui penyemak imbas, Claude Code menerima kebenaran dan menyimpan kelayakan secara tempatan.
Proses pengesahan mencipta fail konfigurasi dalam direktori rumah. Fail ini kekal merentasi sesi, jadi pengesahan hanya berlaku sekali melainkan kelayakan ditarik balik secara manual.
Untuk mengesahkan semuanya berfungsi dengan betul, jalankan:
| claude doctor |
Arahan diagnostik ini menyemak isu konfigurasi biasa, ketersambungan API dan masalah kebenaran.
Menjalankan Sesi Claude Code Pertama Anda
Dengan pengesahan selesai, Claude Code sedia untuk kerja sebenar.
Memulakan Mod Interaktif
Navigasi ke mana-mana direktori projek dan jalankan:
| claude |
Ini melancarkan mod interaktif—sesi berterusan di mana Claude Code mengekalkan konteks merentasi berbilang arahan dan edit fail. Terminal menunjukkan gesaan yang menandakan Claude Code aktif dan menunggu arahan.
Corak Arahan Asas
Claude Code menerima tiga format arahan utama:
| Format Arahan | Tujuan | Contoh |
|---|---|---|
| claude | Mulakan sesi interaktif | claude |
| claude “tugas” | Jalankan tugas sekali sahaja dan keluar | claude “betulkan ralat binaan” |
| claude -p “soalan” | Tanya soalan tanpa membuat perubahan | claude -p “terangkan fungsi ini” |
Mod interaktif paling berguna untuk aliran kerja yang kompleks yang melibatkan pelbagai langkah. Tugas sekali sahaja berfungsi dengan baik untuk pembaikan pantas atau skrip automatik. Mod soalan (bendera -p) memberikan maklumat tanpa pengubahsuaian fail.
Membuat Perubahan Kod Pertama Anda
Dalam mod interaktif, cuba tugasan ringkas:
| Tambahkan pengendalian ralat pada fungsi utama dalam app.js |
Claude Code menganalisis fail, mengenal pasti fungsi utama, dan mencadangkan perubahan dengan blok cuba-tangkap atau logik pemeriksaan ralat yang betul. Sebelum menggunakan perubahan, ia menunjukkan pratonton perbezaan.
Alat ini meminta pengesahan sebelum mengubah fail. Semak perubahan yang dicadangkan dengan teliti. Lulus dengan menaip "ya" atau tolak dengan "tidak" untuk meminta pengubahsuaian.
Aliran Kerja Penting dan Tugasan Biasa
Claude Code mengendalikan pelbagai aliran kerja pembangunan di luar edit kod asas.
Integrasi Git
Claude Code memahami aliran kerja git secara asli. Arahan seperti ini berfungsi secara semula jadi:
- "Buat cawangan baharu untuk ciri log masuk"
- "Kemas kini perubahan ini dengan mesej penerangan"
- "Tunjukkan saya apa yang berubah sejak komit terakhir"
- "Gabungkan cawangan ciri dan selesaikan konflik"
Alat ini boleh membaca sejarah git, memahami struktur cawangan, dan menjana mesej komit yang sesuai berdasarkan perubahan kod.
Penyahpepijatan dan Penyelesaian Masalah
Apabila ralat muncul, Claude Code boleh menyiasat dan mencadangkan pembaikan:
- "Nyahpepijat mengapa panggilan API gagal"
- "Cari punca pengecualian penuding null ini"
- "Mengapa fungsi ini tidak mengembalikan nilai yang diharapkan"
Claude Code memeriksa mesej ralat, menjejaki laluan pelaksanaan, dan menyemak fail berkaitan untuk mengenal pasti punca utama.
Pengubahsuaian Kod
Pengubahsuaian berskala besar menjadi mudah dikendalikan dengan kesedaran berbilang fail:
- "Ekstrak logik ini kepada modul utiliti berasingan"
- "Ubahsuai kelas ini untuk menggunakan komposisi berbanding pewarisan"
- "Kemas kini semua import selepas memindahkan fail ini"
Alat ini menjejaki kebergantungan merentasi fail dan mengemas kini rujukan secara automatik.
Sokongan Pengujian
Claude Code boleh menjana ujian, menjalankan suit ujian dan mentafsir kegagalan:
- "Tulis ujian unit untuk modul pengesahan"
- "Jalankan suit ujian dan terangkan sebarang kegagalan"
- "Tambahkan ujian kes tepi untuk fungsi pengesahan"
Penjanaan ujian mengikut konvensyen projek dan corak rangka kerja ujian yang telah digunakan.
Pengurusan Konteks dan Konfigurasi
Keberkesanan Claude Code sangat bergantung pada konteks yang diberikan tentang projek.
Piawaian AGENTS.md
Cara paling berkesan untuk menyediakan konteks yang berterusan ialah melalui fail AGENTS.md di akar projek. Fail ini berfungsi sebagai piawaian universal untuk mengarahkan ejen pengekodan AI tentang struktur projek, konvensyen dan keperluan.
AGENTS.md asas mungkin termasuk:
- Gambaran keseluruhan projek dan seni bina
- Konvensyen pengekodan dan pilihan gaya
- Keperluan dan corak pengujian
- Proses bina dan pengedaran
- Struktur organisasi fail
Claude Code secara automatik membaca dan menggabungkan kandungan AGENTS.md apabila memulakan sesi dalam direktori tersebut.
Cangkuk untuk Automasi
Cangkuk membenarkan pelaksanaan automatik arahan shell apabila peristiwa tertentu berlaku. Mengikut dokumentasi rasmi, Claude Code menyokong pelbagai peristiwa cangkuk termasuk SessionStart, UserPromptSubmit, PreToolUse, PostToolUse dan Notification.
Cangkuk dikonfigurasikan dalam fail JSON yang menentukan arahan mana yang berjalan untuk peristiwa mana. Contohnya, cangkuk PostToolUse mungkin menjalankan ujian secara automatik selepas Claude Code mengubah fail, atau memformat kod mengikut piawaian projek.
Had masa lalai untuk cangkuk ialah 10 minit, walaupun ini boleh dikonfigurasikan setiap cangkuk. Cangkuk boleh berjalan secara segerak (menyekat Claude Code sehingga selesai) atau secara tak segerak (berjalan di latar belakang).
Peraturan Kursor dan Format Alternatif
Bagi projek yang menggunakan Kursor atau alatan pengekodan AI lain bersama Claude Code, format fail .cursorrules menyediakan alternatif kepada AGENTS.md. Walaupun AGENTS.md ialah piawaian universal, peraturan Kursor menawarkan integrasi yang lebih rapat dengan ciri khusus Kursor.
Projek boleh mengekalkan kedua-dua fail. Claude Code mengutamakan AGENTS.md tetapi menghormati format konfigurasi lain apabila ia hadir.
Petua Praktikal untuk Penggunaan yang Berkesan
Penggunaan dunia sebenar mendedahkan corak yang meningkatkan keberkesanan Claude Code secara ketara.
Tepat dengan Arahan
Arahan yang samar menghasilkan hasil yang samar. Daripada "tingkatkan kod ini," nyatakan apa maksud peningkatan: "ubahsuai fungsi ini untuk mengurangkan kerumitan kitaran" atau "optimumkan pertanyaan pangkalan data ini untuk mengurangkan masa pelaksanaan."
Gunakan Konteks Projek Secara Meluas
Rujuk fail, fungsi atau corak tertentu semasa memberikan arahan. Claude Code memahami konteks seperti "mengikuti corak dalam UserController" atau "sepadan dengan gaya dalam pembekal API sedia ada kami."
Semak Perubahan Sebelum Menerima
Claude Code berkuasa tetapi tidak sempurna. Sentiasa semak perubahan yang dicadangkan dalam pratonton perbezaan. Cari kesan sampingan yang tidak diingini, terutamanya dalam operasi pengubahsuaian yang menyentuh berbilang fail.
Manfaatkan Jaring Keselamatan Git
Kemas kini kod yang berfungsi sebelum operasi Claude Code besar. Jika perubahan menjadi teruk, git menyediakan laluan pulangan yang mudah. Jaring keselamatan ini menggalakkan eksperimen dengan tugasan yang lebih bercita-cita tinggi.
Mulakan Sesi dengan Matlamat yang Jelas
Memulakan sesi dengan matlamat yang dinyatakan dengan jelas membantu Claude Code kekal fokus. "Kami menambah pengesahan pengguna" atau "Kami menyahpepijat aliran pemprosesan pembayaran" menetapkan konteks untuk arahan seterusnya.
Isu Biasa dan Penyelesaian Masalah
Walaupun persediaan yang betul, isu kadang-kadang timbul.
Ralat Kebenaran
Jangan sekali-kali jalankan Claude Code dengan sudo atau kebenaran yang dinaikkan. Ini mewujudkan jurang keselamatan dan masalah pemilikan fail. Jika ralat kebenaran berlaku, semak kebenaran fail dalam direktori projek dan pastikan pengguna semasa mempunyai akses yang sesuai.
Masalah Sambungan API
Kegagalan sambungan biasanya menunjukkan isu rangkaian atau kelayakan API yang tidak sah. Sahkan kesahan kunci API melalui Konsol Anthropic. Semak bahawa tembok api atau VPN tidak menyekat permintaan API.
Tingkah Laku Tidak Dijangka dalam Windows WSL2
Masalah laluan biasa berlaku apabila mencampurkan laluan Windows dan Linux dalam WSL2. Simpan projek di dalam sistem fail Linux (/home/username/) dan bukannya mengakses pemacu Windows (/mnt/c/). Ini meningkatkan prestasi dan mengelakkan masalah terjemahan laluan.
Kehilangan Konteks Semasa Sesi Panjang
Sesi yang panjang mungkin mencapai had konteks, menyebabkan Claude Code kehilangan jejak perbualan awal. Apabila ini berlaku, mulakan sesi baharu atau berikan peringatan yang jelas tentang matlamat projek dan perubahan baru-baru ini.
Ciri Lanjutan yang Patut Diterokai
Selepas menguasai asas, beberapa ciri lanjutan membuka keupayaan tambahan.
Arahan Tersuai
Projek boleh mentakrifkan arahan tersuai dalam direktori .claude/commands. Arahan ini melanjutkan Claude Code dengan aliran kerja khusus projek, seperti " @deploy.md staging" atau "@benchmark.md performance."
Arahan ditulis dalam markdown dengan sintaks khas untuk argumen dan suntikan konteks. Kemahiran pembangunan arahan dalam plugin rasmi Claude Code menyediakan templat dan contoh.
Pasukan Ejen
Untuk operasi yang kompleks, Claude Code boleh menyelaraskan berbilang ejen khusus yang bekerja bersama. Satu ejen mungkin mengendalikan perubahan backend manakala yang lain mengemas kini komponen frontend dan yang ketiga mengurus migrasi pangkalan data.
Pasukan ejen memerlukan konfigurasi tetapi membolehkan kerja selari pada ciri besar atau projek pengubahsuaian.
Soalan Lazim
Adakah Claude Code berfungsi di luar talian?
Tidak, Claude Code memerlukan sambungan internet yang aktif untuk berkomunikasi dengan API Anthropic. Semua pemprosesan berlaku di bahagian pelayan, bukan secara tempatan. Alat ini tidak boleh berfungsi tanpa akses API.
Berapakah kos penggunaan Claude Code?
Claude Code beroperasi berdasarkan asas token bayar-sebagai-guna. Penetapan harga berbeza mengikut model—Kekalkan seperti asal — disahkan dalam bahan sumber rasmi yang menyenaraikan peringkat penetapan harga yang tepat ini. Kos sebenar bergantung pada corak penggunaan, dan model yang dipilih. Keseimbangan akaun minimum ialah $5.
Bolehkah Claude Code secara tidak sengaja merosakkan pangkalan kod saya?
Claude Code meminta pengesahan sebelum membuat pengubahsuaian fail. Bersama dengan kawalan versi git, risikonya adalah minimum. Sentiasa kemas kini kod yang berfungsi sebelum operasi besar dan semak perubahan dalam pratonton perbezaan sebelum menerimanya.
Adakah Claude Code berfungsi dengan semua bahasa pengaturcaraan?
Claude Code menyokong hampir semua bahasa pengaturcaraan arus perdana termasuk JavaScript, Python, TypeScript, Java, Go, Rust, C++, dan banyak lagi. Sokongan bahasa bergantung pada model Claude asas' latihan, yang termasuk data kod yang luas merentasi bahasa.
Bolehkah berbilang pembangun menggunakan Claude Code pada projek yang sama secara serentak?
Ya, tetapi penyelarasan melalui git adalah penting. Setiap pembangun menjalankan sesi Claude Code mereka sendiri dengan kunci API mereka sendiri. Perubahan harus dikemas kini dan disegerakkan melalui git sama seperti pengekodan manual. Claude Code tidak mempunyai ciri kolaborasi terbina dalam selain aliran kerja git standard.
Apakah perbezaan antara Claude Code dan GitHub Copilot?
GitHub Copilot berintegrasi ke dalam editor kod dan memberikan cadangan sebaris semasa menaip. Claude Code beroperasi di terminal dan mengambil tindakan autonomi pada tugasan berbilang fail. Copilot lebih baik untuk pelengkapan baris demi baris; Claude Code unggul dalam melaksanakan aliran kerja lengkap seperti pengubahsuaian, penyahpepijatan, atau pelaksanaan ciri merentasi berbilang fail.
Bagaimana saya mengemas kini Claude Code kepada versi terbaru?
Untuk pemasangan npm (jika digunakan), kemas kini melalui npm atau gunakan kaedah pemasangan yang disyorkan. Untuk pemasangan Homebrew, jalankan: brew upgrade claude-code. Semak versi semasa pada bila-bila masa dengan claude –version.
Bergerak Maju dengan Claude Code
Memulakan dengan Claude Code melibatkan pemasangan, pengesahan dan mempelajari corak arahan asas yang ringkas. Kuasa sebenar alat ini muncul melalui penggunaan yang konsisten dan pengurusan konteks yang betul.
Mulakan dengan tugasan mudah—pembaikan ralat, kemas kini dokumentasi, atau pengubahsuaian fail tunggal. Apabila keyakinan meningkat, tangani aliran kerja yang lebih bercita-cita tinggi seperti pelaksanaan ciri atau perubahan seni bina. Keluk pembelajaran adalah landai kerana arahan bahasa semula jadi mengurangkan hafalan sintaks.
Konfigurasikan fail AGENTS.md untuk projek yang sering digunakan. Pelaburan ini memberikan hasil melalui pemahaman Claude Code yang lebih baik dan cadangan yang lebih relevan.
Paling penting, anggap Claude Code sebagai alat kolaboratif dan bukannya pengganti pertimbangan pembangun. Semak cadangannya secara kritikal, berikan arahan yang jelas, dan kekalkan jaring keselamatan git. Digunakan dengan betul, Claude Code mempercepatkan pembangunan tanpa mengorbankan kualiti kod.
Bersedia untuk mengubah aliran kerja terminal anda? Pasang Claude Code hari ini dan alami pembangunan berbantuan AI yang benar-benar berintegrasi dengan cara pembangun bekerja. Lawati dokumentasi rasmi di docs.anthropic.com untuk bahan rujukan terperinci dan pilihan konfigurasi lanjutan.
