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

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

Claude Code tek bir komutla yüklenir. Genellikle sonrasında takılırsınız: yanlış Windows penceresinde, PATH'te veya npm'deki Node.js sürümünde. Ardından abonelik olmadan API anahtarı ayarlamanız ve euro cinsinden nasıl ödeme yapacağınızı bilmeniz gerekir.

Claude Code'u tek bir resmi komutla yükleyebilirsiniz: macOS, Linux ve WSL'de curl -fsSL https://claude.ai/install.sh | bash, Windows'ta PowerShell ile irm https://claude.ai/install.ps1 | iex (Komut İstemi, CMD'de aşağıdaki install.cmd satırıyla). Ardından ödeme yönteminizi seçersiniz. Pro, Max, Team, Enterprise veya Console hesabıyla oturum açabilirsiniz (ücretsiz Claude.ai aboneliği Claude Code içermez) ya da abonelik olmadan bir API anahtarı kullanabilirsiniz: ANTHROPIC_BASE_URL (yalnızca alan adı, /v1 olmadan), ANTHROPIC_AUTH_TOKEN ve dört model değişkenini ayarlayıp anahtarın etkin olduğunu /status ile kontrol edersiniz. Kunavo bakiyenizi Hollanda'da iDEAL veya Belçika'da Bancontact ile, $10'den başlayan tutarla ve aylık ücret olmadan yüklersiniz.

Claude Code'un resmî kurulum belgelerindeki komutlar ve değişkenler ile ortam değişkenleri belgeleri 3 Ekim 2026 tarihinde kontrol edildi; fiyatlar ve ödeme yöntemleri 10 Ekim 2026 tarihinde doğrulandı. Hollanda ve Belçika, hem Claude.ai hem de API için Anthropic'in desteklediği ülkeler listesinde bulunuyor (3 Ekim 2026 tarihinde kontrol edildi). Bu kılavuz İngilizce olarak da mevcut: Install Claude Code.

Yüklemeden önce

BileşenGereksinim (resmi yükleme belgeleri, 3 Ekim 2026 tarihinde kontrol edilmiştir)
İşletim sistemimacOS 13.0 veya daha yeni; Windows 10 1809 veya daha yeni ya da Windows Server 2019 veya daha yeni; Ubuntu 20.04+; Debian 10+; Alpine Linux 3.19+
DonanımEn az 4 GB RAM, x64 veya ARM64 işlemci (32 bit Windows desteklenmez)
KabukBash, Zsh, PowerShell veya CMD
Ağ ve konumAnthropic'in desteklediği bir ülkede internet bağlantısı (Hollanda ve Belçika listede yer alır)
HesapOturum açmak için Pro, Max, Team, Enterprise veya Console gerekir; ücretsiz Claude.ai aboneliği Claude Code içermez. API anahtarıyla abonelik gerekmez ve oturum açmazsınız.
Node.jsYalnızca npm yöntemi için ve o durumda 22 veya daha yeni sürüm; bağımsız yükleyici buna ihtiyaç duymaz

Claude Code'u macOS ve Linux'a yükleme

Terminal'i açın ve bu satırı yapıştırın:

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

Önerilen bağımsız yükleme budur: arka planda kendini otomatik olarak güncelleyen tek bir bağımsız program. claude komutu ~/.local/bin içine yerleştirilir. Zaten açık olan bir terminal yeni PATH değerini henüz bilmez; bu nedenle test etmeden önce yeni bir pencere açın. WSL'de aynı satırı WSL terminalinde kullanın.

Claude Code'u Windows'a yükleme

Windows'ta iki satır vardır ve hangisine ihtiyacınız olduğu yalnızca açık olan pencereye bağlıdır. İstem PS C:\Users\Naam> ile başlıyorsa PowerShell'desiniz; yalnızca C:\Users\Naam> varsa ve PS içermiyorsa bu Komut İstemi'dir (CMD). Pencereyi yönetici olarak açmanız gerekmez: resmi belgelere göre buna ihtiyaç yoktur.

PowerShell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
cmd.exe
:: Windows Opdrachtprompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

En sık yapılan hata, satırı yanlış pencereye yapıştırmaktır. CMD satırı PowerShell'de The token '&&' is not a valid statement separator hatasını verir; PowerShell satırı CMD'de 'irm' is not recognized as an internal or external command hatasını verir. Türkçe bir Windows'ta ikinci ileti aynı nedenle Türkçe görünebilir. Ayrıca | bash içeren macOS satırı PowerShell'de bash öğesinin tanınmadığını belirten bir hata verir. Her üç durumda da pencerenize uygun satırı kullanın.

