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

Claude Code'u yükleme: Windows, macOS ve Linux komutları, aboneliksiz API anahtarı ve PayPal olmadan ödeme

Claude Code tek komutla yüklenir. Genellikle sonrasında şu noktalarda takılınır: Windows'ta yanlış pencere, PATH veya npm'deki Node.js sürümü. Buna aboneliksiz API anahtarı ve PayPal veya SEPA olmadan nasıl ödeme yapılacağı sorusu eklenir.

Kısaca: Claude Code'u terminalde tek bir satırla, Node.js ve yönetici hakları olmadan yüklersiniz. Hangi satırın kullanılacağı yalnızca pencereye bağlıdır: macOS, Linux ve WSL'de curl -fsSL https://claude.ai/install.sh | bash, Windows PowerShell'de irm https://claude.ai/install.ps1 | iex, Komut İstemi'nde (CMD) ise aşağıdaki üçüncü satır. Claude aboneliği olmayanlar, Claude Code'u API anahtarıyla Kunavo'ya bağlar: ANTHROPIC_BASE_URL=https://api.kunavo.com (/v1 olmadan), ANTHROPIC_AUTH_TOKEN ve dört model değişkeni. Bunun çalışıp çalışmadığını /status gösterir. Ödeme, $10 tutarından başlayan bakiyeden belirteç başına yapılır; bakiye banka veya kredi kartıyla (Visa Debit ve Debit Mastercard dahil), Apple Pay, Google Pay, Link veya Avusturya'da EPS ile yüklenebilir. PayPal ve SEPA otomatik ödeme 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-Eingabeaufforderung (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Anthropic, Claude Code belgelerinin tamamını Almanca olarak da sunuyor; bu nedenle bu kılavuz Almanca sayfalara bağlantı veriyor. Yukarıdaki komutlar 3 Ekim 2026 tarihinde Claude Code'u kurma sayfasıyla, değişkenler ise ortam değişkenleri listesiyle karşılaştırıldı. Kunavo fiyatları ve ödeme yöntemleri 10 Ekim 2026 itibarıyla günceldir. Anthropic'in ülke listesinde Almanya, Avusturya ve İsviçre hem Claude.ai hem de API için yer alıyor (3 Ekim 2026 itibarıyla). İngilizce sürüm Claude Code'u kurma sayfasında bulunuyor.

Sürece genel bakış

  1. Yükleme: yukarıdaki uygun satırı çalıştırın, ardından yeni bir terminal penceresi açın.
  2. Kontrol: claude --version bir sürüm numarası döndürür.
  3. Karar: Claude aboneliğiyle oturum açın veya API anahtarı kullanın (karşılaştırma aşağıdadır).
  4. API anahtarıyla: bakiyeyi yükleyin, anahtar oluşturun ve altı ortam değişkenini ayarlayın.
  5. Kontrol: oturumda /status yazın.

Ön koşullar: bugün geçerli olanlar

Almanca bazı kılavuzlar, Claude Code'un eski bir sürümünü anlatıyor. Tabloda yaygın bilgiler, resmî kurulum sayfasının 3 Ekim 2026 tarihinde belirttiği koşullarla karşılaştırılıyor.

KonuHâlâ sıkça okunanlarAnthropic'e göre
macOSmacOS 10.15 veya daha yenimacOS 13.0 veya daha yeni
Windowsyalnızca WSL üzerindenWindows 10 sürüm 1809'dan itibaren veya Windows Server 2019'da doğrudan; WSL bir seçenektir, zorunlu değildir
İzinlerPowerShell'i yönetici olarak başlatmagerekli değil
Node.jsNode.js 18 veya daha yeniyalnızca npm kurulumu için, ardından sürüm 22 veya daha yeni
npmgüncel değilhâlâ belgelenen bir yol; bağımsız yükleyici önerilir
Linux—Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+
Bilgisayar ve kabuk—en az 4 GB RAM, x64 veya ARM64, 32 bit Windows olmamalı; Bash, Zsh, PowerShell veya CMD
Konum—Anthropic tarafından desteklenen bir ülke; Almanya, Avusturya ve İsviçre buna dahildir
Hesap—Oturum açmak için Pro, Max, Team, Enterprise veya Console; API anahtarıyla abonelik ve oturum açma gerekmez

macOS, Linux ve WSL'ye yükleme

Terminale install.sh satırını ekleyin. Resmî belgelerde bu yol “Native Installation (Önerilen)” sekmesinde yer alır. Betik başlatıcıyı ~/.local/bin/claude konumuna yerleştirir ve yükleme daha sonra arka planda kendini otomatik günceller. WSL'de aynı satır WSL terminalinde çalıştırılır.

Claude Code'u Windows'a yükleme

Windows'ta hangi satırın çalıştığını açık pencere belirler; giriş satırına bakmanız yeterlidir: PS C:\Users\Name> PowerShell'dir, C:\Users\Name> ise PS olmadan Komut İstemi'dir (CMD). Kurulum sayfasına göre iki seçenek için de yönetici hakları gerekmez. Yükleyici, claude.exe dosyasını %USERPROFILE%\.local\bin konumuna yerleştirir.

Pencereleri karıştırırsanız İngilizce, Almanca Windows'ta ise koşullara bağlı olarak Almanca bir mesaj alırsınız. PowerShell'deki CMD satırı The token '&&' is not a valid statement separator ile, CMD'deki PowerShell satırı ise 'irm' is not recognized as an internal or external command ile sonuçlanır. Her iki durumda da anlam aynıdır: yanlış pencere kullanılmıştır; diğer satırı kullanın.

