Cara Menyiapkan Claude Code: Panduan Lengkap 2026

Ringkasan Pantas: Claude Code ialah pembantu pengekodan AI berasaskan terminal yang berjalan secara asli pada macOS dan Linux, atau pada Windows melalui WSL2. Menyiapkannya memerlukan penciptaan kunci API Anthropic, menjalankan pemasang khusus platform, pengesahan dengan kunci, dan pengesahan pemasangan dengan arahan ujian. 

Claude Code mewakili pembantu pengekodan berasaskan terminal rasmi Anthropic. Ia berada terus dalam baris arahan dan mengendalikan segala-galanya daripada penjanaan kod kepada pembaikan pepijat melalui arahan bahasa semula jadi.

Tetapi proses persediaan tidak selalu mudah. Pengguna Windows memerlukan WSL2. Pengesahan API boleh mengelirukan pengguna kali pertama. Konflik versi berlaku.

Panduan ini membincangkan proses persediaan lengkap untuk semua platform, daripada keperluan sistem kepada sesi pengekodan pertama anda.

Apa Sebenarnya Claude Code

Claude Code ialah aplikasi terminal agen yang disepadukan dengan persekitaran pembangunan. Ia memahami asas kod, melaksanakan tugas rutin, dan mengurus aliran kerja git melalui arahan perbualan.

Berbeza dengan alat berasaskan penyemak imbas, Claude Code berjalan secara setempat dalam terminal. Ia mengakses fail projek secara langsung, mengekalkan konteks merentasi sesi, dan disepadukan dengan aliran kerja pembangunan sedia ada. Menurut dokumentasi rasmi Claude Code, alat ini bersambung kepada API Anthropic dan menyokong penyepaduan dengan Amazon Bedrock, Google Cloud Vertex AI, dan Azure AI.

Alat ini beroperasi berbeza daripada pembantu pengekodan tradisional. Sejujurnya: ia lebih seperti mempunyai rakan pengatur cara di terminal anda daripada alat pelengkapan kod.

Keperluan Sistem untuk Claude Code

Sebelum pemasangan, sistem perlu memenuhi keperluan khusus. Inilah yang diperlukan oleh setiap platform:

Semua platform memerlukan sambungan internet yang stabil untuk panggilan API. Muat turun Claude Code biasanya memerlukan sekitar 50MB, dengan WSL2 pada Windows menambah kira-kira 500MB untuk sub-sistem Linux.

Dari segi storan, jangkakan sekurang-kurangnya 4GB ruang kosong. Aplikasi itu sendiri kecil, tetapi ruang untuk kebergantungan dan fail projek adalah penting.

Keperluan Khusus Windows

Claude Code boleh berjalan pada Windows melalui PowerShell atau Command Prompt jika Node.js dipasang. Alat ini memerlukan Windows Subsystem for Linux 2 untuk mencipta persekitaran Linux.

Menurut panduan pemasangan daripada claude.ai, sistem Windows 10 memerlukan Versi 1903 atau lebih baharu dengan Build 19041 atau lebih tinggi. Pengguna Windows 11 mempunyai sokongan WSL2 terbina dalam. Keistimewaan pentadbir diperlukan untuk persediaan WSL2 awal.

Proses ini melibatkan pengaktifan virtualisasi dalam BIOS, pengaktifan ciri Windows, dan pemasangan pengedaran Linux. Ubuntu 22.04 LTS ialah pengedaran yang disyorkan untuk keserasian.

Memasang Claude Code: Proses Langkah demi Langkah

Proses pemasangan berbeza mengikut platform. Begini cara untuk menjalankan Claude Code pada setiap sistem operasi.

Memasang pada macOS dan Linux

Pemasangan macOS dan Linux mengikuti corak yang sama. Kedua-dua platform menyokong pemasangan asli tanpa persediaan tambahan.

Proses bermula dengan memuat turun pemasang. Buka terminal dan jalankan:

curl -fsSL claude.ai/install.sh | sh

Skrip mengesan sistem pengendalian, memuat turun binari yang sesuai, dan memasang Claude Code ke direktori bin tempatan. Pemasangan biasanya selesai dalam masa kurang dari dua minit dengan sambungan yang stabil.

Untuk sistem tanpa curl, wget berfungsi sebagai alternatif. Pemasang menambahkan Claude Code ke PATH sistem secara automatik.

Memasang pada Windows melalui WSL2

Pemasangan Windows memerlukan persediaan WSL2 terlebih dahulu. Berikut ialah proses lengkap:

Buka PowerShell sebagai Pentadbir dan dayakan WSL:

wsl –install

