Windows, Mac ve Linux'ta Claude Code kurulumu: aboneliksiz API anahtarı ve Satispay ile ödeme

Claude Code'u yüklemek için yalnızca bir komut yeterlidir; terminale göre değişir: macOS, Linux ve WSL'de install.sh içeren satır, PowerShell'de irm … | iex, Komut İstemi'nde install.cmd içeren satır. Anthropic'in önerdiği yöntem budur; npm de kullanılabilir, ancak Node.js 22 veya sonraki bir sürümü gerektirir. Claude'un ücretsiz planı Claude Code'u içermez; bu nedenle Pro veya üzeri bir abonelik ya da API anahtarı gerekir. Burada ikinci yolu izliyoruz: ANTHROPIC_BASE_URL=https://api.kunavo.com (/v1 olmadan), anahtar ANTHROPIC_AUTH_TOKEN, modelleri sabitleyen dört değişken ve son kontrol için /status. Kredi, $10 üzerinden euro ile yüklenir ve yalnızca kullandığınız tokenlar için ödeme yaparsınız.

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

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

:: Windows – Prompt dei comandi (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Bu komutların kaynağı: Claude Code belgeleri İtalyanca olarak da mevcut ve 3 Ekim 2026 tarihinde, özellikle kurulum ve LLM ağ geçidi sayfalarını yeniden inceledik. Kunavo fiyatları ve ödeme yöntemleri 10 Ekim 2026 itibarıyla günceldir. Anthropic, İtalya'da hem Claude.ai hem de API hizmeti sunuyor (desteklenen ülkeler, 3 Ekim 2026 tarihinde kontrol edildi).

Gerekenler

Resmî belgelerdeki (3 Ekim 2026 tarihinde kontrol edildi) gereksinimler düşük:

• macOS 13.0 veya üzeri; Windows 10 1809 veya üzeri ya da Windows Server 2019 veya üzeri; Ubuntu 20.04+, Debian 10+ veya Alpine Linux 3.19+.
• En az 4 GB RAM ve x64 veya ARM64 işlemci. 32 bit Windows desteklenmez.
• Bash, Zsh, PowerShell ve CMD arasından bir kabuk.
• Anthropic tarafından desteklenen bir ülkeden bağlantı: İtalya desteklenir.
• Node.js yalnızca npm'yi seçerseniz gerekir; bu durumda sürüm 22 veya üzeri olmalıdır.

Hangi komut, hangi terminalde

Yönetici hakları ve WSL gerekmez: resmî dokümantasyon, internetteki birden fazla rehber aksini öne sürse de bunu açıkça belirtir. Claude Code yüklendikten sonra arka planda kendini otomatik günceller. Paket yöneticisini tercih edenler Homebrew veya WinGet kullanabilir; ancak bu durumda güncellemeleri kendileri başlatır:

# Homebrew – canale stable; non si aggiorna da solo
brew install --cask claude-code

# WinGet (Windows) – non si aggiorna da solo
winget install Anthropic.ClaudeCode

Denemeden önce terminali kapatıp yeni bir terminal açın: yalnızca yeni bir pencere PATH değerini yeniden okur. Ardından doğrulayın. claude doctor ileride de işe yarar; oturum açmadan yüklemeyi ve ayarları kontrol eder ve sorunun hangisinde olduğunu hemen söyler.

claude --version   # stampa la versione, ad esempio 2.1.284 (Claude Code)
claude doctor      # diagnostica di installazione e impostazioni, senza aprire una sessione

İndirme engellendi: 403 veya betik yerine HTML sayfası

Komut dosyası ulaşmadığında terminal bunu açıkça belirtmez: bash, syntax error near unexpected token '<' hatasından yakınır (bir web sayfasını çalıştırmaya çalışıyordur) ya da curl curl: (22) The requested URL returned error: 403 hatasında durur. Kurulum sorunları hakkındaki resmî sayfa (İngilizce, 3 Ekim 2026 tarihinde kontrol edildi) iki durumu birbirinden ayırıyor. İndirilen sayfada App unavailable in region yazıyorsa sunucu, desteklenmeyen bir ülkeden bağlandığınızı sanıyordur: İtalya'dan bağlanırken bunun nedeni çoğunlukla yurt dışından çıkış yapan bir VPN veya proxy'dir. Metinsiz bir 403 hatası ise daha çok kurumsal bir proxy'den ya da güvenlik duvarından kaynaklanır. Kurulum yöntemini değiştirmek işe yaramaz; çünkü Homebrew ve WinGet aynı sunuculardan indirir. Başka bir ağdan deneyin veya BT ekibinizden bu alan adlarının engelini kaldırmasını isteyin.

npm ile: Node.js 22, 18 değil

Node.js'i zaten her gün kullanıyorsanız npm doğal bir seçenek gibi görünür. Çalışır ve belgelenmiş yöntemler arasındadır; ancak birçok İtalyanca rehberde güncellenmemiş bir koşul vardır: Node.js 22 veya üzeri gerekir. Daha eski bir Node sürümüyle EBADENGINE uyarısını görürsünüz, ancak kurulum tamamlanır ve claude yine de çalışır (resmî belge, 3 Ekim 2026 tarihinde kontrol edildi). Node'un güncel sürümleri nodejs.org adresindedir.

node -v                                    # serve v22 o successiva
npm install -g @anthropic-ai/claude-code   # senza sudo

# aggiornamento: @latest, non npm update -g
npm install -g @anthropic-ai/claude-code@latest

Kaçınılması gereken üç alışkanlık:

• sudo komutunu npm install -g komutunun önünde kullanmak. Dokümantasyon, hem izinlerle ilgili sorunlara yol açması hem de güvenlik nedeniyle bunu önermiyor.
• Güncellemek için npm update -g kullanmak. Bunun yerine yukarıdaki son satırdaki gibi @latest ile yüklemeyi tekrarlayın.
• İsteğe bağlı bağımlılıkları atlamak. Claude Code'un ikili dosyası, her platform için bir @anthropic-ai/claude-code-* paketi olarak isteğe bağlı bağımlılıkla gelir. --omit=optional seçeneğiyle veya .npmrc dosyasındaki optional=false ayarıyla indirilmez ve macOS ya da Linux'ta claude şu yanıtı verir: claude native binary not installed (kurulum sorunları, İngilizce, 3 Ekim 2026 tarihinde kontrol edildi).

Windows'ta Claude Code: sorunların çıktığı yerler

Claude Code, Windows'ta doğrudan çalışır ve kurulumun kendisi kolay kısımdır. Sorunlar ortamdan kaynaklanır. İlk sorun terminaldir: CMD için olan satırı PowerShell'e yapıştırırsanız PowerShell && nedeniyle hata verir; PowerShell için olan satırı CMD'ye yapıştırırsanız CMD irm'in ne olduğunu bilmez; Mac için olan curl … | bash satırı da PowerShell'de hiç çalışmaz. İtalyanca Windows'ta bu mesajların bazıları çevrilmiş olarak görünebilir. Her durumda çözüm, yukarıdaki tabloya dönüp kullandığınız terminale uygun satırı seçmektir (İngilizce mesajlar en alttaki hata tablosunda; kaynak: belge, 3 Ekim 2026 tarihinde kontrol edildi).

Başlat menüsüne de dikkat edin: “Windows PowerShell (x86)” 32 bitlik bir işlem açar ve bilgisayar 64 bit olsa bile Claude Code Claude Code does not support 32-bit Windows ile durur. (x86) içermeyen seçeneği seçin.

Git for Windows zorunlu değildir. Yüklüyse Claude Code komutları Git Bash üzerinden çalıştırır; yüklü değilse PowerShell'i kullanır. Git yüklü olduğu hâlde Claude Code bash.exe'i bulamazsa, ~/.claude/settings.json'nin env bloğundaki CLAUDE_CODE_GIT_BASH_PATH ile yolu belirtin; bu yol genellikle C:\Program Files\Git\bin\bash.exe'dir. Peki ya WSL? Yalnızca belirli bir durumda gerekir:

WSL ile her şey Linux içinde gerçekleşir: install.sh satırı WSL kabuğunda çalıştırılmalı ve buradan claude başlatılmalıdır.

“claude” bulunamadı

Yüklemeden sonra terminal command not found: claude veya 'claude' is not recognized yanıtını veriyorsa program vardır, ancak klasörü PATH içinde değildir. Bağımsız yükleyici bunu macOS ve Linux'ta ~/.local/bin/claude, Windows'ta ise %USERPROFILE%\.local\bin\claude.exe konumuna kopyalar. İlk deneme: yeni bir terminal açın. Windows'ta bu yeterli olmazsa, klasörü kontrol edip kullanıcının PATH değişkenine eklemek için belgelerde verilen PowerShell komutları şunlardır:

# 1. Controlla se la cartella di installazione è già nel PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Nessun risultato? Aggiungila al PATH utente, poi chiudi e riapri il terminale
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Nel nuovo terminale
claude --version

PowerShell'de npm.ps1 cannot be loaded

Yalnızca npm ile yükleme yapanları ilgilendirir: PowerShell'in yürütme ilkeleri (execution policy), npm'nin oluşturduğu .ps1 betiğini engeller ve tam mesajda running scripts is disabled on this system ifadesi bulunur. Dokümantasyon üç çözüm belirtir: geçerli kullanıcının yerel betikleri çalıştırmasına aşağıdaki komutla izin vermek, PowerShell betikleri yerine npm.cmd ve claude.cmd çalıştırmak ya da npm'yi bırakıp bağımsız yükleyiciyi kullanmak.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Abonelik olmadan: Claude hesabı veya API anahtarı

Kurulmuş olması hazır olduğu anlamına gelmez: Claude Code ilk açılışta kimlik doğrulaması ister ve Claude.ai'nin ücretsiz planı yeterli değildir (belge, 3 Ekim 2026 tarihinde kontrol edildi). İki seçeneğin karşılaştırması:

Anthropic Console API anahtarı da kullanıma göre ücretlendirilir. Ancak ön ödemeli kredilerin süresi bir yıl sonra dolar ve ücret iadesi yapılmaz (Anthropic desteği, 3 Ekim 2026 tarihinde kontrol edildi); kartla ödeme yapılır, ACH banka havalesi ise aylık faturalandırılan API hesaplarına ayrılmıştır (Anthropic desteği). Kunavo kredilerinin süresi dolmaz.

API anahtarını yapılandırma: altı değişken

Claude Code'un Anthropic'ten farklı bir uç noktayla iletişim kurması desteklenen bir kullanımdır: resmî belgelerde onu bir LLM ağ geçidine bağlama hakkında, İtalyancaya da çevrilmiş bir sayfa vardır. Eklenti gerekmez, değiştirilmiş sürüm gerekmez. Şu değişkenler yeterlidir:

macOS ve Linux'ta bunları ~/.zshrc veya ~/.bashrc dosyasının sonuna ekleyin:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # solo il dominio, senza /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 PowerShell penceresi açık kaldığı sürece geçerli olacak hızlı bir deneme için:

# Vale solo in questa finestra di PowerShell: chiusa la finestra, sparisce
$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

Bunları her seferinde yeniden ayarlamak zorunda kalmamak için doğru yer, ~/.claude/settings.json içindeki env bloğudur (Windows'ta %USERPROFILE%\.claude\settings.json): tüm projeleriniz için geçerlidir. Dosyada zaten başka ayarlar varsa yalnızca env 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"
  }
}

