Instal Claude Code: perintah untuk 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, jalankan irm https://claude.ai/install.ps1 | iex di PowerShell (di Command Prompt, CMD, gunakan baris install.cmd di bawah). Setelah itu buka terminal baru, periksa dengan claude --version, lalu jalankan claude untuk memulai. Pada koneksi pertama ada dua jalur: masuk dengan akun Pro, Max, Team, Enterprise, atau Console (paket gratis Claude.ai tidak menyertakan Claude Code) atau menetapkan dua variabel lingkungan, ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN, lalu menggunakan key API berbayar berdasarkan penggunaan — tanpa langganan apa pun.

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

Sebelum menginstal

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 menginstal binary mandiri yang memperbarui dirinya sendiri di latar belakang. Pintasannya berada di ~/.local/bin/claude, dan terminal yang sudah terbuka tidak melihat PATH baru — jadi buka jendela lain sebelum mengujinya. Di WSL, perintahnya sama.

Menginstal di Windows

Di Windows ada dua baris berbeda, dan satu-satunya perbedaannya adalah terminal yang digunakan. Jika prompt dimulai dengan PS C:\Users\SeuNome>, itu adalah PowerShell; tanpa PS, hanya C:\Users\SeuNome>, itu adalah Command Prompt (CMD). Tidak perlu menjalankannya sebagai administrator.

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

:: Windows Prompt de Comando (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Menempelkan baris ke terminal yang salah adalah kegagalan 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 Portugis, “não é reconhecido como um comando interno ou externo”). Dan curl … | bash dari macOS yang ditempelkan di PowerShell menghasilkan A parameter cannot be found that matches parameter name 'fsSL'. Dalam ketiga kasus tersebut, cukup gunakan baris yang benar.

Menginstal Git for Windows bersifat opsional, tetapi direkomendasikan: Claude Code menggunakan Git Bash yang disertakan untuk menjalankan perintah; tanpa itu, Claude Code menggunakan PowerShell. Jika Git sudah terinstal tetapi Git Bash tetap tidak ditemukan, tetapkan CLAUDE_CODE_GIT_BASH_PATH di blok env pada pengaturan dengan menunjuk ke bash.exe.

Di WSL, jalankan baris macOS/Linux di dalam terminal WSL dan buka claude di sana juga — bukan melalui PowerShell atau CMD.

Melalui pengelola paket

Berfungsi, dengan satu perbedaan penting: tidak satu pun memperbarui dirinya sendiri secara default. Anda memperbaruinya secara manual (brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode). Tersedia juga repositori apt, dnf, dan apk yang ditandatangani untuk Debian/Ubuntu, Fedora/RHEL, dan Alpine.

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

# WinGet (Windows)
winget install Anthropic.ClaudeCode

# npm — exige Node.js 22 ou mais novo; nunca com sudo
npm install -g @anthropic-ai/claude-code

Melalui npm, sejak versi 2.1.198 paket tersebut memerlukan Node.js 22 atau yang lebih baru; pada Node lama, npm hanya menampilkan peringatan EBADENGINE dan instalasi selesai. Paket tersebut menginstal binary native yang sama, yang tidak menggunakan Node.js saat dijalankan. Jangan pernah gunakan sudo npm install -g: hal itu menyebabkan masalah izin dan merupakan risiko keamanan.

Memeriksa instalasi

claude --version   # imprime a versão, por exemplo 2.1.211 (Claude Code)
claude doctor      # diagnóstico da instalação e das configurações, sem abrir sessão

Simpan claude doctor: tanpa membuka sesi, perintah tersebut menampilkan kesehatan instalasi, kesalahan pada file konfigurasi, dan perbaikan yang disarankan — ini adalah cara tercepat untuk mengetahui apakah masalahnya berasal dari instalasi atau konfigurasi.

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

# 1. Veja se a pasta de instalação já está no PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sem saída? Adicione ao PATH do usuário e abra um terminal novo
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. No terminal novo: se houver duas instalações, aparecem dois caminhos
where.exe claude

Koneksi pertama: langganan atau key API

Jalur A — login dengan langganan

Di folder proyek, jalankan claude dan ikuti login di browser menggunakan akun Pro, Max, Team, Enterprise, atau Console. Detail yang sering membingungkan: jika variabel ANTHROPIC_API_KEY sudah ditetapkan, Claude Code bertanya satu kali apakah key tersebut harus digunakan. Jika Anda menolaknya, Claude Code akan mengabaikannya secara diam-diam dan tidak bertanya lagi — sehingga tampak seolah-olah variabel tidak dibaca. Untuk mengaktifkannya kembali, buka /config → Use custom API key.

Jalur B — tanpa langganan, dengan key berbayar berdasarkan penggunaan

Claude Code membaca ANTHROPIC_BASE_URL secara native, sehingga menunjuknya ke endpoint mana pun dari Anthropic Messages API merupakan konfigurasi yang didukung — tanpa plugin, proxy, atau binary yang dimodifikasi. Langkahnya: buat akun, isi saldo (minimum $10), buat key sk-kn- di dashboard key (key hanya ditampilkan satu kali), lalu tetapkan variabelnya. Di macOS dan Linux:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # só o domínio, sem /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Di Windows, untuk menguji dalam jendela PowerShell:

# Vale só para esta janela do PowerShell
$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

Untuk membuatnya tetap, tempat terbaik adalah blok env pada file pengaturan pengguna, ~/.claude/settings.json (di Windows, %USERPROFILE%\.claude\settings.json). Di sana variabel berlaku untuk terminal apa pun, ekstensi editor, dan proses latar belakang. Jika file tersebut sudah memiliki pengaturan lain, cukup tambahkan blok env:

{
  "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"
  }
}

