Cara memasang Claude Code daripada laman web rasmi

Apakah Claude Code dan mengapa ia berada dalam terminal?#

Terminal menakutkan hampir semua orang yang mula mencuba vibe coding tanpa latar belakang pembangunan perisian. Ia kelihatan seperti tetingkap hitam dalam filem penggodam, tetapi sebenarnya ia cuma baris tempat anda menaip arahan. Claude Code memerlukannya supaya ia boleh membuka fail anda, mengubahnya dan menjalankan semakan sendiri sementara anda menerangkan tugasan dengan kata-kata.

Anthropic menerangkan produk ini begini.

Perbezaannya berbanding sembang biasa mudah sahaja. Dalam pelayar, anda menyalin kod secara manual berulang-alik antara tetingkap dan editor. Claude Code masuk terus ke folder projek, membaca fail yang diperlukan, membuat perubahan dan menunjukkan perkara yang telah diubahnya. Anda tetap membuat keputusan dan meluluskan perubahan; ia melakukan kerja mekanikal untuk anda.

Jika anda benar-benar tidak mahu menggunakan terminal, Anthropic menyediakan aplikasi desktop dengan tetingkap biasa dan versi web di claude.ai/code yang berjalan terus dalam pelayar. Namun, pilihan yang paling berkuasa dan fleksibel ialah versi terminal, yang menjadi fokus seluruh artikel ini.

Di manakah laman web rasmi Claude Code, dan apakah yang patut dimuat turun?#

Perkara pertama yang mengelirukan pengguna baharu ialah tempat mencari laman web rasmi Claude Code dan perkara yang perlu diklik untuk memuat turunnya. Berikut ialah jadual semua alamat rasmi Anthropic supaya anda tidak perlu meneka.

Anda tidak memuat turun pemasang daripada laman web seperti yang biasa dilakukan untuk program lain, bertentangan dengan jangkaan ramai orang. Anda memasangnya dengan arahan terminal yang kemudian memuat turun versi yang sesuai untuk sistem anda. Artikel ini menyediakan arahan tepat untuk Mac, Windows dan Linux.

Satu perangkap biasa ialah namanya: ramai orang tersalah eja sebagai clode code, clade code, слод код atau clode design. Nama produk ini ialah Claude Code, dengan au. Ingat perkara ini apabila mencari laman web rasmi: domain yang ejaannya hampir sama dimiliki pihak lain.

Anda juga patut tahu nama tepat pakej npm. Pakej kanonik ialah @anthropic-ai/claude-code, dengan awalan @anthropic-ai/. Anthropic sendiri memiliki nama ringkas claude-code tanpa awalan — itu ialah pautan rasmi mereka kepada pakej yang sama. Peraturannya mudah: penerbitnya mestilah Anthropic, dan nama yang digunakan untuk pemasangan mempunyai awalan tersebut.

Keperluan komputer untuk pemasangan#

Keperluan Claude Code tidak tinggi: pelayan Anthropic melakukan kerja berat; komputer anda hanya menghantar permintaan dan menerima jawapan.

Nota berasingan tentang Node.js, kerana banyak mitos berkait dengannya. Pemasang natif — yang disyorkan oleh Anthropic sendiri — langsung tidak memerlukan Node.js: ia dipasang sebagai satu fail kendiri. Node.js hanya diperlukan jika anda memasang Claude Code melalui npm; dalam kes itu, anda memerlukan versi 22 atau lebih baharu. Artikel lama menyatakan “Node 18 dan ke atas” — maklumat itu sudah lapuk; gunakan versi 22+ sebagai panduan.

Anda memerlukan terminal untuk versi utama. Jika anda tidak mahu menggunakannya, pasang aplikasi desktop dengan tetingkap biasa atau gunakan versi web di claude.ai/code. Versi terminal masih mempunyai lebih banyak ciri, jadi selebihnya artikel ini menerangkan cara memasangnya.

