Cara Mengatur Claude Code: Panduan Lengkap 2026

Ringkasan Singkat: Claude Code adalah asisten pengkodean AI berbasis terminal yang berjalan secara native di macOS dan Linux, atau di Windows melalui WSL2. Pengaturannya memerlukan pembuatan kunci API Anthropic, menjalankan penginstal spesifik platform, otentikasi dengan kunci, dan memverifikasi instalasi dengan perintah uji. 

Claude Code mewakili asisten pengkodean berbasis terminal resmi dari Anthropic. Ia hidup langsung di baris perintah dan menangani segala hal mulai dari pembuatan kode hingga perbaikan bug melalui perintah bahasa alami.

Namun, proses pengaturannya tidak selalu mudah. Pengguna Windows memerlukan WSL2. Otentikasi API bisa membingungkan bagi pengguna baru. Terjadi konflik versi.

Panduan ini membahas proses pengaturan lengkap untuk semua platform, mulai dari persyaratan sistem hingga sesi pengkodean pertama Anda.

Apa Sebenarnya Claude Code Itu

Claude Code adalah aplikasi terminal agen yang terintegrasi dengan lingkungan pengembangan. Ia memahami basis kode, mengeksekusi tugas rutin, dan mengelola alur kerja git melalui perintah percakapan.

Berbeda dengan alat berbasis browser, Claude Code berjalan secara lokal di terminal. Ia mengakses file proyek secara langsung, menjaga konteks antar sesi, dan terintegrasi dengan alur kerja pengembangan yang ada. Menurut dokumentasi resmi Claude Code, alat ini terhubung ke API Anthropic dan mendukung integrasi dengan Amazon Bedrock, Google Cloud Vertex AI, dan Azure AI.

Alat ini beroperasi berbeda dari asisten pengkodean tradisional. Bicara jujur: ini lebih seperti memiliki pasangan programmer di terminal Anda daripada alat pelengkap kode.

Persyaratan Sistem untuk Claude Code

Sebelum instalasi, sistem perlu memenuhi persyaratan tertentu. Berikut yang dibutuhkan setiap platform:

Semua platform memerlukan koneksi internet yang stabil untuk panggilan API. Unduhan Claude Code biasanya membutuhkan sekitar 50MB, dengan WSL2 di Windows menambahkan sekitar 500MB untuk subsistem Linux.

Dalam hal penyimpanan, harapkan setidaknya 4GB ruang kosong. Aplikasi itu sendiri kecil, tetapi ruang untuk dependensi dan file proyek penting.

Persyaratan Khusus Windows

Claude Code dapat berjalan di Windows melalui PowerShell atau Command Prompt jika Node.js terinstal. Alat ini memerlukan Windows Subsystem for Linux 2 untuk membuat lingkungan Linux.

Menurut panduan instalasi dari claude.ai, sistem Windows 10 memerlukan Versi 1903 atau lebih baru dengan Build 19041 atau lebih tinggi. Pengguna Windows 11 memiliki dukungan WSL2 yang terpasang. Hak administrator diperlukan untuk pengaturan WSL2 awal.

Prosesnya melibatkan pengaktifan virtualisasi di BIOS, pengaktifan fitur Windows, dan instalasi distribusi Linux. Ubuntu 22.04 LTS adalah distribusi yang direkomendasikan untuk kompatibilitas.

Menginstal Claude Code: Proses Langkah demi Langkah

Proses instalasi bervariasi berdasarkan platform. Berikut cara menjalankan Claude Code di setiap sistem operasi.

Menginstal di macOS dan Linux

Instalasi macOS dan Linux mengikuti pola yang sama. Kedua platform mendukung instalasi native tanpa pengaturan tambahan.

Proses dimulai dengan mengunduh penginstal. Buka terminal dan jalankan:

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

Skrip mendeteksi sistem operasi, mengunduh biner yang sesuai, dan menginstal Claude Code ke direktori bin lokal. Instalasi biasanya selesai dalam waktu kurang dari dua menit dengan koneksi yang stabil.

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

Menginstal di Windows via WSL2

Instalasi Windows memerlukan pengaturan WSL2 terlebih dahulu. Berikut adalah proses lengkapnya:

Buka PowerShell sebagai Administrator dan aktifkan WSL:

wsl –install

Perintah ini mengaktifkan fitur Windows yang diperlukan, mengunduh kernel WSL2, dan menginstal Ubuntu secara default. Sistem akan meminta restart. Setelah reboot, Ubuntu akan diluncurkan secara otomatis untuk menyelesaikan pengaturan pengguna.