Arahan ini mendayakan ciri Windows yang diperlukan, memuat turun kernel WSL2, dan memasang Ubuntu secara lalai. Sistem akan meminta untuk mulakan semula. Selepas but semula, Ubuntu dilancarkan secara automatik untuk melengkapkan persediaan pengguna.

Cipta nama pengguna dan kata laluan apabila diminta. Kredensial ini adalah untuk persekitaran Linux, berasingan daripada butiran log masuk Windows.

Setelah WSL2 berjalan, proses pemasangan Linux akan diguna pakai. Dalam terminal Ubuntu, jalankan arahan curl dari bahagian macOS/Linux di atas.

Pemasang menguruskan yang lain. Claude Code dipasang dalam persekitaran WSL2 dan berjalan melalui terminal Ubuntu.

Mendapatkan Kunci API Anthropic

Claude Code memerlukan kunci API Anthropic untuk pengesahan. Kunci menyambungkan pemasangan setempat kepada pelayan Anthropic.

Lawati Konsol Anthropic di console.anthropic.com. Cipta akaun atau log masuk dengan kredensial sedia ada. Navigasi ke Kunci API dalam tetapan akaun.

Klik "Cipta Kunci" untuk menjana kunci API baharu. Kunci muncul sekali sahaja—salin segera. Anthropic tidak memaparkan kunci penuh lagi selepas meninggalkan halaman.

Simpan kunci dengan selamat. Ia memberikan akses penuh kepada API Anthropic dan sebarang pengebilan yang berkaitan.

Memahami Kos API

Claude Code beroperasi pada model bayar-setiap-penggunaan melalui API Anthropic. Berdasarkan data daripada panduan pemasangan claude.ai, kos berbeza mengikut model:

Pembelian minimum untuk mengaktifkan pengebilan ialah $5, walaupun perbincangan komuniti mencadangkan $20-30 memberikan ruang yang lebih baik untuk ujian. Pilihan langganan alternatif termasuk Claude Pro pada $20 sebulan atau Claude Max pada $100 sebulan untuk penggunaan yang berat.

Tingkah laku lalai menggunakan Opus sehingga mencapai 50% had penggunaan, kemudian bertukar kepada Sonnet untuk kecekapan kos.

Pengesahan dan Pelancaran Pertama

Selepas pemasangan, Claude Code memerlukan pengesahan sebelum penggunaan pertama. Lancarkan Claude Code dengan menjalankan:

claude

Pelancaran pertama meminta kunci API. Tampal kunci daripada Konsol Anthropic dan tekan Enter. Claude Code mengesahkan kunci dan menyimpannya dengan selamat dalam fail konfigurasi tempatan.

Pengesahan kekal merentasi sesi. Kunci API tidak perlu dimasukkan semula melainkan ia dikeluarkan secara eksplisit atau apabila menukar akaun.

Untuk mengesahkan pengesahan berjaya, Claude Code memaparkan mesej alu-aluan dan baris arahan. Antara muka menunjukkan arahan yang tersedia dan mengesahkan sambungan kepada API Anthropic.

Mengkonfigurasi Keutamaan Model

Claude Code secara lalai memilih model secara automatik, tetapi konfigurasi manual adalah mungkin. Menurut dokumentasi rasmi, pengguna boleh melaraskan pemilihan model melalui arahan /model atau dengan menetapkan pembolehubah persekitaran CLAUDE_CODE_EFFORT_LEVEL.

Tahap usaha mengawal kedalaman pemikiran untuk model Opus 4.6 dan Sonnet 4.6: rendah, sederhana, atau tinggi. Tahap usaha yang lebih tinggi meningkatkan kedalaman penaakulan tetapi juga kos dan masa respons.

Untuk projek yang memerlukan analisis mendalam, termasuk "ultrathink" dalam gesaan sementara menetapkan usaha kepada tinggi untuk giliran khusus itu.

Mengesahkan Kejayaan Pemasangan

Selepas pengesahan, sahkan Claude Code berfungsi dengan betul. Jalankan ujian asas ini:

claude –help
claude –version

Arahan bantuan memaparkan pilihan dan arahan yang tersedia. Output versi mengesahkan keluaran yang dipasang. Kedua-dua arahan sepatutnya berjaya tanpa ralat.

Seterusnya, uji Claude Code dalam direktori projek. Cipta folder ujian:

mkdir test-project
cd test-project
echo “# Test Project” > README.md
claude

Di dalam sesi Claude Code, cuba interaksi asas:

• Taip "help" untuk melihat arahan yang tersedia
• Tanya "explain what you can do"
• Minta "summarize this project"
• Uji arahan /help

Interaksi ini mengesahkan Claude Code boleh membaca fail projek dan bertindak balas kepada gesaan. Respons yang berjaya bermakna pemasangan adalah berfungsi.