Memasang Claude Code ibarat mendapatkan alat untuk digunakan. Namun, dengan sendirinya, ia kerap berhalusinasi: terlupa tentang projek anda, mereka-reka perkara dan hilang arah di tengah-tengah tugasan. Gabungan tiga perkara menjadikannya boleh diharap: klon AI, Otak Kedua dan kejuruteraan konteks. Inilah tiga tonggak yang menghalang AI daripada berhalusinasi.

Bagaimanakah cara memasang Claude Code pada macOS?#

Buka Terminal (ia disertakan pada setiap Mac: tekan Cmd+Space dalam Spotlight, kemudian taip “Terminal”) dan tampal baris ini:

curl -fsSL https://claude.ai/install.sh | bash

Arahan itu memuat turun pemasang daripada alamat rasmi Anthropic dan memasang Claude Code. Node.js tidak diperlukan. Kaedah natif juga mudah kerana kemas kini diuruskan secara automatik.

Jika anda sudah menggunakan Homebrew, ada pilihan kedua:

brew install --cask claude-code

Perbezaannya terletak pada cara kemas kini berfungsi: pemasang natif mengemas kini dirinya sendiri, manakala Homebrew tidak — anda perlu mengemas kininya secara manual dengan arahan brew upgrade claude-code. Programnya sama sahaja, jadi pilih kaedah yang biasa anda gunakan. Jika tidak pasti, gunakan kaedah pertama.

Bagaimanakah cara memasang Claude Code pada Windows?#

Mula-mula, kenal pasti shell yang anda gunakan. Windows mempunyai dua shell dan setiap satunya menggunakan arahan tersendiri. Buka tetingkap dan lihat permulaan prompt: PS C:\> bermaksud PowerShell, manakala C:\> tanpa PS bermaksud Command Prompt (CMD).

Untuk PowerShell (cara paling mudah untuk membukanya ialah klik kanan butang Start dan pilih “Terminal”):

irm https://claude.ai/install.ps1 | iex

Untuk Command Prompt (CMD):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Pilihan ketiga ialah menggunakan pengurus pakej WinGet terbina dalam:

winget install Anthropic.ClaudeCode

Jika anda sudah mempunyai persekitaran WSL yang berfungsi (Linux dalam Windows), pasang Claude Code terus di dalam WSL dengan arahan yang sama seperti di Linux. Terdapat satu isu khusus WSL berkaitan Node, yang akan saya terangkan di bawah dalam bahagian ralat lazim.

Bagaimanakah cara memasang Claude Code pada Linux?#

Kaedah asas untuk semua pengedaran popular adalah sama: gunakan pemasang kendiri ini:

curl -fsSL https://claude.ai/install.sh | bash

Node.js tidak diperlukan; program ini hadir sebagai satu fail dan selepas itu mengemas kini dirinya sendiri.

Jika anda biasa memasang program hanya melalui pengurus pakej sistem, anda boleh menambah repositori rasmi Anthropic: apt untuk Debian dan Ubuntu, dnf untuk Fedora dan RHEL, serta apk untuk Alpine. Repositori ini ditandatangani dengan kunci dan mempunyai saluran stable dan latest. Cara itu terlalu rumit untuk pengguna baharu, jadi saya serahkan butirannya kepada dokumentasi dalam bahagian sumber dan mengesyorkan arahan di atas sebagai pilihan lalai.

Satu masalah mungkin timbul pada pelayan murah. Jika komputer mempunyai memori kosong yang sangat sedikit, pemasangan mungkin terhenti dengan perkataan Killed (kod 137) — sistem menamatkan proses kerana kehabisan memori. Penyelesaiannya ialah menambah fail swap: Claude Code memerlukan kira-kira 512 MB memori kosong untuk dipasang.

Bagaimanakah cara melancarkan Claude Code buat kali pertama?#

Pelancaran pertama mengambil masa beberapa minit. Begini caranya.

1. Pergi ke folder projek

   Dalam terminal, gunakan arahan cd path-to-project untuk pergi ke folder yang ingin anda gunakan, kemudian taip claude.

2. Log masuk ke akaun anda

   Pelayar akan dibuka dengan tetingkap log masuk. Jika ia tidak terbuka secara automatik, tekan c untuk menyalin pautan dan tampalkannya secara manual ke dalam pelayar. Jika pelayar memaparkan kod (ini boleh berlaku dalam WSL dan pada pelayan jauh), tampal kod itu semula ke dalam terminal.

