Kembali ke panduan
Instalasi·3 Oktober 2026·Diperbarui 10 Oktober 2026·Baca 14 menit

Instalasi Claude Code: langkah demi langkah di Windows, macOS, dan Linux, kunci API tanpa langganan, serta pembayaran dengan kartu

Perintah instalasi hanya satu baris; yang memakan waktu adalah terminal yang salah, Node.js lama, PATH, mengonfigurasi kunci tanpa langganan, dan pembayaran dari Turki. Semuanya ada di halaman ini.

Jawaban singkat: Claude Code diinstal dengan satu baris yang sesuai untuk terminal Anda. Di macOS, Linux, dan WSL, jalankan install.sh, di Windows PowerShell irm … | iex, dan di Command Prompt (CMD) install.cmd; ketiganya ada tepat di bawah. Cara ini tidak memerlukan Node.js; jika ingin menginstal dengan npm, Anda memerlukan Node.js 22 atau yang lebih baru. Setelah instalasi, ada dua pilihan: masuk dengan akun Claude (Pro, Max, Team, Enterprise, atau Console; paket gratis tidak mencakup Claude Code) atau menggunakan kunci API tanpa langganan. Dengan metode kunci, tetapkan ANTHROPIC_BASE_URL=https://api.kunavo.com (tanpa menambahkan /v1 di akhir), ANTHROPIC_AUTH_TOKEN, dan empat variabel yang menetapkan model; /status dalam sesi menunjukkan apakah kunci aktif. Anda hanya dikenai biaya untuk token yang digunakan. Isi saldo dengan kartu Visa atau Mastercard, Apple Pay, Google Pay, atau Link mulai dari 10 USD; cicilan dan Papara tidak tersedia.