AUTH_TOKEN mı API_KEY mi?

Kunavo anahtarı her iki üstbilgiden de, Authorization: Bearer ve x-api-key'den okur; dolayısıyla teorik olarak iki değişken de çalışır. Farkı Claude Code yaratır. ANTHROPIC_API_KEY, x-api-key olarak gönderildiğinde etkileşimli oturum anahtarı onaylamak isteyip istemediğinizi bir kez sorar; hayır derseniz, /config → Use custom API key üzerinden yeniden etkinleştirene kadar anahtarı sessizce yok sayar. ANTHROPIC_AUTH_TOKEN hiçbir şey sormaz ve hangi değişkeni seçeceğinizden emin değilseniz ağ geçitleri belgesinin (3 Ekim 2026 tarihinde kontrol edildi) önerdiği değişken de budur.

Modelleri neden sabitlemeli?

Değişkenler olmadan Claude Code takma adlara göre çalışır ve takma adlar Anthropic'in yayımlarını izler. Model yapılandırması belgesine (3 Ekim 2026 tarihinde kontrol edildi) göre bugün API kullanıcıları için opus, Opus 5.5'e; sonnet ise Sonnet 5.5'e karşılık gelir. Kunavo, 3 Ekim 2026 itibarıyla Sonnet 5.5 sunmuyor: ANTHROPIC_DEFAULT_SONNET_MODEL olmadan /model sonnet, opusplan'nin yürütme aşaması ve model: sonnet kullanan alt ajanlar Kunavo'da bulunmayan bir model ister ve 404 hatası verir. Bu değişkende claude-sonnet-5 ile takma ad, Claude Sonnet 5'i gösterir; bu, ANTHROPIC_MODEL ile aynı modeldir. İkincisi ise oturum modelini belirler: ayarlanmazsa Claude Code bugün varsayılanı olan Opus 5.5 ile başlar. Opus 5.5 kullanılabilir. opus'i claude-opus-5-5'e sabitlemek, takma ad bir sonraki Opus'a geçtiğinde modelin ve ücretin bir günden diğerine değişmesini önlemek için başka bir işe yarar. Claude Opus 5.5 için Claude Code 2.1.280 veya üzeri gerekir; daha eski bir sürüm kullanıyorsanız önce claude update'i çalıştırın.

