Claude Code'u Windows, macOS ve Linux'a yükleme: aboneliksiz API anahtarı ve Bancontact ile ödeme

Claude Code'u kurmak için tek bir satır yeterlidir, ancak bu satır her yerde aynı değildir: macOS, Linux veya WSL terminalinde curl -fsSL https://claude.ai/install.sh | bash, PowerShell'de irm https://claude.ai/install.ps1 | iex ve Windows komut isteminde install.cmd satırı. Gerçek soru ilk başlatmada gelir: İstekleri kim ödüyor? Pro, Max, Team, Enterprise veya Console hesabıyla oturum açabilirsiniz (Claude.ai'nin ücretsiz planı Claude Code'u içermez). Abonelik olmadan bir API anahtarı yeterlidir: /v1 içermeyen ANTHROPIC_BASE_URL ve ANTHROPIC_AUTH_TOKEN dahil altı değişkeni ayarlayın, ardından /status komutuna göz atın. Kunavo bakiyesi kart, Apple Pay, Google Pay, Link veya Belçika'da Bancontact ile, $10'den başlayan tutarla ve abonelik olmadan ödenir.

Bilgilerin kaynağı: Komutlar ve değişkenler, kurulum, ortam değişkenleri ve bir ağ geçidine bağlanma hakkındaki resmî Claude Code belgelerinden alınmış ve 3 Ekim 2026 tarihinde yeniden kontrol edilmiştir; Kunavo fiyatları ve ödeme yöntemleri 10 Ekim 2026 tarihinde doğrulanmıştır. Anthropic'in desteklenen ülkeler listesine göre (3 Ekim 2026 tarihinde kontrol edildi) Claude.ai ve API, Fransa, Belçika, İsviçre, Lüksemburg ve Kanada'da olduğu gibi Fas, Tunus, Cezayir, Senegal ve Fildişi Sahili'nde de kullanılabilir. Aynı kılavuz İngilizce olarak ve Flaman bölgesi için Hollandaca olarak da mevcuttur.

Yazılacak komut: her şey pencereye bağlıdır

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

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

:: Invite de commandes Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

İlk üç satır, Anthropic’in önerdiği bağımsız sürümü kurar: güncellemelerini arka planda indiren ve bir sonraki başlatmada uygulayan, ~/.local/bin (%USERPROFILE%\.local\bin Windows’ta) içine yerleştirilen bağımsız bir ikili dosya. Kurulum tamamlandığında terminali kapatıp yenisini açın: kurulumu gerçekleştiren terminal yeni PATH’i henüz bilmiyor.

Windows’ta yanlış pencereyi kullanmak, başarısızlığın bir numaralı nedenidir ve ileti bunu açıkça belirtir. The token '&&' is not a valid statement separator: CMD satırını PowerShell’e yapıştırdınız. 'irm' is not recognized as an internal or external command: tam tersi. Fransızca Windows’ta bu ikinci ileti çevrilmiş olarak görünebilir; neden değişmez. Diğer iletiler kılavuzun sonundaki hata tablosundadır.

Gereksinimler

Windows: Eski eğitimlerin söyledikleri ve günümüzde geçerli olan

Fransızca birçok rehber, Claude Code'un ilk sürümlerinden kalmadır. Yaygın önerileri, güncel kurulum belgeleri ve sorun giderme sayfasındaki bilgilerle karşılaştırdık (3 Ekim 2026 tarihinde kontrol edildi):

Git for Windows'u yüklerseniz Claude Code, PowerShell aracını da yanında tutarak Git Bash üzerinden çalışır. Bazen bash.exe'i bulamaz: bu durumda ~/.claude/settings.json'nin env bloğunda yer alan CLAUDE_CODE_GIT_BASH_PATH değişkenine yolunu belirtin (belgelerde örnek olarak C:\Program Files\Git\bin\bash.exe verilmiştir). Son bir tuzak: “Windows PowerShell (x86)” kısayolu, Claude Code'un kabul etmediği 32 bitlik sürümü açar.

WSL'siz Windows veya WSL seçimi, projelerinizin bulunduğu yere göre yapılır:

WSL tarafında her şey Linux dağıtımının içinde gerçekleşir: curl … | bash satırını buraya yapıştırır ve ardından claude komutunu burada yazarsınız. PowerShell veya CMD’den başlatılırsa bu kurulumu göremez.

