Kılavuzlara dön
Kurulum·3 Ekim 2026·Son güncelleme: 10 Ekim 2026·14 dk okuma

Claude Code nasıl kurulur: Windows, macOS ve Linux için resmi komut, aboneliksiz API anahtarı, /status kontrolü ve kart veya Link ile ödeme

Claude Code tek bir resmi komutla kurulur. Daha sık sorun çıkaran kısım sonraki adımlardır: Windows'ta doğru terminali seçmek, npm üzerinden kurulumda Node.js sürümünü kontrol etmek, giriş yapmadan API anahtarını ayarlamak ve Endonezya'dan QRIS veya e-cüzdan olmadan ödeme yapmak.

Özetle: Claude Code'u tek bir resmi komutla kurun (aşağıda macOS/Linux, PowerShell veya CMD için uygun satırı seçin), ardından giriş yapmak yerine API anahtarıyla bağlantı kurun. Bunun için yalnızca altı değişken yeterlidir: ANTHROPIC_BASE_URL=https://api.kunavo.com (/v1 olmadan), anahtarı içeren ANTHROPIC_AUTH_TOKEN ve modeli sabitleyen dört değişken. Sonucu /status ile kontrol edin. Pro veya Max aboneliği gerekmez; token ücretlerini, en az $10 yükleyerek oluşturduğunuz ön ödemeli bakiyeden ödersiniz; bakiye kart (Visa, Mastercard vb.) veya Link ile yüklenir. QRIS, GoPay, OVO ve DANA kullanılamaz.

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 Command Prompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Buradaki tüm komut ve değişken adlarını, 3 Ekim 2026 tarihindeki resmi Claude Code belgeleriyle eşleştirdik. Belgeler, kurulum sayfası ve LLM ağ geçidine bağlanma sayfası dahil, Endonezce olarak mevcut; böylece kendiniz de karşılaştırabilirsiniz. Kunavo'nun fiyatları ve ödeme yöntemleri 10 Ekim 2026 tarihinde kontrol edildi.

Sıfırdan Claude Code'u çalıştırmaya kadar altı adım

  1. Dizüstü bilgisayarınızın gereksinimleri karşıladığından emin olun ve karar verin: Claude hesabıyla mı giriş yapacaksınız, yoksa API key mi kullanacaksınız.
  2. Terminalinize uygun bağımsız yükleyiciyi çalıştırın.
  3. Yeni bir terminal açın, claude --version değerini kontrol edin ve gerekirse PATH değerini düzeltin.
  4. API key'i ve model sabitlemesini ayarlayın.
  5. İlk oturumu açın ve /status üzerinden key'inizin kullanıldığını doğrulayın.
  6. Kart veya Link ile bakiye yükleyin ve çalışmaya başlayın.

1. adım: gereksinimleri kontrol edin, ardından giriş veya API key seçin

Kontrol edilenlerResmî gereksinimler (3 Ekim 2026 tarihinde kontrol edildi)
İşletim sistemimacOS 13.0+; Windows 10 sürüm 1809+ veya Windows Server 2019+; Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+
DonanımEn az 4 GB RAM; x64 veya ARM64 işlemci. 32 bit Windows desteklenmez.
TerminalBash, Zsh, PowerShell veya CMD
Node.jsBağımsız yükleyici için gerekmez. Yalnızca npm üzerinden yükleme yapıyorsanız gerekir ve 22 veya üzeri sürüm olmalıdır.
ÜlkeAnthropic'in desteklediği ülkeler listesinde yer alıyor. Endonezya, hem Claude.ai hem de API için bu listede bulunuyor.