Yapılandırmadaki üç model için Kunavo'nun milyon token başına tarifeleri (girdi / çıktı): Claude Sonnet 5 $1,40 / $7,00 (Anthropic liste fiyatı: $2,00 / $10,00); Claude Opus 5.5 $2,80 / $14,00; Claude Haiku 4.5 $0,70 / $3,50; bu model arka planda da çalışır.

Nereye koyulmamalı ve hangi ayar geçerli

Projenin içindeki .claude/settings.json sürüm kontrolüne alınır: anahtarı oraya yazarsanız depoya girer ve depoyu klonlayan herkese ulaşır (ağ geçitleri belgesi). Bir değişken hem kabukta hem de ayarlar dosyasının env bloğunda yer alıyorsa dosyadaki değer önceliklidir. ~/.zshrc'teki bir değişiklik uygulanmıyor gibi görünüyorsa, nedeni neredeyse her zaman budur. Ayarlar dosyasındaki model alanı ise ANTHROPIC_MODEL'e göre önceliğini kaybeder. Claude Code'un VS Code uzantısında aynı değişkenler, VS Code kullanıcı ayarlarındaki claudeCode.environmentVariables'e girilir. Claude masaüstü uygulaması bunların tümü dışında kalır: ne ANTHROPIC_BASE_URL'i ne de settings.json'i okur (ağ geçitleri belgesi, 3 Ekim 2026 tarihinde kontrol edildi).