Mengkonfigurasi Claude Code untuk Projek

Claude Code menyimpan tetapan khusus projek dalam fail konfigurasi. Fail ini menyesuaikan tingkah laku, menentukan ingatan, dan mewujudkan aliran kerja.

Fail konfigurasi utama ialah CLAUDE.md di akar projek. Fail ini mengandungi arahan, konteks, dan garis panduan khusus projek yang dirujuk oleh Claude Code semasa sesi.

Cipta fail CLAUDE.md asas:

# Project Context

This is a [project type] built with [technologies].

## Key Guidelines
– [Important rule 1]
– [Important rule 2]

## Project Structure
[Brief explanation of folder organization]

Fail menerima format Markdown. Claude Code membaca konteks ini pada permulaan sesi dan mengekalkannya sepanjang perbualan.

Pilihan Konfigurasi Lanjutan

Selain konteks asas, Claude Code menyokong konfigurasi lanjutan melalui direktori .claude. Direktori ini boleh mengandungi:

• Skills: Keupayaan khusus yang ditakrifkan dalam .claude/skills/SKILL.md
• Commands: Arahan slash tersuai dalam .claude/commands/*.md
• Hooks: Aliran kerja automatik yang dicetuskan oleh peristiwa
• Plugins: Fungsionaliti lanjutan melalui penyepaduan programatik

Menurut dokumentasi rasmi Agent SDK, ciri-ciri ini membolehkan penyesuaian yang canggih. Skills mendefinisikan keupayaan yang boleh digunakan semula. Commands mencipta pintasan untuk tugas biasa. Hooks mengautomasikan respons kepada perubahan fail atau penggunaan alat.

Menggunakan Claude Code: Aliran Kerja Asas

Dengan pemasangan selesai, Claude Code mengendalikan tugas pembangunan biasa melalui bahasa semula jadi.

Mulakan sesi dengan menavigasi ke direktori projek dan menjalankan:

claude

Prompt menerima permintaan bahasa biasa. Beberapa aliran kerja biasa:

• Penjanaan Kod: "Create a Python function that validates email addresses with proper error handling."
• Pembaikan Pepijat: "This function is throwing a null pointer exception. Can you identify and fix the issue?"
• Refaktoring: "Refactor this component to use dependency injection instead of direct instantiation."
• Operasi Git: "Create a new branch, commit these changes with a descriptive message, and push to origin."

Claude Code mengekalkan konteks merentasi sesi. Ia mengingati interaksi terdahulu, menjejaki perubahan fail, dan memahami struktur projek yang lebih luas.

Memahami Mod Rancangan

Untuk perubahan kompleks, Claude Code menawarkan Mod Rancangan. Mod ini mencipta rancangan pelaksanaan terperinci sebelum membuat pengubahsuaian.

Dayakan Mod Rancangan dengan mendahului permintaan dengan "plan:" atau menggunakan arahan /plan. Claude Code kemudiannya menggariskan perubahan yang dicadangkan, menjelaskan penaakulan, dan menunggu kelulusan sebelum pelaksanaan.

Mod Rancangan amat berguna untuk refaktoring, perubahan seni bina, atau pengubahsuaian yang menjejaskan berbilang fail. Ia memberikan keterlihatan tentang apa yang Claude Code berniat lakukan sebelum melakukan perubahan.

Menyepadukan dengan VS Code dan IDE

Walaupun Claude Code berjalan dalam terminal, penyepaduan dengan editor kod meningkatkan aliran kerja. Sambungan VS Code rasmi membawa keupayaan Claude Code terus ke dalam editor.

Pasang sambungan daripada pasaran VS Code. Cari "Claude Code" dan klik Pasang. Sambungan menambahkan panel Claude Code ke bar sisi.

Menurut dokumentasi VS Code rasmi, sambungan menyokong:

Sambungan mengekalkan kesetaraan ciri dengan versi terminal sambil menambah kemudahan khusus IDE seperti perbezaan sebaris dan rujukan fail @-mention.

Mengemas kini dan Mengurus Claude Code

Claude Code dikemas kini secara automatik secara lalai. Aplikasi menyemak versi baharu secara berkala dan memasang kemas kini di latar belakang.

Untuk mengemas kini secara manual, jalankan:

claude –update

Ini memaksa semakan segera dan pemasangan versi terkini. Proses kemas kini mengekalkan fail konfigurasi dan kelayakan pengesahan.

Untuk organisasi yang memerlukan kawalan versi, kemas kini automatik boleh dilumpuhkan. Tetapkan pembolehubah persekitaran CLAUDE_CODE_AUTO_UPDATE kepada palsu atau konfigurasikan melalui tetapan yang diuruskan pelayan.

Untuk memasang versi tertentu, gunakan:

curl -fsSL claude.ai/install.sh | sh -s — –version=X.Y.Z

Gantikan X.Y.Z dengan nombor versi sasaran.

Isu Persediaan Biasa dan Penyelesaian

Beberapa isu biasa berlaku semasa persediaan. Begini cara menyelesaikannya:

• Penolakan Kunci API: Jika Claude Code menolak kunci API, sahkan tiada ruang tambahan atau aksara. Salin semula kunci daripada Konsol Anthropic. Semak sama ada pengebilan didayakan—kunci tidak akan berfungsi tanpa kaedah pembayaran yang didaftarkan.
• Kegagalan Pemasangan WSL2: Sistem Windows kadang-kadang gagal memasang WSL2 kerana tetapan virtualisasi. Masukkan BIOS dan dayakan virtualisasi (Intel VT-x atau AMD-V). Pastikan versi Windows memenuhi keperluan minimum.
• Arahan Tidak Ditemui: Jika terminal tidak mengenali arahan claude, PATH tidak dikemas kini dengan betul. Tutup dan buka semula terminal. Untuk isu berterusan, tambahkan direktori pemasangan ke PATH secara manual.
• Masa Tamat Sambungan: Sekatan rangkaian atau tembok api boleh menyekat panggilan API. Claude Code memerlukan akses HTTPS kepada api.anthropic.com. Rangkaian korporat mungkin memerlukan konfigurasi proksi.
• Ralat Kebenaran: Pemasangan Linux dan macOS kadang-kadang menghadapi isu kebenaran. Jalankan pemasang dengan kebenaran yang sesuai atau pasang ke direktori pengguna dan bukannya lokasi sistem keseluruhan.

Semak Kredit AI yang Tersedia Sebelum Menyiapkan Claude Code

Menyiapkan Claude Code biasanya bermakna bereksperimen—menjalankan gesaan, menguji penyepaduan, dan membina prototaip kecil sebelum apa-apa dimasukkan ke dalam pengeluaran. Peringkat awal itu sering membawa kepada banyak penggunaan API. Daripada membayar setiap permintaan serta-merta, ramai pembangun terlebih dahulu mencari kredit yang tersedia atau program permulaan yang membantu mengurangkan kos awal tersebut.

Get AI Perks mengumpulkan peluang ini di satu tempat. Platform ini menyenaraikan kredit AI, diskaun, dan program rakan kongsi merentasi pembekal AI, platform awan, dan alat pembangun, dengan panduan langkah demi langkah yang menjelaskan cara menuntutnya. Secara keseluruhan, pangkalan data termasuk faedah daripada lebih 200 alat dan berjuta-juta dolar dalam kredit yang tersedia yang boleh dimohon oleh permulaan dan pembangun.

Sebelum anda selesai menyiapkan Claude Code, semak Get AI Perks dan tuntut kredit AI yang boleh menampung eksperimen pertama anda.

Soalan Lazim

Bergerak ke Hadapan dengan Claude Code

Claude Code mengubah pembangunan berasaskan terminal dengan menyepadukan bantuan AI terus ke dalam baris arahan. Persediaan memerlukan pemasangan khusus platform, pengesahan API, dan konfigurasi asas, tetapi prosesnya mudah apabila mengikut langkah yang betul.

Alat ini cemerlang dalam tugas pembangunan rutin, penjanaan kod, dan pengurusan aliran kerja git. Mod Rancangan memberikan keselamatan untuk operasi kompleks. Penyepaduan IDE meluaskan keupayaan di luar terminal.

Mulakan dengan tugas mudah untuk memahami cara Claude Code mentafsir permintaan. Bina sehingga aliran kerja yang lebih kompleks apabila kebiasaan berkembang. Gunakan arahan /clear antara tugasan yang berbeza untuk mengekalkan konteks yang bersih. Konfigurasikan fail CLAUDE.md untuk panduan khusus projek.

Pasukan boleh meneroka tetapan yang diuruskan pelayan dan pasaran pemalam. Pembangun individu boleh mendapat manfaat daripada skills dan arahan tersuai yang disesuaikan dengan corak yang kerap.

Repositori GitHub di anthropics/claude-code mengandungi contoh tambahan, pemalam komuniti, dan sumber penyelesaian masalah. Dokumentasi rasmi di docs.anthropic.com menyediakan rujukan teknikal yang komprehensif.

Kini tiba masanya untuk mula pengekodan. Navigasi ke projek, lancarkan Claude Code, dan lihat bagaimana pembangunan berbantu AI mengubah aliran kerja anda.