Claude Code kurulduktan sonra ödemeyi kimin yaptığını bilmesi gerekir. İlk yol, Claude hesabıyla oturum açmaktır; bunun için Pro, Max, Team, Enterprise planı veya Console hesabı gerekir. Ücretsiz Claude.ai planına Claude Code dahil değildir. Claude fiyatlandırma sayfasına göre (3 Ekim 2026 tarihinde incelendi), Pro ayda 20 ABD doları, yıllık ödemede ayda 17 ABD dolarıdır (peşin 200 ABD doları); Max ayda 100 ABD dolarından başlar ve tüm fiyatlara vergiler dahil değildir. Web üzerinden satın alınan aboneliklerde Anthropic yalnızca kredi veya banka kartı kabul eder; iOS ya da Android uygulamasından alınan aboneliklerde ödeme App Store veya Google Play üzerinden yapılır (Claude faturalandırma SSS'si, 3 Ekim 2026 tarihinde incelendi). Oturum açma yöntemi resmî kimlik doğrulama sayfasında açıklanıyor.

Bu kılavuzda ayrıntılı olarak ele alınan ikinci yol API key'dir: abonelik ve giriş ekranı olmadan. Yalnızca gerçekten kullanılan token başına ödeme yaparsınız; bu nedenle sakin geçen aylarda maliyet de düşük olur. Eksik olan yalnızca claude.ai hesabına bağlı iki özelliktir: Remote Control ve sesle dikte; farklılıkların tam listesi 5. adımda yer alır.

Terminali ilk kez mi açıyorsunuz? Anthropic, yeni başlayanlar için Endonezce terminal kılavuzu sunuyor.

2. adım: yükleyiciyi çalıştırın

macOS, Linux ve WSL

install.sh satırını sayfanın başından Terminal'e yapıştırın, Enter'a basın ve tamamlanmasını bekleyin. Bu betik doğrudan claude.ai adresinden alınır, programı ~/.local/bin/claude konumuna yükler ve bundan sonra Claude Code arka planda kendini otomatik olarak günceller. Resmî belgelerde bu yöntem “Önerilen” olarak etiketlenmiştir.

Windows: önce terminalinizi tanıyın

Birçok eski eğitim, PowerShell'i “Run as Administrator” olarak açmanızı ve önce WSL yüklemenizi önerir. İkisi de gerekli değildir: resmî Endonezce belgeler Windows yüklemesinin sıradan bir terminalden, Yönetici yetkileri olmadan çalıştığını belirtir ve WSL yalnızca bir seçenektir. Hangi komutun kullanılacağını belirleyen şey istemin görünümüdür:

  • PS C:\Users\NamaAnda> istemi PowerShell anlamına gelir. irm … | iex satırını kullanın.
  • C:\Users\NamaAnda> istemi, PS olmadan Command Prompt (CMD) anlamına gelir. install.cmd satırını kullanın.
  • Başlat menüsünde “Windows PowerShell”i seçin; “Windows PowerShell (x86)”ı değil. x86 sürümü 32 bit çalışır ve dizüstü bilgisayar 64 bit olsa bile Claude Code does not support 32-bit Windows ile sonuçlanır.

Yanlış terminalde kullanılan komutlar mesajlarından hemen anlaşılır; örneğin The token '&&' is not a valid statement separator (PowerShell'de CMD satırı) veya 'irm' is not recognized as an internal or external command (CMD'de PowerShell satırı). Endonezce Windows'ta mesajlar çevrilmiş olarak görünebilir. Tam liste aşağıdaki hata tablosundadır.

Git zorunlu değildir. Git for Windows yüklüyse Claude Code'un Bash aracı Git Bash'i kullanır; yüklü değilse komutlar PowerShell üzerinden çalıştırılır. Git yüklü olduğu halde Git Bash bulunamıyorsa ~/.claude/settings.json dosyasının env bloğunda CLAUDE_CODE_GIT_BASH_PATH değişkenini bash.exe dosyasının konumuyla doldurun; örneğin C:\Program Files\Git\bin\bash.exe. WSL kullanmanın uygun olduğu durumlar:

OrtamHazırlıkKorumalı çalıştırmaUygun olduğu durum
Doğrudan WindowsYok (Git for Windows isteğe bağlıdır)HayırDoğrudan Windows'ta yürütülen projeler
WSL 2WSL 2 zaten etkinEvetLinux araçları veya yalıtılmış olarak çalıştırılan komutlar gerektiren projeler
WSL 1WSL 1 zaten etkinHayırYalnızca WSL 2 kullanılamıyorsa

WSL'yi mi seçtiniz? install.sh satırını WSL terminalinin içinde çalıştırın ve claude komutunu her zaman yine aynı WSL terminalinden açın.

Alternatifler: Homebrew, WinGet veya npm

Homebrew ve WinGet de resmîdir; ancak belgelere göre her ikisi de varsayılan olarak otomatik güncellenmez. Bunları kendiniz güncellemeniz gerekir:

# macOS lewat Homebrew (tidak update otomatis; perbarui dengan brew upgrade)
brew install --cask claude-code

# Windows lewat WinGet (tidak update otomatis; perbarui dengan winget upgrade)
winget install Anthropic.ClaudeCode

npm hâlâ belgelerde yer alıyor; gereksinim Node.js 22 veya üzeri (nodejs.org adresinden indirin). Eski Node.js sürümlerinde npm yalnızca EBADENGINE uyarısı verir ve kurulumu sürdürür; çünkü bu paket aslında çalışırken Node.js'e bağımlı olmayan derlenmiş bir ikili dosya indirir.

Terminal
node -v                                    # harus v22 ke atas
npm install -g @anthropic-ai/claude-code   # jangan pakai sudo

# memperbarui ke versi terbaru
npm install -g @anthropic-ai/claude-code@latest

npm yüklemesini bozan üç alışkanlık: sudo npm install -g kullanmak (belgeler bunu izin sorunlarının ve güvenlik risklerinin kaynağı olarak belirtir), npm update -g ile güncellemek yerine @latest kullanmak ve --omit=optional veya optional=false aracılığıyla .npmrc içinde isteğe bağlı bağımlılıkları devre dışı bırakmak. Sonuncusu, platformunuz için @anthropic-ai/claude-code-* paketinin indirilmesini engeller; bu nedenle macOS veya Linux'ta claude komutu claude native binary not installed yanıtını verir.

PowerShell'de npm bazen npm.ps1 cannot be loaded because running scripts is disabled on this system hatasında takılır. Bu, .ps1 betiklerini engelleyen yürütme ilkesidir. Belgeler üç çözüm sunar: aşağıdaki komutla kullanıcınız için yerel betiklere izin verin, npm.cmd ve claude.cmd komutlarını çağırın veya npm'den vazgeçip bağımsız yükleyiciyi kullanın.

PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Bir uyarı daha: eğitimlerde dolaşan üçüncü taraf .exe yükleyicilerini, özellikle Yönetici yetkisi isteyenleri yok sayın. Yukarıdaki resmî komut yeterlidir.

3. adım: Claude Code'un yüklendiğinden emin olun

Yükleme yaptığınız terminali kapatın ve yeni bir terminal açın. Eski pencere yükleme öncesindeki PATH değerini kullanmaya devam eder; bu nedenle orada claude çoğu zaman henüz tanınmaz. Yeni terminalde:

Yeni terminal
claude --version   # muncul nomor versi = instalasi berhasil
claude doctor      # cek instalasi dan file pengaturan tanpa membuka sesi

claude doctor, iki tür sorunu birbirinden ayırmak için yararlıdır: rapor temiz olduğu hâlde Claude Code yine de bağlanmıyorsa sorun yüklemede değil, yapılandırmadadır (4. adım).

Hâlâ command not found: claude veya 'claude' is not recognized mı görüyorsunuz? Yükleme klasörü PATH içine eklenmemiştir. macOS ve Linux'ta bu klasör ~/.local/bin, Windows'ta %USERPROFILE%\.local\bin konumundadır. Windows için belgeler aşağıdaki PowerShell komutunu verir:

PowerShell
# Ada hasilnya? Berarti PATH sudah benar, cukup buka terminal baru.
$env:PATH -split ';' | Select-String '\.local\\bin'

# Tidak ada hasil? Tambahkan folder instalasi ke PATH user:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# Tutup PowerShell, buka lagi, lalu:
claude --version

İndirme daha en başta başarısız olursa hata mesajına dikkat edin. Kurulum sorunlarını giderme sayfasına göre (3 Ekim 2026 tarihinde incelendi), syntax error near unexpected token '<' veya curl: (22) The requested URL returned error: 403 mesajı indirilen içeriğin betik değil, HTML sayfası ya da hata kodu olduğunu gösterir. App unavailable in region mesajı, bağlantınızın desteklenmeyen bir ülkeden geliyormuş gibi göründüğü anlamına gelir; Endonezya desteklendiğinden başlıca şüpheliler VPN veya proxy'dir. İçeriği olmayan 403 hatası da çoğu zaman işyeri proxy'sinden veya üniversite güvenlik duvarından kaynaklanır. Homebrew, WinGet ve npm aynı ana bilgisayardan indirir; bu nedenle yöntem değiştirmeden önce başka bir ağ deneyin veya ağ yöneticinizden erişime izin vermesini isteyin.

4. adım: abonelik olmadan API key ayarlayın

Claude Code, Anthropic dışındaki bir ağ geçidine istek göndermek için yerleşik ANTHROPIC_BASE_URL değişkenine sahiptir ve resmî belgelerinde bunun için özel bir sayfa bulunur. Dolayısıyla bu desteklenen bir yapılandırmadır; modifikasyon veya eklenti değildir. Önce sk-kn-… key'ini alın (liste ve bakiye yükleme için 6. adıma bakın), ardından bunu saklamak için yerlerden birini seçin.

macOS ve Linux: bu altı satırı ~/.zshrc (Zsh, macOS'un varsayılanı) veya ~/.bashrc dosyasının sonuna ekleyin, kaydedin ve yeni bir terminal açın.

~/.zshrc veya ~/.bashrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # domain saja, tanpa /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

Windows'ta önce denemek için: değişkenleri tek bir PowerShell penceresinde ayarlayın ve hemen claude komutunu çalıştırın.

PowerShell
# Untuk uji coba: hanya berlaku sampai jendela PowerShell ini ditutup
$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

Tüm işletim sistemlerinde kalıcı olarak: kullanıcı ayarları dosyanızdaki env bloğuna, yani ~/.claude/settings.json dosyasına (Windows: %USERPROFILE%\.claude\settings.json) ekleyin. Tüm projeler için geçerli olur. Dosyada zaten içerik varsa diğer ayarların üzerine yazmadan yalnızca env bloğunu ekleyin.

~/.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"
  }
}