/status ile ilk başlatma ve kontrol

Anahtar doğru yerdeyse claude oturum açma ekranı göstermeden başlar: yalnızca ilk yapılandırmayı yapıp klasöre güvenip güvenmediğinizi yanıtlamanız gerekir. Oturum açma ekranı görünürse Claude Code anahtarı bulamamıştır. Tipik durum, anahtarın yalnızca projedeki .claude/settings.json veya .claude/settings.local.json'e yazılmış olmasıdır: etkileşimli modda bu env bloğu yalnızca ilk yapılandırma ve güven onayından sonra devreye girer (ağ geçitleri belgesi, 3 Ekim 2026 tarihinde kontrol edildi); dolayısıyla ilk açılışta henüz etkin değildir. Anahtarı kabuğa veya kullanıcı dosyasına taşıyın. Eski bir Pro ya da Max oturumu sorun çıkarmaz; çünkü değişken kayıtlı oturum açma bilgisinden önceliklidir. İsterseniz /logout ile oturumu kapatabilirsiniz.

Oturum içinde /status yazın. Önemli olan iki satır şunlardır:

• Yalnızca bir ağ geçidi ayarlandığında görünen Anthropic base URL şu değeri göstermelidir: https://api.kunavo.com. Yoksa ANTHROPIC_BASE_URL oturuma ulaşmamıştır.
• Anahtarı kullandığınızı gösteren, adı ANTHROPIC_AUTH_TOKEN olan Auth token. Bunun yerine claude.ai hesabıyla Login method görüyorsanız değişken yok sayılmıştır.