Başlat menüsündeki “Windows PowerShell (x86)” girdisini kullanmayın. Sorun giderme sayfasına göre bu, 32 bitlik bir işlem başlatır ve yükleyici 64 bitlik bir bilgisayarda bile Claude Code does not support 32-bit Windows hatasıyla durur. Bu pencerede [Environment]::Is64BitOperatingSystem komutu True çıktısını veriyorsa Windows'unuz uygundur; yalnızca “Windows PowerShell”i, sonundaki ek olmadan açın.

Git for Windows'u yüklemeniz gerekmez. Yüklüyse Claude Code kabuk komutlarını Git Bash'te, değilse PowerShell'de çalıştırır. Claude Code yüklü bir Git Bash'i bulamazsa bash.exe dosyasının yolunu, ~/.claude/settings.json içindeki env bloğunda CLAUDE_CODE_GIT_BASH_PATH olarak belirtin. Standart kurulumda bu yol C:\Program Files\Git\bin\bash.exe'dir.

WSL'siz Windows mu yoksa WSL mi kullanılacağı, projelerinizin nerede bulunduğuna bağlıdır:

VaryantÖn koşulKorumalı çalıştırmaŞu durumda uygundur
WSL'siz Windowsyok; Windows için Git isteğe bağlıhayırprojeleriniz ve araçlarınız doğrudan Windows'ta çalışıyorsa
WSL 2WSL 2 etkinevetLinux araçlarına ihtiyacınız varsa veya komutları bir sandbox içinde çalıştırmak istiyorsanız
WSL 1WSL 1 etkinhayırbilgisayarda WSL 2 kullanılamıyorsa

WSL ile claude komutunu PowerShell veya CMD'de değil, WSL terminalinde yükleyip çalıştırın.

Alternatifler: Homebrew, WinGet ve npm

Yazılımı bir paket yöneticisiyle yönetmeyi tercih edenler bunu yapabilir; ancak bir koşul vardır: Belgelere göre Homebrew ve WinGet yüklemeleri kendiliğinden güncellenmez; bu nedenle düzenli olarak upgrade komutunu çalıştırmanız gerekir. Homebrew iki Cask sunar. claude-code yaklaşık bir hafta geriden gelen kararlı kanalı izler ve büyük gerilemeler içeren sürümleri atlar; claude-code@latest ise her sürümü hemen alır.

# Homebrew (macOS) – stabiler Kanal; claude-code@latest für den neuesten Stand
brew install --cask claude-code
brew upgrade claude-code              # aktualisiert sich nicht von selbst

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # aktualisiert sich nicht von selbst

npm hakkında

npm hâlâ resmî olarak açıklanan bir yöntemdir. Ön koşul Node.js 22 veya daha yeni sürümüdür. npm paketi, yükleyiciyle aynı derlenmiş ikili dosyayı indirir ve çalışma zamanında Node.js'e hiç ihtiyaç duymaz. Bu nedenle daha eski bir Node.js ile kurulum durmaz; npm yalnızca EBADENGINE uyarısı verir. Henüz Node.js'iniz yoksa bağımsız yükleyici daha kısa yoldur.

Terminal
node -v                                    # muss v22 oder neuer zeigen
npm install -g @anthropic-ai/claude-code   # niemals mit sudo

# später aktualisieren: mit @latest, nicht mit npm update -g
npm install -g @anthropic-ai/claude-code@latest

Kurulum sayfasından üç kural: sudo npm install -g kullanmayın, çünkü bu, izin sorunlarına ve güvenlik risklerine yol açar. Güncelleme için @latest kullanın, çünkü npm update -g ilk sürüm aralığında takılı kalır. Ayrıca isteğe bağlı bağımlılıkları devre dışı bırakmayın: İkili dosya, platforma özgü isteğe bağlı bir bağımlılık olarak gelir; --omit=optional kullanıldığında veya .npmrc dosyasında optional=false bulunduğunda bu dosya eksik kalır ve claude, macOS ve Linux'ta Error: claude native binary not installed. hatasını bildirir

Kurulumu doğrulama

Bunun için yeni bir terminal penceresi açın. Kurulumdan önce zaten açık olan bir pencere genişletilmiş PATH'i henüz bilmez ve bu nedenle claude öğesini bulamaz.

claude --version   # zeigt eine Versionsnummer wie 2.1.211 (Claude Code)
claude doctor      # Diagnose von Installation und Einstellungen, startet keine Sitzung

claude doctor bir şeyler yolunda gitmediğinde kullanılan araçtır. Bir oturum başlatmaz; bunun yerine kurulum durumunu, ayar dosyalarındaki hataları ve çözüm önerileri içeren uyarıları listeler. Böylece sorunun kurulumdan mı yoksa yapılandırmadan mı kaynaklandığını anlayabilirsiniz.

Kurulum takılırsa

İndirme HTML veya 403 döndürüyor

Çıktı syntax error near unexpected token '<' ile başlıyorsa veya curl 403 hatası veriyorsa, Sorun giderme sayfasına göre (güncelleme tarihi: 3 Ekim 2026) betik yerine bir web sayfası ya da hata durumu döndürülmüştür. Sayfada App unavailable in region yazıyorsa Anthropic bağlantının desteklenmeyen bir ülkeden geldiğini düşünüyor demektir. Almanya, Avusturya veya İsviçre'deyseniz bu, VPN ya da proxy çıkışının yurt dışında olduğuna işaret eder. Metin içermeyen bir 403 hatasının nedeni aynı olabilir veya bir şirket güvenlik duvarı olabilir. Dokümantasyon, diğer kurulum yöntemleri de aynı sunuculara bağlandığından önce ağ bağlantısını denetlemenizi öneriyor. Burada farklı bir ağ kullanmak veya BT ekibinden erişim izni almak, başka bir yükleyici kullanmaktan daha yararlıdır.