Homebrew, WinGet, apt veya npm

Paket yöneticileri çalışır, ancak bir karşılığı vardır: Claude Code bunlarla otomatik olarak güncellenmez. Homebrew ve WinGet için CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 değişkeni Claude Code’un güncellemeyi kendisinin başlatmasını sağlar; bu değişken olmadan güncellemeyi sizin yapmanız gerekir:

# Homebrew (macOS)
brew install --cask claude-code
brew upgrade claude-code              # pas de mise à jour automatique

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # pas de mise à jour automatique

Debian, Ubuntu, Fedora, RHEL ve Alpine için Anthropic, sistemin geri kalanıyla birlikte güncellenen imzalı apt, dnf ve apk depoları da yayımlar; kurulum adımları kurulum sayfasında yer alır.

Node.js araç zincirinizin zaten bir parçasıysa npm kullanışlıdır. Paket en az Node.js 22 ister. Daha eski bir sürümde npm yalnızca EBADENGINE uyarısı verir ve kurulumu tamamlar; çünkü paket, çalışmak için Node.js gerektirmeyen aynı derlenmiş ikili dosyayı kurar. İki kural: sudo npm install -g kullanmayın ve güncelleme için @latest kullanın; çünkü npm update -g başlangıçtaki sürüm aralığında kalır ve geride kalmanıza neden olabilir.

node -v                                       # v22 ou plus récent
npm install -g @anthropic-ai/claude-code      # jamais avec sudo

# mise à jour : avec @latest, pas avec npm update -g
npm install -g @anthropic-ai/claude-code@latest

Kurulumu doğrulama ve PATH’i düzeltme

claude --version   # affiche le numéro de version, suivi de (Claude Code)
claude doctor      # diagnostic de l’installation et des réglages, sans ouvrir de session

Çıktıda bir sürüm numarası görüyorsanız kurulum tamamlanmıştır. claude doctor oturum başlatmadan daha ileri kontroller yapar: kurulum durumu, ayar dosyalarındaki hatalar ve son güncellemenin sonucu. Bir şeyler ters gittiğinde çalıştırılacak ilk komut budur.

macOS veya Linux'ta command not found: claude, Windows'ta claude için “tanınmıyor” hatası: program yüklenmiştir ama kabuk onu nerede arayacağını bilmiyordur. Çoğu zaman yeni bir pencere açmak yeterlidir. Yetmezse ~/.local/bin'yi ~/.zshrc veya ~/.bashrc'te PATH'e ekleyin. Windows için resmî sorun giderme sayfası şu üç PowerShell adımını verir:

# 1. Le dossier d'installation est-il déjà dans le PATH ?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Aucun résultat ? Ajoutez-le au PATH de l'utilisateur, puis ouvrez une nouvelle fenêtre
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Dans la nouvelle fenêtre : deux chemins = deux installations concurrentes
where.exe claude

npm ile kurulum yaptınız ve PowerShell npm.ps1 cannot be loaded yanıtını mı veriyor? Yürütme ilkesi npm betiklerini engelliyor. Bağımsız yükleyiciye geçin veya yalnızca kendi hesabınız için yerel betiklere izin verin:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

İsteklerin ücretini kim öder: Claude aboneliği mi, API anahtarı mı

Seçim kurulum sırasında değil, ilk başlatmada yapılır ve geri alınabilir. Ortamda tanımlanan bir anahtar, kayıtlı claude.ai oturum açma bilgisinin önüne geçer; bu bilgi pasif kalır. Değişkeni silerseniz sonraki başlatmada oturum açma bilgisi yeniden kullanılır.

Claude aboneliğiyle

Yapılandırılacak bir şey yok: proje klasöründe claude, ardından tarayıcıda oturum açın. Tek istisna, ortamınızda kalmış bir ANTHROPIC_API_KEY değişkenidir. Claude Code bu durumda bir kez bunu kullanıp kullanmayacağını sorar; reddetme kaydedilir ve anahtar daha sonra ileti gösterilmeden yok sayılır. Bu, değişkenin okunmadığı izlenimini verebilir. Bu seçimi değiştirmek için: /config → Özel API anahtarını kullan.

