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.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows-Eingabeaufforderung (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdAnthropic, 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ış
- Yükleme: yukarıdaki uygun satırı çalıştırın, ardından yeni bir terminal penceresi açın.
- Kontrol:
claude --versionbir sürüm numarası döndürür. - Karar: Claude aboneliğiyle oturum açın veya API anahtarı kullanın (karşılaştırma aşağıdadır).
- API anahtarıyla: bakiyeyi yükleyin, anahtar oluşturun ve altı ortam değişkenini ayarlayın.
- Kontrol: oturumda
/statusyazı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.
| Konu | Hâlâ sıkça okunanlar | Anthropic'e göre |
|---|---|---|
| macOS | macOS 10.15 veya daha yeni | macOS 13.0 veya daha yeni |
| Windows | yalnızca WSL üzerinden | Windows 10 sürüm 1809'dan itibaren veya Windows Server 2019'da doğrudan; WSL bir seçenektir, zorunlu değildir |
| İzinler | PowerShell'i yönetici olarak başlatma | gerekli değil |
| Node.js | Node.js 18 veya daha yeni | yalnızca npm kurulumu için, ardından sürüm 22 veya daha yeni |
| npm | güncel değil | hâ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şul | Korumalı çalıştırma | Şu durumda uygundur |
|---|---|---|---|
| WSL'siz Windows | yok; Windows için Git isteğe bağlı | hayır | projeleriniz ve araçlarınız doğrudan Windows'ta çalışıyorsa |
| WSL 2 | WSL 2 etkin | evet | Linux araçlarına ihtiyacınız varsa veya komutları bir sandbox içinde çalıştırmak istiyorsanız |
| WSL 1 | WSL 1 etkin | hayır | bilgisayarda 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 selbstnpm 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.
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@latestKurulum 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 Sitzungclaude 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:
# 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 --versionPowerShell 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:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserAbonelik 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ği | Kunavo API anahtarı | |
|---|---|---|
| Faturalandırma | Aylı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ım | değişken kullanım; bir ay hiç kullanım olmazsa ücret alınmaz |
| Ödeme | Web'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 |
| Kurulum | claude başlatın ve tarayıcıda oturum açın | altı 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.
- Kunavo'ya kaydolun; e-posta adresi veya Google hesabıyla.
- Billing bölümünde en az $10 yükleyin (ödeme yöntemleri için Ödeme bölümüne bakın).
- 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. - 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:
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-5PowerShell'de $env: atamaları yalnızca açık pencere için geçerlidir; ilk deneme için uygundur:
# 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"
claudeUzun 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:
{
"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:
{
"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şken | Değer | Etkisi | Eksik veya yanlış olduğunda |
|---|---|---|---|
ANTHROPIC_BASE_URL | https://api.kunavo.com | tüm istekleri Kunavo'ya yönlendirir; Claude Code /v1/messages yolunu kendisi ekler | Sonunda /v1 bulunursa istek /v1/v1/messages adresine gider ve 404 ile başarısız olur. |
ANTHROPIC_AUTH_TOKEN | Anahtarınız (sk-kn-…) | Authorization: Bearer olarak gönderilir ve hemen öncelik kazanır | Bunun 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_MODEL | claude-sonnet-5 | Her oturumun başlangıç modeli | Bu 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_MODEL | claude-opus-5-5 | /model opus hedefi ve ANTHROPIC_MODEL olmadan varsayılanın kullandığı sürüm | Bu 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_MODEL | claude-sonnet-5 | /model sonnet hedefi, opusplan yürütme aşamasının ve model: sonnet ile alt aracıların modeli | Bu 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_MODEL | claude-haiku-4-5 | /model haiku hedefi ve arka plan işlevleri için model | Bu 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:
| Model | Kunavo (Girdi / Çıktı) | Anthropic liste fiyatı (Input / Output) | Fark | Claude Code'daki rolü |
|---|---|---|---|---|
claude-haiku-4-5 | $0,70 / $3,50 | $1,00 / $5,00 | ~30 % daha ucuz | Claude Code'un haiku takma adı ve arka plan görevleri |
claude-sonnet-5 | $1,40 / $7,00 | $2,00 / $10,00 | ~30 % daha ucuz | Günlük işler için ana model (ANTHROPIC_MODEL) |
claude-opus-5-5 | $2,80 / $14,00 | $4,00 / $20,00 | ~30 % daha ucuz | Yukarı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 ucuz | Takma 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ır | Doğru | Değilse |
|---|---|---|
Anthropic base URL | https://api.kunavo.com | Bu 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 token | ANTHROPIC_AUTH_TOKEN değerini belirtir | Bunun 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.
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": "."}]}'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_TOKENveyaANTHROPIC_API_KEYetkin olduğu sürece devre dışıdır. AyrıcaANTHROPIC_BASE_URLAnthropic dışındaki bir ana bilgisayara işaret ediyorsa Remote Control, 2.1.196 sürümünden itibaren devre dışıdır. /fastFast 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_SEARCHile açıkça etkinleştirilebilir. /contexttahmini 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öntemi | Nerede | Not |
|---|---|---|
| Kart (Visa, Mastercard, Amex, JCB, UnionPay) | her yerde | Kredi ve banka kartları; Visa Debit ve Debit Mastercard da dahil, ancak yalnızca girocard değil |
| Apple Pay | Safari, iPhone ve iPad; Hindistan'da değil | Wallet'taki bir kartla, Visa veya Mastercard banka kartıyla da; yalnızca girocard ile değil |
| Google Pay | Google Pay kurulmuş Chrome ve Android; Hindistan'da değil | Wallet'taki bir kartla, Visa veya Mastercard banka kartıyla da; yalnızca girocard ile değil |
| Link | Hindistan hariç her yerde | Stripe’ın ödeme hizmeti; kartınızı kaydeder ve otomatik yükleme de bununla yapılabilir |
| EPS | Avusturya, 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.
- Hesap oluşturun; Kunavo kayıt sırasında kart sormaz.
- 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.
- 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.
- API-Keys bölümünde bir anahtar oluşturun ve
ANTHROPIC_AUTH_TOKENolarak 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.
| Model | Bir istek | 50 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ı
| İleti | Anlamı ve çözümü |
|---|---|
The token '&&' is not a valid statement separator | CMD 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 403 | Betik 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 region | Bağ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ıyor | Kurulum 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 loaded | Yü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 etkisiz | Tek seferlik onay reddedildi. /config → Use custom API key bölümünden etkinleştirin veya ANTHROPIC_AUTH_TOKEN kullanmaya geçin. |
401 | Anahtar 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? |
404 | ANTHROPIC_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;
/fastkapalı 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,opusplanve 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.