Cara menginstal Claude Code di Windows, macOS, dan Linux — serta cara menggunakannya tanpa langganan

Untuk menginstal Claude Code cukup satu perintah: di macOS, Linux, atau WSL jalankan curl -fsSL https://claude.ai/install.sh | bash; di Windows, irm https://claude.ai/install.ps1 | iex di PowerShell (di Command Prompt, CMD, gunakan baris install.cmd yang akan Anda lihat di bawah). Setelah itu, buka terminal baru, periksa dengan claude --version, masuk ke folder proyek Anda, lalu jalankan claude; perintah pertama yang berguna adalah /init. Untuk terhubung, ada dua pilihan: masuk dengan akun Pro, Max, Team, Enterprise, atau Console (paket gratis Claude.ai tidak menyertakan Claude Code), atau tetapkan dua variabel lingkungan, ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN, lalu gunakan kunci API berbayar sesuai penggunaan, tanpa langganan.

Perintah diverifikasi pada 11 September 2026 berdasarkan dokumentasi instalasi resmi Anthropic.

Persyaratan

Menginstal di macOS dan Linux

Buka Terminal dan tempelkan:

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

Ini adalah metode yang direkomendasikan: metode ini memasang biner mandiri yang diperbarui otomatis di latar belakang. File yang dapat dieksekusi berada di ~/.local/bin/claude dan terminal yang sudah terbuka belum melihat PATH baru, jadi buka jendela lain sebelum mencoba. Di WSL, perintahnya sama.

Menginstal Claude Code di Windows

Di Windows ada dua baris berbeda dan satu-satunya perbedaan adalah terminalnya. Jika prompt diawali PS C:\Users\TuNombre>, Anda berada di PowerShell; tanpa PS, hanya C:\Users\TuNombre>, Anda berada di Command Prompt (CMD). Tidak perlu menjalankannya sebagai administrator.

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

