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şen | Gereksinim (resmi yükleme belgeleri, 3 Ekim 2026 tarihinde kontrol edilmiştir) |
|---|---|
| İşletim sistemi | macOS 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ım | En az 4 GB RAM, x64 veya ARM64 işlemci (32 bit Windows desteklenmez) |
| Kabuk | Bash, Zsh, PowerShell veya CMD |
| Ağ ve konum | Anthropic'in desteklediği bir ülkede internet bağlantısı (Hollanda ve Belçika listede yer alır) |
| Hesap | Oturum 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.js | Yalnı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:
# 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.
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows Opdrachtprompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdEn 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çenek | Gerekenler | Korumalı çalıştırma | Ne zaman seçilir |
|---|---|---|---|
| WSL'siz Windows | Hiçbir şey; Git for Windows isteğe bağlı | Desteklenmiyor | Windows'un kendisinde çalışan projeler ve araçlar |
| WSL 2 | WSL 2 etkin | Destekleniyor | Linux araçları gerekiyor veya komutlar bir sandbox içinde çalıştırılıyor |
| WSL 1 | WSL 1 etkin | Desteklenmiyor | WSL 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 vanzelfnpm 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.
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@latestYüklemeyi kontrol etme
claude --version # toont het versienummer, gevolgd door (Claude Code)
claude doctor # alleen-lezen diagnose van installatie en instellingen, start geen sessieclaude 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:
# 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 claudenpm ü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:
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çma | Yöntem B: abonelik olmadan API anahtarı | |
|---|---|---|
| Gerekenler | Pro, Max, Team, Enterprise veya Console hesabı | sk-kn- ile başlayan bir Kunavo anahtarı |
| Nasıl ödeme yapılır | Pro ve Max: aylık sabit ücret; Console: Anthropic'te token başına | Token başına, önceden ödenmiş bakiyeden; aylık ücret yok |
| Ödeme yöntemi | Web sitesi üzerinden yalnızca kredi veya banka kartı | iDEAL, Bancontact, kart, Apple Pay, Google Pay veya Link |
| Remote Control ve sesle dikte | Mevcut: her ikisi de yalnızca bir claude.ai oturum açma işlemiyle çalışır | Mevcut değil |
| Kurulum | Tarayıcıda oturum açma | Altı 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:
- Kunavo hesabı açın.
- Bakiyenizi Faturalandırma üzerinden, $10'den başlayan tutarla yükleyin (iDEAL ve Bancontact aşağıda açıklanmıştır).
- /app/keys adresinde
sk-kn-ile başlayan bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir; bu nedenle hemen kaydedin. - Değişkenleri ayarlayın. macOS ve Linux'ta
~/.zshrcveya~/.bashrcdosyasında:
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-5Windows'ta önce tek bir PowerShell penceresinde test etmek için:
# 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"
claudeKalı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:
{
"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_URLyalnızca alan adıdır. Claude Code sonuna otomatik olarak/v1/messagesekler; sonunda/v1bulunursa istek/v1/v1/messages'e gider ve 404 alırsınız.ANTHROPIC_AUTH_TOKENkullanın,ANTHROPIC_API_KEYdeğil. Belgelere göreANTHROPIC_AUTH_TOKEN,Authorizationbaşlığı içinde başındaBearerile gönderilir ve hemen geçerli olur.ANTHROPIC_API_KEY,x-api-keybaşlığına gider ve etkileşimli modda önce bir kez onaylanması gerekir (bkz. yöntem A).- Model adını
ANTHROPIC_MODELiç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_MODELveANTHROPIC_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 veopustakma adı Opus 5.5'e,sonnettakma 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ı veyaANTHROPIC_DEFAULT_OPUS_MODELgibi 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 nedenleANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5tanımlanmazsa/model sonnet,opusplan'un yürütme aşaması vemodel: sonnetolarak ayarlanmış alt ajanlar başarısız olur.opustakma 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 updateile güncelleyin.ANTHROPIC_DEFAULT_HAIKU_MODELayarını da sabitleyin.haikutakma 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 haikuvemodel: haikukullanan alt ajanlar 404 hatası alır.ANTHROPIC_DEFAULT_HAIKU_MODELarka plan görevleri için de geçerlidir. Belgelere göre bu değişkenhaikutakma 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.
{
"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):
| Model | Kunavo (girdi / çıktı) | Anthropic liste fiyatı (girdi / çıktı) | Fark | Kullanım amacı |
|---|---|---|---|---|
claude-haiku-4-5 | $0,70 / $3,50 | $1,00 / $5,00 | ~30% daha düşük | Claude 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üşük | Günlük işler için varsayılan model |
claude-opus-5-5 | $2,80 / $14,00 | $4,00 / $20,00 | ~30% daha düşük | Bü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 URLdeğerihttps://api.kunavo.comolmalıdır. Bu satır yalnızca bir ağ geçidi adresi ayarlanmışsa görünür; yoksaANTHROPIC_BASE_URLoturuma ulaşmamıştır.Auth tokensatırıANTHROPIC_AUTH_TOKENifadesini içermelidir. Bunun yerine claude.ai hesabıylaLogin methodgö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.
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 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_TOKENetkin olduğu sürece kullanılamaz; ayrıcaANTHROPIC_BASE_URLAnthropic dışındaki bir adrese yöneldiği sürece Remote Control devre dışıdır. /fastfast 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_URLAnthropic 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/contextyaklaşı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.
- Kunavo hesabı açın.
- 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.
- 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.
- /app/keys adresinde bir anahtar oluşturun ve bunu
ANTHROPIC_AUTH_TOKENiç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 şey | Neden ve çözüm |
|---|---|
The token '&&' is not a valid statement separator | CMD 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 cmdlet | macOS/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 Windows | Windows PowerShell'i (x86) açtınız. Normal Windows PowerShell'i açın. |
npm.ps1 cannot be loaded | PowerShell'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ıyor | Yü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. |
401 | Anahtar 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. |
404 | ANTHROPIC_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.