Terminal
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash
PowerShell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
cmd.exe
:: Windows – Komut İstemi (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Kami mengambil baris-baris ini dan nama variabel di bawah dari dokumentasi penyiapan dan koneksi gateway Claude Code 3 Oktober 2026. Anthropic tidak menerbitkan dokumentasi tersebut dalam bahasa Turki; karena itu, kami menampilkan pesan kesalahan dalam bahasa Inggris aslinya. Kami memeriksa harga dan metode pembayaran Kunavo terakhir kali pada 10 Oktober 2026. Anda tidak perlu mencari VPN atau proksi luar negeri: halaman negara yang didukung Anthropic mencantumkan Turki untuk Claude.ai maupun API (diperiksa: 3 Oktober 2026).

Baris mana untuk terminal mana?

Sebagian besar orang yang mengalami masalah saat instalasi bukan keliru pada perintah, melainkan pada terminal. Tabel di bawah mencocokkan lingkungan Anda dengan baris yang benar. Jika Anda menggunakan Windows, bagian berikutnya menjelaskan cara mengenali terminal Anda.

Lingkungan AndaCara yang harus digunakanPembaruan
macOS, Linux, WSL di Windowsbaris install.sh (penginstal native, direkomendasikan)Otomatis di latar belakang
Windows PowerShellirm https://claude.ai/install.ps1 | iexOtomatis di latar belakang
Windows Command Prompt (CMD)baris install.cmdOtomatis di latar belakang
Homebrew (macOS) atau WinGet (Windows)Manajer paket (di bawah)Tidak ada secara default; Anda melakukannya melalui manajer paket
Node.js 22 atau yang lebih baru terinstalnpm (di bawah)Dengan npm install -g @anthropic-ai/claude-code@latest

Persyaratan sistem

Yang diminta dokumentasi instalasi resmi (per 3 Oktober 2026):

  • Sistem operasi: macOS 13.0 atau yang lebih baru; Windows 10 versi 1809 dan yang lebih baru atau Windows Server 2019 dan yang lebih baru; di Linux, Ubuntu 20.04, Debian 10, dan Alpine Linux 3.19 atau yang lebih baru.
  • Perangkat keras: minimal 4 GB RAM dan prosesor x64 atau ARM64. Windows 32-bit tidak didukung.
  • Shell: Bash, Zsh, PowerShell, atau CMD.
  • Node.js: tidak diperlukan untuk penginstal native; hanya diperlukan pada metode npm, versi 22 atau yang lebih baru.
  • Akun: jika Anda ingin masuk, gunakan Pro, Max, Team, Enterprise, atau Console. Dengan kunci API, tidak diperlukan langganan maupun login.

Sebagian penjelasan berbahasa Turki di internet menyalin versi lama dari daftar ini: masih ada yang mencantumkan Node.js 18 untuk npm, atau Ubuntu 18.04 dan CentOS 7 untuk Linux. Dokumentasi saat ini mencantumkan Node.js 22 dan Ubuntu 20.04 sebagai versi minimum. Peringatan bahwa “setiap langkah akan gagal tanpa proxy tetap dari AS” juga tidak berlaku untuk Türkiye; sebaliknya, VPN terbuka dapat menyebabkan kesalahan wilayah (lihat kesalahan unduhan di bagian macOS dan Linux).

Instalasi Claude Code di Windows

Di Windows, Anda tidak memerlukan hak administrator, WSL, atau Git. Dokumentasi resmi tidak meminta terminal dibuka sebagai administrator; Anda dapat melewati langkah “jalankan PowerShell sebagai administrator” dalam beberapa video berbahasa Turki. Satu-satunya hal yang perlu diketahui adalah terminal yang sedang digunakan:

  • Jika prompt dimulai dengan PS C:\Users\KullaniciAdi> seperti PS, Anda berada di PowerShell: gunakan baris irm … | iex.
  • Jika tidak ada PS di awal dan hanya terlihat C:\Users\KullaniciAdi>, Anda berada di Command Prompt: gunakan baris install.cmd.
  • Jangan buka entri “Windows PowerShell (x86)” di menu Start. Karena merupakan proses 32-bit, entri ini memberikan kesalahan Claude Code does not support 32-bit Windows bahkan di komputer 64-bit; pilih “Windows PowerShell” tanpa akhiran tersebut.

Menempelkan baris ke jendela yang salah adalah salah satu penyebab utama kesalahan di Windows, dan pesan-pesannya tidak menjelaskannya dengan jelas. Baris CMD yang ditempelkan ke PowerShell menghasilkan The token '&&' is not a valid statement separator. Baris PowerShell yang ditempelkan ke CMD pada Windows berbahasa Turki menampilkan “‘irm’ iç ya da dış komut, çalıştırılabilir program ya da toplu iş dosyası olarak tanınmıyor.” (pada sistem berbahasa Inggris, 'irm' is not recognized as an internal or external command). Jika Anda mencoba baris macOS curl … | bash di PowerShell, Anda akan melihat A parameter cannot be found that matches parameter name 'fsSL' atau 'bash' is not recognized as the name of a cmdlet; pada sistem berbahasa Turki, teks ini mungkin muncul dalam bahasa Turki. Dalam ketiga kasus, solusinya sama: gunakan baris untuk terminal yang sedang Anda gunakan.

Apakah Git for Windows dan WSL diperlukan?

Keduanya opsional. Jika Git for Windows terpasang, Claude Code menjalankan perintah shell melalui Git Bash yang disertakan dengannya; jika tidak, Claude Code beralih ke PowerShell. Dokumentasi menyarankan Git, tetapi tidak mewajibkannya. Jika Git terpasang tetapi Git Bash tidak ditemukan, berikan jalur lengkap ke file bash.exe untuk variabel CLAUDE_CODE_GIT_BASH_PATH di blok env pada file ~/.claude/settings.json (contoh dalam dokumentasi: C:\Program Files\Git\bin\bash.exe).

Ada dua alasan untuk memilih WSL: membutuhkan alat Linux atau ingin menjalankan perintah di lingkungan terisolasi (sandbox). Instalasi native Windows tidak memiliki sandbox:

InstalasiPrasyaratSandboxUntuk siapa
Windows nativeTidak ada (Git untuk Windows opsional)Tidak didukungPengguna yang proyek dan alatnya berada di Windows
WSL 2WSL 2 aktifDidukungPengguna yang ingin bekerja dengan alat Linux atau di dalam sandbox
WSL 1WSL 1 aktifTidak didukungPengguna yang tidak dapat menggunakan WSL 2

Jika Anda akan tetap menggunakan WSL, lakukan instalasi dan penggunaan di terminal WSL: baris macOS/Linux berjalan di sana, dan claude juga dibuka dari sana.

Perintah “claude” tidak ditemukan

Jika setelah instalasi selesai Anda melihat 'claude' is not recognized (di macOS dan Linux, command not found: claude), kemungkinan besar Anda bekerja di jendela yang dibuka sebelum instalasi: penginstal memperbarui variabel PATH, tetapi terminal lama tidak melihatnya. Tutup terminal terlebih dahulu, lalu buka kembali. Di Windows, program berada di %USERPROFILE%\.local\bin\claude.exe, sedangkan di macOS dan Linux berada di ~/.local/bin/claude. Jika membuka jendela baru juga tidak membantu di Windows, tambahkan folder tersebut ke variabel pengguna PATH menggunakan perintah dalam dokumen:

PowerShell
# 1. Kurulum klasörü PATH içinde mi?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sonuç yoksa kullanıcı PATH'ine ekleyin, terminali kapatıp yeniden açın
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Yeni terminalde
claude --version

npm.ps1 tidak dapat dimuat

Pesan ini hanya muncul pada jalur npm: npm menulis peluncur .ps1 untuk PowerShell, dan kebijakan eksekusi skrip sistem (execution policy) memblokirnya. Dokumen memberikan tiga jalan keluar: menjalankan perintah dengan nama npm.cmd dan claude.cmd, beralih ke penginstal native di PowerShell, atau hanya mengizinkan skrip lokal untuk pengguna Anda sendiri:

PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Instalasi di macOS dan Linux

Baris install.sh di atas berada di tab “Native Install (Recommended)” pada dokumentasi resmi dan juga berjalan sama persis di WSL. Claude Code yang diinstal dengan cara ini mengunduh versi baru sendiri di latar belakang. Jika Anda lebih memilih menggunakan pengelola paket, Homebrew dan WinGet juga merupakan opsi resmi; namun menurut dokumen, instalasi ini tidak memperbarui dirinya sendiri secara default, sehingga Anda harus mendapatkan versi baru melalui pengelola paket:

# Homebrew – stable kanalı; varsayılan olarak kendini güncellemez
brew install --cask claude-code

# WinGet (Windows) – varsayılan olarak kendini güncellemez
winget install Anthropic.ClaudeCode

Jika yang diterima bukan skrip, melainkan HTML atau 403

Pesan syntax error near unexpected token '<' menunjukkan bahwa halaman HTML diteruskan ke bash alih-alih skrip; curl: (22) The requested URL returned error: 403 berarti server menolak unduhan. Dokumentasi masalah instalasi (diperiksa: 3 Oktober 2026) mengaitkan keduanya dengan alamat penginstal yang tidak mengembalikan skrip. Jika halaman menampilkan App unavailable in region, menurut dokumentasi permintaan tampaknya berasal dari negara tempat Claude Code tidak tersedia. Karena Turki tercantum, jika Anda menerima pesan ini dari Turki, kemungkinan besar lalu lintas Anda keluar melalui VPN atau proksi ke negara lain; nonaktifkan lalu coba lagi. Kesalahan 403 tanpa isi biasanya berasal dari proksi perusahaan atau firewall: coba jaringan lain atau minta tim TI Anda mengizinkan alamat ini.

Instalasi dengan npm: Node.js 22 wajib

Metode npm belum dihapus dan masih dijelaskan dalam dokumentasi resmi; tetapi versi paket yang dibutuhkan sekarang adalah Node.js 22 atau yang lebih baru. Jika node -v menunjukkan versi yang lebih lama, npm tidak akan menghentikan instalasi, tetapi hanya menampilkan peringatan EBADENGINE. Meski begitu, cara terbaik adalah memperbarui Node.js ke versi 22 atau yang lebih baru melalui nodejs.org.

Terminal
node -v                                    # v22 veya üstü olmalı
npm install -g @anthropic-ai/claude-code   # sudo kullanmadan

# güncelleme: npm update -g değil, @latest
npm install -g @anthropic-ai/claude-code@latest

Tiga kebiasaan berikut menimbulkan masalah pada jalur ini:

  • Memasang dengan sudo. Dokumen memperingatkan tentang masalah izin dan risiko keamanan untuk sudo npm install -g.
  • Memperbarui dengan npm update -g. Yang benar adalah npm install -g @anthropic-ai/claude-code@latest.
  • Menonaktifkan dependensi opsional. Berkas yang dapat dieksekusi utama hadir sebagai dependensi opsional melalui paket @anthropic-ai/claude-code-* khusus platform. Flag --omit=optional atau optional=false di dalam .npmrc melewati paket ini: instalasi selesai tanpa kesalahan, tetapi saat claude dibuka di macOS dan Linux, muncul claude native binary not installed.

Apakah instalasi berhasil?

Apa pun jalur yang Anda pilih, buka terminal baru lalu jalankan dua perintah berikut:

claude --version   # sürüm numarasını yazar, ör. 2.1.211 (Claude Code)
claude doctor      # oturum açmadan kurulum ve ayar teşhisi

Jika claude --version menampilkan nomor versi, berarti program sudah berada di tempatnya. claude doctor mencantumkan status instalasi dan masalah pada berkas konfigurasi tanpa perlu masuk; jika terjadi kesalahan pada langkah berikutnya, dari sini Anda dapat membedakan apakah masalahnya ada pada instalasi atau konfigurasi.

Tanpa langganan: menetapkan kunci API untuk Claude Code

Saat pertama kali dibuka, claude meminta autentikasi. Jika Anda memiliki paket Claude, masuk lalu lanjutkan; jika tidak memiliki paket atau ingin membayar sesuai penggunaan alih-alih biaya bulanan tetap, jalankan Claude Code dengan kunci API. Perbedaan kedua jalur tersebut:

KriteriaMasuk dengan akun ClaudeKunci API Kunavo
Yang diperlukanAkun Pro, Max, Team, Enterprise, atau Console. Paket Claude.ai gratis tidak mencukupi.Kunci sk-kn-… dan beberapa variabel lingkungan. Tidak ada langganan atau login.
BiayaPro seharga 20 dolar per bulan; jika dibeli tahunan, 17 dolar per bulan atau 200 dolar dibayar di muka. Max mulai dari 100 dolar per bulan. Belum termasuk pajak (halaman harga Claude, diperiksa: 3 Oktober 2026).Sesuai jumlah token yang digunakan, dipotong dari saldo prabayar. Minimum 10 USD; tidak ada biaya bulanan, saldo berlaku tanpa batas waktu.
Metode pembayaranPaket yang dibeli melalui situs hanya dapat dibayar dengan kartu kredit atau debit (FAQ penagihan paket berbayar Claude, diperiksa: 3 Oktober 2026).Kartu (Visa, Mastercard), Apple Pay, Google Pay, Link. Tidak ada cicilan, Papara, transfer bank/havale/EFT.
Yang tidak berfungsi—Remote Control dan dikte suara. Tidak ada faktur yang diterbitkan (termasuk e-Arşiv).

Jalur kunci ini merupakan konfigurasi yang diantisipasi Anthropic: ANTHROPIC_BASE_URL adalah variabel bawaan Claude Code, dan dokumentasi gateway resmi menjelaskan bahwa Claude Code dijalankan di balik proxy atau gateway menggunakan variabel ini. Anda tidak memasang plugin, patch, atau klien yang dimodifikasi. Di macOS dan Linux, tambahkan enam baris ke berkas shell Anda (~/.zshrc atau ~/.bashrc):

~/.zshrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # yalnızca alan adı, /v1 yok
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

Sebelum membuat pengaturan permanen di Windows, uji dalam satu sesi PowerShell; ketika jendela ditutup, variabel juga hilang:

PowerShell
# Yalnızca bu PowerShell penceresinde geçerli – pencereyi kapatınca kaybolur
$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

Jika Anda ingin berlaku di setiap terminal, tuliskan nilai yang sama ke blok env pada berkas pengaturan pengguna. Menurut dokumen, berkas ini berlaku untuk semua proyek Anda; lokasinya di Windows adalah %USERPROFILE%\.claude\settings.json. %APPDATA%\Claude\settings.json yang muncul dalam beberapa ringkasan AI bukanlah jalur dalam dokumentasi resmi. Jika berkas tersebut sudah ada, tambahkan hanya blok env tanpa menghapus isinya:

~/.claude/settings.json
{
  "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"
  }
}