:: Windows Símbolo del sistema (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Menempelkan baris ke terminal yang salah adalah kegagalan yang paling umum. Baris CMD di PowerShell menghasilkan The token '&&' is not a valid statement separator; baris PowerShell di CMD menghasilkan 'irm' is not recognized as an internal or external command (di Windows berbahasa Spanyol, «no se reconoce como un comando interno o externo»); dan curl … | bash dari macOS yang ditempel di PowerShell menghasilkan A parameter cannot be found that matches parameter name 'fsSL'. Dalam ketiga kasus tersebut, cukup gunakan baris yang sesuai.

Menginstal Git for Windows bersifat opsional tetapi disarankan: Claude Code menggunakan Git Bash untuk menjalankan perintah dan, jika tidak tersedia, menggunakan PowerShell. Jika Git sudah terinstal tetapi Git Bash tetap tidak ditemukan, tetapkan CLAUDE_CODE_GIT_BASH_PATH di blok env konfigurasi dengan jalur ke bash.exe.

Dengan WSL, jalankan baris macOS/Linux di dalam terminal WSL dan buka claude di sana, bukan dari PowerShell atau CMD.

Dengan pengelola paket

Ini juga berfungsi, dengan satu perbedaan penting: tidak ada yang diperbarui otomatis secara default (Anda harus menjalankan brew upgrade claude-code atau winget upgrade Anthropic.ClaudeCode). Tersedia pula repositori apt, dnf, dan apk bertanda tangan untuk Debian/Ubuntu, Fedora/RHEL, dan Alpine.

# Homebrew (macOS, Linux) — canal stable
brew install --cask claude-code

# WinGet (Windows)
winget install Anthropic.ClaudeCode

# npm — requiere Node.js 22 o posterior; nunca con sudo
npm install -g @anthropic-ai/claude-code

Dengan npm, mulai versi 2.1.198 paket ini memerlukan Node.js 22 atau yang lebih baru; dengan Node lama, npm hanya menampilkan peringatan EBADENGINE dan instalasi selesai. Metode ini memasang biner native yang sama, yang tidak menggunakan Node.js untuk berjalan. Jangan pernah gunakan sudo npm install -g: tindakan tersebut menyebabkan masalah izin dan merupakan risiko keamanan.

Memeriksa instalasi

claude --version   # imprime la versión, por ejemplo 2.1.211 (Claude Code)
claude doctor      # diagnóstico de la instalación y la configuración, sin abrir sesión

Gunakan claude doctor: tanpa masuk, perintah ini menampilkan status instalasi, kesalahan file konfigurasi, dan solusi yang disarankan. Ini adalah cara tercepat untuk mengetahui apakah masalahnya ada pada instalasi atau konfigurasi.

Jika Anda melihat command not found: claude (atau, di Windows, claude tidak dikenali), folder instalasi belum ada di PATH. Di macOS dan Linux, buka terminal baru dan, jika masalah tetap ada, tambahkan ~/.local/bin ke PATH di ~/.zshrc atau ~/.bashrc. Di Windows, foldernya adalah %USERPROFILE%\.local\bin; periksa dan tambahkan dari PowerShell:

# 1. Comprueba si la carpeta de instalación ya está en el PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. ¿Sin salida? Añádela al PATH de usuario y abre una terminal nueva
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. En la terminal nueva: si hay dos instalaciones, verás dos rutas
where.exe claude

Koneksi pertama: langganan atau kunci API

Opsi A — masuk dengan langganan Anda

Di folder proyek, jalankan claude dan ikuti proses masuk di browser dengan akun Pro, Max, Team, Enterprise, atau Console. Hal yang membingungkan: jika variabel ANTHROPIC_API_KEY sudah ditetapkan, Claude Code sekali saja menanyakan apakah Anda ingin menggunakan kunci tersebut. Jika Anda menjawab tidak, variabel itu diabaikan seterusnya tanpa ditanyakan lagi, sehingga tampak seolah-olah variabel tidak terbaca. Untuk mengaktifkannya kembali: /config → Use custom API key.

Opsi B — tanpa langganan, dengan kunci berbayar sesuai penggunaan

Claude Code membaca ANTHROPIC_BASE_URL secara native, jadi mengarahkannya ke endpoint Anthropic Messages API mana pun merupakan konfigurasi yang didukung: tanpa plugin, tanpa proxy, dan tanpa biner yang dimodifikasi. Langkah-langkahnya: buat akun, isi saldo (minimal $10), buat kunci sk-kn- di panel kunci (ditampilkan hanya sekali), lalu tambahkan blok env ini ke konfigurasi pengguna Anda, ~/.claude/settings.json (di Windows, %USERPROFILE%\.claude\settings.json). Dengan demikian, semua terminal, ekstensi editor, dan proses latar belakang dapat menggunakannya:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Untuk mencoba terlebih dahulu dalam satu jendela PowerShell:

# Solo para esta ventana de PowerShell (en macOS/Linux: export VARIABLE=valor)
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

• ANTHROPIC_BASE_URL hanya berisi domain. Claude Code menambahkan /v1/messages; jika diakhiri /v1, permintaan diarahkan ke /v1/v1/messages dan menghasilkan 404.
• Gunakan ANTHROPIC_AUTH_TOKEN, bukan ANTHROPIC_API_KEY. Keduanya berada di header HTTP yang berbeda: yang pertama mengirim Authorization: Bearer dan langsung berfungsi; yang kedua mengirim x-api-key dan juga melalui persetujuan satu kali di atas.
• Tuliskan nama model yang tepat di ANTHROPIC_MODEL. Kunavo hanya mengenali nama yang identik dan tidak menerjemahkan nama lama yang memiliki tanggal.
• Tetapkan juga ANTHROPIC_DEFAULT_OPUS_MODEL. Model default Claude Code dan alias opus mengarah ke Opus terbaru dan, jika Kunavo belum menawarkannya, permintaan pertama mengembalikan 404. Di sini alias opus ditetapkan ke Claude Opus 5.5 (claude-opus-5-5), yang memerlukan Claude Code v2.1.280 atau yang lebih baru; dengan versi sebelumnya, jalankan claude update.
• Dan tetapkan juga ANTHROPIC_DEFAULT_SONNET_MODEL. Alias sonnet meminta Sonnet 5.5, yang tidak ditawarkan Kunavo: tanpa variabel ini, /model sonnet, fase eksekusi opusplan, dan subagen yang dikonfigurasi dengan sonnet mengembalikan 404. Menetapkannya ke claude-sonnet-5 mencegahnya.
• Hal yang sama berlaku untuk ANTHROPIC_DEFAULT_HAIKU_MODEL. Alias haiku meminta ID yang tidak disediakan Kunavo (Haiku 5.5 sejak v2.1.293): tanpa variabel ini, /model haiku dan subagen yang dikonfigurasi dengan haiku menghasilkan 404. Menetapkannya ke claude-haiku-4-5 mencegah hal tersebut dan juga mengalihkan panggilan latar belakang yang dilakukan Claude Code sendiri (ringkasan, judul) dari model utama.

Jangan pernah menaruh kunci di .claude/settings.json proyek: file tersebut masuk ke repositori. Di ekstensi VS Code, variabel berada di claudeCode.environmentVariables, di dalam konfigurasi pengguna VS Code, karena ekstensi memeriksa kredensial sebelum mulai.

Tarif per 1 juta token, diambil dari katalog:

Cara mengetahui opsi yang aktif

Di dalam Claude Code, jalankan /status. Baris Auth token berarti kunci sedang digunakan; baris Login method dengan akun claude.ai berarti variabel tidak terbaca. Keduanya tidak dijumlahkan: selama variabel tersebut ada, langganan ditangguhkan; hapus variabel itu dan Claude Code kembali ke langganan tanpa perlu menginstal ulang.

Di balik gateway, tiga hal berubah: Remote Control dan dikte suara tidak tersedia (keduanya memerlukan identitas claude.ai); /fast mungkin menyatakan bahwa mode cepat tidak tersedia, karena pemeriksaan tersebut terhubung langsung ke Anthropic, meskipun permintaan biasa tidak berubah; dan angka pada /context menjadi perkiraan lokal. Kode, alat, subagen, MCP, hook, dan caching prompt tetap berfungsi sama. Semua detail tersedia dalam dokumentasi integrasi dan panduan kunci API Claude Code (keduanya dalam bahasa Inggris).

Cara menggunakan Claude Code: langkah pertama

# 1. Arranca siempre dentro de la carpeta del proyecto
cd ~/proyectos/mi-app
claude

# 2. Primer comando: lee el repositorio y genera CLAUDE.md
> /init

# 3. Pide las tareas en español y con la ruta del archivo
> cambia la validación de src/api/user.ts a zod y arregla los tests

# 4. Para tareas que tocan muchos archivos: Shift+Tab activa el modo plan

Claude Code meminta izin sebelum mengedit file atau menjalankan perintah; jika arahnya salah, tekan Esc untuk menghentikannya dan /rewind untuk kembali ke titik sebelumnya. CLAUDE.md yang dibuat oleh /init adalah draf: pertahankan hanya hal-hal yang akan Anda ulangi di setiap sesi (perintah pengujian, konvensi, folder yang tidak boleh disentuh). File ini dimuat di setiap sesi dan dikirim dalam setiap permintaan, dan Anthropic menyarankan agar panjangnya tidak melebihi 200 baris.

• Beralih model: /model diikuti nama lengkap, misalnya /model claude-opus-5, atau mulai dengan claude --model claude-opus-5. Lakukan di antara tugas: setiap model memiliki cache sendiri, dan beralih di tengah tugas mengharuskan seluruh percakapan dibaca ulang tanpa cache.
• /clear di antara tugas yang tidak berkaitan. Mulai percakapan baru dan tidak dikenai biaya; percakapan sebelumnya dapat dipulihkan dengan /resume.
• /compact ketika tugas berlangsung lama: ringkas riwayat lalu lanjutkan. Dengan kunci API, cache secara default bertahan lima menit, jadi lakukan pemadatan sebelum jeda panjang, bukan sesudahnya.
• Biaya sebuah sesi: /usage menampilkan token, tetapi jumlah yang dihitungnya adalah perkiraan lokal berdasarkan harga daftar Anthropic; dengan Kunavo, biaya sebenarnya ada di halaman penggunaan Anda.

Pembayaran dan kejujuran tentang pilihan

Saldo prabayar melalui Stripe: kartu (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay, atau Link; debit langsung SEPA tidak tersedia. Pengisian saldo minimum adalah $10, saldo tidak kedaluwarsa, permintaan yang gagal tidak dikenai biaya, dan setiap kunci memiliki batas pengeluaran bulanan. Semua tarif tersedia di halaman harga.

Jika Anda menggunakan Claude Code berjam-jam setiap hari, biaya tetap langganan biasanya lebih murah; pembayaran sesuai penggunaan lebih menguntungkan jika penggunaan tidak teratur atau Anda tidak ingin bergantung pada jendela 5 jam, dan bulan tanpa aktivitas biayanya nol. Perbandingan lengkap, dalam bahasa Inggris, tersedia di Claude Code pricing. Melalui Kunavo, Anda menggunakan kapasitas bersama, tanpa kapasitas khusus atau SLA kontraktual: jika memerlukan jaminan tersebut, berlangganan langsung ke Anthropic.

Pertanyaan umum