Buat nama pengguna dan kata sandi saat diminta. Kredensial ini untuk lingkungan Linux, terpisah dari detail login Windows.

Setelah WSL2 berjalan, proses instalasi Linux berlaku. Di terminal Ubuntu, jalankan perintah curl dari bagian macOS/Linux di atas.

Penginstal menangani sisanya. Claude Code terinstal di dalam lingkungan WSL2 dan berjalan melalui terminal Ubuntu.

Mendapatkan Kunci API Anthropic

Claude Code memerlukan kunci API Anthropic untuk otentikasi. Kunci tersebut menghubungkan instalasi lokal ke server Anthropic.

Kunjungi Konsol Anthropic di console.anthropic.com. Buat akun atau masuk dengan kredensial yang ada. Navigasikan ke Kunci API di pengaturan akun.

Klik "Buat Kunci" untuk menghasilkan kunci API baru. Kunci tersebut muncul sekali—salin segera. Anthropic tidak menampilkan kunci lengkap lagi setelah meninggalkan halaman.

Simpan kunci dengan aman. Kunci ini memberikan akses penuh ke API Anthropic dan setiap penagihan terkait.

Memahami Biaya API

Claude Code beroperasi dengan model bayar per penggunaan melalui API Anthropic. Berdasarkan data dari panduan instalasi claude.ai, biaya bervariasi berdasarkan model:

Pembelian minimum untuk mengaktifkan penagihan adalah $5, meskipun diskusi komunitas menunjukkan $20-30 memberikan ruang lebih baik untuk pengujian. Pilihan langganan alternatif termasuk Claude Pro seharga $20 bulanan atau Claude Max seharga $100 bulanan untuk penggunaan yang intensif.

Perilaku default menggunakan Opus hingga mencapai 50% batas penggunaan, kemudian beralih ke Sonnet untuk efisiensi biaya.

Otentikasi dan Peluncuran Pertama

Setelah instalasi, Claude Code memerlukan otentikasi sebelum penggunaan pertama. Jalankan Claude Code dengan menjalankan:

claude

Peluncuran pertama akan meminta kunci API. Tempelkan kunci dari Konsol Anthropic dan tekan Enter. Claude Code akan memvalidasi kunci dan menyimpannya dengan aman di file konfigurasi lokal.

Otentikasi tetap ada antar sesi. Kunci API tidak perlu dimasukkan kembali kecuali secara eksplisit dihapus atau saat beralih akun.

Untuk memverifikasi otentikasi berhasil, Claude Code akan menampilkan pesan selamat datang dan prompt perintah. Antarmuka menunjukkan perintah yang tersedia dan mengonfirmasi koneksi ke API Anthropic.

Mengonfigurasi Preferensi Model

Claude Code secara default memilih model secara otomatis, tetapi konfigurasi manual dimungkinkan. Menurut dokumentasi resmi, pengguna dapat menyesuaikan pemilihan model melalui perintah /model atau dengan mengatur variabel lingkungan CLAUDE_CODE_EFFORT_LEVEL.

Tingkat upaya mengontrol kedalaman pemikiran untuk model Opus 4.6 dan Sonnet 4.6: rendah, sedang, atau tinggi. Tingkat upaya yang lebih tinggi meningkatkan kedalaman penalaran tetapi juga biaya dan waktu respons.

Untuk proyek yang memerlukan analisis mendalam, menyertakan "ultrathink" dalam prompt sementara mengatur upaya ke tinggi untuk giliran spesifik tersebut.

Memverifikasi Keberhasilan Instalasi

Setelah otentikasi, verifikasi Claude Code berfungsi dengan benar. Jalankan tes dasar ini:

claude –help
claude –version

Perintah help menampilkan opsi dan perintah yang tersedia. Output versi mengonfirmasi rilis mana yang terinstal. Kedua perintah harus dieksekusi tanpa kesalahan.

Selanjutnya, uji Claude Code di direktori proyek. Buat folder tes:

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

Di dalam sesi Claude Code, coba interaksi dasar:

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

Interaksi ini mengonfirmasi Claude Code dapat membaca file proyek dan merespons prompt. Respons yang berhasil berarti instalasi berfungsi.

Mengonfigurasi Claude Code untuk Proyek

Claude Code menyimpan pengaturan spesifik proyek dalam file konfigurasi. File-file ini menyesuaikan perilaku, mendefinisikan memori, dan menetapkan alur kerja.