Enam variabel dan hal yang perlu diperhatikan

VariabelFungsiPerhatian
ANTHROPIC_BASE_URLServer tujuan permintaanHanya https://api.kunavo.com. Claude Code menambahkan jalur /v1/messages sendiri; jika Anda menulis /v1 di akhir, permintaan akan menuju /v1/v1/messages dan menerima 404.
ANTHROPIC_AUTH_TOKENKunci yang diawali sk-kn-Dikirim dengan header Authorization: Bearer dan langsung aktif (detail di bawah).
ANTHROPIC_MODELModel utamaDi sini Claude Sonnet 5, yaitu claude-sonnet-5. Nama tersebut harus sama persis dengan yang ada dalam daftar model Kunavo.
ANTHROPIC_DEFAULT_OPUS_MODELModel alias opusclaude-opus-5-5, yaitu Claude Opus 5.5. Model ini memerlukan Claude Code v2.1.280 atau yang lebih baru; jika versi Anda lebih lama, jalankan claude update. Jika tidak diatur, alias akan beralih ke model Opus terbaru milik Anthropic.
ANTHROPIC_DEFAULT_SONNET_MODELModel alias sonnetclaude-sonnet-5. Jika tidak diatur, alias akan meminta Sonnet 5.5 yang tidak disediakan Kunavo; tahap eksekusi /model sonnet dari opusplan dan sub-agen model: sonnet akan menerima 404.
ANTHROPIC_DEFAULT_HAIKU_MODELAlias haiku dan pekerjaan latar belakangclaude-haiku-4-5. Menurut dokumen, fungsi latar belakang juga berjalan dengan model ini. Jika tidak diatur, alias tersebut meminta ID yang tidak disediakan Kunavo (Haiku 5.5 sejak v2.1.293); /model haiku dan subagen yang dikonfigurasi dengan model: haiku akan menerima 404.

