Claude Code kurulumu: Windows, macOS ve Linux'ta adım adım, aboneliksiz API anahtarı ve kartla ödeme

Kısa cevap: Claude Code, terminalinize uygun tek bir satırla kurulur. macOS, Linux ve WSL'de install.sh, Windows PowerShell'de irm … | iex, Komut İstemi'nde (CMD) install.cmd satırını çalıştırırsınız; üçü hemen aşağıda. Bu yol Node.js istemez, npm ile kurmak isterseniz Node.js 22 veya üstü gerekir. Kurulumdan sonra iki seçenek var: Claude hesabıyla giriş (Pro, Max, Team, Enterprise ya da Console; ücretsiz plan Claude Code'u kapsamıyor) ya da abonelik almadan bir API anahtarı. Anahtar yolunda ANTHROPIC_BASE_URL=https://api.kunavo.com (sonuna /v1 eklemeden), ANTHROPIC_AUTH_TOKEN ve modelleri sabitleyen üç değişkeni tanımlarsınız; oturumda /status anahtarın devrede olup olmadığını gösterir. Yalnızca harcanan token'lar ücretlenir. Bakiyeyi Visa veya Mastercard kartla, Apple Pay, Google Pay ya da Link ile en az 10 USD yüklersiniz; taksit ve Papara seçeneği yok.

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

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

