Alat coding AI semakin populer di kalangan pengembang yang ingin bekerja lebih cepat dan menangani tugas dengan lebih efisien. Banyak pengguna memilih menginstal Claude Code untuk menyederhanakan alur kerja coding, mengotomatiskan pekerjaan berulang, dan mengelola proses bertahap dari satu lingkungan. Penyiapan yang tepat di Windows atau Mac membantu memastikan kinerja yang lancar serta integrasi yang lebih baik dengan layanan AI tingkat lanjut. Lanjutkan membaca untuk mempelajari cara menginstal Claude Code di Windows dan Mac.
Cara menginstal Claude Code di Windows?
Windows 11 menyediakan lingkungan yang lancar untuk menjalankan alat pengembangan AI modern. Beberapa langkah penyiapan sederhana dapat membantu memastikan Claude Code berfungsi dengan baik dan terhubung ke layanan yang ingin Anda gunakan. Ikuti petunjuk di bawah ini untuk menyelesaikan proses instalasi dan mulai menggunakan fiturnya tanpa kendala.
Langkah 1: Instal Claude Code menggunakan PowerShell
Buka PowerShell dengan menekan Win + S dan mencari "PowerShell". Salin dan tempel perintah instalasi di bawah ini ke PowerShell, lalu tekan "Enter" untuk menjalankannya:
PowerShell akan mengunduh dan menginstal Claude Code secara otomatis. Tunggu hingga proses instalasi selesai sebelum melanjutkan. Jika Anda lebih memilih CMD atau WinGet, Claude Code juga menyediakan metode instalasi alternatif dalam dokumentasi resminya.
Langkah 2: Instal Git dan Jalankan Git Bash
Unduh dan instal Git untuk Windows. Biarkan pengaturan instalasi default agar Claude Code dapat mengakses alat command-line yang diperlukan dan berfungsi dengan baik.
Setelah mengunduh Git, buka penginstal dan selesaikan proses penyiapan dengan pengaturan default. Biarkan jalur instalasi tetap seperti semula, pilih "Visual Studio Code" sebagai editor default jika diminta, dan pastikan "Git from the command line and 3rd-party software" dipilih dalam opsi konfigurasi PATH.
Setelah instalasi selesai, buka "Git Bash" dari menu Start untuk memverifikasi bahwa Git berfungsi dengan benar. Git Bash menyediakan lingkungan terminal yang diperlukan Claude Code untuk menjalankan perintah di Windows.
Langkah 3: Verifikasi instalasi Claude Code
Kembali ke PowerShell atau Command Prompt dan jalankan:
Jika nomor versi muncul, Claude Code telah berhasil diinstal. Jika tidak, lanjutkan dengan langkah konfigurasi PATH.
Langkah 4: Instalasi selesai
Setelah semuanya selesai, masuk ke Claude Code dan selesaikan proses penyiapan. Setelah masuk, alat ini siap digunakan untuk menjalankan perintah dan mengelola alur kerja berbantuan AI langsung dari terminal di Windows 11.
Bagaimana cara menginstal Claude Code di Mac/macOS?
macOS menyediakan cara yang rapi dan sederhana untuk menyiapkan alat pengembang dengan dukungan terminal bawaan, sehingga proses instalasi berjalan lancar dan konsisten bagi pengembang. Penyiapan Claude Code dilakukan melalui proses berbasis terminal yang jelas agar semuanya tetap tertata dan mudah dikelola. Berikut cara menginstal Claude Code di Mac.
Langkah 1: Instal Claude Code melalui Terminal (perintah curl)
Buka "Terminal" di Mac melalui Spotlight Search (Cmd + Space → ketik "Terminal"). Salin dan tempel perintah instalasi di bawah ini ke Terminal, lalu tekan "Enter":
Terminal akan mengunduh dan menginstal Claude Code secara otomatis. Tunggu hingga proses instalasi selesai sebelum melanjutkan ke langkah berikutnya.
Langkah 2: Konfirmasikan instalasi Claude Code
Tunggu hingga proses instalasi benar-benar selesai. Setelah selesai, akan muncul pesan konfirmasi yang menyatakan bahwa Claude Code berhasil diinstal. Jika terminal meminta penyiapan tambahan, jalankan perintah yang disarankan untuk menambahkan Claude Code ke file konfigurasi zshrc agar dapat diakses dengan benar.
Langkah 3: Muat konfigurasi lingkungan
Setelah instalasi, jalankan perintah yang diberikan atau muat ulang file konfigurasi shell. Langkah ini memperbarui variabel lingkungan agar Claude Code berfungsi secara global di terminal tanpa masalah path. Ini memastikan akses lancar setiap kali membuka jendela terminal baru.
Langkah 4: Jalankan Claude Code
Di Terminal, ketik:
Tekan Enter untuk memulai CLI Claude Code. Layar penyiapan akan muncul; di sana Anda dapat memilih tema dan metode masuk yang diinginkan untuk menyelesaikan konfigurasi akhir.
Bagaimana cara mengintegrasikan API LLM lain ke Claude Code?
Menggunakan Claude Code dengan model AI eksternal membuat pengembangan lebih fleksibel. Menghubungkan API LLM pihak ketiga memungkinkan pengembang menjalankan berbagai model dalam satu lingkungan dan mengelola tugas dengan lebih efisien. Misalnya, API dengan pemahaman konteks panjang yang kuat serta kemampuan menghasilkan output terstruktur dapat semakin mendukung alur kerja pengodean. Pada langkah-langkah berikut, Kimi digunakan sebagai contoh untuk menunjukkan cara menghubungkan API LLM eksternal dengan Claude Code.
Langkah 1: Dapatkan Kimi Code API Key
Catatan: endpoint api.kimi.ai/coding/ yang digunakan dalam panduan ini merupakan bagian dari manfaat keanggotaan Kimi Code. Pastikan Anda memiliki keanggotaan Kimi aktif dengan manfaat Kimi Code yang sudah diaktifkan sebelum membuat key — key dari akun gratis akan ditolak saat dijalankan.
Buka Kimi Code Console, klik Create API Key, masukkan nama dan konfirmasikan, lalu segera salin key tersebut — key lengkap hanya ditampilkan satu kali. Model dan jendela konteks yang tersedia bergantung pada paket keanggotaan Anda (misalnya, paket Andante lama menggunakan kimi-for-coding dengan konteks 1M; paket Plus/Moderato dapat menggunakan k3-256k; paket Pro/Allegretto ke atas dapat menggunakan k3 dengan konteks 1M atau varian berkecepatan tinggi).
Langkah 2: Lewati login (skrip penyiapan opsional)
Setelah instalasi, jangan jalankan Claude Code terlebih dahulu. Jalankan skrip berikut di terminal untuk melewati alur orientasi/login default dan membersihkan konfigurasi lama. Skrip ini mengaktifkan dukungan model pihak ketiga dan mode cepat, serta menghapus entri endpoint, kredensial, dan model yang usang dari ~/.claude/settings.json (sisa entri di sana akan menimpa variabel lingkungan yang diekspor di terminal):
Skrip ini memerlukan Node.js (periksa dengan node --version; jika perintah tidak ditemukan, instal versi LTS dari nodejs.org terlebih dahulu). Skrip tidak menampilkan output jika berhasil — hal itu wajar. Periksa juga file konfigurasi shell seperti ~/.zshrc dan ~/.bashrc untuk ekspor ANTHROPIC_* yang usang (pengguna Windows: periksa variabel lingkungan pengguna) dan hapus, jika tidak, entri tersebut akan mengganggu konfigurasi baru.
Langkah 3: Konfigurasikan akses API dan jalankan Claude Code
Tersedia dua metode konfigurasi — pilih satu, jangan gabungkan keduanya. Metode 1 menulis ke ~/.claude/settings.json dan berlaku secara permanen; Metode 2 mengekspor variabel hanya di terminal saat ini, sehingga berlaku untuk sesi tersebut. Contoh di bawah menggunakan k3-256k (konteks 256K); jika paket Anda mencakup k3 berkonteks 1M, ganti setiap nilai model dengan k3[1m] dan tetapkan kedua nilai konteks menjadi 1048576.
Metode 1: Tulis ke settings.json (direkomendasikan, permanen)
Tulis yang berikut ini ke kolom env di ~/.claude/settings.json (di Windows: %USERPROFILE%\.claude\settings.json; buat file jika belum ada), lalu mulai ulang Claude Code agar perubahan berlaku:
Ganti Your API Key dengan key yang Anda salin pada Langkah 1. File tersebut menyimpan key dalam teks biasa — jangan commit ke git. Perhatikan bahwa blok env dalam settings.json menimpa variabel bernama sama yang diekspor di terminal.
Metode 2: Variabel lingkungan terminal (hanya sesi saat ini)
macOS / Linux
Windows
Atur variabel lingkungan yang sama di PowerShell atau pengaturan sistem, lalu jalankan:
Ganti Your API Key dengan key yang Anda salin pada Langkah 1. Mengonfigurasi hanya sebagian variabel model membuat skenario terkait (percakapan utama, peringkasan latar belakang, sub-agen) gagal tanpa pemberitahuan, jadi gunakan set lengkap.
Jika diminta untuk menggunakan API key ini, konfirmasikan untuk melanjutkan. Setelah itu, ikuti petunjuk untuk memilih folder proyek tepercaya guna menyelesaikan otorisasi.
Langkah 4: Verifikasi status integrasi
Setelah diluncurkan, jalankan:
Jika Base URL menampilkan:
Maka integrasi berhasil. Meskipun antarmuka masih menampilkan model Claude, semua permintaan dialihkan melalui Kimi Code API.
Manfaat menggunakan Kimi API
Pemakaian alat AI tingkat lanjut dalam pengembangan telah menjadi cara praktis untuk mempercepat pekerjaan dan meningkatkan kualitas kode secara keseluruhan. Kimi API menyediakan dukungan kuat untuk pemahaman, otomatisasi, dan alur kerja berbasis tim dalam proyek nyata. Berikut cara Kimi API membantu developer membangun dan mengelola sistem dengan lebih efisien.
Pemahaman konteks multimodal untuk tugas pengembangan
Kimi API memahami berbagai jenis input, seperti teks, mockup desain, diagram arsitektur, diagram alur, bahkan video. API ini mengubah informasi tersebut menjadi rencana teknis yang jelas dan dapat langsung digunakan oleh developer. Hal ini membantu mengubah ide menjadi kode yang berfungsi dengan perencanaan manual yang lebih sedikit.
Lebih hemat biaya dengan penggunaan ulang konteks
Kimi API mendukung penggunaan ulang konteks, sehingga developer dapat melanjutkan pekerjaan dengan percakapan dan konteks proyek yang sudah ada alih-alih berulang kali mengirimkan informasi yang sama. Hal ini membantu mengurangi penggunaan token yang tidak perlu, menekan biaya API, dan membuat alur kerja pengembangan jangka panjang lebih efisien.
Mengotomatiskan alur kerja rekayasa yang berulang
Tugas coding rutin dan berulang dapat diotomatiskan menggunakan skrip atau alur kerja berbasis AI. Tugas ini dapat dijalankan dengan perintah sederhana tanpa perlu dikerjakan secara manual setiap kali. Hal ini menghemat waktu dan mengurangi kemungkinan kesalahan manusia dalam proses pengembangan sehari-hari.
Alur kerja pengembangan yang dapat disesuaikan dengan Skills dan alat
Kimi API mendukung Skills kustom dan integrasi alat untuk berbagai kebutuhan pengembangan. Tim dapat menghubungkan alat internal, skrip, dan sistem mereka sendiri langsung ke dalam alur kerja. Hal ini membuat proses pengembangan lebih fleksibel dan spesifik untuk setiap proyek.
Kolaborasi multi-agen untuk kualitas dan efisiensi yang lebih tinggi
Berbagai agen AI menangani peran yang berbeda, seperti coding, pengujian, arsitektur, dan dokumentasi. Agen-agen ini dapat bekerja bersama secara berurutan atau paralel untuk menyelesaikan tugas lebih cepat. Hal ini meningkatkan kecepatan pengembangan sekaligus kualitas hasil secara keseluruhan.
Pemecahan masalah saat menginstal Claude Code
Saat menginstal Claude Code di Windows atau Mac, pengguna terkadang dapat mengalami masalah teknis kecil akibat pengaturan lingkungan, versi Node.js, atau kondisi jaringan. Masalah ini umum terjadi pada alat berbasis CLI dan biasanya dapat diperbaiki. Berikut masalah yang paling sering muncul serta cara memahaminya secara praktis.
"command not found: claude"
Kesalahan ini biasanya berarti Claude Code belum ditambahkan ke PATH sistem Anda. Terminal tidak dapat menemukan file biner yang telah diinstal. Dalam kebanyakan kasus, memulai ulang terminal atau memperbaiki pengaturan PATH dapat mengatasi masalah ini dengan cepat dan andal.
Autentikasi gagal atau browser tidak terbuka
Hal ini terjadi ketika proses login tidak dapat memicu browser secara otomatis, sering kali pada sistem terbatas atau lingkungan jarak jauh. Dalam kasus tersebut, autentikasi mungkin perlu dilakukan secara manual menggunakan kunci API. Setelah dikonfigurasi, proses login akan berjalan normal tanpa masalah lebih lanjut.
"Network Error" atau waktu habis saat instalasi
Masalah ini sering disebabkan oleh internet lambat, pembatasan firewall, atau akses npm yang diblokir. Penginstal mungkin gagal terhubung ke server yang diperlukan selama penyiapan. Menyesuaikan pengaturan jaringan, konfigurasi proxy, atau mengganti koneksi biasanya dapat mengatasi masalah ini secara efektif.
Claude Code berjalan lambat
Masalah performa umumnya bukan disebabkan oleh alat itu sendiri, melainkan oleh latensi jaringan. Karena Claude Code bergantung pada permintaan API cloud, internet yang tidak stabil atau penggunaan VPN dapat memperlambatnya. Koneksi yang stabil biasanya meningkatkan kecepatan secara signifikan dan konsisten.
Kesimpulan
Memahami cara menginstal Claude Code di Windows atau Mac membantu Anda memulai alur kerja pengembangan berbantuan AI dengan lebih lancar. Setelah disiapkan, Anda dapat mengelola tugas coding dengan lebih efisien dan menyederhanakan pekerjaan pengembangan sehari-hari dalam lingkungan yang lebih terintegrasi. Untuk kebutuhan penggunaan yang lebih lanjut atau fleksibel, Anda dapat mencoba Kimi API untuk memperluas kemampuan ini dan meningkatkan alur kerja pengembangan di dunia nyata.