ANTHROPIC_AUTH_TOKEN atau ANTHROPIC_API_KEY? Kunci Kunavo menerima keduanya: Authorization: Bearer dan x-api-key. Perbedaannya terletak pada perilaku Claude Code. ANTHROPIC_AUTH_TOKEN dikirim ke header Bearer dan bekerja tanpa meminta konfirmasi. Sementara itu, ANTHROPIC_API_KEY dikirim ke header x-api-key dan pada mode interaktif meminta persetujuan Anda untuk pertama kalinya; jika Anda menjawab “tidak”, kunci akan diabaikan tanpa peringatan, dan untuk mengaktifkannya kembali Anda harus membuka /config → Use custom API key. Itulah alasan kami menggunakan ANTHROPIC_AUTH_TOKEN dalam panduan ini.

Mengapa model ditetapkan secara spesifik? Menurut dokumentasi konfigurasi model (diperiksa: 3 Oktober 2026), Claude Code yang menggunakan API akan meminta model default dan alias opus berupa Opus 5.5, serta alias sonnet berupa Sonnet 5.5, jika tidak ada pengaturan. Alias ini juga berubah setiap kali Anthropic merilis model baru. Per 3 Oktober 2026, Kunavo belum menyediakan Sonnet 5.5, sehingga permintaan sonnet yang tidak ditetapkan secara spesifik akan menghasilkan 404. Claude Opus 5.5 tersedia di Kunavo, tetapi tarifnya ($2,80 / $14,00) lebih tinggi daripada tarif Claude Sonnet 5 ($1,40 / $7,00); jika tidak ditetapkan secara spesifik, Anda dapat tanpa sadar menggunakan model yang lebih mahal. Karena itu, blok di atas mencantumkan baris ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5: /model sonnet, tahap eksekusi opusplan, dan subagen yang disetel ke model: sonnet akan menggunakan Claude Sonnet 5 alih-alih Sonnet 5.5. Alias opus kami tetapkan ke model Claude Opus 5.5 (claude-opus-5-5); model ini memerlukan Claude Code v2.1.280 atau yang lebih baru. Jika Anda menggunakan versi lebih lama, jalankan claude update.

Tarif di Kunavo (input / output, per 1 juta token): Claude Sonnet 5 $1,40 / $7,00 (tarif Anthropic: $2,00 / $10,00); Claude Opus 5.5 $2,80 / $14,00; Claude Haiku 4.5 yang menangani pekerjaan latar belakang $0,70 / $3,50.

Di mana kunci tidak boleh ditulis, dan nilai mana yang berlaku?