Yukarıdaki altı değişkenle ilgili dikkat edilmesi gerekenler:

DeğişkenDeğerSık yapılan hata
ANTHROPIC_BASE_URLhttps://api.kunavo.com/v1 eklemek. Claude Code /v1/messages yolunu kendisi ekler; sonuç /v1/v1/messages ve 404 olur.
ANTHROPIC_AUTH_TOKENAnahtar sk-kn-…Kunavo, hem Authorization: Bearer hem de x-api-key başlığından key kabul eder; bu nedenle ANTHROPIC_API_KEY de kullanılabilir. Claude Code tarafındaki fark şudur: ANTHROPIC_AUTH_TOKEN hemen etkinleşir, ANTHROPIC_API_KEY ise etkileşimli modda bir kez onay bekler. Önceden reddedildiyse key, /config → Use custom API key yolundan yeniden etkinleştirilene kadar sessizce yok sayılır.
ANTHROPIC_MODELclaude-sonnet-5 (Claude Sonnet 5)Tarih ile biten eski sürüm model kimliği yazmak. Ad, Kunavo model listesindekiyle tam olarak aynı olmalıdır.
ANTHROPIC_DEFAULT_OPUS_MODELclaude-opus-5-5 (Claude Opus 5.5)Doldurulmaması, opus takma adının da Anthropic'in en yeni modeline taşınmasına neden olur. Claude Opus 5.5 için Claude Code v2.1.280 veya daha yenisi gerekir; daha eski sürüm claude update ile güncellenir.
ANTHROPIC_DEFAULT_SONNET_MODELclaude-sonnet-5 (Claude Sonnet 5)Doldurulmaması, sonnet takma adının Kunavo'da bulunmayan Sonnet 5.5'i istemesine yol açar: /model sonnet, opusplan yürütme aşaması ve model: sonnet kullanan alt aracılar 404 yanıtı alır.
ANTHROPIC_DEFAULT_HAIKU_MODELclaude-haiku-4-5 (Claude Haiku 4.5)Bu değişkenin yalnızca haiku takma adını değil, arka plan görevleri için kullanılan modeli de seçtiğini unutmak. Ayarlanmazsa haiku takma adı Kunavo'da bulunmayan bir kimlik ister (v2.1.293'ten itibaren Haiku 5.5): /model haiku ve model: haiku kullanan alt ajanlar 404 hatası alır.