Abonelik olmadan: Kunavo API anahtarı

Claude Code'u Anthropic dışındaki bir noktaya yönlendirmek geçici bir çözüm değildir. Resmî ortam değişkenleri listesinde ANTHROPIC_BASE_URL, istekleri bir proxy'ye veya ağ geçidine göndermenin yolu olarak açıklanır. Kunavo, Anthropic'in Messages API biçiminde yanıt verir: resmî Claude Code'u eklenti veya değiştirilmiş sürüm olmadan kullanmaya devam edersiniz.

1. Bir hesap açın: Kunavo kaydı.
2. Billing bölümünde bakiyeye en az $10 yükleyin (ödeme yöntemleri aşağıdadır).
3. /app/keys bölümünde bir anahtar oluşturun. Anahtar sk-kn- ile başlar ve yalnızca oluşturulurken gösterilir: hemen kopyalayın.
4. Aşağıdaki altı değişkeni girin.

Neden dört modeli sabitlemeli? Claude Code'un takma adları Anthropic'in yayımlarını izler. Model yapılandırması belgesine göre (3 Ekim 2026 tarihinde kontrol edildi), API hesabında varsayılan ayar ve opus bugün Opus 5.5'i; sonnet ise Kunavo'nun sunmadığı Sonnet 5.5'i hedefliyor. ANTHROPIC_DEFAULT_SONNET_MODEL olmadan /model sonnet, opusplan'nin yürütme aşaması ve sonnet'ye ayarlanmış alt ajanlar 404 hatasıyla karşılaşır. opus takma adı Opus 5.5'e sabitlenmiştir (claude-opus-5-5); bu model için Claude Code v2.1.280 veya üzeri gerekir. Daha eski bir sürümde claude update'i çalıştırın. Yeni yayımlanan bir model de Kunavo'da aynı gün kullanıma sunulmayabilir. Tam model adlarıyla her istek, sunulan bir modele ve bildiğiniz ücrete yönelir. ağ geçidi protokolü belgesi (3 Ekim 2026 tarihinde kontrol edildi), arka plan görevleriyle ilgili noktayı doğruluyor: Claude Haiku 4.5 ile bu görevler düşük maliyetlidir.

Değişkenlerin yazılacağı yer

Zaten içerik varsa dosyanın mevcut içeriğiyle birleştirilecek önerilen sürüm (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"
  }
}

macOS ve Linux’ta shell içindeki aynı değerler:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # le domaine seul, sans /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 penceresinde hızlı bir test için:

# Valable uniquement dans cette fenêtre PowerShell
$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

VS Code uzantısı için düzenleyicinin kullanıcı ayarlarına şu komutla gidin: Preferences: Open User 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" }
  ]
}

Claude masaüstü uygulaması bir istisnadır: ne ANTHROPIC_BASE_URL ne de settings.json okur. Shell’de değiştirdiğiniz bir değişken etkisiz mi kaldı? Önce aynı değişkeni öncelikli bir settings.json içinde arayın.

Kunavo kataloğundan alınan milyon token başına fiyatlar ve claude.com/pricing adresinde kaydedilen Anthropic liste fiyatı karşılaştırması (3 Ekim 2026 tarihinde kontrol edildi):

Bir görev süresince Opus’a geçmek için oturum sırasında /model opus kullanın (claude-opus-5-5 üzerine sabitlenmiş takma ad) veya başlangıçta claude --model claude-opus-5-5 çalıştırın. Kullanımınıza göre aylık bütçe ve aboneliğin daha avantajlı hâle geldiği eşik Claude Code fiyatlandırması sayfasında hesaplanmıştır. Claude token maliyeti hesaplayıcısı kendi hacimleriniz için hesabı yapar; fiyatlandırma sayfası tüm modelleri listeler.

/status ile doğrulama

İlk belirti, hatta /status çalıştırılmadan önce: ANTHROPIC_AUTH_TOKEN tanımlıyken Claude Code oturum açma ekranı olmadan başlar. Bu ekran görünürse hiçbir anahtar okunmamıştır; çoğunlukla anahtar yalnızca proje ayarlarında (.claude/settings.json veya .claude/settings.local.json) bulunur. Etkileşimli oturumda bu env bloğu yalnızca ilk başlatma yardımcısından ve klasöre güven sorusundan sonra uygulanır. Anahtarı shell’e veya ~/.claude/settings.json içine taşıyın.