Git for Windows isteğe bağlıdır. Yüklüyse Claude Code, komutları birlikte gelen Git Bash üzerinden çalıştırır; Git yüklü değilse PowerShell kullanır. Git yüklü olduğu hâlde Git Bash bulunamıyorsa ~/.claude/settings.json dosyasının env bölümünde CLAUDE_CODE_GIT_BASH_PATH değişkenini bash.exe yoluna ayarlayın; belgelerdeki örnek yol C:\Program Files\Git\bin\bash.exe şeklindedir.

SeçenekGerekenlerKorumalı çalıştırmaNe zaman seçilir
WSL'siz WindowsHiçbir şey; Git for Windows isteğe bağlıDesteklenmiyorWindows'un kendisinde çalışan projeler ve araçlar
WSL 2WSL 2 etkinDestekleniyorLinux araçları gerekiyor veya komutlar bir sandbox içinde çalıştırılıyor
WSL 1WSL 1 etkinDesteklenmiyorWSL 2 kullanılamıyorsa

Dolayısıyla WSL, bazı eski kılavuzların iddia ettiği gibi bir gereklilik değil, bir seçenektir. WSL'yi seçerseniz macOS/Linux satırını WSL terminalinde çalıştırın ve claude komutunu da orada başlatın; PowerShell veya CMD'den başlatmayın.

Homebrew, WinGet veya npm aracılığıyla

Bu da mümkündür; ancak önemli bir fark vardır: resmi belgelere göre Homebrew ve WinGet yüklemeleri otomatik olarak güncellenmez. Bu durumda güncellemeyi kendiniz yapmanız gerekir:

# Homebrew (macOS)
brew install --cask claude-code
brew upgrade claude-code              # bijwerken gebeurt niet vanzelf

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # bijwerken gebeurt niet vanzelf

npm paketi Node.js 22 veya daha yeni bir sürüm ister; eski kılavuzların hâlâ yazdığı gibi Node.js 18 değil. Daha eski bir Node.js sürümüyle npm yalnızca bir EBADENGINE uyarısı gösterir ve yükleme normal şekilde devam eder: paket, çalışmak için Node.js gerektirmeyen aynı derlenmiş programı yükler. Hiçbir zaman sudo npm install -g kullanmayın: bu, izin sorunlarına yol açar ve güvenlik riski oluşturur. Güncellemeyi @latest ile yapın, npm update -g ile değil.

Terminal
node -v                                           # moet v22 of hoger zijn
npm install -g @anthropic-ai/claude-code          # nooit met sudo

# later bijwerken: met @latest, niet met npm update -g
npm install -g @anthropic-ai/claude-code@latest

Yüklemeyi kontrol etme

claude --version   # toont het versienummer, gevolgd door (Claude Code)
claude doctor      # alleen-lezen diagnose van installatie en instellingen, start geen sessie

claude doctor bir oturum başlatmaz; bunun yerine yüklemenin ve ayar dosyalarınızın durumunu gösterir. Böylece sorunun yüklemede mi yoksa yapılandırmada mı olduğunu hızlıca görebilirsiniz.

command not found: claude hatasını alırsanız veya Windows claude komutunun tanınmadığını bildirirse kurulum dizini PATH'inizde değildir. Önce yeni bir terminal penceresi açın. Bu işe yaramazsa macOS ve Linux'ta ~/.local/bin'yi ~/.zshrc veya ~/.bashrc aracılığıyla PATH'inize ekleyin. Windows'taki dizin %USERPROFILE%\.local\bin'dir; resmî sorun giderme kılavuzuna göre PowerShell'de şöyle kontrol edip ekleyebilirsiniz:

PowerShell
# 1. Staat de installatiemap al in je PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Geen uitvoer? Voeg de map toe aan je gebruikers-PATH en open een nieuw venster
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. In het nieuwe venster: twee paden betekent twee installaties naast elkaar
where.exe claude

npm üzerinden yükleme yaptığınızda PowerShell npm.ps1 cannot be loaded because running scripts is disabled on this system bildiriyorsa PowerShell'in yürütme ilkesi npm başlangıç komut dosyalarını engelliyordur. Bağımsız yükleyiciyi kullanın, npm.cmd ve claude.cmd komutlarını başlatın veya yerel komut dosyalarına kendi kullanıcı hesabınız için izin verin:

PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