Model neden sabitleniyor? Model yapılandırma belgelerine göre (3 Ekim 2026 tarihinde incelendi), API kullanıcıları için varsayılan model ve opus takma adı şu anda Opus 5.5'e, sonnet takma adı ise Sonnet 5.5'e yöneliyor. Takma adlar yeni bir model çıktığında değişiyor. 3 Ekim 2026 itibarıyla Sonnet 5.5 Kunavo'da mevcut değil ve sonraki model de hemen kullanılabilir olmayabilir; mevcut olmayan bir modele yapılan istek 404 hatası alır. Bu nedenle yukarıdaki blok, ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 ile sonnet takma adını da sabitliyor: sabitleme olmadan /model sonnet, opusplan'ın yürütme aşaması ve sonnet modeliyle çalışan alt ajan 404 hatası alır. opus takma adı Claude Opus 5.5'e sabitlenmiştir (claude-opus-5-5); bunun için Claude Code v2.1.280 veya üzeri gerekir. Sürümünüz daha eskiyse claude update komutunu çalıştırın.

Kunavo'nun 1 milyon token başına ücretleri (girdi / çıktı): Claude Sonnet 5 $1,40 / $7,00 (Anthropic liste fiyatı: $2,00 / $10,00), Claude Opus 5.5 $2,80 / $14,00 ve Claude Haiku 4.5 $0,70 / $3,50.

Dikkat edilmesi gereken iki nokta daha var. Birincisi, anahtarı asla projeye ait .claude/settings.json dosyasına koymayın: ağ geçidi belgelerine göre bu dosya depoya kaydedilir ve depoyu alan herkes tarafından klonlanır. İkincisi, aynı değişken hem kabukta hem ayarlar dosyasının env bloğunda varsa genellikle ayarlar dosyasındaki değer önceliklidir. Bu nedenle ~/.zshrc dosyasında yaptığınız değişiklik etkisiz görünüyorsa ayarlar dosyasını kontrol edin. VS Code uzantısı kullanıcıları aynı değişkenleri VS Code kullanıcı ayarlarındaki claudeCode.environmentVariables alanına girer.

5. adım: ilk oturumu açın ve /status komutunu kontrol edin