“claude” bulunamıyor

macOS ve Linux'ta command not found: claude veya Windows'ta tanınmayan bir claude, kurulum klasörünün PATH'te eksik olduğu anlamına gelir. Genellikle yeni bir pencere açmak yeterlidir. Bu işlem macOS veya Linux'ta sorunu çözmezse ~/.local/bin öğesini sırasıyla ~/.zshrc veya ~/.bashrc içine ekleyin. Windows'ta klasörü sorun gidericinin gösterdiği şekilde denetleyip ekleyin:

PowerShell
# 1. Steht der Installationsordner schon im PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Keine Ausgabe? Ordner zum Benutzer-PATH hinzufügen, dann ein neues Fenster öffnen
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Im neuen Fenster
claude --version

PowerShell npm.ps1'i engelliyor

Bu yalnızca npm varyantını etkiler. npm.ps1 cannot be loaded because running scripts is disabled on this system iletisi, yürütme ilkesinin npm'nin başlatma betiğini engellediği anlamına gelir. İlke kapsamında olmayan npm.cmd ve claude.cmd dosyalarını çağırabilir, bağımsız yükleyiciye geçebilir veya kullanıcı hesabınız için yerel betiklere izin verebilirsiniz:

PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Abonelik mi, API anahtarı mı?

Claude Code ilk kez başlatıldığında ödemeyi kimin yapacağını sorar. Claude hesabınızla oturum açabilir veya bir ortam değişkeni aracılığıyla API anahtarı sağlayabilirsiniz. Bir anahtar ayarlandığında, Gateway kılavuzuna göre öncelik ondadır: kayıtlı oturum açma bilgisi kullanılmaz ve değişkeni kaldırdığınızda yeniden devreye girer. Geçiş yapmak için yeniden yükleme gerekmez.

Claude aboneliğiKunavo API anahtarı
FaturalandırmaAylık: Pro, ayda $20 veya yıllık ödemede ayda $17 ($200 peşin); Max ise $100'dan başlayan fiyatlarla. Olası vergiler dahil değildir (claude.com/de/pricing, güncelleme tarihi: 3 Ekim 2026)ön ödemeli bakiyeden token başına, $10'den başlayan yüklemeyle; aylık ücret ve son kullanma tarihi yok
Şunlar için uygundur:her gün saatlerce kullanımdeğişken kullanım; bir ay hiç kullanım olmazsa ücret alınmaz
ÖdemeWeb'de yalnızca kredi veya banka kartıyla; iOS ve Android uygulamalarında App Store veya Google Play üzerinden (Anthropic'in faturalandırma SSS'si, güncelleme tarihi: 3 Ekim 2026)Banka ve kredi kartı (Visa, Mastercard), Apple Pay, Google Pay, Link; Avusturya'da EPS
Kurulumclaude başlatın ve tarayıcıda oturum açınaltı ortam değişkeni, oturum açma yok
Dahil değildir—Remote Control ve sesli dikte

Pro veya Max'ın anahtara kıyasla hangi noktada daha hesaplı olduğunu Claude Code fiyat kılavuzu gösterir.

API anahtarını ayarlama (abonelik olmadan)

Claude Code'un farklı bir uç noktaya bağlanması bir hile değildir. ANTHROPIC_BASE_URL, Anthropic'in değişkenler listesinde yer alır ve istekleri proxy veya ağ geçidi üzerinden yönlendirmek için tasarlanmıştır. Eklentiye ya da Claude Code'un değiştirilmiş bir sürümüne ihtiyacınız yoktur.

  1. Kunavo'ya kaydolun; e-posta adresi veya Google hesabıyla.
  2. Billing bölümünde en az $10 yükleyin (ödeme yöntemleri için Ödeme bölümüne bakın).
  3. API-Keys bölümünde bir anahtar oluşturun. Anahtar sk-kn- ile başlar ve yalnızca bir kez gösterilir; bu nedenle hemen kopyalayın.
  4. Değişkenleri aşağıda gösterildiği şekilde ayarlayın.

~/.zshrc veya ~/.bashrc içine eklenen değerler macOS, Linux ve WSL'de açılan her yeni terminal için geçerlidir:

~/.zshrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # nur die Domain, ohne /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

PowerShell'de $env: atamaları yalnızca açık pencere için geçerlidir; ilk deneme için uygundur:

PowerShell
# Gilt nur für dieses PowerShell-Fenster
$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

Uzun süreli kullanım için değerleri ~/.claude/settings.json içindeki env bloğuna koyun (Windows'ta %USERPROFILE%\.claude\settings.json). Gateway kılavuzuna göre bu dosya tüm projeleriniz için geçerlidir (güncelleme tarihi: 3 Ekim 2026). Dosya zaten varsa 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"
  }
}

VS Code uzantısı, VS Code kullanıcı ayarlarındaki claudeCode.environmentVariables değerlerini (Preferences: Open User Settings (JSON) komutu) okur:

VS Code settings.json
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.kunavo.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-kn-..." },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" }
  ]
}

Her değişkenin işlevi

