Ringkasan Pantas: Memasang Claude Code pada Windows memerlukan persediaan WSL2 (Windows Subsystem for Linux), memasang Ubuntu, dan menjalankan skrip pemasangan ringkas. Proses ini membolehkan pengguna Windows mengakses pembantu pengekodan AI Anthropic melalui terminal mereka. Binari Windows asli tersedia, bagaimanapun WSL2 masih merupakan amalan terbaik untuk pemasangan Windows.
Claude Code ialah pembantu pengekodan yang dikuasakan oleh AI yang beroperasi terus dalam terminal, membantu pembangun membina ciri, membaiki pepijat, dan mengautomasikan tugasan pembangunan. Tetapi ada satu perkara untuk pengguna Windows.
Claude Code tersedia sebagai boleh laku Windows asli dan boleh dipasang melalui npm atau muat turun binari langsung tanpa WSL2. Walau bagaimanapun, ia memerlukan Windows Subsystem for Linux (WSL2), dan kaedah pemasangan rasmi masih bergantung pada WSL2.
Berikut ialah cara untuk menjayakannya pada Windows 11 atau Windows 10.
Keperluan Sistem
Sebelum memulakan pemasangan, sahkan mesin Windows memenuhi keperluan ini:
- Windows 10 1809+ atau Windows Server 2019+
- Windows 11 (sebarang versi)
- Sekurang-kurangnya 4GB RAM tersedia
- Kelebenaran pentadbir pada sistem
- Sambungan Internet untuk memuat turun WSL2 dan Ubuntu
Pemasangan memerlukan ruang cakera untuk WSL2, Ubuntu, dan Claude Code.
Langkah 1: Dayakan Windows Subsystem for Linux
WSL2 menyediakan persekitaran Linux secara langsung dalam Windows. Ia adalah asas yang membolehkan Claude Code berfungsi.
Buka PowerShell sebagai Pentadbir. Klik kanan butang Mula dan pilih "Windows PowerShell (Admin)" atau "Terminal (Admin)" pada Windows 11.
Jalankan arahan ini:
wsl --install
Arahan ini mendayakan ciri Windows yang diperlukan dan memasang Ubuntu sebagai pengedaran Linux lalai. Sistem kemungkinan besar akan meminta untuk memulakan semula.
Selepas but semula, WSL2 melengkapkan persediaan secara automatik. Ubuntu dilancarkan dan meminta nama pengguna dan kata laluan. Kelayakan ini adalah untuk persekitaran Linux sahaja—ia tidak perlu sepadan dengan kelayakan Windows.
Langkah 2: Sahkan Pemasangan WSL2
Setelah sistem but semula dan Ubuntu melengkapkan persediaan awalnya, sahkan WSL2 berjalan dengan betul.
Buka terminal Ubuntu (cari "Ubuntu" dalam menu Mula) dan jalankan:
wsl --version
Ini memaparkan maklumat versi WSL. Cari "WSL version: 2.x.x" dalam output.
Jika arahan menunjukkan WSL1 sebaliknya, naik taraf kepada WSL2 dengan:
wsl --set-default-version 2
Langkah 3: Pasang Claude Code
Sekarang untuk pemasangan Claude Code yang sebenar. Dokumentasi rasmi menyediakan skrip pemasangan satu baris.
Dalam terminal Ubuntu, jalankan:
curl -fsSL claude.ai/install.sh | bash
Skrip memuat turun binari Claude Code, menetapkan kebenaran yang diperlukan, dan menambahkannya ke PATH sistem. Tempoh pemasangan berbeza bergantung pada kelajuan internet dan spesifikasi sistem.
Menurut dokumentasi Claude Code rasmi, pemasang secara automatik mengesan seni bina sistem dan memuat turun versi binari yang sesuai.
Isu Pemasangan Biasa
Sesetengah pengguna Windows melaporkan melihat "command not found: claude" selepas pemasangan. Ini biasanya berlaku kerana pembolehubah PATH belum dikemas kini.
Tutup dan buka semula terminal Ubuntu, kemudian cuba lagi. Jika isu berterusan, konfigurasi laluan ini mungkin membantu sebagai penyelesaian rasmi:
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Langkah 4: Sahkan Claude Code
Claude Code memerlukan pengesahan dengan akaun Anthropic sebelum digunakan.
Jalankan arahan ini:
claude
Terminal memaparkan URL dan meminta pengesahan. Prosesnya sedikit berbeza untuk pengguna individu berbanding akaun pasukan:
| Jenis Akaun | Kaedah Pengesahan | Apa yang Diperlukan |
|---|---|---|
| Individu | Kunci API peribadi | Akaun Anthropic dengan akses API |
| Pasukan/Organisasi | Token organisasi | Token pengesahan yang disediakan pentadbir |
Buka URL yang diberikan dalam penyemak imbas, log masuk ke akaun Anthropic, dan benarkan Claude Code. Terminal mengesahkan pengesahan berjaya.
Bekerja dengan Projek Windows dalam WSL2
Di sinilah keadaan menjadi rumit. Sistem fail Windows dan sistem fail WSL2 adalah berasingan.
Fail Windows boleh diakses daripada WSL2 pada /mnt/c/ (untuk pemacu C:), /mnt/d/ (untuk pemacu D:), dan sebagainya. Tetapi terdapat kos prestasi. Perbincangan komuniti menunjukkan perbezaan prestasi antara direktori yang dipasang Windows dan direktori WSL2 asli.
Untuk prestasi terbaik, salin fail projek ke dalam direktori rumah WSL2:
cp -r /mnt/c/Users/YourName/Projects/your-project ~/projects/your-project
Kelemahannya? Integrasi IDE menjadi lebih kompleks. Visual Studio Code mengendalikan ini dengan baik dengan sambungan Remote-WSLnya, tetapi IDE lain mungkin menghadapi kesukaran.
Menguji Pemasangan
Sahkan Claude Code berfungsi dengan betul dengan ujian ringkas.
Navigasi ke direktori projek (atau cipta folder ujian):
mkdir ~/claude-test
cd ~/claude-test
claude "cipta skrip python hello world ringkas"
Claude Code sepatutnya bertindak balas, mencipta fail, dan memaparkan kod. Ini mengesahkan pemasangan berjaya.
Berhenti Membayar Berlebihan, Tuntut Kredit AI yang Tersedia Terlebih Dahulu
Memasang Claude Code pada Windows biasanya cepat. Kos sebenar muncul kemudian apabila pembangun mula menguji gesaan, menjalankan skrip, dan menyepadukan model ke dalam aplikasi. Fasa eksperimen itu boleh menjana banyak panggilan API, dan banyak pasukan hanya menyedari kos selepas mereka mula membina.
Sebelum membelanjakan wang untuk penggunaan, adalah berbaloi untuk menyemak sama ada anda layak mendapat kredit AI atau program rakan kongsi. Get AI Perks mengumpul peluang ini di satu tempat, menyenaraikan kredit dan diskaun daripada pembekal AI, platform awan dan alatan pembangun, bersama-sama dengan arahan ringkas tentang cara menuntutnya.
Sebelum anda menjalankan projek Claude Code pertama anda, semak Get AI Perks dan tuntut kredit AI yang boleh menampung kos pembangunan anda.
Soalan Lazim
Bolehkah Claude Code berjalan asli pada Windows tanpa WSL2?
Ya, tetapi WSL2 masih kekal sebagai kaedah pemasangan terbaik untuk Windows.
Adakah Claude Code berfungsi dengan Windows Terminal?
Ya. Windows Terminal boleh membuka tab Ubuntu, membenarkan akses kepada Claude Code tanpa bertukar kepada tetingkap Ubuntu yang berasingan. Dalam Windows Terminal, klik anak panah lungsur dan pilih Ubuntu daripada senarai profil.
Adakah alatan pembangunan Windows sedia ada saya akan berfungsi dengan Claude Code?
Ia bergantung pada alatan. Visual Studio Code berintegrasi dengan baik melalui sambungan Remote-WSL. IDE JetBrains dan alatan lain mungkin memerlukan konfigurasi tambahan. Dokumentasi rasmi menyebut VS Code dan JetBrains sebagai platform yang disokong.
Bagaimana cara mengemas kini Claude Code pada Windows?
Claude Code dikemas kini secara automatik secara lalai. Untuk mengemas kini secara manual, jalankan claude update dalam terminal Ubuntu. Ciri kemas kini automatik boleh dilumpuhkan melalui fail konfigurasi jika diperlukan untuk persekitaran perusahaan.
Apakah perbezaan antara Claude Code dan Claude API?
Claude Code ialah pembantu pengekodan berasaskan terminal yang melaksanakan arahan dan mengedit fail. Claude API menyediakan akses atur cara kepada model bahasa Claude untuk membina aplikasi tersuai. Ia mempunyai tujuan yang berbeza dan memerlukan proses persediaan yang berbeza.
Bolehkah saya menggunakan Claude Code dengan projek .NET pada Windows?
Ya, tetapi dengan beberapa pengecualian. Perbincangan komuniti menunjukkan bahawa sokongan .NET SDK dalam WSL2 berfungsi, tetapi memerlukan pemasangan versi Linux .NET SDK dalam Ubuntu. .NET yang dipasang Windows tidak akan dapat diakses daripada WSL2.
Berapakah kos Claude Code?
Harga bergantung pada penggunaan dan jenis akaun. Semak laman web Anthropic rasmi untuk peringkat harga semasa dan pelan pasukan, kerana kos berbeza berdasarkan penggunaan API dan keperluan organisasi.
Langkah Seterusnya Selepas Pemasangan
Dengan Claude Code dipasang, mula terokai keupayaannya. Dokumentasi permulaan pantas mengesyorkan untuk bermula dengan tugasan ringkas seperti penjelasan kod sebelum beralih kepada operasi yang lebih kompleks.
Cuba arahan ini untuk membiasakan diri:
- claude "jelaskan fungsi ini" -- Dapatkan penjelasan kod
- claude commit -- Hasilkan mesej komit Git
- claude -c -- Teruskan perbualan yang paling baru
Dokumentasi rasmi menyediakan panduan terperinci untuk integrasi IDE, pemasangan plugin, dan pilihan konfigurasi lanjutan. Untuk pasukan, tetapan yang diuruskan pelayan dan penjejakan analitik menawarkan kawalan tambahan ke atas penempatan Claude Code.
Persediaan WSL2 mungkin kelihatan seperti langkah tambahan berbanding aplikasi Windows asli, tetapi ia pada masa ini merupakan satu-satunya laluan untuk menjalankan Claude Code pada Windows. Berita baiknya? Setelah dikonfigurasikan, ia berjalan dengan lancar dan berintegrasi dengan kebanyakan aliran kerja pembangunan.