Proje klasörüne gidin ve claude yazın. Key okunmuşsa oturum giriş ekranı olmadan hemen açılır. Giriş ekranının görünmesi, key'in ulaşmadığının işaretidir. En yaygın neden, key'in yalnızca .claude/settings.json veya .claude/settings.local.json içinde bulunmasıdır. Etkileşimli modda proje dosyasındaki env bloğu, ilk sihirbaz ve bu klasöre güvenilip güvenilmediği sorusundan sonra okunur; bu nedenle ilk başlatmada Claude Code yine giriş ister. Key'i shell'e veya ~/.claude/settings.json dosyasına taşıyın.

Oturum açıldıktan sonra /status yazın. Yapılandırma şu durumlarda doğrudur:

  • Anthropic base URL satırında https://api.kunavo.com bulunur (bu satır yalnızca ağ geçidi yapılandırılmışsa görünür; yoksa ANTHROPIC_BASE_URL okunmamış demektir) ve
  • Auth token satırında ANTHROPIC_AUTH_TOKEN belirtilir. Login method satırı claude.ai hesabıyla görünüyorsa Claude Code hâlâ eski girişi kullanıyordur.

Claude Code'u açmadan önce key'i test etmek ister misiniz? Resmî belgeler yalnızca 1 çıktı token'ı isteyen bir istek kullanır; bu nedenle kesilen bakiye çok küçüktür. Komut, değişkenleri etkin shell'den okur; key'iniz ayar dosyasında saklanıyorsa önce bu terminalde export yapın. {"id":"msg_ ile başlayan sonuç başarılı, 401 ise key'in reddedildiği anlamına gelir.

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": "."}]}'

PowerShell sürümü; yanıttaki id alanı msg_ ile başlıyorsa başarılıdır:

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": "."}]}'

Claude Code API key ve ağ geçidi kullanırken bazı şeyler farklı çalışır:

ÖzellikKunavo API key'i ileKaynak (3 Ekim 2026 tarihinde kontrol edildi)
Remote Control, sesle dikteKullanılamaz. İkisi de claude.ai kimliği gerektirir ve ANTHROPIC_BASE_URL Anthropic ana makinesi değilse Remote Control da devre dışı kalır.Ağ geçidi belgeleri
/fastDevre dışı olarak görünür; yalnızca bearer token ile Claude Code kullanılabilirliğini sormaz.Ağ geçidi belgeleri
MCP araç aramasıVarsayılan olarak devre dışıdır; bu nedenle MCP araçları oturumun başında yüklenir. ENABLE_TOOL_SEARCH ile değiştirilebilir.MCP belgeleri
/context içindeki sayıKunavo /v1/messages/count_tokens sağlamadığı için karakter sayısına dayalı tahmindir.Ağ geçidi uyumluluk kılavuzu
/usage içindeki dolarToken sayısı ve Anthropic liste fiyatı kullanılarak yerel olarak hesaplanır (kuruluş yöneticisi bir modelPricing tablosu ayarlamadıysa). Gerçekte azalan, Billing sayfasındaki Kunavo bakiyesidir.Maliyet belgeleri

6. adım: kart veya Link ile bakiye yükleyin (QRIS, GoPay, OVO, DANA olmadan)

Kunavo'da ödediğiniz şey abonelik değil, ön ödemeli API bakiyesidir. Key ayarlandıktan sonra Claude Code bunu token başına düşer. Sıra şöyledir:

  1. e-posta veya Google hesabı kullanarak Kunavo hesabı oluşturun. Kayıt sırasında kart istenmez.
  2. Faturalandırma sayfasını açın ve bir tutar seçin. Minimum tutar $10; aylık ücret yoktur. Daha yüksek tutarlar bonus bakiye sağlar: $100 öde → $110 bakiye, $1.000 öde → $1.200 bakiye ve $5.000 öde → $6.250 bakiye.
  3. Stripe ödeme adımında kartla (Visa, Mastercard vb.), Link ile veya cihaz ve tarayıcınızda ayarlanmışsa Apple Pay/Google Pay ile ödeme yapabilirsiniz. Link, ödeme bilgilerini kaydederek sonraki bakiye yüklemelerini birkaç tıklamayla yapmanızı sağlar.
  4. API Keys sayfasını açın ve bir key oluşturun. sk-kn- ile başlayan key yalnızca bir kez gösterilir; bu nedenle o anda ANTHROPIC_AUTH_TOKEN içine kopyalayın.

QRIS, GoPay, OVO, DANA, ShopeePay, sanal hesap ve banka havalesi kullanılamaz. Uluslararası çevrim içi işlemleri destekleyen bir kartınız yoksa şu anda Kunavo'ya bakiye yükleyemezsiniz. Visa veya Mastercard logolu banka kartları da kart olarak kabul edilir; reddedilirse genellikle çevrim içi veya yurt dışı işlemleri banka uygulamasında etkinleştirilmemiştir ve nihai karar kartı veren bankaya aittir.