DeğişkenDeğerEtkisiEksik veya yanlış olduğunda
ANTHROPIC_BASE_URLhttps://api.kunavo.comtüm istekleri Kunavo'ya yönlendirir; Claude Code /v1/messages yolunu kendisi eklerSonunda /v1 bulunursa istek /v1/v1/messages adresine gider ve 404 ile başarısız olur.
ANTHROPIC_AUTH_TOKENAnahtarınız (sk-kn-…)Authorization: Bearer olarak gönderilir ve hemen öncelik kazanırBunun yerine ANTHROPIC_API_KEY ayarlayanlar (başlık x-api-key), anahtarı etkileşimli modda bir kez onaylamalıdır. Bu reddedilirse Claude Code anahtarı yeniden sormadan yok sayar; /config → Use custom API key bölümünden yeniden etkinleştirilebilir. Kunavo anahtarı her iki başlıkta da kabul eder.
ANTHROPIC_MODELclaude-sonnet-5Her oturumun başlangıç modeliBu değişken olmadan oturum Opus sabitlemesindeki modelle, yani Opus 5.5 ile başlar; bu da yoksa Anthropic'in ilgili varsayılan modelini kullanır (şu anda yine Opus 5.5).
ANTHROPIC_DEFAULT_OPUS_MODELclaude-opus-5-5/model opus hedefi ve ANTHROPIC_MODEL olmadan varsayılanın kullandığı sürümBu değişken olmadan takma ad Anthropic'in belirlemesini izler; şu anda yine Opus 5.5'tir. Daha yeni bir Opus çıktığında, Kunavo'nun henüz sunmadığı bir modele işaret edebilir. Opus 5.5 için Claude Code'un 2.1.280 veya daha yeni bir sürümü gerekir; eski sürümler claude update ile güncellenir.
ANTHROPIC_DEFAULT_SONNET_MODELclaude-sonnet-5/model sonnet hedefi, opusplan yürütme aşamasının ve model: sonnet ile alt aracıların modeliBu değişken olmadan API kullanıcıları için takma ad, Kunavo'nun şu anda ( 3 Ekim 2026 itibarıyla) sunmadığı Sonnet 5.5'e işaret eder: 404.
ANTHROPIC_DEFAULT_HAIKU_MODELclaude-haiku-4-5/model haiku hedefi ve arka plan işlevleri için modelBu satır olmadan, Claude Code 2.1.293'ten itibaren takma ad Haiku 5.5'e, öncesinde ise tarih içeren bir Haiku 4.5 kimliğine işaret eder; Kunavo bu ikisinden hiçbirini tanımaz: 404.

Neden sabit bir başlangıç modeli? Model yapılandırmasına göre (3 Ekim 2026 itibarıyla) Opus 5.5, API kullanıcıları için varsayılan modeldir ve takma adlar zaman içinde yeni sürümlere yönlendirilir. Kunavo, Opus 5.5'i sunar; dolayısıyla burada model değişkenlerini hiç ayarlamadan başlamak Opus 5.5'i kullanmak anlamına gelir; bu modelin belirteç başına maliyeti Claude Sonnet 5 modelinin maliyetinin iki katıdır. Model adlarını sabitleyerek hangi modelin ve hangi tarifeyle yanıt verdiğini bilirsiniz. Opus sabitlemesi, Anthropic daha sonra takma adı daha yeni bir Opus sürümüne yönlendirse bile opus takma adını Claude Opus 5.5 (claude-opus-5-5) olarak tutar. Kunavo'da Opus 5.5, token başına Claude Opus 5 ile kıyaslandığında daha az ödeme gerektirir (1 milyon giriş/çıkış token'ı başına $2,80 / $14,00 ile $3,50 / $17,50 karşılaştırması) ve Claude Code'un 2.1.280 veya sonraki sürümünü gerektirir; eski bir kurulumu claude update güncel sürüme getirir. Sonnet sabitlemesi zorunludur: API kullanıcıları için sonnet takma adı Kunavo'nun sunmadığı Sonnet 5.5'e karşılık gelir ve ANTHROPIC_DEFAULT_SONNET_MODEL olmadan /model sonnet, opusplan'ün yürütme aşaması ve model: sonnet içeren alt ajanlar 404 hatasıyla sonuçlanır. Claude Haiku 4.5 arka plan görevlerinin maliyetini düşük tutar; oturum sırasında istediğiniz zaman /model ile geçiş yapabilirsiniz.

Depolama konusunda iki nokta var. Anahtar, bir projenin .claude/settings.json dosyasına asla konulmamalıdır; çünkü ağ geçidi kılavuzuna göre bu dosya commit edilir ve depoyu klonlayan herkesin eline geçer. Ayrıca bir shell export'u ile bir env bloğu aynı değişkeni ayarlarsa ayar dosyası önceliklidir. Bu nedenle shell'de bir değişkeni değiştirir ve hiçbir şey olmazsa eski değer muhtemelen hâlâ bir settings.json dosyasındadır.

Modellerin karşılaştırması: Kunavo fiyatları kataloğundan, Anthropic'in liste fiyatları ise claude.com/de/pricing sayfasından alınmıştır (güncelleme tarihi: 3 Ekim 2026); tüm fiyatlar 1 milyon token başınadır:

ModelKunavo (Girdi / Çıktı)Anthropic liste fiyatı (Input / Output)FarkClaude Code'daki rolü
claude-haiku-4-5$0,70 / $3,50$1,00 / $5,00~30 % daha ucuzClaude Code'un haiku takma adı ve arka plan görevleri
claude-sonnet-5$1,40 / $7,00$2,00 / $10,00~30 % daha ucuzGünlük işler için ana model (ANTHROPIC_MODEL)
claude-opus-5-5$2,80 / $14,00$4,00 / $20,00~30 % daha ucuzYukarıdaki sabitle birlikte opus takma adı (büyük yeniden düzenlemeler, planlama); sabitleme olmadan API kullanıcıları için varsayılan
claude-opus-5$3,50 / $17,50$5,00 / $25,00~30 % daha ucuzTakma ad yok; yalnızca /model claude-opus-5 ile özel olarak

Tüm Claude modelleri ve tarifeler Claude API fiyatları kılavuzunda ve fiyatlandırma sayfasında yer alır.

İlk başlatma: /status ile denetleme

Proje klasörünüze geçin ve claude komutunu çalıştırın. ANTHROPIC_AUTH_TOKEN ayarlıysa doğrudan oturuma geçilir; giriş ekranı gösterilmez. Yine de giriş ekranı çıkarsa Claude Code bir anahtar bulamamış demektir. Gateway kılavuzuna göre en yaygın neden, anahtarın yalnızca projenin .claude/settings.json veya .claude/settings.local.json dosyasında bulunmasıdır. Claude Code, etkileşimli oturumda bu env bloklarını ancak kurulum sihirbazından ve klasöre güvenip güvenmediğiniz sorulduktan sonra değerlendirir. Bu nedenle anahtarı kabuğa (export) veya ~/.claude/settings.json dosyasına koyun.

Oturum içinde /status, Status sekmesinde Claude Code'un adresi ve kimlik bilgilerini nereden aldığını gösterir. İki satır önemlidir:

SatırDoğruDeğilse
Anthropic base URLhttps://api.kunavo.comBu satır yalnızca bir ağ geçidi adresi ayarlanmışsa görünür. Eksikse ANTHROPIC_BASE_URL oturuma ulaşmamıştır.
Auth tokenANTHROPIC_AUTH_TOKEN değerini belirtirBunun yerine bir claude.ai hesabıyla Login method görünüyorsa değişken okunmamıştır ve oturum aboneliğiniz üzerinden çalışıyordur.

Bağlantıyı Claude Code olmadan da ağ geçidi kılavuzundaki istekle test edebilirsiniz (buradaki model claude-sonnet-5 olarak ayarlanmıştır). İstek tam olarak bir output token ister ve buna karşılık yalnızca çok küçük bir tutar tutar. Komutlar shell değişkenlerini okur; değerleriniz yalnızca settings.json içinde bulunuyorsa test için bunları ayrıca dışa aktarın.

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