File .claude/settings.json milik proyek bukan tempat yang tepat untuk menyimpan kunci: dokumentasi gateway mengingatkan bahwa file ini dikomit ke repositori, sehingga kunci akan diteruskan kepada siapa pun yang mengkloning repositori. Jika variabel yang sama ditetapkan di shell dan di blok env pada file pengaturan, biasanya nilai dari file pengaturan yang berlaku; jika nilai yang Anda ubah di shell tidak berpengaruh, periksa bagian itu terlebih dahulu. Kunci model pada file pengaturan tidak mengikuti aturan ini: variabel ANTHROPIC_MODEL lebih diprioritaskan, sedangkan model hanya digunakan jika variabel tersebut tidak ada. Di ekstensi VS Code, variabel dimasukkan ke kolom claudeCode.environmentVariables dalam pengaturan pengguna VS Code.

Pembukaan pertama dan pemeriksaan /status

Jika variabel berada di tempat yang benar, perintah claude akan membuka sesi tanpa menampilkan layar login sama sekali; dokumentasi gateway (pemeriksaan: 3 Oktober 2026) menjelaskan perilaku ini ketika ANTHROPIC_AUTH_TOKEN diatur. Jika layar login muncul, Claude Code belum melihat kuncinya. Penyebab yang sering terjadi adalah kunci hanya berada di pengaturan proyek: dalam mode interaktif, blok env pada berkas .claude/settings.json atau .claude/settings.local.json proyek baru dibaca setelah wizard pertama kali dijalankan dan pertanyaan kepercayaan terhadap folder dilewati. Kunci harus berada di tempat yang dibaca sebelum wizard: export di shell, ~/.claude/settings.json tingkat pengguna, atau pengaturan terkelola (managed settings).

Setelah login, ketik /status. Dua baris memberikan informasi yang cukup:

  • Anthropic base URL: hanya terlihat jika alamat khusus ditetapkan dan harus menampilkan https://api.kunavo.com. Jika baris tersebut sama sekali tidak ada, ANTHROPIC_BASE_URL belum mencapai sesi.
  • Auth token: jika di sebelahnya tertulis nama ANTHROPIC_AUTH_TOKEN, permintaan dikirim menggunakan kunci API. Jika sebagai gantinya ada baris Login method yang menunjukkan akun claude.ai, Claude Code masih menggunakan login tersimpan; keluar dari sesi, buka terminal baru, lalu periksa tempat Anda menulis variabel tersebut.

Menguji tanpa membuka Claude Code