Kunavo fiyatları USD cinsindendir. Ödeme sayfasında Endonezya rupisi gösteriliyorsa kur Stripe tarafından belirlenir ve alıcının ödediği %2–4'lük dönüşüm ücretini içerir (Stripe Adaptive Pricing belgeleri, 3 Ekim 2026 tarihinde incelendi). USD ile ödeme yapmayı seçmek bu ücreti önler; yine de kendi bankanızın döviz kuru ve ücretleri geçerliliğini korur.

Bakiye hiçbir zaman süresi dolarak silinmez ve başarısız istekler bakiyeden düşülmez. Otomatik yükleme yalnızca kayıtlı kart veya Link ile çalışır. Kunavo herhangi bir vergi belgesi düzenlemez. Bu bakiye Claude Pro veya Max ödemelerinde kullanılamaz. Tüm Claude modellerinin ücret ayrıntıları ve Endonezya'dan ödeme yöntemi Claude API fiyatları sayfasında; yalnızca Claude Code için abonelik ile API key karşılaştırması Claude Code fiyatları sayfasında yer alır.

Yaklaşık ne kadar harcanır?

Her Claude Code isteği konuşma bağlamını yeniden gönderir; ancak istekten isteğe aynı kalan başlangıç bölümü çok daha ucuz önbellek okuma tarifesiyle ücretlendirilir. Aşağıdaki hesap, yazılı varsayımlara dayalı salt token aritmetiğidir; ölçüm sonucu veya üst sınır değildir:

  • tek istek = 40.000 girdi token'ı; 36.000 (90) önbellekten okunur, kalan 4.000 önbelleğe yazılır;
  • tek istek 1.000 çıktı token'ı üretir;
  • tek oturum = 50 istek; arka plandaki Claude Haiku 4.5 çağrıları dahil değildir;
  • önbellek okuma tarifesi 10%, önbellek yazma tarifesi ise girdi tarifesinin 1,25 katıdır (Kunavo'da Claude Sonnet 5 oranı; tablodaki her model kendi oranını kullanır).
Modelİstek başınaTek oturum (50 istek)Önbellek kullanılmadığında tek oturum
Claude Sonnet 5$0,019$0,95$3,15
Claude Opus 5.5$0,033$1,65$6,30

Gerçek rakamınız bağlamın uzunluğuna, önbelleğin ne sıklıkla kullanıldığına, yanıtın uzunluğuna ve görev değiştirirken konuşmanın /clear ile temizlenip temizlenmediğine göre artıp azalır. Anthropic'in maliyet belgelerine göre Claude Code'un arka plan işlemleri genellikle oturum başına 0,04 $'ın altındadır (3 Ekim 2026 tarihinde kontrol edildi). Tam ücretler fiyatlandırma sayfasında yer alır; kendi kullanım düzeninizi tahmin etmek için Claude token maliyeti hesaplayıcısını (İngilizce) kullanabilirsiniz.

Claude Code'u günlük kullanma

Terminal
cd ~/proyek-saya   # Claude Code bekerja di folder tempat ia dijalankan
claude              # mulai sesi
claude -c           # lanjutkan percakapan terakhir di folder ini
  • “bu projenin yapısını açıkla” veya “giriş sayfasındaki hatayı düzelt” gibi normal bir dille istekte bulunun. Claude Code dosyaları okur ve bir şeyi değiştirmeden veya çalıştırmadan önce izin ister.
  • Görev değiştirirken /clear kullanın: eski geçmiş yeniden gönderilmez, böylece istek başına token sayısı azalır.
  • Model değiştirmek için /model kullanın. 4. adımdaki sabitlemeyle opus = claude-opus-5-5, sonnet = claude-sonnet-5 ve haiku = claude-haiku-4-5 olur.
  • Ağ geçidini ve key'i kontrol etmek için /status; maliyet tahmini için /usage kullanın (liste fiyatlarıyla; 5. adımdaki tabloya bakın).

Hata mesajları ve anlamları

MesajAnlamı ve yapılması gereken
The token '&&' is not a valid statement separatorCMD satırı PowerShell'de çalıştırılmış. irm … | iex kullanın.
'irm' is not recognized as an internal or external commandPowerShell satırı CMD'de çalıştırılmış. install.cmd satırını kullanın.
A parameter cannot be found that matches parameter name 'fsSL', 'bash' is not recognized as the name of a cmdletmacOS/Linux satırı PowerShell'de çalıştırılmış. PowerShell satırını kullanın.
Claude Code does not support 32-bit Windows“Windows PowerShell (x86)” açılmış. Normal “Windows PowerShell”i açın.
syntax error near unexpected token '<', 403İndirilen şey HTML sayfası veya hata kodu. VPN, proxy ve güvenlik duvarını kontrol edin; diğer yöntemler de aynı ana makineyi kullanır.
command not found: claude, 'claude' is not recognizedPATH yükleme klasörünü henüz içermiyor. Yeni bir terminal açın; Windows'ta 3. adımdaki PATH komutunu çalıştırın.
EBADENGINE (uyarı)Node.js sürümü 22'nin altında. Yükleme yine de çalışır, ancak Node.js'i güncelleyin.
claude native binary not installed (macOS, Linux)npm isteğe bağlı bağımlılıkları (--omit=optional, optional=false) veya yükleme betiklerini (--ignore-scripts) atlamış. Bu ayarı kaldırın ve yeniden yükleyin.
npm.ps1 cannot be loadedPowerShell yürütme ilkesi. 2. adımdaki Set-ExecutionPolicy komutunu çalıştırın veya bağımsız yükleyiciyi kullanın.
Giriş ekranı hâlâ görünüyorKey henüz okunmamış. Bunu yalnızca proje ayarlarına değil, shell'e veya ~/.claude/settings.json dosyasına kaydedin ve yeni bir terminal açın.
401Key reddedildi. sk-kn- key'inin boşluk olmadan eksiksiz kopyalandığını, /app/keys bölümünde silinmediğini ve ANTHROPIC_AUTH_TOKEN içinde bulunduğunu kontrol edin.
404ANTHROPIC_BASE_URL /v1 ile bitiyor veya istenen model Kunavo'da bulunmuyor (genellikle model değişkeni doldurulmadığı için).

Sınırlamalar

  • Yalnızca kart, Link veya Apple Pay/Google Pay ile ödeme yapılabilir. QRIS, GoPay, OVO, DANA, ShopeePay, sanal hesap veya banka havalesi yoktur; otomatik yükleme yalnızca kayıtlı kart veya Link ile yapılır.
  • Kunavo herhangi bir vergi belgesi düzenlemez.
  • Bu, abonelik değil token başına ücretlendirilen bir API'dir; Claude Pro veya Max değildir. API key ile Remote Control ve sesle dikte kullanılamaz, /fast devre dışıdır ve MCP tool search varsayılan olarak kapalıdır.
  • 3 Ekim 2026 itibarıyla Sonnet 5.5 Kunavo'da henüz kullanılamamaktadır; model sabitlenmezse varsayılan takma ad 404 ile sonuçlanabilir.
  • Claude Code belgeleri Endonezce olarak mevcuttur; ancak Kunavo entegrasyon belgeleri ve bu kılavuzun İngilizce sürümü (Install Claude Code) henüz Endonezce olarak mevcut değildir.

Sık sorulan sorular

Dizüstü bilgisayara Claude Code'u yüklemek için hangi komut kullanılır?

Terminale bağlıdır. macOS, Linux veya WSL'de: curl -fsSL https://claude.ai/install.sh | bash. Windows PowerShell'de: irm https://claude.ai/install.ps1 | iex. Command Prompt (CMD)'de: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Üçü de Node.js gerektirmeyen ve kendini güncelleyen resmi bağımsız yükleyicilerdir. Ardından yeni bir terminal açıp claude --version yazın; bir sürüm numarası görünürse kurulum tamamlanmıştır.

Windows'ta Claude Code'u WSL üzerinden mi yoksa Run as Administrator ile mi kurmak gerekir?

Gerekmez. Endonezce resmi belgelere göre Claude Code, yönetici yetkisi olmadan ve Git for Windows yalnızca isteğe bağlı olacak şekilde, normal PowerShell veya CMD üzerinden doğrudan Windows'ta çalışır. WSL 2 yalnızca projeniz Linux araçlarına veya sandboxing'e ihtiyaç duyuyorsa yararlıdır. Sık gözden kaçan bir nokta: Başlat menüsünden “Windows PowerShell (x86)” seçeneğini açmayın; bu 32 bit işlemdir ve Claude Code çalışmayı reddeder.

Claude Code ücretsiz mi? Claude Pro aboneliği gerekli mi?

Programın kurulumu ücretsizdir, ancak kullanımı ücretlidir. Claude hesabıyla giriş yaparsanız Pro, Max, Team, Enterprise paketi veya Console hesabı gerekir; ücretsiz Claude.ai paketi Claude Code'u içermez. Diğer seçenek API key'dir: ANTHROPIC_BASE_URL=https://api.kunavo.com ve ANTHROPIC_AUTH_TOKEN değişkenlerini ayarladığınızda Claude Code giriş yapmadan açılır ve her token aylık ücret olmadan Kunavo'nun ön ödemeli bakiyesinden ödenir. Remote Control ve sesli dikte dahil değildir; çünkü ikisi de claude.ai hesabı gerektirir.

Claude Code Endonezya'dan kullanılabilir mi?

Evet. Endonezya, Claude.ai ve API için Anthropic'in desteklediği ülkeler listesindedir. Yükleyici veya Claude Code “App unavailable in region” gösteriyorsa bağlantınız genellikle başka bir ülkedeki VPN ya da proxy üzerinden çıkıyordur; önce bunu kapatıp yeniden deneyin.

Claude Code API key'i nereye konur ve ANTHROPIC_BASE_URL için /v1 kullanılır mı?

/v1 kullanılmaz; Claude Code /v1/messages yolunu kendisi ekler. /v1 ile sonuç /v1/v1/messages olur ve 404 hatası alınır. Değişkenleri ~/.zshrc veya ~/.bashrc'ye, PowerShell'de $PROFILE'a ya da kullanıcıya ait ~/.claude/settings.json dosyasındaki env bloğuna (Windows: %USERPROFILE%\.claude\settings.json) kaydedin. Projeye ait .claude/settings.json'a koymayın; bu dosya depoya dahil edilir. Kunavo, key'i Authorization: Bearer veya x-api-key header'ından kabul eder. ANTHROPIC_AUTH_TOKEN'ı öneriyoruz; doğrudan etkinleşir. ANTHROPIC_API_KEY ise etkileşimli modda bir kez onayladıktan sonra kullanılır.

Model neden ANTHROPIC_MODEL ve ANTHROPIC_DEFAULT_OPUS/SONNET/HAIKU_MODEL ile sabitlenmelidir?

Çünkü Claude Code'un yerleşik alias'ları Anthropic yeni model yayımladıkça değişir. Model yapılandırma belgelerine göre (3 Ekim 2026 tarihinde kontrol edildi), API kullanıcıları için varsayılan model ve opus alias'ı şu anda Opus 5.5'e, sonnet alias'ı ise Sonnet 5.5'e yönelir. 3 Ekim 2026 itibarıyla Sonnet 5.5 Kunavo'da henüz mevcut değildir; sonraki modeller de hemen sunulmayabilir, bu nedenle sabitleme olmadan request 404 alabilir. Sabitlemeyle ana oturum her zaman claude-sonnet-5; opus her zaman claude-opus-5-5 (Opus 5.5; Claude Code v2.1.280 veya üzeri gerekir, eski sürümler claude update ile güncellenebilir); sonnet, opusplan'ın yürütme aşaması ve sonnet modelini kullanan subagent'lar her zaman claude-sonnet-5; haiku ve arka plan görevleri her zaman claude-haiku-4-5 olur. Böylece hangi ücretin uygulandığını tam olarak bilirsiniz.

Claude Code'un claude.ai hesabı yerine API key kullandığından nasıl emin olunur?

Oturum içinde /status yazın. Doğruysa https://api.kunavo.com içeren bir “Anthropic base URL” satırı ve ANTHROPIC_AUTH_TOKEN'dan söz eden bir “Auth token” satırı görünür. Bunun yerine claude.ai hesabıyla birlikte “Login method” görünüyorsa değişkenler okunmamıştır: oturumdan çıkın, yeni bir terminal açın ve kaydettiğiniz dosyayı kontrol edin.

Bakiye yüklemek için QRIS, GoPay, OVO, DANA veya banka havalesi kullanılabilir mi?

Kullanılamaz. Kunavo bakiyesi yalnızca kart (Visa, Mastercard vb.; bu ağların logolarını taşıyan banka kartları dahil), Link veya cihazınız ve tarayıcınız yapılandırılmışsa Apple Pay/Google Pay ile yüklenebilir. QRIS, GoPay, OVO, DANA, ShopeePay, sanal hesap ve banka havalesi kullanılamaz. Kart reddedilirse bankacılık uygulamasında çevrim içi veya uluslararası işlemlerin etkin olup olmadığını kontrol edin; işlemin onaylanıp onaylanmayacağına kartı veren banka karar verir.

Minimum yükleme tutarı nedir? Bakiye sona erer mi? Vergi faturası var mı?

Minimum tutar $10; aylık ücret olmadan tek seferde ödenir ve bakiyenin kullanım süresi hiçbir zaman dolmaz. Başarısız istekler için bakiyeden kesinti yapılmaz. Fiyatlar USD cinsindendir; ödeme sayfası rupiah gösterirse kur Stripe tarafından sağlanır ve alıcının karşıladığı %2–4 dönüşüm ücretini zaten içerir. Otomatik yükleme yalnızca kayıtlı kart veya Link ile yapılabilir. Kunavo, vergi faturası dahil hiçbir vergi belgesi düzenlemez. Bu bakiye yalnızca Kunavo API'si içindir; Claude Pro veya Max ödemesinde kullanılamaz.