İlk başlatma: abonelik veya API anahtarı

İlk başlatmada Claude Code'un nasıl ücretlendirileceğini seçersiniz. İki yöntem birbirini dışlar: bir API anahtarı ayarlanmışsa kayıtlı oturum açma kullanılmaz; değişkeni kaldırırsanız Claude Code yeniden yükleme yapmadan oturum açma yöntemine geri döner.

Yöntem A: abonelikle oturum açmaYöntem B: abonelik olmadan API anahtarı
GerekenlerPro, Max, Team, Enterprise veya Console hesabısk-kn- ile başlayan bir Kunavo anahtarı
Nasıl ödeme yapılırPro ve Max: aylık sabit ücret; Console: Anthropic'te token başınaToken başına, önceden ödenmiş bakiyeden; aylık ücret yok
Ödeme yöntemiWeb sitesi üzerinden yalnızca kredi veya banka kartıiDEAL, Bancontact, kart, Apple Pay, Google Pay veya Link
Remote Control ve sesle dikteMevcut: her ikisi de yalnızca bir claude.ai oturum açma işlemiyle çalışırMevcut değil
KurulumTarayıcıda oturum açmaAltı ortam değişkeni

Yöntem A: aboneliğinizle oturum açma

Proje klasörünüzde claude komutunu başlatın ve tarayıcı üzerinden oturum açın. Bir tuzak: ANTHROPIC_API_KEY zaten ayarlanmışsa Claude Code bu anahtarı kullanıp kullanmaması gerektiğini bir kez sorar. Reddederseniz daha sonra anahtarı sormadan yok sayar ve değişken okunmuyormuş gibi görünür. /config → Use custom API key yoluyla yeniden etkinleştirin.

Yöntem B: abonelik olmadan API anahtarıyla

ANTHROPIC_BASE_URL, Claude Code'un yerleşik bir değişkenidir. Resmi belgelere göre API uç noktasını geçersiz kılar ve istekleri bir proxy veya ağ geçidi üzerinden göndermeyi sağlar. Claude Code'u Anthropic Messages API'sini kullanan bir uç noktaya yönlendirmek, eklenti veya özel sürüm gerektirmeyen desteklenen bir yapılandırmadır. Adımlar:

  1. Kunavo hesabı açın.
  2. Bakiyenizi Faturalandırma üzerinden, $10'den başlayan tutarla yükleyin (iDEAL ve Bancontact aşağıda açıklanmıştır).
  3. /app/keys adresinde sk-kn- ile başlayan bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir; bu nedenle hemen kaydedin.
  4. Değişkenleri ayarlayın. macOS ve Linux'ta ~/.zshrc veya ~/.bashrc dosyasında:
~/.zshrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # alleen het domein, zonder /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Windows'ta önce tek bir PowerShell penceresinde test etmek için:

PowerShell
# Geldt alleen voor dit PowerShell-venster
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Kalıcı kullanım için en iyi yer, kullanıcı ayarlarınızın env bloğudur: ~/.claude/settings.json (Windows'ta %USERPROFILE%\.claude\settings.json). Buradaki değerler, arka plan aracılarında dahil olmak üzere Claude Code'un çalıştığı her yerde geçerlidir. Shell değişkenleri yalnızca o terminal penceresi için geçerlidir: Dock'tan veya Başlat menüsünden açtığınız bir düzenleyici bunları görmez. Dosyada başka ayarlar 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"
  }
}

Anahtarı bir projedeki .claude/settings.json dosyasına asla koymayın: resmî gateway belgelerine (3 Ekim 2026 tarihinde kontrol edildi) göre bu dosya repoya kaydedilir ve depoyu klonlayan herkesle paylaşılır. Değişkenlerin öncelik sırasına da dikkat edin: kabuğunuzda ve bir ayar dosyasında aynı değişken tanımlıysa ayar dosyasındaki değer geçerli olur. Kabuğunuzdaki bir değişiklik etkili olmuyorsa önce settings.json'yi kontrol edin.