Claude Code'u açmadan önce kontrol etmek ister misiniz? Dokümantasyon, krediden ihmal edilebilir bir tutar düşen, 1 çıktı token'lı minimum bir istek önerir. Komut mevcut kabuğun değişkenlerini okur: anahtar yalnızca settings.json içindeyse önce bu terminalde dışa aktarın. {"id":"msg_ ile başlayan bir JSON dönerse sorun yoktur; 401 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ı deneme şöyledir ve başarılı yanıt msg_ ile başlayan bir id içerir:

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 kaybettikleriniz

• Remote Control ve sesli dikte. Bunlar claude.ai kimliği gerektirir ve ANTHROPIC_AUTH_TOKEN veya ANTHROPIC_API_KEY ile çalışmaz; 2.1.196 sürümünden itibaren ANTHROPIC_BASE_URL Anthropic'e ait olmayan bir ana bilgisayara işaret ettiğinde Remote Control da kapanır.
• /fast modu. Yalnızca bearer token ile Claude Code bunu devre dışı kabul eder ve istemeyi bile denemez.
• Başlangıçta MCP araçlarını arama. Özel bir ANTHROPIC_BASE_URL kullanıldığında bu özellik kapalı başlar (MCP belgesi, İngilizce, 3 Ekim 2026 tarihinde kontrol edildi). Ağ geçidi tool_reference bloklarını iletip ENABLE_TOOL_SEARCH=true ayarını açarsa yeniden etkinleşir; Kunavo ile denemedik.
• /context'in doğruluğu. Kunavo, /v1/messages/count_tokens'yi sunmuyor. Bu, ağ geçidi belirtimine göre isteğe bağlı bir uç noktadır (3 Ekim 2026 tarihinde kontrol edildi); bu uç nokta olmadığında Claude Code token sayısını karakterlerden tahmin eder.

Daha fazla bilgi için İngilizce olarak: Claude Code entegrasyonu dokümantasyonu, ANTHROPIC_BASE_URL için kenar durumları sayfası ve Install Claude Code rehberi.

Kredi kartı olmadan Satispay ile ödeme

Önce, en sık sorulan soru olduğu için bir noktayı açıklığa kavuşturalım: Satispay ile Claude aboneliği ödenemez. Web üzerinden satın alınan Pro ve Max için Anthropic yalnızca kredi veya banka kartlarını kabul eder (Anthropic desteği), PayPal'ı kabul etmez (Anthropic desteği). Her ikisi de 3 Ekim 2026 tarihinde kontrol edildi. Kunavo'da Satispay ise Claude Code'un yukarıda yapılandırılan anahtarla kullandığı API kredisine bakiye yükler. Kullanılabilir bakiyeye yükleme ücretleri dâhil tüm ayrıntılar Claude için Satispay ile ödeme kılavuzunda yer alır. Claude Code için adımlar şöyledir:

1. E-posta adresinizle veya Google hesabınızla Kunavo'ya kaydolun: kart gerekmez.
2. Faturalandırma sayfasını açın ve ne kadar yüklemek istediğinizi seçin: minimum $10, sabit ücret yok. Belirli eşiklerin üzerinde bonus vardır: $100 $110 olur, $1.000 $1.200 olur ve $5.000 $6.250 olur kredi.
3. Tutarı avro olarak gösteren Stripe ödeme sayfasında Satispay'ı seçin. Satispay sayfasına geçersiniz (Stripe belgesi): cep telefonu numarasını girin veya uygulamadaki QR kodunu tarayın, ardından Gönder'e dokunarak onaylayın (Satispay desteği, 3 Ekim 2026 tarihinde kontrol edildi). Başlamadan önce Kullanılabilir bakiyenizin yeterli olduğundan emin olun.
4. Stripe ödemeyi onaylar onaylamaz kredi Billing bölümünde görünür. Hemen görmezseniz tekrar ödeme yapmak yerine sayfayı yenileyin: ikinci ödeme ilkini değiştirmez, krediye eklenir.
5. API Keys bölümünde sk-kn-… anahtarını oluşturun ve hemen ANTHROPIC_AUTH_TOKEN içine kopyalayın: yalnızca bir kez gösterilir.

Kunavo fiyatları dolar cinsinden belirler; Stripe bunları ödemeyi yapan kişinin karşıladığı %2–4 döviz dönüştürme ücretiyle avroya çevirir (Stripe, Adaptive Pricing, 3 Ekim 2026 tarihinde kontrol edildi): $10'lık en düşük yüklemede bu ücret $0,20 ile $0,40 arasındadır. Dolarla ödemede bu ücret ortadan kalkar, ancak yalnızca avro ile ödeme sayfasında kullanılabilen Satispay da kaybolur; ödeme sayfasında dolar görünüyorsa bunun nedeni çoğu zaman VPN'dir. Avro cinsinden kesin tutar, onaylamadan önce ödeme sayfasında gördüğünüz tutardır.

Satispay ile yüklemeler elle yapılır: Kunavo'nun otomatik yükleme özelliği yalnızca kayıtlı bir karttan veya Link üzerinden tahsilat yapar. Satispay kartı olanlar, Plus, Metal ve Velvet planlarında kullanılabilen Mastercard banka kartını (Satispay desteği, 3 Ekim 2026 tarihinde kontrol edildi) kaydedip diğer kartlar gibi kullanabilir. Kredinin süresi dolmaz ve başarısız yükleme talepleri için ücret alınmaz. Kunavo, KDV'li veya SDI üzerinden elektronik fatura düzenlemez; yükleme geçmişi Billing bölümünde kalır.

Dürüst bir not: Satispay, 3 Ekim 2026'dan beri Kunavo'nun ödeme ekranında yer alıyor ve Stripe bunu euro ödemelerinde sunuyor, ancak henüz oradan geçen hiçbir yükleme olmadı. Bulamazsanız kart, Apple Pay, Google Pay ve Link aynı işi görür.

Bir çalışma oturumunun maliyeti

API anahtarıyla maliyet tokenlardadır ve Claude Code çok sayıda token gönderir: her adımda tüm bağlamı yeniden gönderir. Ancak değişmeyen kısım, çok daha düşük bir tarifeyle önbellekten okunabilir. Aşağıda varsayımları açıkça belirtilmiş, özel olarak oluşturulmuş bir örnek var: bu bir ölçüm değildir ve harcama üst sınırı değildir.

• İstek başına 40.000 girdi tokenı; bunların 36.000 kadarı (%90) önbellekten okunur ve 4.000 kadarı önbelleğe yazılır;
• İstek başına 1.000 çıktı tokenı;
• Bir oturumda 50 istek; arka plandaki Claude Haiku 4.5 çağrıları hariç;
• Girdi tarifesinin 10% oranında bir ücretle önbellekten okuma ve girdi tarifesinin 1,25 katı ücretle önbelleğe yazma: bunlar Claude Sonnet 5 için Kunavo oranlarıdır ve tablonun her satırı kendi modelinin oranlarını kullanır.

Uzun bağlamlar, önbellekten az okuma ve uzun yanıtlar hesabı artırır; görevler arasında bir /clear hesabı düşürür. Aboneliğin mi yoksa API'nin mi sizin için daha avantajlı olduğunu Claude Code ne kadar? bölümünde bulabilirsiniz; tüm Claude modellerinin tarifeleri Claude API fiyatları ve fiyatlandırma sayfasında yer alır. Kendi sayılarınızla yeniden hesaplamak için (İngilizce) Claude token maliyeti hesaplayıcısı kullanılabilir.

Hatalar: mesaj, neden, çözüm

Bu yapılandırmanın yapmadıkları

• Claude Pro veya Max aboneliğini etkinleştirmez: Kunavo kredisi API'yi ve anahtarlı Claude Code'u öder; claude.ai'yi veya Claude uygulamasını ödemez.
• Fatura oluşturmaz: ne KDV'li ne de SDI üzerinden elektronik fatura.
• Satispay ile otomatik yükleme yapmaz: otomatik yükleme kayıtlı bir kart veya Link gerektirir.
• Kunavo Sonnet 5.5'i sunana kadar model değişkenleri olmadan çalışmaz ( 3 Ekim 2026 itibarıyla): sonnet takma adı 404 döndürür; onunla birlikte /model sonnet, opusplan'in yürütme aşaması ve model: sonnet kullanan alt aracılar da 404 döndürür.
• Kunavo'nun İtalyanca dokümantasyonu yok: entegrasyon rehberi ve bakiye ve ödemeler sayfası İngilizcedir; Anthropic'in Claude Code sayfası ise çevrilmiştir.

İtalya'dan Claude ile geliştirme yapanlar için genel çerçeve İtalya'da Claude API rehberinde bulunur. Başlangıç: hesabı oluşturun, Satispay ile $10 yükleyin, altı değişkeni ayarlayın ve /status ile kontrol edin.

Sık sorulan sorular