File konfigurasi utama adalah CLAUDE.md di akar proyek. File ini berisi instruksi, konteks, dan panduan spesifik proyek yang direferensikan Claude Code selama sesi.

Buat file CLAUDE.md dasar:

# Konteks Proyek

Ini adalah [tipe proyek] yang dibangun dengan [teknologi].

## Pedoman Utama
– [Aturan penting 1]
– [Aturan penting 2]

## Struktur Proyek
[Penjelasan singkat tentang organisasi folder]

File ini menerima format Markdown. Claude Code membaca konteks ini pada awal sesi dan mempertahankannya sepanjang percakapan.

Opsi Konfigurasi Tingkat Lanjut

Selain konteks dasar, Claude Code mendukung konfigurasi tingkat lanjut melalui direktori .claude. Direktori ini dapat berisi:

• Skill: Kemampuan khusus yang didefinisikan dalam .claude/skills/SKILL.md
• Perintah: Perintah slash kustom di .claude/commands/*.md
• Hook: Alur kerja otomatis yang dipicu oleh peristiwa
• Plugin: Fungsionalitas yang diperluas melalui integrasi terprogram

Menurut dokumentasi SDK Agen resmi, fitur-fitur ini memungkinkan kustomisasi yang canggih. Skill mendefinisikan kemampuan yang dapat digunakan kembali. Perintah membuat pintasan untuk tugas umum. Hook mengotomatiskan respons terhadap perubahan file atau penggunaan alat.

Menggunakan Claude Code: Alur Kerja Dasar

Setelah instalasi selesai, Claude Code menangani tugas pengembangan umum melalui bahasa alami.

Mulai sesi dengan menavigasi ke direktori proyek dan menjalankan:

claude

Prompt menerima permintaan bahasa biasa. Beberapa alur kerja umum:

• Pembuatan Kode: "Buat fungsi Python yang memvalidasi alamat email dengan penanganan kesalahan yang tepat."
• Perbaikan Bug: "Fungsi ini melemparkan exception null pointer. Bisakah Anda mengidentifikasi dan memperbaiki masalahnya?"
• Refactoring: "Refactor komponen ini untuk menggunakan dependency injection alih-alih instansiasi langsung."
• Operasi Git: "Buat branch baru, commit perubahan ini dengan pesan deskriptif, dan push ke origin."

Claude Code menjaga konteks di seluruh sesi. Ia mengingat interaksi sebelumnya, melacak modifikasi file, dan memahami struktur proyek yang lebih luas.

Memahami Mode Rencana

Untuk perubahan yang kompleks, Claude Code menawarkan Mode Rencana. Mode ini membuat rencana eksekusi terperinci sebelum membuat modifikasi.

Aktifkan Mode Rencana dengan memberi awalan pada permintaan dengan "plan:" atau menggunakan perintah /plan. Claude Code kemudian menguraikan perubahan yang diusulkan, menjelaskan alasannya, dan menunggu persetujuan sebelum eksekusi.

Mode Rencana sangat berguna untuk refactoring, perubahan arsitektur, atau modifikasi yang memengaruhi beberapa file. Ini memberikan visibilitas tentang apa yang dimaksud Claude Code untuk dilakukan sebelum melakukan perubahan.

Integrasi dengan VS Code dan IDE

Meskipun Claude Code berjalan di terminal, integrasi dengan editor kode meningkatkan alur kerja. Ekstensi VS Code resmi membawa kemampuan Claude Code langsung ke editor.

Instal ekstensi dari marketplace VS Code. Cari "Claude Code" dan klik Instal. Ekstensi menambahkan panel Claude Code ke bilah sisi.

Menurut dokumentasi resmi VS Code, ekstensi mendukung:

Ekstensi menjaga kesetaraan fitur dengan versi terminal sambil menambahkan kenyamanan khusus IDE seperti diff inline dan referensi file @-mention.

Memperbarui dan Mengelola Claude Code

Claude Code diperbarui secara otomatis secara default. Aplikasi memeriksa versi baru secara berkala dan menginstal pembaruan di latar belakang.

Untuk memperbarui secara manual, jalankan:

claude –update

Ini memaksa pemeriksaan dan instalasi segera versi terbaru. Proses pembaruan mempertahankan file konfigurasi dan kredensial otentikasi.

Untuk organisasi yang memerlukan kontrol versi, pembaruan otomatis dapat dinonaktifkan. Atur variabel lingkungan CLAUDE_CODE_AUTO_UPDATE ke false atau konfigurasikan melalui pengaturan yang dikelola server.

Untuk menginstal versi tertentu, gunakan:

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

Ganti X.Y.Z dengan nomor versi target.

Masalah Pengaturan Umum dan Solusinya

Beberapa masalah umum terjadi selama pengaturan. Berikut cara menyelesaikannya:

• Penolakan Kunci API: Jika Claude Code menolak kunci API, pastikan tidak ada spasi atau karakter tambahan. Salin ulang kunci dari Konsol Anthropic. Periksa apakah penagihan diaktifkan—kunci tidak akan berfungsi tanpa metode pembayaran yang terdaftar.
• Kegagalan Instalasi WSL2: Sistem Windows terkadang gagal menginstal WSL2 karena pengaturan virtualisasi. Masuk ke BIOS dan aktifkan virtualisasi (Intel VT-x atau AMD-V). Pastikan versi Windows memenuhi persyaratan minimum.
• Perintah Tidak Ditemukan: Jika terminal tidak mengenali perintah claude, PATH tidak diperbarui dengan benar. Tutup dan buka kembali terminal. Untuk masalah yang terus-menerus, tambahkan direktori instalasi ke PATH secara manual.
• Batas Waktu Koneksi: Pembatasan jaringan atau firewall dapat memblokir panggilan API. Claude Code memerlukan akses HTTPS ke api.anthropic.com. Jaringan perusahaan mungkin memerlukan konfigurasi proxy.
• Kesalahan Izin: Instalasi Linux dan macOS terkadang mengalami masalah izin. Jalankan penginstal dengan izin yang sesuai atau instal ke direktori pengguna alih-alih lokasi sistem.

Periksa Kredit AI yang Tersedia Sebelum Mengatur Claude Code

Mengatur Claude Code biasanya berarti bereksperimen—menjalankan prompt, menguji integrasi, dan membangun prototipe kecil sebelum ada yang masuk ke produksi. Tahap awal itu seringkali menyebabkan banyak penggunaan API. Alih-alih membayar setiap permintaan segera, banyak pengembang terlebih dahulu mencari kredit yang tersedia atau program startup yang membantu mengurangi biaya awal tersebut.

Get AI Perks mengumpulkan peluang ini di satu tempat. Platform ini mencantumkan kredit AI, diskon, dan program mitra di seluruh penyedia AI, platform cloud, dan alat pengembang, dengan panduan langkah demi langkah yang menjelaskan cara mengklaimnya. Totalnya, basis data mencakup lebih dari 200 alat dan jutaan dolar dalam kredit yang tersedia yang dapat diajukan oleh startup dan pembangun.

Sebelum Anda menyelesaikan pengaturan Claude Code, periksa Get AI Perks dan klaim kredit AI yang dapat menutupi eksperimen pertama Anda.

Pertanyaan yang Sering Diajukan

Melangkah Maju dengan Claude Code

Claude Code mengubah pengembangan berbasis terminal dengan mengintegrasikan bantuan AI langsung ke dalam baris perintah. Pengaturan memerlukan instalasi spesifik platform, otentikasi API, dan konfigurasi dasar, tetapi prosesnya mudah jika mengikuti langkah-langkah yang benar.

Alat ini unggul dalam tugas pengembangan rutin, pembuatan kode, dan manajemen alur kerja git. Mode Rencana memberikan keamanan untuk operasi yang kompleks. Integrasi IDE memperluas kemampuan di luar terminal.

Mulailah dengan tugas-tugas sederhana untuk memahami bagaimana Claude Code menafsirkan permintaan. Bangun alur kerja yang lebih kompleks seiring bertambahnya keakraban. Gunakan perintah /clear di antara tugas yang berbeda untuk menjaga konteks yang bersih. Konfigurasikan file CLAUDE.md untuk panduan spesifik proyek.

Tim dapat menjelajahi pengaturan yang dikelola server dan pasar plugin. Pengembang individu dapat memperoleh manfaat dari skill dan perintah kustom yang disesuaikan dengan pola yang sering.

Repositori GitHub di anthropics/claude-code berisi contoh tambahan, plugin komunitas, dan sumber daya pemecahan masalah. Dokumentasi resmi di docs.anthropic.com memberikan referensi teknis yang komprehensif.

Sekarang saatnya mulai mengode. Navigasikan ke proyek, luncurkan Claude Code, dan lihat bagaimana pengembangan yang dibantu AI mengubah alur kerja Anda.