Her satırın kendine özgü bir tuzağı vardır:

  • ANTHROPIC_BASE_URL yalnızca alan adıdır. Claude Code sonuna otomatik olarak /v1/messages ekler; sonunda /v1 bulunursa istek /v1/v1/messages'e gider ve 404 alırsınız.
  • ANTHROPIC_AUTH_TOKEN kullanın, ANTHROPIC_API_KEY değil. Belgelere göre ANTHROPIC_AUTH_TOKEN, Authorization başlığı içinde başında Bearer ile gönderilir ve hemen geçerli olur. ANTHROPIC_API_KEY, x-api-key başlığına gider ve etkileşimli modda önce bir kez onaylanması gerekir (bkz. yöntem A).
  • Model adını ANTHROPIC_MODEL içinde tam olarak yazın. Kunavo yalnızca tam adı tanır ve sonuna tarih eklenmiş eski adları dönüştürmez.
  • ANTHROPIC_DEFAULT_OPUS_MODEL ve ANTHROPIC_DEFAULT_SONNET_MODEL'yi de sabitleyin. Model yapılandırması belgelerine göre (3 Ekim 2026 tarihinde kontrol edildi), API kullanıcıları için varsayılan ayar ve opus takma adı Opus 5.5'e, sonnet takma adı ise Sonnet 5.5'e yönelir; yeni sürümler çıktıkça bu takma adlar da güncellenir. Sabitlemek için modelin tam adını veya ANTHROPIC_DEFAULT_OPUS_MODEL gibi değişkenleri kullanın. Kunavo şu anda Sonnet 5.5'i sunmuyor ve yeni bir Opus modeli her zaman hemen kullanıma açılmayabilir; mevcut olmayan bir model 404 hatası verir. Bu nedenle ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 tanımlanmazsa /model sonnet, opusplan'un yürütme aşaması ve model: sonnet olarak ayarlanmış alt ajanlar başarısız olur. opus takma adını Opus 5.5'e (claude-opus-5-5) sabitleyin; bunun için Claude Code v2.1.280 veya daha yeni bir sürüm gerekir. Daha eski bir sürümü claude update ile güncelleyin.
  • ANTHROPIC_DEFAULT_HAIKU_MODEL ayarını da sabitleyin. haiku takma adı Kunavo'nun sunmadığı bir kimlik ister: v2.1.293'ten itibaren Haiku 5.5, daha öncesinde ise tarih içeren bir Haiku 4.5 kimliği. Bu satır olmadan /model haiku ve model: haiku kullanan alt ajanlar 404 hatası alır.
  • ANTHROPIC_DEFAULT_HAIKU_MODEL arka plan görevleri için de geçerlidir. Belgelere göre bu değişken haiku takma adını ve oturum başlıkları gibi arka plan işlevleri için kullanılan modeli belirler. Claude Haiku 4.5 ile bunlar düşük maliyetli kalır.

VS Code uzantısını kullanıyorsanız değişkenleri claudeCode.environmentVariables içine, yani VS Code'un kendi kullanıcı ayarlarına ( Preferences: Open User Settings (JSON) komutu) yerleştirin. Uzantı, başlatılmadan önce oturum açma bilgilerini zaten orada kontrol eder; ~/.claude/settings.json içindeki değerler başlatılan işleme ulaşır, ancak bu kontrolü etkilemez.

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" }
  ]
}

Milyon token başına fiyatlar Kunavo kataloğundan alınmıştır; Anthropic'in liste fiyatı claude.com/pricing sayfasından alınmıştır (3 Ekim 2026 tarihinde kontrol edildi):

ModelKunavo (girdi / çıktı)Anthropic liste fiyatı (girdi / çıktı)FarkKullanım amacı
claude-haiku-4-5$0,70 / $3,50$1,00 / $5,00~30% daha düşükClaude Code'un kendi arka plan görevleri ve basit işler
claude-sonnet-5$1,40 / $7,00$2,00 / $10,00~30% daha düşükGünlük işler için varsayılan model
claude-opus-5-5$2,80 / $14,00$4,00 / $20,00~30% daha düşükBüyük yeniden düzenlemeler ve planlama

Bir oturum içinde /model claude-opus-5-5 ile geçiş yapabilir veya doğrudan claude --model claude-opus-5-5 ile başlatabilirsiniz. Claude Code'un aylık yaklaşık maliyeti ve aboneliğin ne zaman daha avantajlı olduğu Claude Code pricing (İngilizce) sayfasında yer alır; kendi kullanımınızın maliyetini Claude token cost calculator ile hesaplayabilirsiniz. Tüm modeller ve fiyatlar fiyatlandırma sayfasında yer alır.

/status ile kontrol etme

