Ringkasan Pantas: Claude Code boleh dipasang melalui pemasang asli pada macOS, Windows, dan Linux dari laman web rasmi Claude Code. Pengguna Windows mesti memasang WSL2 terlebih dahulu sebelum menjalankan Claude Code. Selepas pemasangan, sahkan dengan akaun Claude anda apabila Claude Code membuka tetingkap penyemak imbas untuk anda log masuk pada pelancaran pertama untuk mula pengekodan dengan bantuan AI terus dari terminal atau aplikasi desktop anda.
Claude Code mewakili dorongan Anthropic ke dalam alat pembangunan AI agen. Pembantu baris arahan ini membaca pangkalan kod, mengedit fail, menjalankan arahan, dan menyepadukan dengan aliran kerja pembangunan.
Tetapi memasangnya tidak selalu mudah. Platform yang berbeza memerlukan pendekatan yang berbeza. Windows memerlukan persediaan tambahan. Dan dokumentasi, walaupun komprehensif, boleh membebankan pendatang baru.
Panduan ini memotong kerumitan. Ia meliputi keperluan sistem, langkah pemasangan khusus platform, pengesahan, dan pengesahan—semuanya yang diperlukan untuk mendapatkan Claude Code berjalan dengan betul.
Keperluan Sistem Sebelum Pemasangan
Menurut dokumentasi rasmi Claude Code, alat ini menyokong macOS, Windows, dan Linux. Walau bagaimanapun, setiap platform mempunyai prasyarat khusus.
Untuk macOS, keperluannya adalah minimum. Sistem memerlukan macOS 13.0 atau lebih baru. Kedua-dua cip Intel dan Apple Silicon berfungsi dengan baik.
Windows membentangkan lebih banyak kerumitan. Sistem operasi mesti Windows 10 Build 19041 atau lebih baru, atau Windows 11. Tetapi inilah jerankapnya—Claude Code tidak berjalan secara asli di Windows.
Windows Subsystem for Linux 2 (WSL2) adalah wajib. Ini mencipta persekitaran Linux di mana Claude Code sebenarnya beroperasi. Tanpa WSL2, pemasangan gagal.
Pengguna Linux memerlukan pengedaran 64-bit. Dokumentasi rasmi mengesahkan sokongan untuk Ubuntu, Debian, Fedora, dan pengedaran utama lain. Sistem berasaskan Alpine Linux dan musl memerlukan konfigurasi tambahan.
Semua platform memerlukan sambungan internet yang stabil semasa pemasangan. Saiz muat turun berbeza tetapi biasanya berkisar antara 50MB hingga 500MB bergantung pada apa yang telah dipasang.
| Platform | Versi Minimum | Keperluan Khas |
|---|---|---|
| macOS | 13.0 | Tiada |
| Windows | 10 Build 19041 atau 11 | WSL2 diperlukan |
| Linux | Pengedaran 64-bit | glibc-based digalakkan |
Memasang Claude Code pada macOS
Proses pemasangan macOS menggunakan pemasang asli. Ini adalah laluan paling mudah di kalangan semua platform.
Pertama, muat turun pemasang dari laman web rasmi Claude Code. Halaman muat turun secara automatik mengesan macOS dan menawarkan pakej yang sesuai.
Buka fail .dmg yang dimuat turun. Seret aplikasi Claude Code ke folder Aplikasi. Pemasangan macOS standard—tiada yang luar biasa di sini.
Sesetengah pengguna menghadapi gesaan keselamatan apabila melancarkan buat kali pertama. macOS menyekat aplikasi daripada pembangun yang tidak dikenal pasti secara lalai. Klik kanan aplikasi Claude Code dan pilih "Buka" untuk memintas amaran sekali ini.
Alat baris arahan dipasang secara automatik dengan aplikasi desktop. Buka Terminal dan taip claude –version untuk mengesahkan. Jika nombor versi muncul, pemasangan berjaya.
Mengesahkan Pemasangan macOS
Jalankan arahan ini untuk mengesahkan semuanya berfungsi:
| claude –version claude –help |
Kedua-dua arahan sepatutnya mengembalikan output tanpa ralat. Arahan versi menunjukkan versi Claude Code yang dipasang. Arahan bantuan memaparkan pilihan dan arahan yang tersedia.
Mencipta direktori ujian membantu mengesahkan fungsi penuh. Navigasi ke folder projek dan jalankan claude untuk memulakan sesi interaktif. Alat ini sepatutnya memulakan dan menggesa pengesahan jika belum log masuk.
Pemasangan Windows Dengan WSL2
Pemasangan Windows memerlukan beberapa langkah. Proses mengambil masa lebih lama daripada macOS tetapi tetap boleh diuruskan.
WSL2 mesti dipasang terlebih dahulu. Buka PowerShell sebagai Pentadbir dan jalankan:
| wsl –install |
Arahan ini memasang WSL2 dan Ubuntu secara lalai. Sistem akan memerlukan permulaan semula. Selepas but semula, Ubuntu dilancarkan secara automatik untuk melengkapkan persediaan awal.
Cipta nama pengguna dan kata laluan Unix apabila digesa. Kelayakan ini berasingan daripada kelayakan log masuk Windows.
Setelah WSL2 berjalan, proses pemasangan Linux berlaku. Buka terminal Ubuntu (dipasang dengan WSL2) dan muat turun pemasang Claude Code untuk Linux.
Memasang Claude Code dalam WSL2
Menurut dokumentasi rasmi, arahan pemasangan memuat turun dan menjalankan pemasang asli:
| curl -o- raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash |
Skrip ini menguruskan kebergantungan secara automatik. Ia memasang Node.js jika perlu, menyediakan binari Claude Code, dan mengkonfigurasi pembolehubah PATH.
Pemasangan mengambil masa beberapa minit. Bar kemajuan dan mesej status menunjukkan apa yang sedang berlaku. Apabila selesai, tutup dan buka semula terminal untuk menyegarkan pembolehubah persekitaran.
Menguji pemasangan mengikuti proses yang sama seperti macOS. Jalankan claude –version untuk mengesahkan.
Proses Pemasangan Linux
Pengguna Linux mempunyai laluan pemasangan yang paling mudah. Pemasang asli berfungsi terus tanpa lapisan tambahan seperti WSL2.
Muat turun dan jalankan skrip pemasangan:
| curl -fsSL claude.ai/install.sh | bash |
Ini memuat turun binari Claude Code, memasang kebergantungan, dan mengkonfigurasi persekitaran shell. Skrip mengesan pengedaran dan menyesuaikan dengan sewajarnya.
Untuk sistem berasaskan Ubuntu dan Debian, skrip mengkonfigurasi pemasangan. Dokumentasi rasmi mengesahkan sokongan untuk Ubuntu 20.04+, Debian 10+, dan pengedaran lain.
Pertimbangan Alpine Linux
Pengedaran berasaskan Alpine Linux dan musl memerlukan langkah tambahan. Dokumentasi rasmi menyatakan sistem ini memerlukan konfigurasi manual.
Pemasang standard mungkin gagal pada Alpine. Sebaliknya, muat turun binari yang serasi dengan musl terus dari halaman keluaran. Ekstrak ke direktori dalam PATH sistem, biasanya /usr/local/bin.
Tetapkan kebenaran boleh laku:
| chmod +x /usr/local/bin/claude |
Pengguna Alpine harus mengesahkan keserasian sebelum meneruskan. Sesetengah ciri mungkin tidak berfungsi sama seperti pengedaran berasaskan glibc.
Persediaan Pengesahan dan Akaun
Selepas memasang Claude Code, jalankan claude dalam terminal anda. Pada pelancaran pertama, Claude Code membuka tetingkap penyemak imbas untuk anda log masuk.
Ini membuka halaman pengesahan Claude. Daftar masuk dengan akaun Claude sedia ada atau buat akaun baharu.
Penyemak imbas memaparkan kod kebenaran. Salin kod ini dan kembali ke terminal. Tampal kod apabila digesa.
Pengesahan yang berjaya menyimpan kelayakan secara tempatan. Sesi masa depan tidak memerlukan log masuk kecuali kelayakan tamat tempoh atau telah dipadam secara manual.
Pengesahan Pasukan dan Perusahaan
Menurut dokumentasi pengesahan rasmi, pasukan yang menggunakan Claude untuk Pasukan atau Perusahaan mempunyai pilihan tambahan. Organisasi boleh mengkonfigurasi log masuk tunggal (SSO) atau pengesahan penyedia awan.
Persediaan SSO memerlukan konfigurasi pentadbir. Pembangun individu kemudiannya mengesahkan melalui penyedia identiti organisasi mereka dan bukannya akaun Claude peribadi.
Pengesahan penyedia awan berfungsi untuk penempatan AWS, Google Cloud, dan Azure. Kaedah ini menggunakan kelayakan awan sedia ada dan bukannya akaun Claude berasingan.
| Kaedah Pengesahan | Kes Penggunaan | Kerumitan Persediaan |
|---|---|---|
| Akaun Peribadi | Pembangun individu | Mudah |
| Pasukan/Perusahaan SSO | Organisasi | Memerlukan pentadbir |
| Penyedia Awan | Pengguna AWS/GCP/Azure | Sederhana |
Pemasangan Aplikasi Desktop
Claude Code menawarkan aplikasi baris arahan dan desktop. Aplikasi desktop menyediakan antara muka grafik sambil mengekalkan fungsi terminal penuh.
Muat turun pemasang desktop dari laman web rasmi Claude. Halaman ini menawarkan versi macOS, Windows, dan Windows ARM64. Pilih versi yang sesuai untuk sistem.
Pemasangan macOS mengikuti proses .dmg yang sama seperti yang diterangkan sebelum ini. Pengguna Windows boleh memuat turun aplikasi desktop untuk antara muka grafik tanpa memerlukan persediaan WSL2.
Aplikasi desktop termasuk akses terminal bersepadu. Ia boleh melancarkan sesi Claude Code tanpa bertukar kepada aplikasi terminal luaran.
Satu kelebihan aplikasi desktop ialah ketersediaan latar belakang. Menurut halaman muat turun rasmi, aplikasi 'tetap bersedia di latar belakang' dan boleh dipanggil daripada mana-mana aplikasi tanpa bertukar tetingkap atau kehilangan fokus.
Gunakan Get AI Perks untuk Mencari Kredit untuk Timbunan Claude Code Anda
Pemasangan adalah bahagian yang mudah. Kos sebenar biasanya datang dari segala-galanya di sekelilingnya: infrastruktur, alat sokongan, dan perkhidmatan berbayar yang digunakan semasa persediaan dan ujian. Get AI Perks boleh membantu dengan menyenaraikan kredit permulaan dan diskaun di satu tempat, bersama dengan panduan tentang cara memohon.
Dengan Get AI Perks, anda boleh:
- Cari kredit untuk alat berkaitan awan dan AI
- Semak syarat tawaran sebelum memohon
- Elakkan membuang masa untuk tawaran yang anda mungkin tidak layak
- Kurangkan kos untuk mendapatkan persediaan anda siap
Lawati Get AI Perks untuk melihat sama ada tawaran yang tersedia sepadan dengan alat yang anda rancang untuk digunakan dengan Claude Code.
Sambungan IDE dan Integrasi
Selain pemasangan kendiri, Claude Code menyepadukan dengan persekitaran pembangunan popular. Sambungan wujud untuk Visual Studio Code dan IDE JetBrains.
Sambungan VS Code dipasang melalui pasaran. Cari "Claude Code" dalam panel Sambungan dan klik Pasang. Sambungan memerlukan alat baris arahan dipasang terlebih dahulu.
Sesetengah pengguna melaporkan masalah dengan fail sambungan VS Code yang dibundel. Jika pemasangan automatik gagal dengan ralat "End of central directory record signature not found", fail .vsix yang dibundel mungkin rosak.
Penyelesaiannya melibatkan pemasangan sambungan secara manual daripada pasaran VS Code dan bukannya bergantung pada versi yang dibundel oleh CLI. Ini mengasingkan kedua-dua komponen dan mengelakkan konflik pemasangan.
Integrasi JetBrains berfungsi serupa. Pasang pemalam daripada pasaran JetBrains dalam IntelliJ IDEA, PyCharm, WebStorm, atau produk JetBrains yang lain.
Mengesahkan Kejayaan Pemasangan
Pengesahan yang betul memastikan Claude Code berfungsi dengan betul sebelum memulakan tugas pembangunan sebenar.
Semakan asas menguji ketersediaan arahan:
| claude –help claude –version |
Arahan ini sepatutnya dilaksanakan tanpa ralat. Arahan bantuan menyenaraikan pilihan yang tersedia. Arahan versi menunjukkan keluaran yang dipasang.
Pengujian fungsional memerlukan memulakan sesi. Cipta direktori ujian:
| mkdir test-project cd test-project claude |
Ini memulakan sesi Claude Code interaktif. Alat ini sepatutnya menganalisis direktori (kosong dalam kes ini) dan membentangkan gesaan.
Cuba arahan asas dalam sesi. Taip help untuk melihat tindakan yang tersedia. Minta tugasan mudah seperti "cipta fail README" atau "jelaskan apa yang boleh anda lakukan."
Respons yang berjaya menunjukkan pemasangan yang betul. Jika ralat berlaku, ia biasanya berkaitan dengan pengesahan, ketersambungan rangkaian, atau kebergantungan yang hilang.
Pengurusan Kemas Kini dan Versi
Claude Code dikemas kini secara automatik secara lalai. Dokumentasi rasmi menjelaskan bahawa alat ini memeriksa versi baharu dan memasangnya tanpa campur tangan pengguna.
Tingkah laku kemas kini boleh dikonfigurasi melalui tetapan Claude Code. Dokumentasi rasmi meliputi konfigurasi saluran keluaran dan pilihan kemas kini manual.
Kemas kini manual memerlukan menjalankan skrip pemasangan sekali lagi. Arahan yang sama yang digunakan untuk pemasangan awal menarik versi terbaharu:
| curl -fsSL claude.ai/install.sh | bash |
Memasang versi tertentu adalah mungkin untuk tujuan ujian atau keserasian. Dokumentasi persediaan lanjutan meliputi penetapan versi dan konfigurasi saluran keluaran.
Saluran keluaran termasuk stabil, beta, dan harian. Stabil disyorkan untuk kerja pengeluaran. Saluran beta dan harian memberikan akses awal kepada ciri baharu tetapi mungkin mengandungi pepijat.
Masalah Pemasangan Biasa
Beberapa isu muncul dengan kerap dalam perbincangan komuniti tentang pemasangan Claude Code.
Konfigurasi PATH menyebabkan banyak masalah. Jika arahan claude tidak ditemui selepas pemasangan, direktori binari tidak berada dalam PATH sistem.
Pada macOS dan Linux, menambah direktori ke PATH biasanya melibatkan penyuntingan ~/.bashrc, ~/.zshrc, atau fail konfigurasi shell yang serupa. Skrip pemasangan biasanya menguruskan ini secara automatik, tetapi pengesahan manual membantu dalam menyelesaikan masalah.
Pengguna Windows dalam WSL2 mungkin perlu menutup dan membuka semula terminal selepas pemasangan. Pembolehubah persekitaran tidak segar semula dalam sesi yang sedia ada.
Sekatan rangkaian menghalang beberapa pemasangan. Keselamatan korporat atau pelayan proksi mungkin menghalang muat turun pemasang atau sambungan ke pelayan pengesahan.
Konfigurasi proksi memerlukan pembolehubah persekitaran:
| export HTTP_PROXY= proxy.example.com:8080 export HTTPS_PROXY= proxy.example.com:8080 |
Ralat kebenaran berlaku apabila memasang ke direktori yang dilindungi. Pemasang memerlukan akses tulis ke /usr/local/bin atau lokasi yang setara. Menjalankan dengan sudo menyelesaikan ini tetapi harus dielakkan kecuali perlu.
Soalan Lazim
Bolehkah Claude Code berjalan tanpa sambungan internet?
Tidak. Claude Code memerlukan sambungan internet untuk berfungsi. Alat ini menghantar kod dan pertanyaan ke pelayan Anthropic untuk diproses. Storan cache tempatan mungkin membenarkan beberapa operasi berfungsi buat sementara waktu di luar talian, tetapi fungsi penuh memerlukan sambungan aktif.
Adakah Claude Code berfungsi dengan alat pengekodan AI sedia ada?
Ya. Claude Code boleh berjalan bersama GitHub Copilot, Cursor, atau alat pembangunan AI lain. Mereka beroperasi secara bebas dan tidak bercanggang. Walau bagaimanapun, menggunakan berbilang pembantu AI secara serentak boleh mewujudkan kekeliruan tentang alat mana yang mengendalikan tugasan mana.
Adakah WSL2 diperlukan untuk semua ciri Windows?
Alat baris arahan memerlukan WSL2 di Windows. Walau bagaimanapun, aplikasi desktop berjalan secara asli di Windows tanpa WSL2. Aplikasi desktop menyediakan fungsi yang serupa melalui antara muka grafik dan bukannya interaksi baris arahan tulen.
Berapakah kos penggunaan Claude Code?
Harga berbeza bergantung pada penggunaan dan peringkat langganan. Semak laman web rasmi Claude untuk harga semasa, kerana kos dan struktur pelan berubah dari semasa ke semasa. Sesetengah ciri memerlukan langganan Claude Pro atau Enterprise.
Bolehkah Claude Code mengedit fail di luar direktori projek?
Secara lalai, Claude Code mengehadkan akses fail kepada direktori projek semasa untuk keselamatan. Tetapan konfigurasi boleh mengembangkan kebenaran, tetapi berbuat demikian memerlukan kebenaran eksplisit. Dokumentasi sandboxing merangkumi pengurusan kebenaran secara terperinci.
Apakah perbezaan antara Claude Code dan API Claude?
Claude Code ialah alat pembangunan untuk bantuan pengekodan interaktif. API Claude menyediakan akses programatik untuk membina aplikasi yang menggunakan keupayaan AI Claude. Mereka melayani tujuan yang berbeza—satu untuk pembangun yang menulis kod, yang lain untuk aplikasi yang menyepadukan ciri AI.
Adakah menyahpasang memadam semua data Claude Code?
Menyahpasang memadam binari aplikasi tetapi mungkin meninggalkan fail konfigurasi dan data cache. Penyingkiran lengkap memerlukan pemadaman manual direktori ~/.claude pada macOS dan Linux, atau lokasi AppData yang setara pada Windows.
Memulakan Selepas Pemasangan
Dengan Claude Code dipasang dan disahkan, langkah seterusnya melibatkan pemahaman cara menggunakannya dengan berkesan.
Dokumentasi permulaan pantas mengesyorkan bermula dengan tugasan mudah. Navigasi ke projek sedia ada dan jalankan claude untuk memulakan sesi interaktif.
Minta Claude menjelaskan struktur projek. Minta ringkasan tentang apa yang dilakukan oleh pangkalan kod. Pertanyaan eksploratori ini membantu memahami cara alat ini mentafsir kod.
Cuba membuat perubahan kecil. Minta Claude menambah ulasan pada fungsi, mencipta fail ujian ringkas, atau refaktor blok kod asas. Tugasan ini menunjukkan keupayaan penyuntingan tanpa risiko.
Integrasi Git berfungsi secara automatik jika projek menggunakan kawalan versi. Claude Code boleh mencipta komit, menjelaskan perbezaan, dan mencadangkan penambahbaikan berdasarkan perubahan.
Dokumentasi rasmi termasuk contoh aliran kerja untuk tugasan pembangunan biasa. Ini merangkumi pembaikan pepijat, pelaksanaan ciri, semakan kod, dan ujian automatik.
Claude Code ialah alat yang berkembang. Pemasangan hanyalah asas. Memahami keupayaan, batasan, dan amalan terbaiknya memerlukan percubaan dan latihan.
Bersedia untuk memasang Claude Code? Muat turun pemasang yang sesuai untuk platform anda dari laman web rasmi dan ikuti langkah-langkah yang digariskan dalam panduan ini. Sahkan dengan akaun Claude anda, sahkan pemasangan berfungsi dengan betul, dan mula meneroka pembangunan dibantu AI.