3. Tunggu pengesahan

   Selepas anda log masuk, terminal akan memaparkan Login successful dan meminta anda menekan Enter.

4. Kemukakan soalan pertama

   Tanya sesuatu yang mudah tentang projek, seperti “apakah fungsi projek ini?” Claude akan membaca fail dan menjawab.

5. Luluskan perubahan pertama

   Apabila anda memintanya mengubah sesuatu, Claude akan menunjukkan perubahan yang dicadangkan dan meminta pengesahan. Anda boleh menukar mod akses dengan Shift+Tab.

Anda patut mempelajari beberapa arahan asas yang boleh digunakan dalam sesi dengan segera: /help menyenaraikan arahan, /clear mengosongkan sejarah perbualan dan /exit menamatkan sesi (menekan Ctrl+D dua kali memberikan hasil yang sama). Claude akan menunjukkan semua ini jika anda menaip /help.

Log masuk dengan langganan atau kunci API: yang manakah patut dipilih?#

Inilah soalan pertama yang timbul semasa log masuk.

Terdapat dua cara untuk log masuk dan perbezaannya ialah cara pembayaran.

Untuk log masuk dengan langganan, gunakan sahaja akaun Claude.ai anda. Untuk log masuk menggunakan kunci API, dapatkan kunci daripada Claude Console (platform.claude.com); caj ditolak daripada baki prabayar semasa anda menggunakan perkhidmatan. Tetapkan kunci itu dalam pemboleh ubah persekitaran ANTHROPIC_API_KEY, dan Claude Code tidak akan membuka pelayar setiap kali.

Anda boleh menukar akaun dalam sesi menggunakan /login dan log keluar dengan /logout.

Namun, Claude Code tidak akan dilancarkan tanpa akses berbayar. Jika anda belum mempunyai akaun, ketahui dahulu alamat e-mel yang perlu digunakan untuk mendaftar: anda tidak boleh menukarnya kemudian.

Bagaimanakah cara menyemak sama ada semuanya dipasang dengan betul?#

Terdapat tiga arahan yang elok diketahui sejak awal.

Arahan pertama menyemak versi:

claude --version

Pemasangan yang berfungsi akan memberikan nombor dalam format X.Y.Z (Claude Code). Angka khusus berubah dari satu versi ke versi yang lain; perkara pentingnya ialah arahan itu mengembalikan nombor versi. Respons “command not found” bermaksud sesuatu yang lain — hal itu diterangkan dalam bahagian seterusnya.

Arahan kedua digunakan untuk diagnostik jika berlaku masalah.

Arahan ketiga ialah /status dalam sesi: arahan ini menunjukkan cara anda log masuk, alamat e-mel atau organisasi yang dipautkan dan sama ada akses anda telah tamat tempoh. claude update pula menggunakan kemas kini terkini dengan serta-merta dan tidak menunggu kemas kini latar belakang.

Mengapa arahan claude tidak dapat ditemui selepas pemasangan?#

Ini ialah aduan paling lazim daripada pengguna baharu dan bunyinya lebih menakutkan daripada keadaan sebenar. Terminal tidak mencari arahan di seluruh komputer; ia hanya menyemak folder dalam PATH. Claude Code meletakkan dirinya di ~/.local/bin/claude (pada Mac dan Linux) atau %USERPROFILE%\\.local\\bin\\claude.exe (pada Windows), dan jika folder itu tiada dalam PATH, terminal tidak dapat melihat program tersebut.

Pada Mac dan Linux, tambahkan folder itu ke dalam senarai. Buka fail tetapan shell anda (~/.zshrc untuk Zsh, ~/.bashrc untuk Bash) dan tambahkan baris ini di hujung fail:

export PATH="$HOME/.local/bin:$PATH"

Kemudian tutup dan buka semula terminal (atau jalankan source ~/.zshrc). Selepas itu, arahan claude akan dapat ditemui.