claude komutunu başlatın. ANTHROPIC_AUTH_TOKEN ayarlanmışsa oturum açma ekranı görmezsiniz: değişken hemen geçerli olur. Yine de oturum açma ekranını görüyorsanız Claude Code bir anahtar okumamıştır. Anahtarı, Claude Code'un ilk başlatma sihirbazından önce okuduğu bir konuma, yani shell'inizdeki bir export satırına veya ~/.claude/settings.json içindeki env bloğuna yerleştirin. Projenin .claude/settings.json veya .claude/settings.local.json dosyasındaki bir env bloğu, etkileşimli oturumda ancak ilk başlatma sihirbazından ve klasöre güvenip güvenmediğiniz sorusundan sonra geçerli olur.

Oturumda /status yazın ve Status sekmesindeki iki satırı kontrol edin (kaynak: resmî gateway belgeleri, 3 Ekim 2026 tarihinde kontrol edildi):

  • Anthropic base URL değeri https://api.kunavo.com olmalıdır. Bu satır yalnızca bir ağ geçidi adresi ayarlanmışsa görünür; yoksa ANTHROPIC_BASE_URL oturuma ulaşmamıştır.
  • Auth token satırı ANTHROPIC_AUTH_TOKEN ifadesini içermelidir. Bunun yerine claude.ai hesabıyla Login method görüyorsanız değişken okunmamıştır ve oturumunuz aboneliğiniz üzerinden çalışıyordur.

Daha önce bir abonelikle oturum açtıysanız Claude Code başlatılırken iki oturum açma kaynağının etkin olduğu konusunda uyarabilir (ileti auth may not work as expected ile biter). İstekler anahtar üzerinden gönderilir; eski oturum açma bilgisini /logout ile temizleyebilirsiniz.

Claude Code'u açmadan önce adresi ve anahtarı test etmek ister misiniz? Belgelerin önerdiği gibi tek bir çıktı token'ı isteyen bir istek gönderin; bu işlem çok küçük bir bakiye tüketir. Komutlar değişkenleri shell'inizden okur; bu nedenle değişkenler zaten settings.json içindeyse onları orada da ayarlayı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 yanıtı adresin ve anahtarın çalıştığı anlamına gelir; PowerShell'de id ile başlayan bir msg_ görürsünüz. 401, anahtarın reddedildiği anlamına gelir.

API anahtarıyla başka neler çalışır

  • Remote Control ve sesle dikte yoktur. Her ikisi de claude.ai hesabı gerektirir ve ANTHROPIC_AUTH_TOKEN etkin olduğu sürece kullanılamaz; ayrıca ANTHROPIC_BASE_URL Anthropic dışındaki bir adrese yöneldiği sürece Remote Control devre dışıdır.
  • /fast fast mode'un kapalı olduğunu bildirir. Yalnızca bir bearer token ile Claude Code, fast mode'u devre dışı kabul eder ve kontrol isteğini göndermez.
  • MCP tool search, ANTHROPIC_BASE_URL Anthropic dışındaki bir adrese yönelir yönelmez varsayılan olarak kapatılır.
  • /context'deki sayılar yaklaşık değerlerdir: Kunavo şu anda /v1/messages/count_tokens'yi sunmuyor. Resmî gateway uyumluluk belgelerine göre (3 Ekim 2026 tarihinde kontrol edildi), bu uç nokta olmadığında Claude Code karakter sayısına dayalı bir tahmine geri döner; dolayısıyla /context yaklaşık sayılar gösterir.

Kod, araçlar, alt aracılar, MCP sunucuları, hook'lar ve prompt caching her zamanki gibi çalışır. Daha fazla ayrıntı Claude Code entegrasyon belgelerinde (İngilizce) ve Claude Code without a subscription (İngilizce) sayfasında yer alır.

iDEAL veya Bancontact ile ödeme