Anda juga dapat menguji alamat dan kunci secara independen dari Claude Code. Metode dalam dokumentasi resmi mengirim permintaan dengan satu token output; saldo Anda akan berkurang dalam jumlah yang sangat kecil. Perintah membaca variabel dari shell saat itu, jadi jika kunci hanya berada di berkas pengaturan, jalankan export terlebih dahulu di terminal ini. Jika respons dimulai dengan {"id":"msg_, alamat dan kunci valid; 401 menunjukkan bahwa kunci ditolak.

Terminal
curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Padanan PowerShell ada di bawah; jika berhasil, respons akan memiliki bidang id yang diawali msg_:

PowerShell
Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Apa yang berubah jika menggunakan kunci API?

  • Remote Control dan dikte suara tidak tersedia. Menurut dokumen, keduanya memerlukan identitas claude.ai dan tidak berfungsi ketika ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, atau apiKeyHelper aktif. Sejak v2.1.196, Remote Control juga dinonaktifkan ketika ANTHROPIC_BASE_URL menunjuk ke server di luar Anthropic.
  • /fast tampak nonaktif. Menurut dokumen, ketika hanya token bearer yang ditetapkan, Claude Code tidak menanyakan status mode cepat (fast mode) dan menganggapnya nonaktif.
  • Pencarian alat MCP dinonaktifkan secara default. Dokumentasi MCP (diperiksa: 3 Oktober 2026) mencantumkan pengaturan ANTHROPIC_BASE_URL khusus sebagai salah satu konfigurasi yang tidak menggunakan pencarian alat.
  • Angka /context merupakan perkiraan. Kunavo tidak menyediakan endpoint /v1/messages/count_tokens; dalam kondisi ini, menurut dokumentasi kompatibilitas gateway (diperiksa: 3 Oktober 2026), Claude Code memperkirakan penggunaan konteks berdasarkan jumlah karakter.

Detail teknis integrasi tersedia dalam dokumen integrasi Claude Code berbahasa Inggris; padanan bahasa Inggris panduan ini adalah Install Claude Code.

Pembayaran dari Turki: kartu, Apple Pay, Google Pay, Link

Yang Anda bayar di sini bukan langganan, melainkan saldo API prabayar yang digunakan Claude Code per token. Paket Pro dan Max yang dibeli dari situs Anthropic hanya dapat dibayar dengan kartu kredit atau debit (FAQ penagihan paket berbayar Claude, diperiksa: 3 Oktober 2026). Pengisian saldo Kunavo tidak menggantikan atau membayar paket-paket tersebut. Langkah-langkahnya:

  1. Daftar ke Kunavo. Alamat email atau akun Google sudah cukup; informasi kartu tidak diminta saat pendaftaran.
  2. Pilih jumlah di halaman Billing. Minimum 10 USD; tidak ada langganan atau biaya bulanan. Bonus ditambahkan untuk jumlah besar: Saldo 110 USD untuk pengisian 100 USD, Saldo 1.200 USD untuk pengisian 1.000 USD, dan Saldo 6.250 USD untuk pengisian 5.000 USD.
  3. Halaman pembayaran Stripe akan terbuka. Pilih salah satu kartu (Visa, Mastercard), Apple Pay, Google Pay, atau Link; Apple Pay dan Google Pay hanya ditampilkan pada perangkat dan browser yang mendukungnya.
  4. Kemudian, di halaman API Keys, buat kunci yang diawali sk-kn-. Kunci hanya ditampilkan sekali; salin lalu segera tuliskan ke nilai ANTHROPIC_AUTH_TOKEN.

Apakah jumlahnya ditampilkan dalam lira atau dolar?

Harga Kunavo dalam dolar; Stripe menentukan mata uang yang ditampilkan di halaman pembayaran, dan jumlahnya mungkin ditampilkan dalam lira Turki. Dokumentasi Adaptive Pricing Stripe (diperiksa: 3 Oktober 2026) mencantumkan Turki sebagai salah satu pasar yang didukung dan menyatakan bahwa konversi ini menambahkan biaya 2–4% pada nilai tukar, yang ditanggung pembeli. Jika memilih membayar dalam dolar, biaya ini tidak dikenakan; dalam hal itu, bank penerbit kartu Anda akan menerapkan nilai tukarnya sendiri dan biaya transaksi luar negeri jika ada. Apa pun mata uangnya, Anda dapat melihat jumlah pasti di halaman pembayaran sebelum mengonfirmasi.

Cicilan, Papara, transfer bank, dan Troy

  • Tidak ada cicilan; pembayaran dilakukan sekaligus. Pembelian dengan kartu Turki di situs luar negeri juga tidak dapat diubah menjadi cicilan setelah transaksi (enuygunfinans.com, diperiksa: 3 Oktober 2026).
  • Tidak tersedia Papara, transfer bank/EFT, dan PayPal. Opsi tersebut tidak akan muncul di halaman pembayaran.
  • Troy: Troy tidak tercantum di halaman merek kartu yang didukung Stripe (diperiksa: 3 Oktober 2026). Bayar dengan kartu berlogo Visa atau Mastercard.
  • Tidak ada faktur. Kunavo tidak menerbitkan faktur apa pun, termasuk e-Arşiv; rincian pengisian saldo Anda tersedia di halaman Billing.

Jika kartu ditolak, periksa terlebih dahulu aplikasi seluler bank Anda: kartu harus diaktifkan untuk transaksi internet dan transaksi internasional. Pengisian otomatis hanya dapat diatur dengan kartu tersimpan atau Link. Saldo tidak memiliki tanggal kedaluwarsa, dan permintaan yang gagal tidak dikenai biaya. Tarif semua model tersedia dalam panduan harga Claude API.

Berapa biaya satu sesi kerja?

Pada jalur kunci, biaya sepenuhnya bergantung pada jumlah token. Claude Code mengirim ulang konteks percakapan dari awal pada setiap permintaan; ketika bagian awal konteks yang tidak berubah dibaca dari cache, perhitungannya menggunakan tarif yang jauh lebih rendah. Tabel di bawah bukan pengukuran, melainkan perhitungan berdasarkan asumsi yang dinyatakan secara jelas; tabel ini juga tidak boleh dibaca sebagai batas atas. Asumsi:

  • 40.000 token input per permintaan; sebesar 36.000 (%90) dibaca dari cache, sedangkan sisanya sebesar 4.000 ditulis ke cache;
  • 1.000 token output per permintaan;
  • 50 permintaan dalam sesi; panggilan Claude Haiku 4.5 di latar belakang tidak diperhitungkan;
  • Untuk Claude Sonnet 5, pembacaan dari cache sebesar %10 dari tarif input, sedangkan penulisan ke cache sebesar 1,25 kali lipat. Setiap model dalam tabel dihitung menggunakan tarifnya sendiri.
ModelSatu permintaan50 permintaan50 permintaan, tanpa cache hit
Claude Sonnet 5$0,019$0,95$3,15
Claude Opus 5.5$0,033$1,65$6,30

Jumlah sebenarnya ditentukan oleh panjang konteks, tingkat kecocokan cache, panjang jawaban, dan apakah Anda menghapus percakapan saat berganti topik. Dokumentasi biaya resmi (diperiksa: 3 Oktober 2026) menambahkan dua detail: Claude Code menggunakan sejumlah kecil token di latar belakang meskipun Anda tidak mengetik apa pun, biasanya kurang dari 0,04 dolar per sesi; untuk kunci API, masa aktif cache secara default adalah lima menit, sehingga pesan pertama setelah jeda lebih lama tidak cocok dengan cache dan seluruh konteks akan diproses ulang. Saat berganti topik, gunakan /clear; untuk sesi panjang, /compact dapat mengurangi biaya ini.

Semua tarif tersedia di halaman harga. Anda dapat memperkirakan penggunaan Anda sendiri dengan kalkulator biaya token Claude (bahasa Inggris). Panduan harga Claude Code membahas apakah langganan atau API lebih sesuai.

Pesan kesalahan dan solusinya

PesanPenyebab dan solusi
The token '&&' is not a valid statement separatorBaris CMD ditempelkan ke PowerShell. Gunakan baris irm … | iex.
“'irm' bukan perintah internal atau eksternal, program yang dapat dijalankan, atau berkas batch.” (Bahasa Inggris: 'irm' is not recognized as an internal or external command)Baris PowerShell ditempelkan ke CMD. Gunakan baris install.cmd.
A parameter cannot be found that matches parameter name 'fsSL', 'bash' is not recognized as the name of a cmdletPerintah macOS/Linux dijalankan di Windows. Gunakan baris PowerShell.
syntax error near unexpected token '<', 403, App unavailable in regionAlamat penginstal mengembalikan halaman HTML atau kode kesalahan. Periksa VPN, proxy, dan firewall; Turki termasuk negara yang didukung.
command not found: claude, 'claude' is not recognizedFolder instalasi tidak berada di dalam PATH. Buka terminal baru; di Windows, tambahkan jalurnya dengan perintah PowerShell di atas.
Peringatan EBADENGINEVersi Node.js lebih lama dari 22. Instalasi tidak berhenti, tetapi sebaiknya Anda memperbarui Node.js.
claude native binary not installed (macOS, Linux)npm melewati dependensi opsional (--omit=optional atau optional=false) atau skrip instalasi (--ignore-scripts). Hapus pengaturan ini lalu instal ulang.
npm.ps1 cannot be loadedKebijakan eksekusi PowerShell memblokir skrip npm. Jalankan perintah Set-ExecutionPolicy atau gunakan penginstal native.
Claude Code does not support 32-bit WindowsPowerShell (x86) sedang terbuka. Buka “Windows PowerShell” biasa.
Layar login muncul meskipun kunci sudah diaturClaude Code tidak membaca kunci. Tuliskan variabel bukan hanya di pengaturan proyek, tetapi juga di shell atau berkas ~/.claude/settings.json, lalu buka terminal baru.
401Kunci ditolak. Periksa apakah kunci sk-kn- disalin lengkap tanpa spasi, tidak dihapus dari halaman /app/keys, dan berada di dalam ANTHROPIC_AUTH_TOKEN.
404ANTHROPIC_BASE_URL berakhir dengan /v1 atau model yang diminta tidak tersedia di Kunavo; misalnya, empat variabel yang menetapkan model belum diatur dan alias sonnet meminta Sonnet 5.5.

Batasan yang perlu diketahui

  • Kunavo tidak menerbitkan faktur; e-Arşiv juga tidak tersedia.
  • Pembayaran dilakukan sekaligus: tidak ada cicilan, Papara, atau transfer bank/EFT. Untuk pengisian otomatis diperlukan kartu tersimpan atau Link.
  • Ini bukan langganan Claude Pro atau Max, melainkan API yang dibayar per token. Pada jalur kunci, Remote Control dan dikte suara tidak berfungsi, /fast tampak nonaktif, dan pencarian alat MCP dinonaktifkan secara default.
  • Kunavo tidak menyediakan Sonnet 5.5 sejak 3 Oktober 2026; jika model tidak ditetapkan secara tetap, alias sonnet mengembalikan 404.
  • Dokumentasi resmi Claude Code dan dokumen integrasi Kunavo hanya tersedia dalam bahasa Inggris (pemeriksaan: 3 Oktober 2026).

Pertanyaan yang sering diajukan

Bagaimana cara menginstal Claude Code?

Cara termudah adalah penginstal native yang direkomendasikan Anthropic dalam dokumentasinya. Di macOS, Linux, dan WSL, jalankan perintah curl -fsSL https://claude.ai/install.sh | bash. Di Windows, gunakan irm https://claude.ai/install.ps1 | iex di PowerShell, sedangkan di Command Prompt (CMD), gunakan baris curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Setelah itu, buka terminal baru dan periksa instalasi dengan claude --version. Instalasi native memperbarui dirinya sendiri di latar belakang. Jika ingin menginstal dengan npm, Anda memerlukan Node.js 22 atau yang lebih baru; jangan gunakan sudo, dan lakukan pembaruan dengan npm install -g @anthropic-ai/claude-code@latest.

Bagaimana cara menginstal Claude Code di Windows? Apakah harus dijalankan sebagai administrator, dan apakah WSL serta Git wajib?

Hak administrator tidak diperlukan; dokumentasi resmi menyatakannya dengan jelas. WSL dan Git juga tidak wajib: cukup jalankan baris instalasi untuk PowerShell atau CMD di terminal biasa. Git for Windows bersifat opsional tetapi direkomendasikan; jika terinstal, Claude Code menjalankan perintah dengan Git Bash, jika tidak, dengan PowerShell. Jika Anda memerlukan alat Linux atau ingin menjalankan perintah di lingkungan terisolasi (sandbox), pilih WSL 2; kemudian instal claude di terminal WSL dan mulai dari sana. “Windows PowerShell (x86)” di menu Start adalah proses 32-bit dan akan memberikan kesalahan Windows 32-bit bahkan di komputer 64-bit, jadi jangan buka yang itu.

Apakah Claude Code gratis dan dapat digunakan tanpa langganan?

Paket gratis Claude.ai tidak mencakup Claude Code; untuk masuk dengan akun Claude, diperlukan akun Pro, Max, Team, Enterprise, atau Console. Anda juga dapat menggunakannya tanpa langganan: saat menetapkan ANTHROPIC_BASE_URL=https://api.kunavo.com dan ANTHROPIC_AUTH_TOKEN dengan kunci API Anda, Claude Code terbuka tanpa menampilkan layar login dan membayar token yang digunakan dari saldo prabayar di Kunavo. Tidak ada biaya bulanan. Dalam mode ini, Remote Control dan dikte suara tidak berfungsi karena keduanya memerlukan identitas claude.ai.

Di mana kunci API dimasukkan untuk Claude Code? Apakah ANTHROPIC_BASE_URL harus diakhiri /v1? AUTH_TOKEN atau API_KEY?

Tidak boleh diakhiri /v1. Claude Code menambahkan rute /v1/messages sendiri; jika alamat berakhir dengan /v1, permintaan akan menuju /v1/v1/messages dan mengembalikan 404. Tulis variabel tersebut ke file shell Anda (~/.zshrc, ~/.bashrc, atau $PROFILE di PowerShell) atau ke blok env dalam file pengaturan pengguna ~/.claude/settings.json; di Windows, jalurnya %USERPROFILE%\.claude\settings.json, bukan %APPDATA%. Jangan pernah menulisnya ke file .claude/settings.json proyek karena file tersebut akan di-commit ke repositori. Kunci Kunavo dibaca baik dari header Authorization: Bearer maupun x-api-key, jadi kedua variabel berfungsi. Kami merekomendasikan ANTHROPIC_AUTH_TOKEN karena langsung berlaku; ANTHROPIC_API_KEY meminta konfirmasi sekali dalam mode interaktif dan, jika ditolak, akan diabaikan secara diam-diam (untuk mengaktifkannya kembali: /config → Use custom API key).

Mengapa ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, dan ANTHROPIC_DEFAULT_SONNET_MODEL perlu ditetapkan?

Jika tidak ditetapkan, Claude Code menggunakan alias yang berubah mengikuti model-model baru Anthropic. Menurut dokumentasi konfigurasi model resmi (diperiksa: 3 Oktober 2026), model default dan alias opus untuk pengguna API menunjuk ke Opus 5.5, sedangkan alias sonnet menunjuk ke Sonnet 5.5. Kunavo saat ini tidak menyediakan Sonnet 5.5 (per 3 Oktober 2026), sehingga permintaan sonnet mengembalikan 404: /model sonnet, fase eksekusi opusplan, dan subagen (subagent) yang ditetapkan sebagai model: sonnet tidak berfungsi. Opus 5.5 default berfungsi, tetapi lebih mahal daripada model Claude Sonnet 5. Setelah ditetapkan, model utama dan alias sonnet menjadi claude-sonnet-5, alias opus menjadi claude-opus-5-5, sedangkan alias haiku dan pekerjaan latar belakang menjadi claude-haiku-4-5; Anda akan mengetahui model yang menjawab dan tarif yang dibayarkan. Opus 5.5 memerlukan Claude Code v2.1.280 atau yang lebih baru; jika versi Anda lebih lama, jalankan claude update.

Bagaimana cara memeriksa apakah Claude Code menggunakan kunci API dengan /status?

Ketik /status dalam sesi Claude Code. Baris “Anthropic base URL” harus menampilkan https://api.kunavo.com dan baris “Auth token” harus mencantumkan nama ANTHROPIC_AUTH_TOKEN. Jika yang terlihat adalah baris “Login method” dengan akun claude.ai, berarti variabel belum dibaca: keluar dari sesi, buka terminal baru, lalu periksa lokasi penulisan variabel tersebut.

Bagaimana cara membayar dari Türkiye? Harganya dalam TRY atau dolar?

Halaman pembayaran Stripe menawarkan kartu (Visa, Mastercard), Apple Pay, Google Pay, dan Link. Harga dinyatakan dalam dolar; Stripe dapat menampilkan jumlah dalam lira Turki, dan dalam kasus ini kurs sudah mencakup biaya konversi 2–4% yang dibayar pembeli. Jika memilih membayar dalam dolar, biaya ini tidak ada, tetapi kurs dan biaya bank Anda sendiri berlaku. Jumlah pengisian minimum adalah 10 USD, tidak ada biaya bulanan, dan saldo tidak kedaluwarsa. Pengisian otomatis hanya berfungsi dengan kartu tersimpan atau Link. Kunavo tidak menerbitkan faktur (termasuk e-Arşiv); riwayat pengisian Anda terlihat di halaman Billing.

Dapatkah saya membayar dengan cicilan, Papara, transfer bank/EFT, atau kartu Troy? Apakah pembayaran ini mencakup Claude Pro?

Tidak. Kunavo tidak menawarkan cicilan; Papara, transfer bank/EFT, dan PayPal juga tidak tersedia. Troy tidak termasuk merek kartu yang tercantum dalam dokumentasi Stripe; gunakan kartu dengan logo Visa atau Mastercard. Jika kartu ditolak, periksa di aplikasi bank apakah pembelian online dan transaksi internasional diizinkan. Pengisian ini hanya masuk ke saldo API Kunavo; pembayaran ini tidak mencakup langganan Claude Pro atau Max. Langganan yang dibeli dari situs web Anthropic hanya dapat dibayar dengan kartu kredit atau debit.