Windows, macOS ve Linux'ta Claude Code nasıl kurulur — aboneliksiz API anahtarı ve BLIK ile ödeme

Claude Code tek bir resmi komutla yüklenir (aşağıda macOS ve Linux, PowerShell ve CMD sürümleri yer alır). Anthropic, bağımsız yükleyiciyi önerir; npm ise Node.js 22 veya daha yeni bir sürüm gerektiren alternatiftir. Pro/Max aboneliği ve oturum açma olmadan yalnızca ANTHROPIC_BASE_URL=https://api.kunavo.com ( /v1 olmadan), API anahtarı içeren ANTHROPIC_AUTH_TOKEN ve modelleri sabitleyen dört değişkeni ayarlamanız yeterlidir. Böylece yalnızca bakiyenizden kullanılan tokenlar için ödeme yaparsınız; bakiyenizi BLIK ile zloti üzerinden, 10 USD tutarından başlayarak yüklersiniz. Son olarak anahtarın çalışıp çalışmadığını kontrol etmek için Claude Code'da /status yazın.

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

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

:: Windows – wiersz polecenia (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Komutları ve değişkenleri 3 Ekim 2026, Claude Code'un resmi kurulum belgelerinde ve ortam değişkenleri belgelerinde kontrol ettik. Bu belgelerin Lehçe sürümü yok. Fiyatları ve ödeme yöntemlerini 10 Ekim 2026 tarihinde kontrol ettik. Polonya, hem Claude.ai hem de API için Anthropic'in desteklenen ülkeler listesinde yer alıyor ( 3 Ekim 2026 tarihinde kontrol edildi).

Oturum açma mı, API anahtarı mı?

Claude Code yüklendikten sonra kimlik doğrulaması yapmalıdır. İki yol vardır; bu kılavuz bunlardan ikincisini ayrıntılı olarak açıklar:

Başlamadan önce

Yöntem 1: bağımsız yükleyici (önerilen)

Resmi belgelerde bu yöntemin sekmesi “Native Install (Recommended)” olarak adlandırılır. Komutları sayfanın başında bulabilirsiniz. macOS, Linux ve WSL'de bunun için install.sh içeren satır kullanılır. Windows PowerShell'de irm … | iex, CMD komut isteminde ise install.cmd içeren satırı kullanın. Bağımsız yükleme arka planda otomatik olarak güncellenir. Claude Code, Homebrew veya WinGet ile de yüklenebilir; ancak belgelere göre bu yüklemeler varsayılan olarak kendiliğinden güncellenmez. Bu nedenle paket yöneticisinde manuel olarak güncellemeniz gerekir:

# Homebrew – kanał stable; domyślnie nie aktualizuje się sam
brew install --cask claude-code

# WinGet (Windows) – domyślnie nie aktualizuje się sam
winget install Anthropic.ClaudeCode

Yüklemeden sonra yeni bir terminal penceresi açın; daha önce açılmış pencere güncellenen PATH değişkenini görmez. Ardından şunu kontrol edin:

claude --version   # wypisuje numer wersji, np. 2.1.280 (Claude Code)
claude doctor      # diagnostyka instalacji i ustawień, bez otwierania sesji

claude doctor oturum açmaz. Yalnızca yükleme durumunu ve ayar dosyalarının tanılamasını görüntüler. Böylece yükleme sorununu yapılandırma sorunundan en hızlı şekilde ayırt edebilirsiniz.

İndirme başarısız olduğunda

Terminalde syntax error near unexpected token '<' veya curl: (22) The requested URL returned error: 403 görünüyorsa, resmi kurulum sorunları sayfasına göre ( 3 Ekim 2026 tarihinde kontrol edildi) kurulum adresi betik yerine bir HTML sayfası veya hata kodu döndürmüştür. App unavailable in region yazan sayfa, belgelere göre Claude Code'un ülkenizde kullanılamadığı anlamına gelir. Ancak Polonya desteklenen ülkeler listesinde yer alıyor; bu nedenle bu yazıyı Polonya'da görüyorsanız bağlantının VPN veya proxy üzerinden geçip geçmediğini kontrol edin. İçeriksiz bir 403 yanıtı, indirmeyi engelleyen bir şirket proxy'sinden veya güvenlik duvarından da kaynaklanabilir. Belgeler, diğer kurulum yöntemleri de aynı sunuculara bağlandığından önce ağ bağlantısını kontrol etmeyi öneriyor. Başka bir ağdan deneyin veya yöneticinizden bu adreslerin engelini kaldırmasını isteyin.

Yöntem 2: npm (Node.js 22 veya daha yeni)

npm, resmi belgelerde açıklanan yöntemlerden biri olmaya devam ediyor. Paket Node.js 22 veya daha yenisini gerektirir. Bazı Lehçe kılavuzlarda hâlâ artık güncel olmayan Node.js 18 belirtiliyor. Daha eski Node.js sürümünde npm EBADENGINE uyarısını verir ancak kurulumu durdurmaz; paket çalışma zamanında Node.js kullanmayan yerleşik bir program indirdiği için claude çalışır. Node.js yüklü değilse nodejs.org sitesinden 22 veya daha yeni sürümü yükleyin.

node -v                                    # potrzebna wersja v22 lub nowsza
npm install -g @anthropic-ai/claude-code   # bez sudo

# aktualizacja: @latest, a nie npm update -g
npm install -g @anthropic-ai/claude-code@latest

• sudo npm install -g kullanmayın. Belgeler bunun izin sorunlarına yol açtığı ve güvenlik riski oluşturduğu konusunda uyarır.
• @latest ile güncelleyin. Güncelleme için npm install -g @anthropic-ai/claude-code@latest, npm update -g kullanın.
• İsteğe bağlı bağımlılıkları atlamayın. Doğru program, platformunuz için @anthropic-ai/claude-code-* paketi olarak isteğe bağlı bir bağımlılık şeklinde yüklenir. --omit=optional bayrağıyla veya .npmrc içinde optional=false kullanıldığında macOS ya da Linux kurulumu claude native binary not installed mesajıyla sonlanır.

Windows'ta Claude Code: PowerShell, CMD, WSL ve PATH

Windows'ta iki farklı yükleme komutu vardır ve seçim yalnızca terminale bağlıdır. Satır PS C:\Users\TwojaNazwa> ile başlıyorsa PowerShell kullanıyorsunuzdur. Yalnızca C:\Users\TwojaNazwa>, PS olmadan görüyorsanız bu CMD komut istemidir. Belgelere göre terminali yönetici olarak çalıştırmanız gerekmez; ancak bazı kılavuzlar bunu önerir.

En yaygın hata, komutu yanlış terminale yapıştırmaktır. CMD satırını PowerShell'e yapıştırmak The token '&&' is not a valid statement separator hatasını verir. PowerShell satırını CMD'ye yapıştırmak 'irm' is not recognized as an internal or external command hatasını verir. Lehçe Windows'ta aynı ileti şöyledir: “irm” iç veya dış komut, çalıştırılabilir program ya da toplu iş dosyası olarak tanınmıyor. Buna karşılık macOS'taki curl … | bash satırını PowerShell'e yapıştırmak A parameter cannot be found that matches parameter name 'fsSL' veya 'bash' is not recognized as the name of a cmdlet hatasıyla sonuçlanır. Bu durumların her birinde terminalinize uygun satırı kullanmanız yeterlidir.

Başlat menüsünde iki giriş vardır: “Windows PowerShell” ve “Windows PowerShell (x86)”. İkincisi 32 bitlik bir işlem olarak çalıştığından 64 bitlik bir bilgisayarda bile Claude Code does not support 32-bit Windows hatasıyla sonuçlanır. Sonunda (x86) ibaresi olmayan girişi açın.

Git for Windows isteğe bağlıdır ancak önerilir. Yüklüyse Claude Code komutları birlikte gelen Git Bash üzerinden, yüklü değilse PowerShell üzerinden çalıştırır. Git yüklü olduğu hâlde Claude Code Git Bash'i bulamıyorsa, ~/.claude/settings.json dosyasının env bloğunda bash.exe yolu için CLAUDE_CODE_GIT_BASH_PATH değişkenini ayarlayın. Belgelerdeki örnek yol: C:\Program Files\Git\bin\bash.exe.

WSL'yi seçerseniz macOS ve Linux satırını WSL terminalinde çalıştırın ve claude komutunu da PowerShell veya CMD'de değil, burada başlatın.

Komut dosyası yürütme ilkesi hatası (PowerShell'de npm)

npm ile yükleme veya çalıştırma sırasında görülen npm.ps1 cannot be loaded because running scripts is disabled on this system iletisi, PowerShell yürütme ilkesinin npm'nin oluşturduğu .ps1 başlangıç komut dosyasını engellediği anlamına gelir. Belgelere göre geçerli kullanıcının yerel komut dosyalarını çalıştırmasına izin verebilir (aşağıdaki komut), npm.cmd ve claude.cmd kullanabilir ya da PowerShell için bağımsız yükleyiciye geçebilirsiniz.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Yüklemeden sonra “claude” komutu tanınmıyor

command not found: claude veya 'claude' is not recognized, yükleme dizininin PATH içinde bulunmadığı anlamına gelir. Bağımsız yükleyici programı macOS ve Linux'ta ~/.local/bin/claude, Windows'ta ise %USERPROFILE%\.local\bin\claude.exe konumuna yerleştirir. Önce yeni bir terminal açın. Windows'ta hâlâ çalışmıyorsa belgelerde gösterildiği gibi PowerShell'de yolu kontrol edip ekleyin:

# 1. Sprawdź, czy katalog instalacji jest już w PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Brak wyniku? Dopisz go do PATH użytkownika, zamknij i otwórz terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. W nowym terminalu
claude --version

Oturum açma yerine API anahtarı (abonelik olmadan)

ANTHROPIC_BASE_URL, Claude Code'un yerleşik bir değişkenidir. Resmi belgelere göre API uç noktasını geçersiz kılarak istekleri bir proxy veya ağ geçidi (gateway) üzerinden yönlendirir. Bu nedenle Claude Code'u Anthropic Messages API ile uyumlu bir hizmete bağlamak, Anthropic tarafından öngörülen bir yapılandırmadır. Eklentiye veya değiştirilmiş programa ihtiyacınız yoktur. macOS ve Linux'ta değişkenleri kabuk yapılandırma dosyasına (~/.zshrc veya ~/.bashrc) ekleyin:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # sama domena, bez /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 yapılandırmayı tek bir PowerShell penceresinde kontrol edebilirsiniz:

# Działa tylko w tym oknie PowerShella – po zamknięciu znika
$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

Kalıcı olarak değişkenleri kullanıcı ayarları dosyasındaki env bloğuna, yani ~/.claude/settings.json dosyasına (Windows'ta %USERPROFILE%\.claude\settings.json) yazmak en iyisidir. Belgelere göre bu dosya tüm projeleriniz için geçerlidir. Dosyada başka ayarlar zaten varsa 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-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Bu altı satırın her birinde hata yapmak kolaydır:

• ANTHROPIC_BASE_URL yalnızca alan adıdır. Claude Code sonuna otomatik olarak /v1/messages ekler. Sonunda /v1 bulunursa istek /v1/v1/messages adresine gider ve 404 döndürür.
• ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY değil. ANTHROPIC_AUTH_TOKEN değeri, Bearer ön ekiyle Authorization başlığına gönderilir ve hemen çalışır. ANTHROPIC_API_KEY, x-api-key başlığına gönderilir ve etkileşimli modda bir kez onaylanması gerekir. O sırada reddederseniz anahtar sessizce yok sayılır. /config → Use custom API key yolundan yeniden etkinleştirebilirsiniz.
• ANTHROPIC_MODEL ana modeli seçer. Burada bu değer Claude Sonnet 5 (claude-sonnet-5) şeklindedir. Ad, Kunavo model listesinde göründüğüyle tam olarak aynı olmalıdır. Sonunda tarih bulunan eski adlar Kunavo tarafından tanınmaz.
• ANTHROPIC_DEFAULT_OPUS_MODEL ve ANTHROPIC_DEFAULT_SONNET_MODEL, opus ve sonnet takma adlarını sabitler. Model yapılandırmasına ilişkin resmi belgelere göre ( 3 Ekim 2026 tarihinde kontrol edildi), API kullanıcıları için varsayılan model ve opus takma adı Opus 5.5'i, sonnet takma adı ise Sonnet 5.5'i gösterir. Takma adlar zamanla değişir; sürüm, modelin tam adıyla veya bu iki değişken gibi değişkenlerle sabitlenir. Kunavo'da bulunmayan bir model sorgusu 404 döndürür. Anthropic'in yayımladığı bir sonraki Opus Kunavo'da hemen kullanıma sunulmayabileceğinden, opus takma adını Claude Opus 5.5 değerine (claude-opus-5-5) sabitliyoruz. Opus 5.5 için Claude Code'un 2.1.280 veya daha yeni bir sürümü gerekir; eski sürümü claude update komutuyla güncelleyebilirsiniz. Sonnet 5.5 şu anda ( 3 Ekim 2026 itibarıyla) Kunavo'da kullanılamıyor; bu nedenle sonnet takma adı claude-sonnet-5 değerine sabitlenmezse /model sonnet, opusplan modundaki yürütme aşaması ve model: sonnet olarak ayarlanmış alt ajanlar 404 hatası alır.
• ANTHROPIC_DEFAULT_HAIKU_MODEL ayarını da sabitleyin. haiku takma adı Kunavo'nun desteklemediği bir kimlik ister: Claude Code 2.1.293 sürümünden itibaren Haiku 5.5, daha önce ise tarih içeren bir Haiku 4.5 kimliği. Bu değişken olmadan /model haiku ve model: haiku olarak ayarlanan alt ajanlar 404 hatası alır.
• ANTHROPIC_DEFAULT_HAIKU_MODEL arka plandaki görevleri de destekler. Belgelere göre bu değişken haiku takma adı ve arka planda çalışan işlevler için modeli seçer. Kunavo'da Claude Haiku 4.5, girişte milyon token başına 0,70 USD, çıkışta milyon token başına 3,50 USD tutarındadır. Ana model Claude Sonnet 5, 1,40 USD / 7,00 USD (Anthropic fiyat listesi: 2,00 USD / 10,00 USD); Claude Opus 5.5 ise 2,80 USD / 14,00 USD tutarındadır (milyon token başına giriş / çıkış).

Anahtarı projeye ait .claude/settings.json dosyasına yazmayın. ağ geçidine bağlanma belgelerine göre bu dosya depoya girer ve dolayısıyla depoyu klonlayan herkesin eline geçer. Öncelik sırasını da göz önünde bulundurun. Aynı değişken hem kabukta hem de ayar dosyasının env bloğunda tanımlıysa, çoğu oturumda ayar dosyasındaki değer geçerlidir. Ayar dosyasındaki model anahtarı için ayrı bir kural vardır: ANTHROPIC_MODEL değişkeni buna öncelik taşır, model ise yalnızca değişken tanımlı değilse kullanılır. Kabuktaki değişiklik etkili olmuyorsa önce ayar dosyasını kontrol edin. VS Code için Claude Code uzantısında değişkenler, VS Code'un kendi kullanıcı ayarlarında bulunan claudeCode.environmentVariables bölümünde ayarlanır.

İlk çalıştırma ve /status

Ağ geçidine bağlanma belgelerine göre (3 Ekim 2026 tarihinde kontrol edildi), ANTHROPIC_AUTH_TOKEN ayarlandığında claude komutu oturumu giriş ekranı olmadan hemen açar. Değişken hemen etkinleşir ve ANTHROPIC_API_KEY için olduğu gibi onaylanması gerekmez. Bunun yerine giriş ekranını görüyorsanız Claude Code anahtarı okumamıştır.

Anahtar, Claude Code'un ilk yapılandırmadan önce okuyacağı yerde olmalıdır; yani kabukta export komutuyla veya kullanıcının ~/.claude/settings.json dosyasındaki env bloğunda ayarlanmalıdır. Etkileşimli modda proje kapsamındaki env bloğu, .claude/settings.json veya .claude/settings.local.json dosyasından, yalnızca ilk çalıştırma sihirbazından ve klasöre güven sorusundan sonra etkinleşir. Anahtar yalnızca proje ayarlarında bulunuyorsa ilk başlatmada yine de oturum açma ekranını görürsünüz.

Oturumda /status yazın ve şu iki satırı kontrol edin:

• Anthropic base URL, yalnızca ağ geçidi adresi ayarlandığında görünür. https://api.kunavo.com değerini göstermelidir. Bu satır yoksa ANTHROPIC_BASE_URL oturuma ulaşmamıştır.
• Auth token, ANTHROPIC_AUTH_TOKEN adıyla görünüyorsa API anahtarının çalıştığı, claude.ai oturum açma bilgilerinin kullanılmadığı anlamına gelir. claude.ai hesabının bulunduğu Login method görüyorsanız değişken çalışmamıştır.

Claude Code'u başlatmadan önce adresi ve anahtarı, resmi belgelerdeki yöntemle de kontrol edebilirsiniz. Bu yöntem, 1 çıkış tokenı isteyen ve bakiyeden sembolik bir tutar düşen bir istek göndermeye dayanır. Komut değişkenleri geçerli kabuktan okur; bu nedenle anahtar ayar dosyasındaysa bile önce bu terminalde export komutuyla değişkenleri ayarlayın. {"id":"msg_ ile başlayan JSON yanıtı, adresin ve anahtarın çalıştığını gösterir. 401 kodu, anahtarın reddedildiği anlamına gelir.

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'de aynı kontrol şu şekilde görünür. Her şey çalışıyorsa yanıtta id alanını görürsünüz; değeri msg_ ile başlar:

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 farklı çalışan özellikler

• Remote Control ve sesli dikte kullanılamaz. Belgelere göre bunlar claude.ai kimliği gerektirir ve ANTHROPIC_AUTH_TOKEN etkin olduğunda çalışmaz. 2.1.196 sürümünden itibaren ANTHROPIC_BASE_URL, api.anthropic.com dışında bir ana bilgisayarı gösterdiğinde Remote Control da devre dışı bırakılır.
• /fast hızlı modu devre dışı olarak gösterir. Belgelere göre yalnızca bearer token bulunduğunda Claude Code hızlı modu devre dışı kabul eder ve kullanılabilirlik sorgusu göndermez.
• MCP araçlarını arama varsayılan olarak devre dışıdır. Bu durum, ANTHROPIC_BASE_URL Anthropic dışında bir ana bilgisayarı gösterdiğinde gerçekleşir.
• /context içindeki sayılar tahminidir. Kunavo /v1/messages/count_tokens uç noktasını sunmaz. ağ geçidi uyumluluğu belgelerine göre ( 3 Ekim 2026 tarihinde kontrol edildi), Claude Code bu durumda karakter sayısına göre tokenları yerel olarak hesaplar.

Entegrasyonun tam açıklamasını Claude Code entegrasyonu belgelerinde (İngilizce), bu kılavuzun İngilizce sürümünü ise Install Claude Code makalesinde bulabilirsiniz.

BLIK ile ödeme: bakiye yükleme ve API anahtarı

Anthropic'in web sitesi üzerinden satın alınan Claude abonelikleri yalnızca kredi veya banka kartıyla ödenebilir (Claude faturalandırma SSS, 3 Ekim 2026 tarihinde kontrol edildi). Pro veya Max için BLIK ile ödeme yapılamaz. Kunavo'da BLIK, API'nin ön ödemeli bakiyesini yükler; yukarıdaki gibi bir anahtar ayarlandığında Claude Code token ücretlerini bu bakiyeden öder. Tüm ödeme adımları Claude için BLIK ile ödeme kılavuzunda açıklanıyor; kısaca şöyle:

1. E-posta veya Google hesabı üzerinden Kunavo hesabı oluşturun. Kayıt sırasında kart bilgisi vermeniz gerekmez.
2. Rozliczenia (Billing) sekmesinden yükleme tutarını seçin. Minimum tutar 10 USD ve aylık ücret yoktur. Daha yüksek tutarlarda bonus alırsınız: 100 USD → bakiyede 110 USD, 1000 USD → bakiyede 1200 USD ve 5000 USD → bakiyede 6250 USD.
3. Stripe ödeme sayfasında tutar zloti cinsinden gösterilir. BLIK'i seçin, bankacılık uygulamanızda altı haneli bir kod oluşturun, kodu girin ve ödemeyi uygulamada onaylayın. Stripe belgelerine göre ( 3 Ekim 2026 tarihinde kontrol edildi), BLIK kodu 2 dakika geçerlidir ve ödeme başladıktan sonra onaylamak için 60 saniyeniz vardır.
4. Klucze API sekmesinden sk-kn- ile başlayan bir anahtar oluşturun. Anahtar yalnızca bir kez görüntülenir; bu nedenle hemen kaydedin ve ANTHROPIC_AUTH_TOKEN içine yazın.

Zloti cinsinden ödeme sayfasında BLIK'in yanı sıra kartlar (Visa, Mastercard), desteklenen cihazlarda Apple Pay ve Google Pay ile Link de bulunur. Przelewy24, PayU, PayPal veya sıradan banka havalesi yoktur. Fiyatlar dolar olarak belirlenir ve Stripe bunları zlotiye çevirir. Stripe'ın Adaptive Pricing belgelerine göre ( 3 Ekim 2026 tarihinde kontrol edildi), döviz kuru, alıcının ödediği %2–4 oranında bir çevrim ücreti içerir. Dolar cinsinden kartla ödeyerek bu ücretten kaçınabilirsiniz; ancak bu durumda bankanızın döviz kuru ve ücretleri geçerli olur. BLIK yalnızca zloti ile çalışır. Zloti cinsinden kesin tutarı, onaylamadan önce ödeme sayfasında görebilirsiniz.

BLIK yalnızca manuel yüklemede çalışır. Otomatik yükleme için kayıtlı bir kart veya Link gerekir. Bakiye süresi dolmaz ve başarısız istekler için ödeme yapmazsınız. Kunavo KDV faturası düzenlemez; yükleme geçmişini Rozliczenia (Billing) sekmesinde bulabilirsiniz. Bunun Claude Pro veya Max ücreti değil, Kunavo API bakiyesi yüklemesi olduğunu unutmayın.

Ücreti nedir (örnek hesaplama)

Claude Code'da tokenlar için ödeme yaparsınız. Her istekte Claude Code konuşmanın tüm bağlamını yeniden gönderir; ancak bağlamın tekrarlanan başlangıcı önbellekten okuma tarifesi üzerinden ücretlendirilebilir. Aşağıda tokenlar üzerinden örnek bir hesaplama yer alır. Bu bir ölçüm veya maliyet üst sınırı değildir. Tüm varsayımlar belirtilmiştir:

• her istek 40.000 giriş tokenı içerir; bunların 36.000'si (90%) önbellekten okuma olarak, kalan 4000 ise önbelleğe yazma olarak ücretlendirilir;
• her istek 1000 çıkış tokenı döndürür;
• tek bir çalışma oturumunda, arka planda Claude Haiku 4.5 çağrısı olmadan bu tür 50 istek bulunur;
• Kunavo'da önbellekten okuma, giriş tarifesinin 10% kadarı; önbelleğe yazma ise giriş tarifesinin 1,25 katı tutarındadır. Bunlar Claude Sonnet 5 için geçerli oranlardır; listedeki her model kendi oranlarına göre hesaplanır.

Gerçek maliyet; bağlamın uzunluğuna, önbellek isabetlerinin sayısına, yanıtın uzunluğuna ve görevler arasında konuşmayı /clear komutuyla temizleyip temizlemediğinize bağlıdır. Tüm modellerin tarifelerini fiyatlandırma sayfasında bulabilirsiniz. Kendi kullanımınızı Claude token maliyeti hesaplayıcısıyla (İngilizce) tahmin edebilirsiniz. Aboneliğin ne zaman, API'nin ne zaman daha avantajlı olduğunu Claude Code'un maliyeti nedir kılavuzu açıklar.

En yaygın hatalar

Sınırlamalar

• Kunavo KDV faturası düzenlemez.
• BLIK yalnızca manuel yüklemede çalışır. Otomatik yükleme için kayıtlı bir kart veya Link gerekir.
• Bu, Claude Pro veya Max aboneliği değil, token başına ücretlendirilen bir API'dir. API anahtarıyla Remote Control ve sesli dikte çalışmaz, /fast modu devre dışıdır ve MCP araçlarını arama varsayılan olarak kapalıdır.
• Kunavo şu anda (3 Ekim 2026 tarihi itibarıyla) Sonnet 5.5'i sunmamaktadır; bu nedenle yukarıdaki yapılandırma sonnet takma adını claude-sonnet-5'ye sabitler. Modeller sabitlenmeden varsayılan takma adlar 404 döndürebilir. Claude Opus 5.5, opus takma adına sabitlenmiş olup Claude Code'un 2.1.280 veya daha yeni sürümünü gerektirir.
• Claude Code'un resmi belgeleri ve Kunavo entegrasyonu belgeleri yalnızca İngilizcedir.

Sık sorulan sorular