Claude aboneliği web sitesi üzerinden yalnızca kredi veya banka kartıyla ödenebilir (Claude'un ücretli planlarla ilgili yardım makalesi, 3 Ekim 2026 tarihinde kontrol edildi); claude.com/pricing sayfasındaki fiyatlara vergi dahil değildir.

Kunavo bakiyenize Stripe Checkout üzerinden para yükleyebilirsiniz. Fiyatlar ABD doları cinsindendir; Hollanda ve Belçika'daki alıcılara Stripe tutarı avro olarak gösterir. Stripe Adaptive Pricing belgelerine göre (3 Ekim 2026 tarihinde kontrol edildi), döviz kuruna alıcının ödediği %2–4'lük bir dönüştürme farkı dahildir. Dolarla ödeme yapanlar (kart, Apple Pay, Google Pay veya Link ile) bu farkı ödemez. iDEAL ve Bancontact yalnızca avro cinsinden kullanılabilir. Ödeme sayfasında şu yöntemler sunulur:

  • iDEAL, Hollanda için. Yöntemin adı artık iDEAL | Wero (Stripe, 2026'nın ilk çeyreğinde bu adın kullanılmasını istedi); dolayısıyla ödeme sayfasında bu adı görebilirsiniz. Kendi bankanızın sayfasına yönlendirilir ve ödemeyi orada onaylarsınız (Stripe'ın iDEAL hakkındaki belgeleri, 3 Ekim 2026 tarihinde kontrol edildi).
  • Bancontact, Belçika için; Bancontact kartınızla veya uygulamayla ödeme yapabilirsiniz (Stripe'ın Bancontact hakkındaki belgeleri, 3 Ekim 2026 tarihinde kontrol edildi).
  • Kartlar (Visa, Mastercard), Apple Pay, Google Pay ve Link.

Sunulmaz: PayPal, SEPA otomatik ödeme, Klarna (yalnızca Amerika Birleşik Devletleri'ndeki alıcılar için kullanılabilir), Tikkie, Riverty (eski adıyla AfterPay) ve normal banka havalesi.

  1. Kunavo hesabı açın.
  2. Billing sayfasında en az $10 olmak üzere bir tutar seçin. Tek seferde daha fazla bakiye yükleyenler ek bakiye alır: $100 karşılığında $110 alırsınız, $1.000 karşılığında $1.200 alırsınız ve $5.000 karşılığında $6.250 alırsınız.
  3. Stripe ödeme sayfasında iDEAL veya Bancontact'ı seçin ve ödemeyi bankanızın ortamında (iDEAL) ya da Bancontact uygulaması veya kartıyla tamamlayın. Avro cinsinden tutarı onaylamadan önce ödeme sayfasında görürsünüz.
  4. /app/keys adresinde bir anahtar oluşturun ve bunu ANTHROPIC_AUTH_TOKEN içine girin.

Bakiye ön ödemelidir: aylık ücret yoktur, bakiyenin süresi dolmaz ve başarısız istekler ücretlendirilmez. Otomatik bakiye yükleme yalnızca kayıtlı bir kart veya Link ile yapılabilir; iDEAL ve Bancontact ile her seferinde manuel olarak bakiye yüklersiniz. Kunavo KDV faturası düzenlemez; yükleme geçmişiniz Billing sayfasında yer alır. Bu ödeme yöntemleri yalnızca Kunavo API bakiyenizi yükler: Claude Pro veya Max aboneliği bunlarla ödenemez. Avro ile ödeme hakkında daha fazla bilgi: Claude'a iDEAL ile ödeme.

Yaygın hatalar

Gördüğünüz şeyNeden ve çözüm
The token '&&' is not a valid statement separatorCMD satırı PowerShell'e yapıştırılmış. irm … | iex kullanın.
'irm' is not recognized as an internal or external command (veya bu iletinin Türkçe sürümü)PowerShell satırı CMD'ye yapıştırılmış. install.cmd satırını kullanın.
'bash' is not recognized as the name of a cmdletmacOS/Linux satırı Windows'a yapıştırılmış. PowerShell satırını kullanın.
Komut komut dosyasının metnini gösteriyor ancak hiçbir şey yüklemiyorİkinci yarı eksik. PowerShell'de satırın tamamı irm … | iex, CMD'de ise -o install.cmd içeren tam komuttur.
syntax error near unexpected token '<' veya bir 403İndirme, komut dosyası yerine bir web sayfası veya hata kodu döndürdü. Resmi sorun gidermeye göre bunun nedeni ağ sorunları, bölgesel yönlendirme, geçici bir kesinti veya (yalın bir 403 durumunda) şirket proxy'si ya da güvenlik duvarı olabilir. Birkaç dakika sonra yeniden deneyin veya macOS'ta Homebrew, Windows'ta WinGet üzerinden yükleyin.
Claude Code does not support 32-bit WindowsWindows PowerShell'i (x86) açtınız. Normal Windows PowerShell'i açın.
npm.ps1 cannot be loadedPowerShell'in yürütme ilkesi npm'yi engelliyor. Set-ExecutionPolicy satırını çalıştırın veya bağımsız yükleyiciyi kullanın.
command not found: claude veya claude tanınmıyorYükleme klasörü PATH'inizde değil. Yeni bir pencere açın; Windows'ta yukarıdaki PATH bölümünü kullanın.
Anahtar ayarlanmışken oturum açma ekranıClaude Code bir anahtar okumamıştır. Değişkenleri shell'inize veya ~/.claude/settings.json içine, yalnızca proje ayarlarına değil, yerleştirin ve yeni bir pencere açın.
auth may not work as expected ile biten uyarıAnahtar ve eski oturum açma bilgisi aynı anda etkin. Yalnızca anahtarı tutmak için /logout kullanın veya oturum açma yöntemini kullanmak için değişkeni kaldırın.
401Anahtar tanınmıyor: sk-kn- anahtarının tamamını boşluk olmadan kopyaladığınızı, /app/keys adresinden silinmediğini ve ANTHROPIC_AUTH_TOKEN içinde bulunduğunu kontrol edin.
404ANTHROPIC_BASE_URL değeri /v1 ile bitiyor veya istenen model Kunavo'da bulunmuyor (örneğin dört model değişkeni eksik olduğu için).

Yüklemeden sonra

Bir projede ilk kez başlatırken /init yazın: Claude Code depoyu okur ve bulduğu test komutları ile kuralları içeren bir CLAUDE.md oluşturur. Bu dosyayı kontrol edin ve kısa tutun; çünkü her oturumda yüklenir. Ayrı görevler arasında /clear yeni bir konuşma başlatır; bir görev uzarsa /compact geçmişi özetler ve çalışmaya devam edersiniz.

Bilmeniz gerekenler

  • Bu, Claude Pro veya Max aboneliği değil, token başına ücretlendirilen bir API'dir. Claude Code'u her gün saatlerce kullananlar için abonelik çoğu zaman daha ucuzdur; değişken kullanımda token başına ödeme uygundur ve bir ay hiç kullanmamak hiçbir maliyet doğurmaz. Karşılaştırma Claude Code pricing sayfasında (İngilizce) yer alır.
  • API anahtarıyla Remote Control ve sesle dikte kullanılamaz.
  • Kunavo üzerinden rezerve edilmiş kota veya sözleşmeye dayalı garanti olmadan paylaşılan kapasiteyi kullanırsınız; bunlara ihtiyacınız varsa doğrudan Anthropic ile sözleşme yapın.
  • iDEAL ve Bancontact yalnızca manuel bakiye yükleme içindir; otomatik bakiye yükleme yalnızca bir kart veya Link ile yapılabilir.
  • Avro cinsinden tutarlara Stripe'ın dönüştürme ek ücreti dahildir. Kunavo KDV faturası düzenlemez.

Sık sorulan sorular

Claude Code'u nasıl yüklerim?

Tek bir resmi komutla. macOS, Linux ve WSL'de: curl -fsSL https://claude.ai/install.sh | bash. Windows'ta PowerShell ile: 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. Bu, Anthropic'in önerdiği bağımsız kurulumdur; arka planda kendini günceller. Ardından yeni bir terminal penceresi açın, claude --version ile kontrol edin ve claude ile başlatın.

Claude Code'u Windows'a yüklemek için WSL'ye veya yönetici haklarına ihtiyacım var mı?

Hayır. Resmi yükleme belgelerine göre yükleme komutunu pencereyi yönetici olarak açmadan PowerShell veya CMD'de çalıştırırsınız. Git for Windows isteğe bağlıdır: yüklüyse Claude Code komutları Git Bash üzerinden, değilse PowerShell üzerinden çalıştırır. Linux araçlarına veya sandboxing'e ihtiyacınız varsa WSL 2'yi seçebilirsiniz; bu durumda Claude Code'u WSL terminali içinde yükleyip başlatın. Windows PowerShell (x86)'yı açmayın: Claude Code 32 bit Windows'u desteklemez.

Claude Code için Node.js'e ihtiyacım var mı?

Yalnızca npm üzerinden yükleme yapıyorsanız ve o zaman Node.js 22 veya daha yeni bir sürüm gerekir. Bağımsız yükleyici, Homebrew ve WinGet Node.js gerektirmez. Daha eski bir Node.js ile npm yalnızca EBADENGINE uyarısı gösterir ve yüklemeye devam eder. Asla sudo npm install -g kullanmayın; npm update -g yerine npm install -g @anthropic-ai/claude-code@latest ile güncelleyin.

Claude Code'u abonelik olmadan kullanabilir miyim?

Evet. Oturum açmak için Pro, Max, Team, Enterprise veya Console hesabı gerekir; ücretsiz Claude.ai aboneliği Claude Code'u içermez. Abonelik olmadan ANTHROPIC_BASE_URL=https://api.kunavo.com ve bir Kunavo anahtarıyla ANTHROPIC_AUTH_TOKEN ayarlayın; Claude Code oturum açma ekranını atlar ve ön ödemeli Kunavo bakiyenizden, aylık ücret olmadan, kullanılan token başına ödeme yaparsınız. Başlangıç tutarı $10'dır. Remote Control ve sesli dikte bu şekilde kullanılamaz; çünkü claude.ai hesabı gerektirirler.

Claude Code için API anahtarını nasıl ayarlarım?

Değişkenleri ~/.claude/settings.json dosyasındaki env bloğuna (Windows'ta %USERPROFILE%\.claude\settings.json) veya ~/.zshrc, ~/.bashrc ya da PowerShell-$PROFILE dosyanıza export satırları olarak ekleyin. ANTHROPIC_API_KEY yerine ANTHROPIC_AUTH_TOKEN kullanın: ANTHROPIC_AUTH_TOKEN, Authorization: Bearer olarak gönderilir ve hemen geçerlidir; ANTHROPIC_API_KEY ise x-api-key başlığına gider ve önce bir kez onaylanmalıdır. ANTHROPIC_BASE_URL yalnızca https://api.kunavo.com alan adıdır; /v1 içermemelidir. Claude Code sonuna kendisi /v1/messages ekler; bu nedenle /v1 ile /v1/v1/messages ve 404 alırsınız. Anahtarı asla bir projenin .claude/settings.json dosyasına koymayın; çünkü bu dosya commit edilir. Kabuk ve ayar dosyası aynı değişkeni ayarlarsa ayar dosyasındaki değer geçerli olur.

Neden API anahtarı üzerinden Claude Code için dört model değişkeni gerekiyor?

Sabit modeller olmadan Claude Code, Anthropic'in yeni sürümleriyle birlikte değişen takma adları kullanır. Model yapılandırmasına ilişkin resmi belgelere göre ( 3 Ekim 2026 tarihinde kontrol edilmiştir) varsayılan ayar ile API kullanıcıları için opus takma adı Opus 5.5'e, sonnet takma adı ise Sonnet 5.5'e yönelir. Kunavo şu anda Sonnet 5.5'i sunmuyor ve mevcut olmayan bir model 404 döndürür: sabit bir sonnet değişkeni olmadan /model sonnet, opusplan'ın yürütme aşaması ve model: sonnet kullanan alt aracılar başarısız olur. 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 ile her istek Kunavo'nun sunduğu bir modeli ister ve ne ödediğinizi bilirsiniz. Opus 5.5, Claude Code v2.1.280 veya daha yeni bir sürümü gerektirir; eski bir sürümü claude update ile güncellersiniz. Haiku değişkeni, Claude Code'un arka plan görevleri için kullanılan modeli de belirler.

Claude Code'un API anahtarımı kullandığını nasıl kontrol ederim?

Claude Code'da /status yazın. Status sekmesinde Anthropic base URL satırında https://api.kunavo.com, Auth token satırında ise ANTHROPIC_AUTH_TOKEN görünmelidir. Bunun yerine claude.ai hesabıyla Login method görüyorsanız değişken okunmamıştır ve oturumunuz aboneliğiniz üzerinden çalışıyordur. Başlangıçta bir oturum açma ekranı görüyorsanız Claude Code hiçbir anahtar okumamıştır.

Claude Code için iDEAL veya Bancontact ile ödeme yapabilir miyim?

Kunavo API bakiyesi için evet. Stripe ödeme sayfasında kartlar, Apple Pay, Google Pay ve Link'in yanı sıra iDEAL (Hollanda) ve Bancontact (Belçika) sunulur. Fiyat dolar cinsindendir ve Stripe tutarı avro cinsinden gösterir; Stripe'a göre bu döviz kuruna %2–4 oranında dönüştürme ek ücreti dahildir. Minimum tutar $10'dir, aylık ücret yoktur ve bakiyenin süresi dolmaz. iDEAL ve Bancontact yalnızca manuel bakiye yükleme içindir: otomatik bakiye yükleme yalnızca kayıtlı bir kart veya Link ile yapılabilir. PayPal ve SEPA otomatik ödeme sunulmaz ve Kunavo KDV faturası düzenlemez. Claude Pro veya Max aboneliğini burada ödeyemezsiniz; claude.ai bunu web sitesi üzerinden yalnızca kredi kartı veya banka kartıyla tahsil eder.