Ringkasan Pantas: Claude Code CLI dipasang melalui satu arahan yang memuat turun dan mengkonfigurasi alat secara automatik. Di macOS dan Linux, gunakan skrip shell rasmi daripada dokumentasi Anthropic, manakala pengguna Windows menjalankan arahan PowerShell atau WSL. Selepas pemasangan, sahkan dengan kunci API anda untuk mula menggunakan pembantu pengekodan AI Claude dalam terminal anda.
Claude Code ialah alat pengekodan agen yang berada dalam terminal anda dan memahami keseluruhan kod sumber anda. Menurut dokumentasi rasmi Claude Code, ia boleh membaca fail, melaksanakan arahan, mengedit kod, dan berintegrasi dengan alat pembangunan melalui perbualan bahasa semula jadi.
Tetapi memulakan memerlukan pemasangan yang betul. Berikut ialah semua yang diperlukan untuk memasang Claude Code CLI dan mengkonfigurasinya dengan betul.
Keperluan Sistem Sebelum Pemasangan
Sebelum memasang Claude Code, sahkan sistem memenuhi keperluan asas. Menurut dokumentasi Persediaan Lanjutan rasmi, alih keluar ayat ini sepenuhnya.
Semak pemasangan Node.js dengan membuka terminal dan menjalankan:
| node –version |
Jika Node.js tidak dipasang atau versi di bawah 18, muat turunnya daripada laman web Node.js rasmi. Versi Sokongan Jangka Panjang (LTS) berfungsi dengan sempurna untuk Claude Code.
Selain Node.js, sistem memerlukan keperluan asas: macOS 13.0 atau lebih tinggi untuk pengguna Mac, Windows 10 atau lebih tinggi untuk sistem Windows, dan kebanyakan pengedaran Linux moden berfungsi tanpa masalah. Akaun Claude daripada Anthropic juga diperlukan untuk pengesahan selepas pemasangan.
Memasang Claude Code pada macOS dan Linux
Proses pemasangan untuk macOS dan Linux menggunakan satu arahan shell yang menguruskan segala-galanya secara automatik. Kaedah ini didokumentasikan dalam panduan permulaan pantas Claude Code rasmi.
Buka Terminal dan jalankan skrip pemasangan:
| curl -fsSL claude.ai/install.sh | bash |
Skrip memuat turun binari Claude Code, meletakkannya di direktori yang betul, dan mengkonfigurasi PATH secara automatik. Keseluruhan proses biasanya selesai dalam masa kurang dari seminit.
Untuk pengguna macOS yang lebih suka Homebrew, kaedah pemasangan alternatif wujud walaupun ia tidak didokumentasikan secara rasmi dalam sumber utama. Kaedah curl kekal sebagai pendekatan yang disyorkan mengikut dokumentasi rasmi.
Mengesahkan Pemasangan
Selepas pemasangan selesai, sahkan Claude Code boleh diakses:
| claude –version |
Arahan ini sepatutnya memaparkan nombor versi yang dipasang. Jika ralat muncul menyatakan "arahan tidak ditemui", konfigurasi PATH perlu diselaraskan.
Menurut dokumentasi penyelesaian masalah rasmi, masalah PATH adalah masalah pemasangan yang paling biasa. Pembaikan melibatkan penambahan direktori pemasangan Claude ke fail konfigurasi shell.
Memasang Claude Code pada macOS dan Linux
Proses pemasangan untuk macOS dan Linux bergantung pada npm (Node Package Manager). Menurut dokumentasi rasmi, anda mesti mempunyai Node.js 18+ dipasang pada sistem anda sebelum meneruskan. Berbeza dengan alat CLI tradisional yang menggunakan skrip shell, Claude Code dipasang secara global melalui terminal anda untuk memastikan semua kebergantungan dikendalikan dengan betul.
Buka Terminal anda dan jalankan arahan berikut untuk memasang pakej:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Nota: Pemboleh ubah persekitaran CLAUDE_CODE_RELEASE_ALPHA=1 diperlukan buat masa ini semasa fasa beta/alfa awam untuk mengiktiraf status pratonton alat tersebut.
Arahan ini memuat turun pakej daripada daftar npm rasmi dan memautkan eksekutif claude ke direktori bin global sistem anda. Walaupun sesetengah pengguna mungkin cuba mencari formula Homebrew, kaedah npm adalah satu-satunya laluan pemasangan yang disokong dan didokumentasikan secara rasmi.
Mengesahkan Pemasangan
Selepas pemasangan selesai, sahkan bahawa CLI dipetakan dengan betul ke persekitaran anda dengan menjalankan:
| claude –version |
Arahan ini sepatutnya memaparkan nombor versi semasa (cth., 0.2.9). Jika anda menghadapi ralat "arahan tidak ditemui", ia biasanya bermakna direktori npm global anda tidak berada dalam PATH sistem anda.
Menurut dokumentasi penyelesaian masalah rasmi, anda boleh membetulkan ini dengan mengenal pasti awalan npm anda dengan npm config get prefix dan memastikan folder /bin yang terhasil ditambahkan pada fail .zshrc atau .bashrc anda.
Memasang Claude Code pada Windows
Pemasangan Windows menawarkan dua pendekatan utama: pemasangan PowerShell asli atau menggunakan Windows Subsystem for Linux (WSL). Dokumentasi rasmi mengesyorkan PowerShell untuk kebanyakan pengguna.
Kaedah Pemasangan PowerShell
Buka PowerShell sebagai Pentadbir (klik kanan pada menu Mula dan pilih "Windows PowerShell (Admin)"). Jalankan arahan ini:
| irm claude.ai/install.ps1 | iex |
Skrip PowerShell menguruskan pemuatan turun, pemasangan, dan konfigurasi PATH secara automatik. Selepas selesai, tutup dan buka semula PowerShell untuk memastikan kemas kini PATH berkuat kuasa.
Kaedah Pemasangan WSL
Pembangun yang sudah menggunakan WSL boleh memasang Claude Code menggunakan kaedah Linux. Buka terminal WSL dan jalankan arahan curl yang sama seperti untuk Linux:
| curl -fsSL claude.ai/install.sh | bash |
Pendekatan WSL berfungsi sama seperti pemasangan Linux asli. Satu kelebihan: WSL menyediakan persekitaran yang lebih mirip Unix yang sepadan dengan konfigurasi pelayan pengeluaran.
Menurut dokumentasi penyelesaian masalah rasmi, pengguna WSL kadang-kadang menghadapi isu sambungan rangkaian. Jika pemasangan tergantung, sahkan bahawa WSL boleh mengakses rangkaian luaran dan peraturan firewall tidak menyekat trafik.
Cari Kredit Claude dan Alat AI di Satu Tempat
Memasang Claude Code CLI adalah satu langkah. Membayar alat AI dalam jangka panjang adalah satu lagi. Get AI Perks mengumpul kredit permulaan dan diskaun perisian untuk alat AI dan awan di satu tempat. Ia memberi pengasas akses kepada 200+ tawaran, termasuk tawaran daripada Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom, dan lain-lain. Platform ini juga memaparkan syarat tawaran dan panduan untuk menuntut setiap tawaran.
Mencari Kredit Claude atau Anthropic?
Semak Get AI Perks untuk:
- cari kredit dan diskaun alat AI di satu tempat
- semak syarat tawaran sebelum memohon
- akses panduan untuk menuntut tawaran permulaan
👉 Lawati Get AI Perks untuk menyemak tawaran Claude, Anthropic dan perisian AI lain yang tersedia.
Pengesahan dan Konfigurasi Awal
Selepas pemasangan, Claude Code memerlukan pengesahan sebelum ia boleh berfungsi. Alat ini menggunakan kunci API daripada Anthropic untuk mengesahkan akses.
Mulakan proses pengesahan dengan menjalankan:
| claude |
Kali pertama arahan ini dijalankan, Claude Code meminta pengesahan. Menurut panduan permulaan pantas rasmi, ini akan membuka tetingkap penyemak imbas untuk log masuk ke akaun Anthropic.
Selepas log masuk melalui penyemak imbas, CLI menerima token pengesahan secara automatik. Token ini disimpan secara tempatan dan berterusan merentasi sesi, jadi pengesahan berulang tidak diperlukan.
Menyusun Tetapan Peringkat Projek
Claude Code menyokong konfigurasi pada pelbagai peringkat mengikut dokumentasi tetapan rasmi. Peringkat konfigurasi yang paling biasa ialah:
| Skop | Lokasi | Kes Penggunaan |
|---|---|---|
| Pengguna | ~/.claude/ directory | Pilihan peribadi merentasi semua projek |
| Projek | .claude/ dalam repositori | Konfigurasi pasukan kongsi |
| Tempatan | .claude/settings.local.json | Tindihan spesifik mesin |
Untuk persediaan kali pertama, konfigurasi peringkat pengguna sudah memadai. Tetapan peringkat projek menjadi penting apabila bekerja dengan pasukan yang berkongsi standard pengekodan.
Memulakan Sesi Claude Code Pertama Anda
Dengan pemasangan dan pengesahan selesai, lancarkan Claude Code dengan menjalankan arahan tanpa argumen:
| claude |
Ini memulakan mod interaktif di mana Claude bertindak balas kepada permintaan bahasa semula jadi. Dokumentasi rasmi menerangkan mod interaktif sebagai cara utama untuk menggunakan Claude Code untuk tugas pembangunan.
Cuba arahan ujian ringkas:
| Tunjukkan saya struktur projek ini |
Claude Code menganalisis direktori semasa dan memberikan gambaran keseluruhan struktur kod sumber. Ini menunjukkan bahawa pemasangan berfungsi dengan betul dan Claude mempunyai akses untuk membaca fail.
Arahan Penting untuk Penggunaan Harian
Selain mod interaktif, Claude Code menyokong beberapa corak arahan yang didokumentasikan dalam rujukan CLI:
| Corak Arahan | Tujuan | Contoh |
|---|---|---|
| claude | Mulakan sesi interaktif | claude |
| claude “tugasan” | Jalankan tugasan sekali sahaja | claude “betulkan ralat linting” |
| claude -p “pertanyaan” | Siasatan pantas tanpa sesi | claude -p “apa fungsi ini lakukan” |
Corak tugasan sekali sahaja sangat berguna untuk saluran paip CI/CD dan skrip automasi di mana sesi interaktif tidak sesuai.
Penyelesaian Masalah Pemasangan Umum
Walaupun dengan skrip pemasangan automatik, isu kadang-kadang berlaku. Dokumentasi penyelesaian masalah rasmi merangkumi masalah yang paling kerap berlaku.
Ralat Arahan Tidak Ditemui
Jika terminal memaparkan "arahan tidak ditemui: claude" selepas pemasangan, konfigurasi PATH tidak selesai dengan betul. Untuk macOS dan Linux, tambahkan lokasi binari Claude ke fail konfigurasi shell secara manual.
Untuk pengguna bash, edit ~/.bashrc atau ~/.bash_profile dan tambahkan:
| export PATH=”$HOME/.local/bin:$PATH” |
Untuk pengguna zsh (lalai pada macOS moden), edit ~/.zshrc dengan baris yang sama. Selepas menyimpan, muatkan semula konfigurasi dengan source ~/.zshrc atau buka tetingkap terminal baharu.
Isu Rangkaian dan Firewall
Rangkaian korporat dan firewall yang ketat kadang-kadang menyekat skrip pemasangan. Menurut dokumentasi penyelesaian masalah, jika pemasangan tergantung atau mengembalikan HTML dan bukannya melaksanakan, akses rangkaian ke pelayan Anthropic mungkin disekat.
Penyelesaian melibatkan memuat turun skrip pemasangan secara berasingan:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Pendekatan ini memberikan lebih banyak kejelasan tentang apa yang gagal jika ralat berlaku semasa pemuatan turun atau pelaksanaan.
Masalah Spesifik WSL
Pengguna Windows yang menjalankan WSL kadang-kadang menghadapi masalah sambungan antara sub-sistem Linux dan Windows. Dokumentasi rasmi menyebut bahawa peraturan firewall mungkin perlu diselaraskan untuk membenarkan trafik WSL.
Jika Claude Code dipasang dengan jayanya tetapi tidak dapat mencapai pelayan Anthropic untuk pengesahan, semak bahawa firewall Windows membenarkan akses rangkaian WSL. Panduan penyelesaian masalah menyediakan arahan PowerShell khusus untuk mengkonfigurasi peraturan firewall.
Mengemas Kini Claude Code
Claude Code menerima kemas kini berkala dengan ciri baharu dan penambahbaikan. Menurut dokumentasi rasmi, kemas kini dipasang menggunakan arahan yang sama seperti pemasangan awal.
Jalankan semula skrip pemasangan:
| curl -fsSL code.anthropic.com/install.sh | sh |
Skrip mengesan pemasangan sedia ada dan menaik tarafnya kepada versi terbaharu. Tiada konfigurasi atau pengesahan hilang semasa proses kemas kini.
Semak versi semasa sebelum dan selepas mengemas kini:
| claude –version |
Log perubahan dalam dokumentasi Claude Code rasmi menyenaraikan semua perubahan antara versi, yang membantu menentukan sama ada kemas kini memperkenalkan ciri yang berkaitan dengan aliran kerja khusus.
Langkah Seterusnya Selepas Pemasangan
Dengan Claude Code dipasang dan berfungsi, penerokaan ciri lanjutan menjadi mungkin. Dokumentasi rasmi menerangkan beberapa kawasan yang patut disiasat:
- Kemahiran dan penyesuaian: Menurut dokumentasi kemahiran rasmi, Claude Code menyokong kemahiran tersuai yang ditakrifkan dalam fail Markdown dalam direktori .claude/skills/. Kemahiran ini melanjutkan keupayaan Claude dengan arahan dan aliran kerja khusus projek.
- Protokol Konteks Model (MCP): Integrasi MCP membolehkan Claude Code berhubung dengan alat dan perkhidmatan luaran. Ini menjadikan Claude sebagai hab yang boleh mengakses pangkalan data, API dan sumber pembangunan lain.
- Kerjasama pasukan: Fail konfigurasi peringkat projek dalam direktori .claude/ boleh dikomit ke kawalan versi, berkongsi tetapan Claude Code di seluruh pasukan pembangunan.
- Dokumentasi rasmi menyediakan panduan terperinci untuk setiap kawasan ini, membina persediaan asas yang dilindungi di sini.
Soalan Lazim
Adakah saya memerlukan langganan Claude berbayar untuk menggunakan Claude Code CLI?
Claude Code memerlukan akaun Claude daripada Anthropic, tetapi peringkat langganan khusus yang diperlukan bergantung pada penggunaan. Menurut dokumentasi rasmi, pengesahan diperlukan tetapi butiran harga harus disahkan di laman web rasmi Anthropic kerana rancangan berubah dari semasa ke semasa.
Bolehkah saya memasang Claude Code tanpa keistimewaan pentadbir?
Pada macOS dan Linux, Claude Code dipasang ke direktori rumah pengguna secara lalai dan tidak memerlukan akses pentadbir. Pengguna Windows mungkin memerlukan keistimewaan pentadbir untuk kaedah pemasangan PowerShell, walaupun pemasangan WSL tidak memerlukan akses admin.
Adakah Claude Code berfungsi di luar talian?
Tidak. Claude Code ialah alat berkuasa AI yang berkomunikasi dengan pelayan Anthropic untuk memproses permintaan. Menurut dokumentasi rasmi, sambungan internet aktif diperlukan untuk Claude menganalisis kod dan menjana respons.
Bagaimana saya menyahpasang Claude Code?
Dokumentasi Persediaan Lanjutan rasmi menjelaskan bahawa penyahpasangan melibatkan pemadaman binari dan fail konfigurasi. Pada macOS dan Linux, padamkan direktori ~/.claude dan alih keluarkan pengubahsuaian PATH daripada fail konfigurasi shell. Pengguna Windows harus memadamkan direktori pemasangan dan mengosongkan pemboleh ubah persekitaran PATH.
Bolehkah Claude Code mengakses keseluruhan sistem fail saya?
Secara lalai, Claude Code beroperasi dalam direktori kerja semasa dan subdirektorinya. Menurut dokumentasi kebenaran rasmi, akses boleh dibatasi lagi menggunakan tetapan sandbox dalam fail konfigurasi. Claude sentiasa meminta pengesahan sebelum melaksanakan operasi yang berpotensi merosakkan.
Apakah perbezaan antara Claude Code CLI dan Claude Desktop?
Claude Code CLI berjalan dalam terminal dan menumpukan pada aliran kerja pembangunan dengan akses terus ke sistem fail dan pelaksanaan arahan. Claude Desktop ialah aplikasi kendiri dengan antara muka grafik. Kedua-dua alat melayani kes penggunaan yang berbeza, dengan CLI dioptimumkan untuk pembangun yang lebih suka aliran kerja berasaskan terminal.
Berapa kerap saya perlu mengemas kini Claude Code?
Kemas kini boleh dipasang bila-bila masa yang sesuai. Log perubahan mendokumentasikan ciri baharu dan pembaikan pepijat. Untuk pasukan, menyelaraskan kemas kini memastikan semua orang menggunakan versi yang serasi, walaupun Claude Code mengekalkan keserasian ke belakang dengan fail konfigurasi merentasi versi.
Kesimpulan
Memasang Claude Code CLI mengambil masa hanya beberapa minit tanpa mengira sistem pengendalian. Skrip pemasangan automatik menguruskan konfigurasi, persediaan PATH, dan penempatan binari tanpa campur tangan manual.
Selepas pemasangan dan pengesahan, Claude Code menjadi pembantu pengekodan AI yang berkuasa yang boleh diakses dari mana-mana terminal. Arahan bahasa semula jadi membolehkan pembangun menulis kod, membetulkan pepijat, dan mengautomasikan tugas tanpa meninggalkan baris arahan.
Bersedia untuk mengalami pembangunan dibantu AI? Jalankan arahan pemasangan untuk platform anda dan mulakan sesi Claude Code pertama anda hari ini. Dokumentasi rasmi di code.claude.com menyediakan panduan komprehensif untuk ciri lanjutan selepas persediaan asas selesai.