Ralat lazim semasa pemasangan dan pelancaran pertama#

Mari kita lihat satu demi satu; semuanya diambil daripada panduan penyelesaian masalah rasmi Anthropic.

1. Node lama semasa memasang melalui npm. Pakej @anthropic-ai/claude-code memerlukan Node.js 22 atau lebih baharu. Pada Windows, npm mungkin gagal dengan mesej tentang skrip yang dilumpuhkan — dasar PowerShell menghalang skrip daripada dijalankan. Dalam WSL, ralat lazim ialah exec: node: not found: WSL menggunakan Node Windows dan bukannya Node Linux. Jika npm menimbulkan masalah, beralih kepada pemasang natif; ia tidak memerlukan Node.
2. Pemasang yang salah untuk shell. Mesej 'irm' is not recognized bermaksud anda menampal arahan PowerShell ke dalam Command Prompt. The token '&&' is not a valid statement separator bermaksud anda melakukan sebaliknya dan menjalankan arahan CMD dalam PowerShell. A parameter cannot be found that matches parameter name 'fsSL' bermaksud anda menjalankan arahan Mac/Linux dalam PowerShell. Semak permulaan prompt: PS C:\ ialah PowerShell, manakala C:\ ialah CMD.
3. Kunci API lama mengatasi langganan. Jika langganan anda aktif tetapi kunci lama masih ditetapkan dalam persekitaran, anda akan melihat API Error: 400 ... This organization has been disabled. Kunci itu mengatasi log masuk langganan. Buangkannya dengan unset ANTHROPIC_API_KEY (dalam PowerShell, gunakan Remove-Item Env:ANTHROPIC_API_KEY), semak ~/.zshrc dan ~/.bashrc, kemudian taip /status.
4. Memori tidak mencukupi pada pelayan yang lemah. Pemasangan terhenti dengan perkataan Killed dan kod 137 — ini bermakna RAM tidak mencukupi. Anda memerlukan kira-kira 512 MB ruang kosong; menambah swap akan menyelesaikan masalah.
5. Pemasang memulangkan sesuatu yang lain. Ralat syntax error near unexpected token '<' atau rujukan kepada <!DOCTYPE html> bermaksud URL pemasangan memulangkan halaman web dan bukannya skrip pemasangan — biasanya disebabkan rantau anda, firewall korporat atau gangguan sementara. Cuba kaedah lain (Homebrew, WinGet) atau cuba lagi dalam beberapa minit.

Untuk mana-mana ralat ini, langkah pertama tetap sama: jalankan claude doctor. Ia akan menunjukkan perkara yang tidak berfungsi dan mencadangkan tempat untuk menyiasat.

Terdapat satu lagi perkara dalam diagnostik: 403 sahaja semasa pemasangan juga boleh berpunca daripada firewall atau proksi korporat. Jadi, jika anda menggunakan rangkaian pejabat, semak dahulu sama ada rangkaian itu menyekat akses.

Perkara yang perlu dilakukan selepas pemasangan: langkah pertama#

Pemasangan hanyalah permulaan. Kerja sebenar bermula selepas itu, dan perkara pertama yang dihadapi ramai orang ialah ingatan. Model bahasa tidak mengingati anda antara perbualan: dalam sembang baharu, ia hanya tahu perkara yang anda masukkan dalam konteksnya.

Jadi, langkah sebenar pertama selepas pemasangan ialah mencipta fail CLAUDE.md di akar projek anda. Fail teks ini mengandungi peraturan dan konteks projek yang dibaca oleh Claude Code setiap kali ia dilancarkan. Terangkan sekali sahaja perkara yang anda lakukan, cara projek disusun dan perkara yang penting — selepas itu anda tidak perlu mengulanginya dalam setiap perbualan.

Dalam panduan berasingan, saya menerangkan cara menyediakan fail itu dan menyesuaikan Claude: cara menyesuaikan Claude. Saya juga menyediakan peta umum alat vibe coding untuk 2026.

Apakah soalan lain yang sering ditanya?#

Rangka kerja lengkap vibe coding: klon AI + Otak Kedua + Kejuruteraan konteks.