Oturuma girdikten sonra /status komutu Status sekmesini açar. ağ geçitleri belgesine göre (3 Ekim 2026 tarihinde kontrol edildi) bu sekmeyi şöyle okuyabilirsiniz:

Zaten abonelikle oturum açmış mıydınız? Claude Code başlangıçta iki etkin kimlik kaynağı bulunduğunu ve uyarının auth may not work as expected ile bittiğini bildirebilir. İsteklerde kullanılan anahtar budur; /logout eski oturumu siler ve uyarıyı kaldırır.

Bir sorunun Kunavo’dan mı yoksa yapılandırmanızdan mı kaynaklandığını öğrenmek için Claude Code olmadan test edin. Belgeler, tek bir çıktı tokenıyla sınırlı ve sentin küçük bir kısmına mal olan bir istek önerir. Aşağıdaki iki komut adresi ve anahtarı shell’den alır: yalnızca settings.json içinde tanımlanmışlarsa burada görülmezler.

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ğeri msg_ ile başlayan bir nesne: adres ve anahtar çalışıyor. 401: anahtar reddedildi.

API anahtarıyla değişenler

• Remote Control ve sesli dikte kullanılamaz. Her ikisi de claude.ai hesabına dayanır ve ANTHROPIC_AUTH_TOKEN tanımlı olduğu sürece kullanılamaz. ANTHROPIC_BASE_URL, Anthropic dışındaki başka bir ana bilgisayarı gösterdiğinde Remote Control da devre dışı kalır.
• Hızlı mod (/fast) devre dışı görünür; çünkü doğrulama claude.ai oturumu veya Anthropic anahtarı gerektirir, basit bir bearer token yeterli değildir.
• MCP araç araması varsayılan olarak kapatılır çünkü ANTHROPIC_BASE_URL Anthropic dışındaki bir konumu gösterir.
• /context tahmini değerler gösterir. Kunavo /v1/messages/count_tokens'yi sunmuyor; bu durumda Claude Code, karakter sayısına göre hesaplama yapar (ağ geçidi protokolü belgesi).

Geri kalan her şeyde (kod okuma ve yazma, araçlar, alt aracılar, MCP sunucuları, hook’lar, prompt önbelleği) hiçbir şey değişmez. İngilizce teknik ayrıntılar Claude Code entegrasyonu belgelerinde yer alır.

Fransa veya Belçika’dan ödeme yapma

Karıştırılmaması gereken iki ödeme yöntemi var. Web üzerinden satın alınan Claude aboneliği yalnızca kredi veya banka kartıyla ödenir (Anthropic faturalandırma SSS, 3 Ekim 2026 tarihinde kontrol edildi); mobil uygulamadan alınan aboneliğin ödemesi ise App Store veya Google Play üzerinden yapılır. claude.com/pricing adresindeki tutarlar vergiler hariçtir.

Kunavo bakiyesi ise Stripe ödeme sayfası üzerinden yüklenir. Fiyat ABD doları cinsinden belirlenir, ancak Fransa veya Belçika'dan bağlandığınızda Stripe size 24 saat boyunca garanti edilen ve sizin karşıladığınız %2–4 döviz dönüştürme ücretini içeren bir kur üzerinden tutarı avro olarak gösterir (Stripe'ın Adaptive Pricing belgesi, 3 Ekim 2026 tarihinde kontrol edildi). Bu ücretlerden kaçınmak için dolar olarak ödeme yapabilirsiniz; ancak bu durumda bankanız kendi döviz kurunu uygular ve Bancontact yalnızca avro cinsinden ödemelerde sunulur. Kullanılabilir ödeme yöntemleri:

• Fransız CB kartı mı? Stripe'ın Cartes Bancaires belgesine göre (3 Ekim 2026 tarihinde kontrol edildi), CB kartlarının %95'inden fazlası Visa veya Mastercard ortak markasını taşır. Bu nedenle ödeme sayfasında Visa veya Mastercard olarak işleme alınırlar; sıradan bir banka kartı yeterlidir.
• Bancontact Belçika'da bulunan alıcılara sunulur. Stripe, onaylamanız için sizi Bancontact sitesine veya uygulamasına yönlendirir ve işlem sonucu hemen belli olur (Stripe'ın Bancontact belgesi, 3 Ekim 2026 tarihinde kontrol edildi).
• Çevrimiçi bankanız üzerinden ödeme yapmanızı sağlayan Pay by Bank, Fransa veya Belçika'dan kullanılamaz: ödeme sayfasında yalnızca Birleşik Krallık, İrlanda ve Finlandiya'da bulunan alıcılara gösterilir. Stripe'ın Pay by Bank belgesi (3 Ekim 2026 tarihinde kontrol edildi), hizmeti Fransa için özel önizleme olarak sınıflandırıyor ve Belçika'dan söz etmiyor.
• İsviçre veya Kanada’dan tutar İsviçre frangı veya Kanada doları cinsinden gösterilir; karta ve Link’e ek olarak karta dayanan Apple Pay ve Google Pay de kullanılabilir.

Sunulmayanlar: PayPal, SEPA otomatik ödeme ve yalnızca Amerika Birleşik Devletleri’ndeki alıcılara sunulan Klarna (dolarla ödeme yapmak yeterli değildir).

1. Kunavo’ya kaydolun; bu aşamada kart istenmez.
2. Billing bölümünde tutarı seçin: en az $10. Daha yüksek tutarlar bonus kazandırır ($100 ödenir, $110 bakiyeye eklenir; $1.000 ödenir, $1.200 bakiyeye eklenir; $5.000 ödenir, $6.250 bakiyeye eklenir).
3. Stripe sayfasında ödeme yöntemini seçin; avro tutarı onaydan önce gösterilir. Bancontact ile uygulamada veya kartla onaylayın.
4. /app/keys bölümünde anahtarı oluşturun ve ANTHROPIC_AUTH_TOKEN içine yerleştirin.

Bakiye ön ödemelidir: aylık ücret yoktur, bakiyenin son kullanma tarihi yoktur ve başarısız olan istekler ücretlendirilmez. Otomatik bakiye yükleme için kayıtlı bir kart veya Link gerekir. Bancontact, Stripe üzerinden yinelenen ödemeleri desteklemez; bu nedenle her Bancontact bakiye yüklemesi manuel olarak başlatılır. Kunavo, Fransa, Belçika veya başka herhangi bir ülke için KDV içeren fatura düzenlemez; bakiye yükleme geçmişi Billing bölümünden görüntülenebilir. Son olarak, bu ödeme yöntemleri yalnızca Kunavo API bakiyesi için kullanılır ve Claude Pro veya Max aboneliğinin ödemesini karşılamaz. App Store ve Google Play dahil diğer tüm seçenekler, Claude için banka kartı olmadan ödeme yapma rehberinde incelenmektedir.

Yaygın hatalar

Bir projede ilk adımlar

Claude Code’un keşfettiği bir depoda /init ile başlayın: kodu inceler ve belirlenen test komutlarını ve kuralları kaydeden bir CLAUDE.md oluşturur. Bu dosyayı gözden geçirip kısaltın; çünkü her oturumda yeniden yüklenir. Konu değiştirmek için /clear boş bir konuşma başlatır; uzun bir görevi sürdürmek için /compact geçmişi özetler.

API anahtarının sınırları

• Claude Pro veya Max planı değil, kullandıkça ödeme yaparsınız. Claude Code’u her gün birkaç saat kullanıyorsanız abonelik çoğunlukla daha avantajlıdır; düzensiz kullanımda token başına ödeme daha esnektir ve düşük kullanım ayları hiçbir ücrete mal olmaz. Rakamlar Claude Code fiyatlandırması sayfasındadır.
• Anahtar etkin olduğu sürece Remote Control ve sesli dikte kullanılamaz.
• Kunavo kapasitesi paylaşılır; ayrılmış kota veya sözleşmesel taahhüt yoktur. İhtiyacınız varsa doğrudan Anthropic ile sözleşme yapın.
• Bancontact yalnızca manuel yüklemeye izin verir; otomatik yükleme kayıtlı bir kart veya Link üzerinden yapılır.
• Avro tutarlarına Stripe’ın dönüştürme ücretleri dâhildir ve Kunavo KDV’li fatura düzenlemez.

Sık sorulan sorular