Masing-masing baris ini memiliki jebakan:

• ANTHROPIC_BASE_URL hanya berisi domain. Claude Code menambahkan /v1/messages; dengan /v1 di akhir, permintaan dikirim ke /v1/v1/messages dan mengembalikan 404.
• Gunakan ANTHROPIC_AUTH_TOKEN, bukan ANTHROPIC_API_KEY. Keduanya dikirim dalam header HTTP yang berbeda: yang pertama mengirim Authorization: Bearer dan berlaku segera; yang kedua mengirim x-api-key dan masih melalui persetujuan satu kali yang dijelaskan di atas.
• Tuliskan nama model yang tepat di ANTHROPIC_MODEL. Kunavo hanya mengenali nama yang identik dan tidak menerjemahkan nama lama yang memiliki tanggal sebagai sufiks.
• Tetapkan juga ANTHROPIC_DEFAULT_OPUS_MODEL dan ANTHROPIC_DEFAULT_SONNET_MODEL. Model default Claude Code dan alias opus mengarah ke Opus terbaru dan, jika Kunavo belum menyediakannya, permintaan pertama menghasilkan 404. Alias sonnet sudah meminta Sonnet 5.5, yang tidak disediakan Kunavo: tanpa menetapkannya, /model sonnet, fase eksekusi opusplan, dan subagen dengan model: sonnet menerima 404. Alias opus ditetapkan ke Opus 5.5 (claude-opus-5-5), yang memerlukan Claude Code v2.1.280 atau yang lebih baru—pada instalasi lama, jalankan claude update.
• Dan patok ANTHROPIC_DEFAULT_HAIKU_MODEL. Alias haiku meminta ID yang tidak disediakan Kunavo (Haiku 5.5 sejak v2.1.293): jika tidak dipatok, /model haiku dan subagen dengan model: haiku menerima 404. Baris yang sama mengalihkan panggilan latar belakang yang dilakukan Claude Code sendiri (ringkasan, judul) dari model utama.

Jangan pernah menaruh key di .claude/settings.json proyek — file ini akan masuk ke git dan tersedia bagi siapa pun yang mengkloning repositori. Dalam ekstensi VS Code, variabel berada di claudeCode.environmentVariables, di pengaturan pengguna VS Code itu sendiri, karena ekstensi memeriksa kredensial sebelum memulai.

Tarif per 1 juta token, diambil dari katalog:

Untuk mengganti model di dalam sesi, gunakan /model dengan nama lengkap (misalnya /model claude-opus-5-5) atau buka Claude Code dengan claude --model claude-opus-5-5. Biaya penggunaan selama sebulan dan kapan langganan lebih menguntungkan tersedia dalam panduan harga Claude Code.

Cara mengetahui jalur yang aktif

Di dalam Claude Code, jalankan /status. Baris Auth token berarti key sedang berlaku; baris Login method dengan akun claude.ai berarti variabel tidak dibaca. Keduanya tidak digabungkan: saat variabel ditetapkan, langganan berhenti digunakan; hapus variabel dan Claude Code kembali ke langganan, tanpa perlu menginstal ulang.

Di balik gateway, tiga hal berubah: Remote Control dan dikte suara tidak berfungsi (keduanya memerlukan identitas claude.ai); /fast mungkin mengatakan bahwa mode cepat tidak tersedia karena pemeriksaan ini langsung menuju Anthropic, tetapi permintaan normal tidak berubah; dan angka /context menjadi perkiraan lokal. Kode, alat, subagen, MCP, hook, dan prompt caching tetap berfungsi sama. Detailnya tersedia dalam dokumentasi integrasi (dalam bahasa Inggris).

Membayar dari Brasil — Pix di checkout

Langganan claude.ai adalah tagihan berulang dalam dolar yang memerlukan kartu internasional yang diaktifkan untuk pembelian di luar negeri. Pada rute kunci API, isi ulang dilakukan melalui checkout Stripe dan Pix muncul sebagai metode pembayaran bagi mereka yang membayar dari Brasil: harga dalam USD dan Stripe menampilkan jumlah yang dikonversi ke real sebelum Anda mengonfirmasi. Kartu internasional (Visa, Mastercard, American Express), Apple Pay, Google Pay, dan Link juga muncul di checkout. Dompet ini prabayar—isi ulang minimum $10, saldo tidak kedaluwarsa, dan permintaan yang gagal tidak dikenai biaya—serta setiap kunci dapat memiliki batas pengeluaran bulanan. Panduan langkah demi langkah, layar demi layar, tersedia di cara membayar API dengan Pix.

Kesalahan umum

Setelah menginstal

Pada penggunaan pertama, jalankan /init di dalam proyek: Claude Code membaca repositori dan menghasilkan CLAUDE.md dengan perintah pengujian serta konvensi yang ditemukannya. Tinjau file ini dan buat tetap singkat — file tersebut dimuat pada setiap sesi. Di antara tugas yang tidak berkaitan, /clear memulai percakapan baru; dalam tugas yang menjadi panjang, /compact merangkum riwayat dan melanjutkan.

Sejujurnya tentang pilihan ini: bagi mereka yang menggunakan Claude Code berjam-jam setiap hari, biaya bulanan langganan biasanya lebih murah; pay-as-you-go lebih menguntungkan ketika penggunaan berfluktuasi atau ketika Anda tidak ingin terikat pada jendela 5 jam — dan satu bulan tanpa penggunaan biayanya nol. Dengan Kunavo Anda menggunakan kapasitas bersama, tanpa kuota khusus dan tanpa SLA kontraktual; siapa pun yang memerlukan jaminan tersebut harus berlangganan langsung kepada Anthropic.

Pertanyaan yang sering diajukan