{"id":"msg_ ile başlayan bir JSON veya PowerShell'de id değerinin msg_ ile başladığı bir nesne dönerse adres ve anahtar doğrudur. 401, anahtarın reddedildiği anlamına gelir.

API anahtarıyla ne değişir

Çoğu şey olduğu gibi kalır: kod düzenleme, araçlar, alt aracılar, MCP sunucuları, hook'lar ve prompt önbelleğe alma normal şekilde çalışır. Bilmeniz gereken dört fark vardır:

  • Remote Control ve sesli dikte kullanılamaz. Ağ geçidi kılavuzuna göre her ikisi de claude.ai kimliği gerektirir ve ANTHROPIC_AUTH_TOKEN veya ANTHROPIC_API_KEY etkin olduğu sürece devre dışıdır. Ayrıca ANTHROPIC_BASE_URL Anthropic dışındaki bir ana bilgisayara işaret ediyorsa Remote Control, 2.1.196 sürümünden itibaren devre dışıdır.
  • /fast Fast Mode'un kullanılamadığını bildirir. Yalnızca bir Bearer token ile Claude Code bunu devre dışı kabul eder ve kullanılabilirlik denetimini hiç göndermez.
  • MCP için araç araması devre dışı. MCP dokümantasyonuna göre (güncelleme tarihi: 3 Ekim 2026) ANTHROPIC_BASE_URL, üçüncü taraf bir hizmeti gösterdiğinde Claude Code araç aramasını kapatır; ENABLE_TOOL_SEARCH ile açıkça etkinleştirilebilir.
  • /context tahmini değerler gösterir. Kunavo /v1/messages/count_tokens'ü sunmaz. Bu uç nokta olmadığında Claude Code, Gateway uyumluluk kılavuzuna göre (3 Ekim 2026 itibarıyla) sayımı karakterlere dayanarak yapar.

Entegrasyon hakkında daha fazla bilgi Claude Code entegrasyon kılavuzunda (İngilizce) yer alır.

PayPal ve SEPA olmadan ödeme

Önce bir ayrım: Kunavo Claude abonelikleri satmaz; Claude Code'un her token için düşeceği API erişim bakiyesi satar. Anthropic Pro ve Max planları için web'de yalnızca kredi veya banka kartı kabul edilir; uygulamalarda ise ödemeyi App Store veya Google Play alır (Faturalandırma SSS'si). Anthropic, reddedilen kartlarla ilgili yardım makalesine göre PayPal veya Venmo kabul etmez (her iki bilgi de 3 Ekim 2026 tarihi itibarıyla geçerlidir).

Kunavo, Stripe Checkout üzerinden bakiye yükler. Fiyatlar ABD doları cinsindendir; Almanya veya Avusturya'dan ödeme yapanlar tutarı avro olarak görür. Stripe'ın Adaptive Pricing dokümantasyonuna göre bu kura alıcının ödediği %2–4'lük bir dönüştürme ücreti dahildir (3 Ekim 2026 itibarıyla). Stripe Checkout'ta ABD dolarını seçerseniz bu ücret alınmaz; bu durumda bankanız kendi kuruyla dönüştürme yapar ve kendi ücretlerini uygulayabilir. Checkout şu ödeme yöntemlerini sunar:

Ödeme yöntemiNeredeNot
Kart (Visa, Mastercard, Amex, JCB, UnionPay)her yerdeKredi ve banka kartları; Visa Debit ve Debit Mastercard da dahil, ancak yalnızca girocard değil
Apple PaySafari, iPhone ve iPad; Hindistan'da değilWallet'taki bir kartla, Visa veya Mastercard banka kartıyla da; yalnızca girocard ile değil
Google PayGoogle Pay kurulmuş Chrome ve Android; Hindistan'da değilWallet'taki bir kartla, Visa veya Mastercard banka kartıyla da; yalnızca girocard ile değil
LinkHindistan hariç her yerdeStripe’ın ödeme hizmeti; kartınızı kaydeder ve otomatik yükleme de bununla yapılabilir
EPSAvusturya, euro ödeme sayfasıBankanızın çevrim içi bankacılık sistemine yönlendirme

EPS, Stripe'a göre Avusturya'da kullanılan ve tüm Avusturya bankalarının desteklediği bir ödeme yöntemidir. Bankanızın sayfasına yönlendirilir ve ödemeyi orada onaylarsınız; bu yöntem yalnızca avro ile ödeme yaparken çalışır. İsviçre'den ödeme yapanlar kart, Apple Pay, Google Pay veya Link kullanabilir.

girocard: Yalnızca girocard olan bir kart (eski adıyla EC-Karte), Stripe'ın desteklenen kart markaları arasında girocard bulunmadığından Kunavo Checkout'ta kabul edilmez (güncelleme tarihi: 3 Ekim 2026). Kartınızda ayrıca Visa veya Mastercard logosu varsa ödeme bu ağ üzerinden yapılır; Apple Pay ve Google Pay'de de durum aynıdır.

Sunulmayanlar: PayPal, SEPA otomatik ödeme, manuel banka havalesi (peşin ödeme), giropay ve Sofort. Klarna'yı ödeme sayfası yalnızca ABD'deki alıcılara sunar; ABD dışından ABD dolarına geçiş yapılsa bile Klarna görünmez.

  1. Hesap oluşturun; Kunavo kayıt sırasında kart sormaz.
  2. Faturalandırma bölümünde $10'den başlayan bir yükleme kademesi seçin. Daha büyük kademeler bonus bakiye sağlar: $100 tutarı $110 olur, $1.000 tutarı $1.200 olur ve $5.000 tutarı $6.250 olur.
  3. Stripe ödeme sayfasında ödeme yöntemini seçin. Onaydan önce euro tutarını görürsünüz; EPS kullanıyorsanız çevrim içi bankacılıkta onaylayın.
  4. API-Keys bölümünde bir anahtar oluşturun ve ANTHROPIC_AUTH_TOKEN olarak girin.

Bakiye önceden ödenmiştir: aylık ücret yoktur, son kullanma tarihi yoktur ve başarısız istekler ücretlendirilmez. Otomatik yükleme yalnızca kayıtlı kart veya Link ile yapılabilir; Apple Pay, Google Pay ve EPS ile manuel yükleme yaparsınız. Kunavo, KDV'nin ayrıntılı olarak gösterildiği faturalar düzenlemez; yüklemelerinizi Billing bölümünde görürsünüz. Ödeme yöntemleri ve reddedilen kartlar hakkında daha fazla bilgi: Claude için kredi kartı olmadan ödeme.

Bir oturumun maliyeti: hesaplama örneği

API anahtarıyla token'lar için ödeme yaparsınız ve Claude Code her adımda önceki bağlamın tamamını gönderir. Ancak bu bağlamın tamamı her seferinde ücretlendirilmez: Değişmeyen başlangıç kısmını model önbellekten okur ve bunun için daha düşük önbellek okuma tarifesi uygulanır. Tablo varsayımsal bir örneği hesaplar; ölçüm veya üst sınır değildir. Varsayım:

  • İstek başına 40.000 girdi tokenı; bunların 36.000'si (%90) önbellekten okunur ve 4.000'si önbelleğe yeni yazılır;
  • İstek başına 1.000 Output token;
  • Her çalışma oturumunda bu tür 50 istek; arka plan çağrıları dahil değildir;
  • Önbellek okuma, Claude Sonnet 5 için Input tarifesinin 10 % kadarına mal olur; önbellek yazma bunun 1,25 katıdır. Tablodaki her model kendi katsayılarıyla hesaplanmıştır.
ModelBir istek50 istekÖnbellek isabeti olmadan 50 istek
Claude Sonnet 5$0,019$0,952$3,15
Claude Opus 5$0,0476$2,38$7,88
Claude Opus 5.5$0,033$1,65$6,30

Gerçekte ödeyeceğiniz tutar bağlam uzunluğuna, önbellek isabetlerine ve yanıt uzunluğuna, ayrıca iki görev arasında /clear ile yeniden başlayıp başlamadığınıza bağlıdır. Kendi değerleriniz için Claude token hesaplayıcısı (İngilizce) kullanılabilir; Pro ve Max ile karşılaştırmayı Claude Code fiyat kılavuzu hesaplar.

Hata iletileri ve anlamları

İletiAnlamı ve çözümü
The token '&&' is not a valid statement separatorCMD satırı PowerShell penceresinde kullanılmış. Orada irm … | iex kullanılmalıdır.
'irm' is not recognized as an internal or external command (veya aynı iletinin Almanca sürümü)PowerShell satırı CMD'de kullanılmış. Orada install.cmd içeren satır kullanılmalıdır.
Claude Code does not support 32-bit Windows“Windows PowerShell (x86)” açılmış. (x86) olmayan girişi seçin.
syntax error near unexpected token '<' veya 403Betik yerine bir web sayfası veya hata kodu geldi. VPN, proxy ve şirket güvenlik duvarını denetleyin ya da başka bir ağ deneyin.
App unavailable in regionBağlantı desteklenmeyen bir ülkeden geliyor gibi görünüyor. DE, AT ve CH'de bunun nedeni genellikle VPN veya proxy'dir.
command not found: claude veya claude tanınmıyorKurulum klasörü PATH'te eksik. Yeni bir pencere açın; Windows'ta yukarıdaki PATH komutunu kullanın.
EBADENGINE uyarısıNode.js 22'den eski. Kurulum yine de tamamlanır; ancak güncelleme yapılması önerilir.
claude native binary not installed (macOS, Linux)npm isteğe bağlı bağımlılıkları atladı (--omit=optional, optional=false). Ayarı kaldırıp yeniden yükleyin.
npm.ps1 cannot be loadedYürütme ilkesi npm'yi engelliyor. npm.cmd kullanın, Set-ExecutionPolicy satırını çalıştırın veya bağımsız yükleyiciyi kullanın.
Anahtar ayarlanmış olmasına rağmen oturum açma ekranıAnahtar yalnızca proje ayarlarında bulunuyor. export ile veya ~/.claude/settings.json içinde ayarlayın ve yeni bir terminal açın.
ANTHROPIC_API_KEY ayarlanmış, ancak etkisizTek seferlik onay reddedildi. /config → Use custom API key bölümünden etkinleştirin veya ANTHROPIC_AUTH_TOKEN kullanmaya geçin.
401Anahtar reddedildi. Anahtarı eksiksiz ve boşluksuz kopyaladınız mı, /app/keys adresinde hâlâ mevcut mu ve ANTHROPIC_AUTH_TOKEN içine girildi mi?
404ANTHROPIC_BASE_URL /v1 ile bitiyor veya istenen model Kunavo'da mevcut değil; örneğin Sonnet sabitlemesi olmadan /model sonnet kullanıldıktan sonra.

Bu yöntemin sınırları

  • Token başına ödeme yapılır, sabit ücret yoktur. Claude Code'u her gün saatlerce kullananlar Pro veya Max ile çoğu zaman daha ucuza gelir. Değişken kullanımda yalnızca oluşan tutarı ödersiniz; bir ay hiç kullanım olmazsa ücret alınmaz.
  • claude.ai hesabı olmadan Remote Control ve sesli dikte yoktur; /fast kapalı kabul edilir ve MCP için araç araması varsayılan olarak kapalıdır.
  • Sonnet 5.5 şu anda Kunavo'da sunulmuyor; bu nedenle /model sonnet, opusplan ve Sonnet alt aracıları yukarıdaki örneklerdeki Sonnet sabitlemesini gerektirir.
  • Apple Pay, Google Pay ve EPS yalnızca manuel yükleme için kullanılabilir; otomatik yükleme yalnızca kart veya Link ile yapılır. Euro tutarları Stripe'ın dönüştürme ücretini içerir.
  • Kunavo, KDV'nin ayrıntılı olarak gösterildiği faturalar düzenlemez.
  • Anthropic'in Claude Code belgeleri Almanca olarak mevcut; Kunavo'nun entegrasyon kılavuzu ise yalnızca İngilizcedir.

Sık sorulan sorular

Claude Code kurulumu nasıl yapılır?

Bir terminal açıp sisteminiz için resmî komutu çalıştırırsınız. macOS, Linux ve WSL'de: curl -fsSL https://claude.ai/install.sh | bash. Windows PowerShell'de: irm https://claude.ai/install.ps1 | iex. Windows Komut İstemi'nde (CMD): curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Ardından yeni bir terminal penceresi açıp claude --version yazın. Bir sürüm numarası görünürse Claude Code yüklenmiştir. Bu bağımsız yükleme arka planda kendini otomatik günceller; Homebrew veya WinGet üzerinden yapılan yüklemeleri sizin güncellemeniz gerekir.

Claude Code'u Windows'a yükleme: WSL veya yönetici haklarına ihtiyacım var mı?

İkisi de gerekmez. Claude Code, Windows 10 sürüm 1809'dan itibaren ve Windows Server 2019'da doğrudan çalışır; Anthropic'e göre yükleyicinin yönetici olarak çalıştırılması gerekmez. WSL 2 yalnızca Linux araçlarına veya sandbox kullanımına ihtiyacınız varsa faydalıdır; bu durumda Claude Code'u WSL terminalinde yükleyip başlatın. Windows için Git isteğe bağlıdır: Git ile Claude Code komutları Git Bash'te çalıştırır, Git olmadan PowerShell'de çalıştırır. Yaygın sorunlar, CMD satırını PowerShell penceresinde (veya tersini) kullanmak ve Başlat menüsündeki „Windows PowerShell (x86)“ girdisini açmaktır; bu sonuncusu 32 bit işlem olarak çalıştığı için sonlanır.

Claude Code için Node.js gerekli mi?

Yalnızca npm ile yükleme yapıyorsanız gereklidir; bu durumda Node.js 22 veya daha yeni olmalıdır. Eski kılavuzlarda sıkça Node.js 18 belirtilir; bu bilgi güncel değildir. Bağımsız yükleyici, Homebrew ve WinGet Node.js olmadan çalışır. Node.js sürümünüz çok eskiyse npm EBADENGINE uyarısı verir ancak yine de yüklemeyi sürdürür. Asla sudo ile yükleme yapmayın; güncellemek için npm update -g yerine npm install -g @anthropic-ai/claude-code@latest kullanın.

Claude Code'u abonelik olmadan kullanabilir miyim?

Evet, bir API anahtarıyla. Oturum açmak için Pro, Max, Team, Enterprise veya Console hesabı gerekir; ücretsiz Claude planında Claude Code yoktur. Kunavo ile bunun yerine ANTHROPIC_BASE_URL=https://api.kunavo.com ve ANTHROPIC_AUTH_TOKEN değerlerini tanımlayın; Claude Code oturum açma ekranı olmadan başlar. Her belirteç, $10 tutarından itibaren yüklediğiniz ön ödemeli bakiyeden düşülür; aylık ücret yoktur. Remote Control ve sesli dikte özelliklerinden vazgeçmeniz gerekir; çünkü ikisi de claude.ai hesabı gerektirir.

Claude Code'da API anahtarını nasıl ayarlarım?

En iyisi, ~/.claude/settings.json dosyasının env bloğunda (Windows'ta %USERPROFILE%\.claude\settings.json) tanımlamaktır; alternatif olarak ~/.zshrc veya ~/.bashrc içinde export satırları kullanabilirsiniz. Altı değere ihtiyacınız vardır: /v1 olmadan ANTHROPIC_BASE_URL=https://api.kunavo.com (aksi halde istek /v1/v1/messages adresine gider ve 404 ile başarısız olur), anahtarınızla birlikte ANTHROPIC_AUTH_TOKEN ve ayrıca ANTHROPIC_MODEL=claude-sonnet-5, ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5, ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 ve ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5. ANTHROPIC_AUTH_TOKEN hemen etkinleşir. ANTHROPIC_API_KEY de çalışır; çünkü Kunavo anahtarı her iki üst bilgide kabul eder, ancak etkileşimli modda bir kez onaylanması gerekir. Anahtarı asla bir projenin .claude/settings.json dosyasına yazmayın; bu dosya depoyla paylaşılır.

Claude Code API anahtarıyla hangi modeli kullanır?

Belirlediğiniz modeli kullanır. Herhangi bir model belirlenmezse Anthropic'e göre (3 Ekim 2026 itibarıyla) Claude Code API kullanıcıları için Opus 5.5 ile başlar. Kunavo, Opus 5.5'i sunar; bu modelin belirteç başına maliyeti Claude Sonnet 5 modelinin maliyetinin iki katıdır. ANTHROPIC_MODEL=claude-sonnet-5 ile başlangıç modeli Claude Sonnet 5 olur; bu sayfadaki hesaplama örneğinden bir istek yaklaşık $0,019 tutar. ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5, /model opus komutunun başlattığı modeli belirler; Opus 5.5, Claude Code'un 2.1.280 veya sonraki sürümünü gerektirir; claude update, eski bir kurulumu en güncel sürüme getirir. ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 de gereklidir; çünkü sonnet takma adı API kullanıcıları için Sonnet 5.5'e yönelir ve Kunavo Sonnet 5.5'i sunmaz: Bu satır olmadan /model sonnet, opusplan'ın yürütme aşaması ve model: sonnet kullanan alt aracılar 404 ile sonlanır. ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 arka plan görevleri için de geçerlidir.

Claude Code'un API anahtarını kullandığını /status içinde nasıl anlarım?

Çalışan oturumda /status yazın ve Status sekmesine bakın. Anthropic base URL satırı https://api.kunavo.com adresini, Auth token satırı ise ANTHROPIC_AUTH_TOKEN değerini göstermelidir. Base URL satırı yoksa değişken oturuma ulaşmamıştır. Login method satırında claude.ai hesabı görünüyorsa oturum aboneliğiniz üzerinden çalışıyordur. İlk başlatmada oturum açma ekranını görüyorsanız anahtar muhtemelen yalnızca proje ayarlarında bulunuyordur; Claude Code bunları kurulum sihirbazından sonra değerlendirir.

Claude Code için PayPal, SEPA otomatik ödeme, girocard veya EPS ile ödeme yapabilir miyim?

Kunavo bakiyesi için geçerli durum şöyledir: Avusturya'dan avro ile ödeme yapıyorsanız EPS kullanılabilir. PayPal ve SEPA otomatik ödeme yoktur; Klarna yalnızca ABD'deki alıcılar içindir. Stripe girocard'ı kart markası olarak kabul etmediğinden yalnızca girocard özelliği olan bir kartla ödeme başarısız olur. Kartınızda ayrıca Visa veya Mastercard logosu varsa bu ağ üzerinden, Apple Pay veya Google Pay ile de ödeme yapabilirsiniz. Kredi ve banka kartları ile Link de kullanılabilir. Minimum tutar $10, aylık ücret yoktur ve bakiyenin süresi dolmaz; Stripe'a göre avro tutarı %2–4 dönüşüm ücreti içerir. Otomatik yükleme yalnızca kayıtlı kart veya Link ile yapılabilir. Kunavo, KDV'nin ayrıca gösterildiği faturalar düzenlemez. Claude Pro veya Max aboneliğini bu şekilde ödeyemezsiniz; Anthropic web üzerinde yalnızca kart kabul eder, PayPal kabul etmez.