:: Windows – Komut İstemi (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Bu satırları ve aşağıdaki değişken adlarını Claude Code'un kurulum ve gateway bağlantısı belgelerinden 3 Ekim 2026 tarihinde aldık. Anthropic bu belgeleri Türkçe yayımlamıyor; hata mesajlarını bu yüzden İngilizce asıllarıyla veriyoruz. Kunavo fiyatlarını ve ödeme yöntemlerini en son 3 Ekim 2026 tarihinde kontrol ettik. VPN ya da yurt dışı proxy'si aramanıza gerek yok: Anthropic'in desteklenen ülkeler sayfası Türkiye'yi hem Claude.ai hem API için sayıyor (kontrol: 3 Ekim 2026).

Hangi satır, hangi terminal?

Kurulumda takılanların çoğu komutta değil, terminalde yanılıyor. Aşağıdaki tablo ortamınızı doğru satırla eşleştiriyor. Windows kullanıyorsanız terminali nasıl tanıyacağınızı bir sonraki bölümde anlatıyoruz.

Sistem gereksinimleri

Resmi kurulum belgesinin istedikleri (3 Ekim 2026 itibarıyla):

• İşletim sistemi: macOS 13.0 ya da daha yeni; Windows 10 sürüm 1809 ve sonrası veya Windows Server 2019 ve sonrası; Linux tarafında Ubuntu 20.04, Debian 10 ve Alpine Linux 3.19 ya da daha yenisi.
• Donanım: en az 4 GB RAM ve x64 ya da ARM64 işlemci. 32 bit Windows desteklenmiyor.
• Kabuk: Bash, Zsh, PowerShell veya CMD.
• Node.js: yerel yükleyici için gereksiz; yalnızca npm yolunda 22 veya üstü.
• Hesap: giriş yapacaksanız Pro, Max, Team, Enterprise veya Console. API anahtarıyla ne abonelik ne giriş gerekir.

İnternette dolaşan Türkçe anlatımların bir kısmı bu listenin eski hâlini kopyalıyor: npm için Node.js 18, Linux için Ubuntu 18.04 ya da CentOS 7 yazanlar hâlâ var. Bugünkü belge en düşük sürüm olarak Node.js 22'yi ve Ubuntu 20.04'ü veriyor. “ABD çıkışlı sabit bir proxy olmadan her adım hata verir” uyarısı da Türkiye için geçerli değil; tersine, açık bir VPN kurulumu bölge hatasına düşürebilir (macOS ve Linux bölümündeki indirme hatalarına bakın).

Claude Code Windows kurulumu

Windows'ta yönetici yetkisine, WSL'e ya da Git'e ihtiyacınız yok. Resmi belge terminalin yönetici olarak açılmasını istemiyor; bazı Türkçe videolardaki “PowerShell'i yönetici olarak çalıştırın” adımını atlayabilirsiniz. Bilmeniz gereken tek şey hangi terminalde olduğunuz:

• İstem PS C:\Users\KullaniciAdi> gibi PS ile başlıyorsa PowerShell'desiniz: irm … | iex satırını kullanın.
• Başında PS yoksa, yalnızca C:\Users\KullaniciAdi> görünüyorsa Komut İstemi'ndesiniz: install.cmd satırını kullanın.
• Başlat menüsündeki “Windows PowerShell (x86)” kaydını açmayın. 32 bitlik bir süreç olduğu için 64 bit bilgisayarda da Claude Code does not support 32-bit Windows hatasını verir; eki olmayan “Windows PowerShell”i seçin.

Satırı yanlış pencereye yapıştırmak Windows'taki hataların başında geliyor ve mesajlar bunu açıkça söylemiyor. PowerShell'e yapıştırılan CMD satırı The token '&&' is not a valid statement separator ile döner. CMD'ye yapıştırılan PowerShell satırı Türkçe Windows'ta “'irm' iç ya da dış komut, çalıştırılabilir program ya da toplu iş dosyası olarak tanınmıyor.” der (İngilizce sistemde 'irm' is not recognized as an internal or external command). macOS'un curl … | bash satırını PowerShell'de denerseniz A parameter cannot be found that matches parameter name 'fsSL' ya da 'bash' is not recognized as the name of a cmdlet görürsünüz; Türkçe sistemde bu metinler Türkçe çıkabilir. Üç durumda da çözüm aynı: bulunduğunuz terminalin satırını alın.

Git for Windows ve WSL gerekli mi?

İkisi de isteğe bağlı. Git for Windows kuruluysa Claude Code kabuk komutlarını onunla gelen Git Bash'te çalıştırır, değilse PowerShell aracına geçer; belge Git'i öneriyor ama şart koşmuyor. Git kurulu olduğu hâlde Git Bash bulunamıyorsa ~/.claude/settings.json dosyasının env bloğunda CLAUDE_CODE_GIT_BASH_PATH değişkenine bash.exe dosyasının tam yolunu verin (belgedeki örnek: C:\Program Files\Git\bin\bash.exe).

WSL'i seçmek için iki neden var: Linux araçlarına ihtiyaç duymak ya da komutları korumalı alanda (sandbox) çalıştırmak istemek. Yerel Windows kurulumunda sandbox yok:

WSL'de kalacaksanız kurulumu da kullanımı da WSL terminalinde yapın: macOS/Linux satırı orada çalışır, claude da oradan açılır.

“claude” komutu bulunamıyor

Kurulum bittiği hâlde 'claude' is not recognized (macOS ve Linux'ta command not found: claude) görüyorsanız, büyük ihtimalle kurulumdan önce açılmış bir pencerede çalışıyorsunuz: yükleyici PATH değişkenini günceller ama eski terminal bunu görmez. Önce terminali kapatıp yeniden açın. Program Windows'ta %USERPROFILE%\.local\bin\claude.exe, macOS ve Linux'ta ~/.local/bin/claude konumunda durur. Windows'ta yeni pencere de işe yaramazsa klasörü belgedeki komutlarla kullanıcı PATH değişkeninize ekleyin:

# 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 cannot be loaded

Bu mesaj yalnızca npm yolunda çıkar: npm, PowerShell için bir .ps1 başlatıcı yazar ve sistemin betik yürütme ilkesi (execution policy) onu engeller. Belge üç çıkış yolu veriyor: komutları npm.cmd ve claude.cmd adlarıyla çalıştırmak, PowerShell'de yerel yükleyiciye geçmek ya da yalnızca kendi kullanıcınız için yerel betiklere izin vermek:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

macOS ve Linux'ta kurulum

Yukarıdaki install.sh satırı resmi belgede “Native Install (Recommended)” sekmesinde duruyor ve WSL'de de aynen çalışıyor. Bu yolla kurulan Claude Code yeni sürümleri arka planda kendisi indirir. Paket yöneticisi kullanmayı tercih ederseniz Homebrew ve WinGet de resmî seçenekler; ancak belgeye göre bu kurulumlar varsayılan olarak kendini güncellemez, yeni sürümü paket yöneticisi üzerinden siz alırsınız:

# 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

Betik yerine HTML ya da 403 gelirse

syntax error near unexpected token '<' mesajı, bash'e betik yerine bir HTML sayfasının gittiğini gösterir; curl: (22) The requested URL returned error: 403 ise sunucunun indirmeyi reddettiğini. Kurulum sorunları belgesi (kontrol: 3 Ekim 2026) ikisini de yükleyici adresinin betik döndürmemesine bağlıyor. Sayfada App unavailable in region yazıyorsa istek, belgeye göre Claude Code'un sunulmadığı bir ülkeden gelmiş görünüyor. Türkiye listede olduğuna göre bu mesajı Türkiye'den alıyorsanız trafiğiniz büyük ihtimalle bir VPN ya da proxy üzerinden başka bir ülkeye çıkıyordur; kapatıp yeniden deneyin. İçeriksiz bir 403 genellikle şirket proxy'sinden ya da güvenlik duvarından gelir: başka bir ağdan deneyin veya BT ekibinizden bu adrese izin vermesini isteyin.

npm ile kurulum: Node.js 22 şart

npm yolu kaldırılmadı, resmi belgede hâlâ anlatılıyor; ama paketin istediği sürüm artık Node.js 22 ve üstü. node -v daha eski bir sürüm gösteriyorsa npm kurulumu durdurmaz, yalnızca bir EBADENGINE uyarısı basar. Yine de en temizi Node.js'i nodejs.org üzerinden 22 veya üstüne yükseltmek.

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

Bu yolda üç alışkanlık sorun çıkarıyor:

• sudo ile kurmak. Belge sudo npm install -g için izin sorunları ve güvenlik riski konusunda uyarıyor.
• npm update -g ile güncellemek. Doğrusu npm install -g @anthropic-ai/claude-code@latest.
• İsteğe bağlı bağımlılıkları kapatmak. Asıl çalıştırılabilir dosya, platforma özel bir @anthropic-ai/claude-code-* paketiyle isteğe bağlı bağımlılık olarak gelir. --omit=optional bayrağı ya da .npmrc içindeki optional=false bu paketi atlatır: kurulum hatasız biter, ama macOS ve Linux'ta claude açılırken claude native binary not installed der.

Kurulum çalıştı mı?

Hangi yolu seçtiyseniz yeni bir terminal açıp şu iki komutu çalıştırın:

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

claude --version bir sürüm numarası yazıyorsa program yerinde demektir. claude doctor ise oturum açmadan kurulumun durumunu ve ayar dosyalarındaki sorunları listeler; sonraki adımda bir şey ters giderse sorunun kurulumda mı yoksa yapılandırmada mı olduğunu buradan ayırırsınız.

Abonelik olmadan: Claude Code'a API anahtarı tanımlamak

claude ilk açıldığında kimlik ister. Claude planınız varsa giriş yapıp devam edersiniz; planınız yoksa ya da sabit aylık ücret yerine kullandığınız kadar ödemek istiyorsanız Claude Code'u bir API anahtarıyla çalıştırırsınız. İki yolun farkı:

Anahtar yolu Anthropic'in öngördüğü bir yapılandırma: ANTHROPIC_BASE_URL Claude Code'un yerleşik değişkeni ve resmi gateway belgesi, Claude Code'u bir proxy ya da gateway arkasında çalıştırmayı bu değişkenle anlatıyor. Eklenti, yama ya da değiştirilmiş bir istemci kurmazsınız. macOS ve Linux'ta beş satırı kabuk dosyanıza (~/.zshrc veya ~/.bashrc) ekleyin:

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
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Windows'ta ayarları kalıcı yapmadan önce tek bir PowerShell oturumunda deneyin; pencere kapanınca değişkenler de gider:

# 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"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Her terminalde geçerli olsun istiyorsanız aynı değerleri kullanıcı ayar dosyasının env bloğuna yazın. Belgeye göre bu dosya bütün projelerinize uygulanır; Windows'taki yeri %USERPROFILE%\.claude\settings.json. Bazı yapay zekâ özetlerinde geçen %APPDATA%\Claude\settings.json resmi belgedeki yol değil. Dosya zaten varsa içindekileri silmeden yalnızca env bloğunu ekleyin:

{
  "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",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Beş değişken ve dikkat edilecekler

ANTHROPIC_AUTH_TOKEN mı, ANTHROPIC_API_KEY mı? Kunavo anahtarı iki başlıktan da kabul eder: Authorization: Bearer ve x-api-key. Fark Claude Code'un davranışında. ANTHROPIC_AUTH_TOKEN Bearer başlığına gider ve soru sormadan çalışır. ANTHROPIC_API_KEY ise x-api-key başlığına gider ve etkileşimli modda ilk seferde onayınızı ister; o soruya “hayır” derseniz anahtar uyarı vermeden yok sayılır, geri açmak için /config → Use custom API key yolunu bulmanız gerekir. Bu rehberde ANTHROPIC_AUTH_TOKEN kullanmamızın nedeni bu.

Modelleri neden sabitliyoruz? Model yapılandırma belgesine göre (kontrol: 3 Ekim 2026) API ile çalışan Claude Code, hiçbir şey ayarlanmamışsa varsayılan model ve opus takma adı için Opus 5.5'i, sonnet takma adı için Sonnet 5.5'i ister; Anthropic yeni model çıkardıkça bu takma adlar da kayar. Kunavo 3 Ekim 2026 itibarıyla Sonnet 5.5'i sunmuyor, dolayısıyla sabitlenmemiş bir sonnet isteği 404 ile döner. Claude Opus 5.5 Kunavo'da çalışıyor, ama tarifesi ($2,80 / $14,00) Claude Sonnet 5 tarifesinden ($1,40 / $7,00) yüksek; sabitlemezseniz farkında olmadan daha pahalı modelle çalışırsınız. Oturum içinde /model sonnet ile model değiştiriyorsanız ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 satırını da ekleyin.

Kunavo'daki tarifeler (girdi / çıktı, 1 milyon token başına): Claude Sonnet 5 $1,40 / $7,00 (Anthropic tarifesi: $2,00 / $10,00); Claude Opus 5 $3,50 / $17,50; arka plan işlerini üstlenen Claude Haiku 4.5 $0,70 / $3,50.

Anahtar nereye yazılmaz, hangi değer kazanır?

Projenin kendi .claude/settings.json dosyası anahtar için yanlış yer: gateway belgesi bu dosyanın depoya commit edildiğini hatırlatıyor, yani anahtar depoyu klonlayan herkese gider. Aynı değişken hem kabukta hem ayar dosyasının env bloğunda tanımlıysa çoğu durumda ayar dosyasındaki geçerli olur; kabukta değiştirdiğiniz bir değer etki etmiyorsa önce oraya bakın. Ayar dosyasındaki model anahtarı bu kuralın dışında: ANTHROPIC_MODEL değişkeni ondan önce gelir, model yalnızca değişken yoksa kullanılır. VS Code eklentisinde değişkenler, VS Code kullanıcı ayarlarındaki claudeCode.environmentVariables alanına girer.

İlk açılış ve /status kontrolü

Değişkenler doğru yerdeyse claude komutu giriş ekranını hiç göstermeden oturumu açar; gateway belgesi (kontrol: 3 Ekim 2026) ANTHROPIC_AUTH_TOKEN ayarlıyken davranışı böyle tarif ediyor. Karşınıza giriş ekranı çıkıyorsa Claude Code anahtarı görmemiştir. Sık rastlanan neden, anahtarın yalnızca proje ayarlarında durması: etkileşimli modda projenin .claude/settings.json ya da .claude/settings.local.json dosyasındaki env bloğu, ilk çalıştırma sihirbazı ve klasöre güven sorusu geçildikten sonra okunur. Anahtar, sihirbazdan önce okunan bir yerde olmalı: kabukta export, kullanıcı düzeyindeki ~/.claude/settings.json ya da yönetilen ayarlar (managed settings).

Oturum açıldığında /status yazın. İki satır yeterli bilgi verir:

• Anthropic base URL: yalnızca özel bir adres tanımlıysa görünür ve https://api.kunavo.com yazmalıdır. Satır hiç yoksa ANTHROPIC_BASE_URL oturuma ulaşmamıştır.
• Auth token: yanında ANTHROPIC_AUTH_TOKEN adı yazıyorsa istekler API anahtarıyla gidiyor. Onun yerine claude.ai hesabınızı gösteren bir Login method satırı varsa Claude Code hâlâ kayıtlı girişi kullanıyor; oturumu kapatın, yeni bir terminal açın ve değişkenleri nereye yazdığınızı kontrol edin.

Claude Code'u açmadan sınamak

Adresi ve anahtarı Claude Code'dan bağımsız olarak da deneyebilirsiniz. Resmi belgedeki yöntem, tek çıktı token'lık bir istek göndermek; bakiyenizden çok küçük bir tutar düşer. Komut değişkenleri o anki kabuktan okur, anahtar yalnızca ayar dosyasındaysa önce bu terminalde export edin. Yanıt {"id":"msg_ ile başlıyorsa adres ve anahtar sağlam; 401 anahtarın reddedildiğini gösterir.

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 karşılığı aşağıda; başarılıysa yanıtta msg_ ile başlayan bir id alanı olur:

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

API anahtarıyla neler değişir?

• Remote Control ve sesli dikte yok. Belgeye göre ikisi de claude.ai kimliği ister ve ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN ya da bir apiKeyHelper etkinken çalışmaz. v2.1.196'dan itibaren Remote Control, ANTHROPIC_BASE_URL Anthropic dışında bir sunucuyu gösterdiğinde de kapalı.
• /fast kapalı görünür. Belgeye göre yalnızca bir bearer token tanımlıyken Claude Code hızlı modun (fast mode) durumunu sormaz, kapalı varsayar.
• MCP araç araması varsayılan olarak devre dışı. MCP belgesi (kontrol: 3 Ekim 2026) özel bir ANTHROPIC_BASE_URL ayarını, tool search kullanılmayan yapılandırmalar arasında sayıyor.
• /context rakamları yaklaşıktır. Kunavo /v1/messages/count_tokens uç noktasını sunmuyor; bu durumda Claude Code, gateway uyumluluk belgesine göre (kontrol: 3 Ekim 2026) bağlam kullanımını karakter sayısından tahmin eder.

Entegrasyonun teknik ayrıntıları İngilizce Claude Code entegrasyon belgesinde; bu rehberin İngilizce karşılığı Install Claude Code.

Türkiye'den ödeme: kart, Apple Pay, Google Pay, Link

Burada ödediğiniz şey bir abonelik değil, Claude Code'un token başına harcadığı ön ödemeli API bakiyesi. Anthropic'in sitesinden alınan Pro ve Max ise yalnızca kredi veya banka kartıyla ödenebiliyor (Claude ücretli plan SSS, kontrol: 3 Ekim 2026). Kunavo'ya yaptığınız yükleme bu planların yerine geçmez ve onları ödemez. Adımlar:

1. Kunavo'ya kaydolun. E-posta adresi ya da Google hesabı yeterli; kayıtta kart bilgisi sorulmaz.
2. Billing sayfasında tutarı seçin. Alt sınır 10 USD; abonelik ya da aylık ücret yok. Yüksek tutarlarda bonus eklenir: 100 USD yükleyene 110 USD bakiye, 1.000 USD yükleyene 1.200 USD bakiye, 5.000 USD yükleyene 6.250 USD bakiye.
3. Stripe ödeme sayfası açılır. Kart (Visa, Mastercard), Apple Pay, Google Pay ya da Link'ten birini seçin; Apple Pay ve Google Pay yalnızca bunları destekleyen cihaz ve tarayıcılarda listelenir.
4. Ardından API Keys sayfasında sk-kn- ile başlayan bir anahtar üretin. Anahtar yalnızca bir kez gösterilir; kopyalayıp hemen ANTHROPIC_AUTH_TOKEN değerine yazın.

Tutar TL mi görünür, dolar mı?

Kunavo fiyatları dolar cinsinden; ödeme sayfasında hangi para biriminin gösterileceğine Stripe karar verir ve tutar TL olarak da çıkabilir. Stripe'ın Adaptive Pricing belgesi (kontrol: 3 Ekim 2026) Türkiye'yi desteklenen pazarlar arasında sayıyor ve bu çevrimde kura %2–4 arası, alıcının ödediği bir ücret eklendiğini yazıyor. Dolarla ödemeyi seçerseniz bu ücret olmaz; o zaman kartınızın bankası kendi döviz kurunu ve varsa yurt dışı işlem ücretini uygular. Para birimi hangisi olursa olsun, kesin tutarı onaylamadan önce ödeme sayfasında görürsünüz.

Taksit, Papara, havale ve Troy

• Taksit yok, ödeme tek çekim. Türk kartlarıyla yurt dışı sitelerden yapılan harcamalar sonradan da taksite bölünemiyor (enuygunfinans.com, kontrol: 3 Ekim 2026).
• Papara, havale/EFT ve PayPal yok. Ödeme sayfasında bu seçenekler çıkmaz.
• Troy: Stripe'ın desteklenen kart markaları sayfasında Troy geçmiyor (kontrol: 3 Ekim 2026). Visa ya da Mastercard logolu bir kartla ödeyin.
• Fatura yok. Kunavo e-Arşiv dahil hiçbir fatura düzenlemez; yüklemelerinizin dökümü Billing sayfasında durur.

Kart reddedilirse önce bankanızın mobil uygulamasına bakın: kartın internet alışverişine ve yurt dışı işlemlere açık olması gerekir. Otomatik yükleme yalnızca kayıtlı kart ya da Link ile kurulabilir. Bakiyenin son kullanma tarihi yoktur, başarısız istekler ücretlendirilmez. Bütün modellerin tarifeleri Claude API fiyatları rehberinde.

Bir çalışma oturumu kaça mal olur?

Anahtar yolunda maliyet tamamen token sayısına bağlı. Claude Code her istekte konuşmanın bağlamını baştan gönderir; bağlamın değişmeyen baş kısmı önbellekten okunduğunda ise çok daha düşük tarifeden sayılır. Aşağıdaki tablo bir ölçüm değil, açık varsayımlarla yapılmış bir hesap; üst sınır olarak da okunmamalı. Varsayımlar:

• istek başına 40.000 girdi token'ı; bunun 36.000 kadarı (%90) önbellekten okunuyor, kalan 4.000 kadarı önbelleğe yazılıyor;
• istek başına 1.000 çıktı token'ı;
• oturumda 50 istek; arka plandaki Claude Haiku 4.5 çağrıları hesaba katılmadı;
• Claude Sonnet 5 için önbellekten okuma girdi tarifesinin %10 kadarı, önbelleğe yazma ise 1,25 katı. Tablodaki her model kendi oranlarıyla hesaplandı.

Gerçek tutarı bağlamın uzunluğu, önbellek isabeti, yanıtların uzunluğu ve konu değiştirirken sohbeti temizleyip temizlemediğiniz belirler. Resmi maliyet belgesi (kontrol: 3 Ekim 2026) iki ayrıntı ekliyor: Claude Code siz bir şey yazmasanız da arka planda az miktarda token harcar, genellikle oturum başına 0,04 dolardan az; API anahtarında önbellek ömrü varsayılan olarak beş dakika, dolayısıyla daha uzun bir aradan sonraki ilk mesaj önbelleği ıskalar ve bağlamın tamamı yeniden işlenir. Konu değiştirirken /clear, uzun oturumlarda /compact bu maliyeti düşürür.

Tüm tarifeler fiyat sayfasında. Kendi kullanımınızı Claude token maliyet hesaplayıcısıyla (İngilizce) tahmin edebilirsiniz. Abonelik mi daha uygun, API mi, sorusunu Claude Code fiyatı rehberi ele alıyor.

Hata mesajları ve çözümleri

Bilmeniz gereken kısıtlar

• Kunavo fatura düzenlemez; e-Arşiv de yok.
• Ödeme tek çekim: taksit, Papara ve havale/EFT yok. Otomatik yükleme için kayıtlı kart ya da Link gerekir.
• Bu bir Claude Pro ya da Max aboneliği değil, token başına ödenen bir API. Anahtar yolunda Remote Control ve sesli dikte çalışmaz, /fast kapalı görünür, MCP araç araması varsayılan olarak devre dışıdır.
• Kunavo 3 Ekim 2026 itibarıyla Sonnet 5.5'i sunmuyor; modeller sabitlenmezse sonnet takma adı 404 döner.
• Claude Code'un resmi belgeleri ve Kunavo entegrasyon belgesi yalnızca İngilizce (kontrol: 3 Ekim 2026).

Sık sorulan sorular