Claude Code, her sistem için resmî bir komutla kurulur: macOS, Linux ve WSL'de curl -fsSL https://claude.ai/install.sh | bash; Windows'ta PowerShell'de irm https://claude.ai/install.ps1 | iex (Komut İstemi, yani CMD için aşağıdaki install.cmd satırına bakın). Ardından iki şekilde kullanılabilir. Abonelikle kullanmak için Pro, Max, Team, Enterprise veya Console hesabıyla oturum açılır (yalnızca Claude.ai'ın ücretsiz planına sahip olanlar Claude Code'a erişemez). Abonelik olmadan kullanmak için bir API anahtarı gerekir: ANTHROPIC_BASE_URL (yalnızca alan adı, /v1 olmadan), ANTHROPIC_AUTH_TOKEN ve dört model değişkeni ayarlanır, ardından /status ile doğrulanır. Kunavo bakiyesi, aylık ücret olmadan, ödeme adımında euro cinsinden MB WAY ile US$ 10 tutarından başlayarak yüklenir.
Komutlar ve değişkenler 3 Ekim 2026, Claude Code'un resmi kurulum belgelerinde ve ortam değişkenleri belgelerinde kontrol edildi; fiyatlar ve ödeme yöntemleri 10 Ekim 2026 tarihinde kontrol edildi. Portekiz, hem Claude.ai hem de API için Anthropic'in desteklenen ülkeler listesinde yer alıyor ( 3 Ekim 2026 tarihinde kontrol edildi). Bu kılavuz İngilizce olarak da mevcut: Install Claude Code.
Kurulumdan önce
| Bileşen | Gereksinim (3 Ekim 2026 tarihinde incelenen resmî kurulum belgeleri) |
|---|---|
| İşletim sistemi | macOS 13.0 veya üzeri; Windows 10 1809 veya üzeri ya da Windows Server 2019 veya üzeri; 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 tarafından desteklenen bir ülkede internet bağlantısı (Portekiz listede yer alır) |
| Hesap | Oturum açmak için: Pro, Max, Team, Enterprise veya Console (Claude.ai'nin ücretsiz planı yeterli değildir). API anahtarıyla abonelik veya oturum açma gerekmez. |
| Node.js | Yalnızca npm ile kurulum için ve bu durumda sürüm 22 veya üzeri; bağımsız kurulum bunu gerektirmez |
macOS, Linux ve WSL: tek satır
Terminal'de (macOS'ta Uygulamalar › İzlenceler altında bulunur) şunu çalıştırın:
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bashBu, önerilen bağımsız kurulumdur: resmî belgelere göre arka planda kendini otomatik güncelleyen bağımsız bir programdır. claude komutu ~/.local/bin konumunda bulunur. Zaten açık olan bir terminal yeni PATH'i henüz bilmez; bu nedenle test etmeden önce yeni bir pencere açın. WSL'de satır tamamen aynıdır ve WSL terminalinin içinde çalıştırılır.
Windows'a kurulum
Windows'ta iki satır vardır ve seçim yalnızca açık olan pencereye bağlıdır. Satır PS C:\Users\Nome> ile başlıyorsa PowerShell'desiniz; yalnızca C:\Users\Nome> görünüyorsa, PS olmadan, Komut İstemi'ndesiniz (CMD). «Yönetici olarak çalıştır» kullanmak gerekmez: resmî belgeler, bazı Portekizce kılavuzların önerdiğinin aksine bunun gerekli olmadığını açıkça belirtir.
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Linha de Comandos do Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdWindows'ta en sık yaşanan sorun yanlış pencerenin kullanılmasıdır. PowerShell The token '&&' is not a valid statement separator yanıtını verirse CMD satırını almışsınızdır; CMD 'irm' is not recognized as an internal or external command yanıtını verirse PowerShell satırını almışsınızdır. Portekizce Windows'ta bu ikinci mesaj aynı nedenle çevrilmiş görünebilir. macOS satırını, | bash ile birlikte PowerShell'e yapıştırmak da bash komutunun tanınmadığını belirten bir hata verir. Her üç durumda çözüm, pencereye karşılık gelen satırı kullanmaktır.
Git for Windows isteğe bağlıdır. Yüklüyken Claude Code'un Bash aracı Git Bash'te çalışır ve PowerShell de kullanılabilir olmaya devam eder; Git for Windows yüklü değilken tüm komutlar PowerShell üzerinden çalışır. Git alışılmışın dışında bir klasöre yüklüyse ve Claude Code bash.exe'yi bulamıyorsa, yolu ~/.claude/settings.json'nin env bloğundaki CLAUDE_CODE_GIT_BASH_PATH içinde belirtin; belgelerdeki örnek: C:\Program Files\Git\bin\bash.exe.
| Seçenek | Gerekenler | Korumalı alan | Ne zaman seçilmeli |
|---|---|---|---|
| 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ı veya sandbox içinde komutlar gerektiğinde |
| WSL 1 | WSL 1 etkin | Desteklenmiyor | WSL 2 kullanılabilir olmadığında |
Dolayısıyla WSL bir gereksinim değil, bir tercihtir; bazı kılavuzlarda yazılanların aksine. WSL'yi seçenler macOS/Linux satırını WSL terminalinde çalıştırır ve claude komutunu da orada başlatır; PowerShell veya CMD üzerinden değil.
Homebrew, WinGet veya npm ile
Bu da çalışır, ancak önemli bir fark vardır: resmî belgelere göre Homebrew ve WinGet ile yapılan kurulumlar kendilerini otomatik olarak güncellemez. Güncelleme elle yapılır. Linux için imzalı apt, dnf ve apk depoları da vardır.
# Homebrew
brew install --cask claude-code
brew upgrade claude-code # não se atualiza sozinho
# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode # não se atualiza sozinhonpm paketi Node.js 22 veya üzerini gerektirir — bazı kılavuzların hâlâ belirttiği Node.js 18'i değil. Daha eski bir Node.js ile npm kurulum sırasında yalnızca EBADENGINE uyarısı gösterir, başarısız olmaz. Asla sudo npm install -g kullanmayın: resmî belgeler bunu açıkça önermemektedir. Güncellemek için @latest, npm update -g değil, kullanın.
node -v # tem de ser v22 ou posterior
npm install -g @anthropic-ai/claude-code # nunca com sudo
# para atualizar mais tarde: com @latest, não com npm update -g
npm install -g @anthropic-ai/claude-code@latestKurulumu doğrulama
claude --version # mostra o número da versão, seguido de (Claude Code)
claude doctor # diagnóstico só de leitura da instalação e das definições, sem abrir sessãoclaude doctor hiçbir oturum başlatmaz: kurulumun ve ayar dosyalarının durumunu gösterir. Bir sorunun kurulumda mı yoksa yapılandırmada mı olduğunu anlamanın en hızlı yoludur.
Bir command not found: claude (veya Windows'ta claude'in bilinen bir komut olmadığını belirten ileti), terminalin programın nereye yüklendiğini bulamadığı anlamına gelir. Çoğu zaman pencereyi kapatıp yeniden açmak yeterlidir. Sorun sürerse klasör PATH'te yoktur: macOS ve Linux'ta ~/.local/bin yolunu kabuğun başlangıç dosyasına (~/.zshrc veya ~/.bashrc) ekleyin; Windows'ta bu yol %USERPROFILE%\.local\bin'tir. resmi sorun giderme belgelerine göre PowerShell'de şöyle doğrulayabilir ve ekleyebilirsiniz:
# 1. A pasta de instalação já está no PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'
# 2. Sem resultado? Acrescente-a ao PATH do utilizador e abra uma janela nova
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# 3. Na janela nova: dois caminhos significam duas instalações lado a lado
where.exe claudenpm ile kurulum yaptıysanız ve PowerShell npm.ps1 cannot be loaded because running scripts is disabled on this system yanıtını veriyorsa npm komut dosyalarını engelleyen PowerShell yürütme ilkesidir. Bağımsız yükleyiciyi kullanın veya kendi kullanıcınız için yerel komut dosyalarına izin verin:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserClaude Code does not support 32-bit Windows görünürse «Windows PowerShell (x86)» açılmıştır. Windows'ta iki PowerShell girişi vardır ve x86 sürümü 32 bit işlem olarak çalışır; «Windows PowerShell» girişini, (x86) olmadan açın.
İlk kullanım: abonelik veya API anahtarı
İlk başlatmada Claude Code'un nasıl ücretlendirileceğine karar verilir. Yolu değiştirmek için yeniden kurulum gerekmez: belirleyici olan bir anahtarın tanımlı olup olmamasıdır.
| Yol A: abonelikle oturum açma | Yol B: aboneliksiz API anahtarı | |
|---|---|---|
| Gerekenler | Pro, Max, Team, Enterprise veya Console hesabı | sk-kn- ile başlayan bir Kunavo anahtarı |
| Nasıl ödenir | Pro ve Max: sabit tutar, aylık veya yıllık; Console: Anthropic'teki gibi token başına | Token başına, ön ödemeli bakiyeden; aylık ücret olmadan |
| Ödeme yöntemi | Siteden satın alınan Pro ve Max: yalnızca kredi veya banka kartı | MB WAY, kart, Apple Pay, Google Pay veya Link |
| Remote Control ve sesli dikte | claude.ai hesabıyla (Pro, Max, Team, Enterprise) kullanılabilir; Console hesabıyla kullanılamaz | Kullanılamıyor |
| Yapılandırma | Tarayıcıda oturum açma | Altı ortam değişkeni |
Yol A — abonelikle oturum açma
Proje klasöründe claude komutunu çalıştırın ve tarayıcıda oturum açın. Ortamında zaten ANTHROPIC_API_KEY bulunan kullanıcılar dikkat: tarayıcıyı açmak yerine Claude Code bu anahtar için tek seferlik onay ister. Bu onay reddedilirse anahtar bundan sonra yok sayılır ve soru tekrarlanmaz; bu da değişkenin okunmadığı izlenimi verebilir. Yeniden etkinleştirmek için: /config → Use custom API key.
Yol B — aboneliksiz, API anahtarıyla
ANTHROPIC_BASE_URL, istekleri bir proxy veya gateway üzerinden yönlendirmek için tasarlanmış, Claude Code'un kendi değişkenidir. Bu nedenle onu Anthropic Messages API'siyle uyumlu bir endpoint'e yönlendirmek, eklenti veya değiştirilmiş sürüm olmadan desteklenen bir yapılandırmadır. Adımlar:
- Kunavo’da hesap oluşturun.
- Faturalandırma bölümünde bakiyeyi en az US$ 10 yükleyerek artırın (MB WAY ile ödeme aşağıda açıklanmıştır).
- /app/keys adresinde
sk-kn-ile başlayan bir anahtar oluşturun. Yalnızca bir kez gösterildiğinden hemen kaydetmeniz önerilir. - Değişkenleri tanımlayın. macOS ve Linux'ta
~/.zshrcveya~/.bashrcdosyasında:
export ANTHROPIC_BASE_URL=https://api.kunavo.com # só o domínio, sem /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 bir PowerShell penceresinde test etmek için:
# Vale só para esta janela do 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"
claudeKalıcı kullanım için en uygun yer, kullanıcı ayarlarındaki env bloğudur: ~/.claude/settings.json (Windows'ta %USERPROFILE%\.claude\settings.json). Buradaki değerler, arka plan aracıları da dâhil olmak üzere tüm projelere uygulanır; VS Code uzantısı istisnadır (aşağıya bakın). Shell'de dışa aktarılan bir değişken yalnızca o shell'den başlatılan programlara ulaşır: Dock veya Başlat menüsünden açılan bir düzenleyici onu 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 projenin .claude/settings.json'sine asla koymayın: resmi ağ geçitleri belgelerine göre ( 3 Ekim 2026 tarihinde kontrol edildi), bu dosya commit'lere girer ve depoyu klonlayan kişilerle paylaşılır. Öncelik sırasına da dikkat edin: kabuk ve ayar dosyası aynı değişkeni tanımladığında ayar dosyasındaki değer geçerli olur. Kabukta yaptığınız bir değişiklik etkili olmazsa önce settings.json'yi kontrol edin.
VS Code uzantısını kullananlar değişkenleri VS Code'un kendi kullanıcı ayarlarında claudeCode.environmentVariables, (Preferences: Open User Settings (JSON)) olarak tanımlar. Gateway belgelerine göre uzantı, başlamadan önce kimlik bilgilerini bu ayarda kontrol eder; ~/.claude/settings.json içindeki değerler Claude Code işlemine ulaşır, ancak bu kontrole ulaşmaz:
{
"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" }
]
}Dört model değişkeni ve diğer tuzaklar
Bloktaki her satırın kendi tuzağı vardır:
ANTHROPIC_BASE_URLiçine yol eklenmez./v1/messagesyolunu Claude Code kendisi ekler; zaten/v1ile biten bir adres/v1/v1/messagesile sonuçlanır ve 404 döner.ANTHROPIC_AUTH_TOKENveyaANTHROPIC_API_KEY: Kunavo her ikisini de kabul eder. Gateway belgelerine göreANTHROPIC_AUTH_TOKEN,Authorization: Bearerbaşlığında gönderilir ve hemen uygulanır;ANTHROPIC_API_KEYisex-api-keybaşlığında gönderilir ve etkileşimli modda yürürlüğe girmeden önce bir kez onaylanmalıdır (Yol A'ya bakın). Bu nedenle bu kılavuzANTHROPIC_AUTH_TOKENkullanır.ANTHROPIC_MODELiçindeki ad tam olmalıdır. Burada göründüğü şekilde kopyalayın:claude-sonnet-5.ANTHROPIC_DEFAULT_SONNET_MODELveANTHROPIC_DEFAULT_OPUS_MODELolmadan takma adlar kendiliğinden değişir. Model yapılandırması belgelerine göre (3 Ekim 2026 tarihinde kontrol edildi), Anthropic API'sini kullananlar içinopustakma adı Opus 5.5'i,sonnettakma adı ise Sonnet 5.5'i gösterir; bu takma adlar yeni sürümler çıktıkça değişir. Modelin tam adıyla veyaANTHROPIC_DEFAULT_OPUS_MODELgibi değişkenlerle sabitleyebilirsiniz. Kunavo, Sonnet 5.5'i sunmaz ve mevcut olmayan bir model 404 döndürür:ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5olmadan/model sonnet,model: sonnetkullanan alt ajanlar veopusplanyürütme adımı başarısız olur.opusise Kunavo'nun sunduğuclaude-opus-5-5modelini gösterir, ancak bu eşleme yalnızca Claude Code v2.1.280 ve sonraki sürümlerde geçerlidir; daha eski bir sürümü olanlarclaude updatekomutunu çalıştırmalıdır.ANTHROPIC_DEFAULT_HAIKU_MODELdeğerini de ayarlayın.haikutakma adı, Kunavo'nun sunmadığı bir kimlik ister: v2.1.293'ten itibaren Haiku 5.5, öncesinde ise tarih içeren bir Haiku 4.5 kimliği. Bu satır olmadan/model haikuvemodel: haikukullanan alt ajanlar 404 döndürür.ANTHROPIC_DEFAULT_HAIKU_MODELarka plan görevleri için de geçerlidir. Belgelere görehaikutakma adını ve Claude Code'un arka plan işlevlerinin modelini tanımlar. Claude Haiku 4.5 ile bu çağrılar aşağıdaki tablodaki en ucuz modeli kullanır.
Kunavo kataloğundan alınan milyon token başına fiyatlar; Anthropic sütunu claude.com/pricing sayfasından alınmıştır ( 3 Ekim 2026 tarihinde kontrol edildi):
| Model | Kunavo (giriş / çıkış) | Anthropic tablo fiyatı (girdi / çıktı) | Fark | Verwendung |
|---|---|---|---|---|
claude-haiku-4-5 | US$ 0,70 / US$ 3,50 | US$ 1,00 / US$ 5,00 | yaklaşık %30 daha ucuz | Claude Code'un kendi arka plan görevleri ve basit işler |
claude-sonnet-5 | US$ 1,40 / US$ 7,00 | US$ 2,00 / US$ 10,00 | yaklaşık %30 daha ucuz | Günlük işler için varsayılan model |
claude-opus-5-5 | US$ 2,80 / US$ 14,00 | US$ 4,00 / US$ 20,00 | yaklaşık %30 daha ucuz | Büyük yeniden düzenlemeler ve planlama |
Bir oturum içinde model /model claude-opus-5-5 ile değiştirilir veya doğrudan claude --model claude-opus-5-5 ile başlatılır. Aylık kullanım örnekleri ve aboneliğin hangi noktadan itibaren daha avantajlı olduğu da dahil olmak üzere euro cinsinden maliyet hesabı, Claude Code'un euro cinsinden fiyatı sayfasında yer alır; her kullanıcının tüketimi token maliyeti hesaplayıcısı ile hesaplanır. Tüm modeller ve fiyatlar fiyatlandırma sayfasında yer alır.
/status ile doğrulama
claude komutunu çalıştırın. ANTHROPIC_AUTH_TOKEN tanımlıysa oturum açma ekranı görünmez: değişken hemen uygulanır. Oturum açma ekranı görünürse Claude Code hiçbir anahtarı okumamıştır. Bu durumda anahtarı Claude Code'un ilk başlatma asistanından önce okuduğu bir konumda tanımlayın: shell'de bir export veya ~/.claude/settings.json dosyasındaki env bloğu. Bir projedeki .claude/settings.json ya da .claude/settings.local.json içindeki env bloğu, etkileşimli bir oturumda yalnızca ilk başlatma asistanından ve klasöre güvenme sorusundan sonra uygulanır.
Oturumdayken /status yazın ve Status sekmesindeki iki satırı bulun (kaynak: resmi ağ geçitleri belgeleri, 3 Ekim 2026 tarihinde kontrol edildi):
Anthropic base URL,https://api.kunavo.comdeğerini göstermelidir. Bu satır yalnızca bir gateway adresi tanımlı olduğunda görünür; eksikseANTHROPIC_BASE_URLoturuma ulaşmamıştır.Auth tokensatırıANTHROPIC_AUTH_TOKENdeğerini belirtmelidir. Bunun yerine claude.ai hesabıyla birlikteLogin methodgörünüyorsa değişken okunmamıştır ve oturum aboneliği kullanıyordur.
Daha önce abonelikle oturum açmış olanlar, başlangıçta iki etkin kimlik bilgisi olduğunu belirten bir uyarı görebilir (mesaj auth may not work as expected ile biter). İstekler anahtar üzerinden gönderilir; /logout eski oturumu kapatır.
Claude Code'u açmadan önce adresi ve anahtarı test etmek için belgeler, bakiyenin çok küçük bir kısmını harcayan tek bir çıktı belirteci isteği önerir. Komutlar kabuk değişkenlerini okur; bu nedenle değişkenleri zaten settings.json içinde tanımlı olsalar bile kabukta da tanımlayı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ünür. 401, anahtarın tanınmadığı anlamına gelir.
API anahtarıyla neler değişir
- Remote Control ve sesli dikte kullanılamaz. Gateway belgelerine göre bunlar
ANTHROPIC_API_KEY,ANTHROPIC_AUTH_TOKENveya birapiKeyHelperetkinken kullanılamaz;ANTHROPIC_BASE_URLAnthropic dışındaki bir adresi gösterirken Remote Control da devre dışı kalır. /fasthızlı modu devre dışı olarak gösterir. Yalnızca bearer token kullanıldığında Claude Code hızlı modu kapalı kabul eder.- MCP araç araması (MCP tool search),
ANTHROPIC_BASE_URLAnthropic dışındaki bir adresi gösterdiğinde varsayılan olarak kapalıdır (ortam değişkenleri belgeleri, 3 Ekim 2026 tarihinde kontrol edildi). /contextiçindeki sayılar tahminidir. Kunavo/v1/messages/count_tokens'yi sunmaz ve ağ geçitleri için uyumluluk belgelerine göre ( 3 Ekim 2026 tarihinde kontrol edildi), bu uç nokta olmadan Claude Code karakter sayısına dayalı bir tahmin kullanır.
Geri kalan her şey — kod, araçlar, alt aracılar, MCP sunucuları, hook'lar ve istem önbelleğe alma — her zamanki gibi çalışır. Daha fazla ayrıntı için Claude Code entegrasyon belgelerine (İngilizce) ve Claude Code without a subscription (İngilizce) sayfasına bakın.
Bakiyeyi MB WAY ile yükleme
Önce abonelik: Anthropic'in web sitesinden satın alınan Claude aboneliği yalnızca kredi veya banka kartıyla ödenebilir (Anthropic'in ücretli planlar hakkındaki yardım makalesi, 3 Ekim 2026 tarihinde kontrol edildi); iOS veya Android Claude uygulamasından alınan abonelikte ödeme yöntemleri App Store veya Google Play tarafından belirlenir. Kunavo'nun ödeme yöntemleri, MB WAY dahil, Claude Pro veya Max için kullanılamaz; Kunavo API bakiyesini yükler ve Rota B bu bakiyeyi kullanır.
Bakiye Stripe ödeme adımında yüklenir. Fiyatlar ABD dolarıdır; Portekiz'den alışveriş yapanlara Stripe tutarı avro olarak gösterir. Stripe'ın Adaptive Pricing belgelerine göre ( 3 Ekim 2026 tarihinde kontrol edildi), bu dönüşüm alıcının ödediği %2–4 komisyonu içerir. Dolarla (kart, Apple Pay, Google Pay veya Link kullanarak) ödemeyi seçenler bu komisyonu ödemez; ancak banka kendi döviz kurunu ve ücretlerini uygulayabilir. MB WAY yalnızca avro ile çalışır. Avro cinsinden ödeme adımında şunlar görünür:
- MB WAY. MB WAY'i seçin, cep telefonu numaranızı girin ve MB WAY uygulamasında bildirim üzerinden veya etkinlikler bölümünden satın almayı onaylayın (Stripe'ın MB WAY hakkındaki belgeleri ve MB WAY'in çevrimiçi alışveriş hakkındaki bilgileri, 3 Ekim 2026 tarihinde kontrol edildi). Stripe'a göre uluslararası numaralar kabul edilir ancak müşterilerin çoğu +351 ile başlayan Portekiz numarası kullanır.
- Kartlar (Visa, Mastercard), Apple Pay, Google Pay ve Link.
Şunlar görünmez: Multibanco referansları (kurum ve referans numarasıyla ödeme), PayPal, SEPA otomatik ödeme ve yalnızca ABD'deki alıcılara sunulan Klarna. Avroya dönüşüm Stripe'ın Adaptive Pricing özelliğiyle yapılır; bu özelliğin sunduğu ödeme yöntemleri listesinde MB WAY vardır, Multibanco yoktur. MB WAY ayrıca çevrimiçi alışveriş için sanal MB NET kartları oluşturmanıza olanak tanır (MB WAY'in MB NET hakkındaki bilgileri, 3 Ekim 2026 tarihinde kontrol edildi); ödeme adımındaki kart alanının bunları kabul ettiği doğrulanmadı, bu nedenle en güvenli yol doğrudan MB WAY'i seçmektir.
Stripe'ın MB WAY hakkında belgelediği bilgiler (3 Ekim 2026 tarihinde kontrol edildi):
- Ödeme başına: 0,50 € ile 5000 € arasında.
- Günlük: varsayılan olarak 1000 €, MB WAY uygulamasında 10.000 €'ya kadar ayarlanabilir. Daha büyük yüklemeler önceden belirlenmiş günlük limiti aşabilir; bu durumda ödeme yapmadan önce limiti uygulamada yükseltin. Checkout'ta gösterilen avro tutarını bu limitlerle karşılaştırın.
- Tekrarlanan ödemeler: desteklenmiyor.
- Ekstrede, işlem tutarıyla birlikte Stripe'ın adı (Stripe Inc) görünür.
- Kunavo’da hesap oluşturun.
- Faturalandırma bölümünde US$ 10 tutarından başlayarak bir tutar seçin. Daha büyük yüklemeler ek bakiye sağlar: US$ 100 yükleyen kişi US$ 110 alır; US$ 1000 yükleyen kişi US$ 1200 alır; US$ 5000 yükleyen kişi US$ 6250 alır.
- Stripe checkout'unda, avro tutarını gördükten sonra MB WAY'i seçin, cep telefonu numaranızı girin ve satın almayı MB WAY uygulamasında onaylayın. Avro tutarı onaydan önce görünür.
- /app/keys bölümünde anahtarı oluşturup
ANTHROPIC_AUTH_TOKENiçine yerleştirin.
Bakiye ön ödemelidir: aylık ücret yoktur, bakiyenin süresi dolmaz ve başarısız istekler için ücret alınmaz. Otomatik bakiye yükleme yalnızca kayıtlı bir kart veya Link ile çalışır; MB WAY ile bakiye her zaman manuel olarak yüklenir, çünkü Stripe'a göre MB WAY yinelenen ödemeleri kabul etmez ve gelecekteki ödemeler için kaydedilemez. Kunavo, NIF veya KDV içeren faturalar da dahil olmak üzere fatura düzenlemez; bakiye yükleme geçmişi Billing bölümünde yer alır. Bu ödeme yöntemleri yalnızca Kunavo API bakiyesini yüklemek için kullanılır. Konuyla ilgili daha fazla bilgi için Claude ödemesini MB WAY ile yapma sayfasına bakın.
Yaygın hatalar
| Görünen ş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 aynı mesajın Portekizce 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 ve WSL için olan | bash satırı PowerShell'e girilmiş. PowerShell'de doğru satır install.ps1 satırıdır. |
| Komut betiğin metnini gösteriyor ancak hiçbir şey yüklemiyor | Komut yapıştırılırken kesilmiş: irm yalnızca betiği indirir; betiği çalıştıran | iex olur. CMD'de genellikle -o install.cmd && install.cmd bölümü eksiktir. |
syntax error near unexpected token '<' veya bir 403 | İndirme, betik yerine bir web sayfası veya hata kodu döndürdü. 3 Ekim 2026 tarihinde incelenen resmî sorun giderme bilgilerine göre «App unavailable in region» yazan bir sayfa, Claude Code'un ülkede kullanılamadığı anlamına gelir (Portekiz listede yer alır). Basit bir 403 de şirket proxy'sinden veya güvenlik duvarından kaynaklanabilir: desteklenen bir ülkedeyseniz önce ağı kontrol edin (proxy arkasındaysanız HTTPS_PROXY ve HTTP_PROXY değerlerini tanımlayın); çünkü Homebrew ve WinGet aynı sunuculara ulaşır. Bunların dışında sorun ağdan, bölgesel yönlendirmeden veya geçici bir arızadan kaynaklanabilir: daha sonra tekrar deneyin ya da macOS'ta Homebrew, Windows'ta WinGet ile yükleyin. |
Claude Code does not support 32-bit Windows | Windows PowerShell (x86) açılmış. Normal Windows PowerShell'i açın. |
npm.ps1 cannot be loaded | PowerShell 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 | Terminal programı bulamıyor. Pencereyi kapatıp yeniden açın; sorun devam ederse klasörü PATH'e ekleyin (Windows'ta yukarıdaki blokla). |
| Anahtar tanımlanmış oturum açma ekranı | Claude Code anahtarı okumadı. Değişkenleri yalnızca proje ayarlarında değil, kabukta veya ~/.claude/settings.json içinde tanımlayın ve yeni bir pencere açın. |
auth may not work as expected ile biten uyarı | Anahtar ile eski bir oturum aynı anda etkin. Yalnızca anahtarı kullanmak için /logout komutunu çalıştırın veya aboneliğe dönmek için değişkeni kaldırın. |
401 | Anahtar tanınmadı: sk-kn- anahtarının tamamını boşluksuz kopyaladığınızı, /app/keys bölümünde silinmediğini ve ANTHROPIC_AUTH_TOKEN gibi doğru adlı bir değişkende bulunduğunu doğrulayın. |
404 | ANTHROPIC_BASE_URL değeri /v1 ile bitiyor, istenen model Kunavo'da mevcut değil veya /model sonnet komutu ANTHROPIC_DEFAULT_SONNET_MODEL olmadan kullanılmış. |
Kurulumdan sonra
Bir projede ilk kez başlatırken /init yazın: Claude Code depoyu tarar ve çıkardığı bilgileri içeren bir CLAUDE.md dosyası yazar: projenin nasıl çalıştırılacağı, değişikliklerin nasıl test edileceği ve hangi stil kurallarının izleneceği. Bu dosyayı gözden geçirin ve kısa tutun; çünkü tüm oturumlarda yüklenir. Bağımsız görevler arasında /clear yeni bir konuşma başlatır; uzun bir görevde /compact, devam edebilmek için geçmişi özetler.
Bilinmesi gerekenler
- Bu, Claude Pro veya Max aboneliği değil, belirteç başına ücretlendirilen bir API'dir. Claude Code'u her gün birkaç saat kullananlar genellikle abonelikle daha az öder; düzensiz kullanımda belirteç başına ödeme avantajlıdır ve kullanılmayan bir ay hiçbir ücrete mal olmaz. Avro cinsinden karşılaştırma için Claude Code'un avro cinsinden fiyatı sayfasına bakın.
- API anahtarıyla çalışanlar Remote Control ve sesli dikte özelliklerini kullanamaz.
- Kunavo üzerinden, rezerve kota veya sözleşmesel garanti olmadan paylaşılan kapasite kullanılır; bunlara ihtiyaç duyanlar doğrudan Anthropic ile sözleşme yapmalıdır.
- MB WAY yalnızca manuel yüklemeler içindir; otomatik yükleme için kart veya Link gerekir.
- Checkout'ta gösterilen avro tutarlarına Stripe'ın dönüşüm komisyonu zaten dahildir.
Sık sorulan sorular
Claude Code nasıl kurulur?
Her sistem için resmî bir komutla. macOS, Linux ve WSL'de: curl -fsSL https://claude.ai/install.sh | bash. Windows'ta 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. Bu, Anthropic'in önerdiği ve arka planda kendini otomatik güncelleyen bağımsız kurulumdur. Ardından yeni bir terminal penceresi açın, claude --version ile doğrulayın ve claude ile başlayın.
Claude Code'u Windows'a kurmak için WSL veya yönetici izinleri gerekir mi?
İkisi de gerekmez. Resmî kurulum belgelerine göre komut, pencereyi yönetici olarak açmadan PowerShell veya Komut İstemi'nde (CMD) çalışır. Git for Windows isteğe bağlıdır: kuruluysa Claude Code komutları Git Bash üzerinden, değilse PowerShell üzerinden çalıştırır. Proje Linux araçlarına ihtiyaç duyuyorsa veya komutları bir sandbox içinde çalıştırmak istiyorsanız WSL 2 anlamlıdır; bu durumda Claude Code WSL terminalinin içine kurulur ve orada başlatılır. Windows PowerShell (x86) kullanmayın: Claude Code 32 bit Windows'u desteklemez.
Claude Code'u kurmak için Node.js gerekir mi?
Yalnızca npm ile kurulum yapıyorsanız gerekir; bu durumda Node.js 22 veya üzeri gerekir — bazı kılavuzların hâlâ belirttiği 18 değil. Bağımsız kurulum, Homebrew ve WinGet Node.js gerektirmez. Daha eski bir Node.js ile npm yalnızca bir EBADENGINE uyarısı gösterir ve kurulum devam eder. Asla sudo npm install -g kullanmayın; güncelleme için npm update -g yerine npm install -g @anthropic-ai/claude-code@latest kullanın.
Claude Code'u Pro veya Max aboneliği olmadan kullanmak mümkün mü?
Evet. Oturum açmak için ücretli bir hesap (Pro, Max, Team veya Enterprise) ya da bir Console hesabı gerekir; Claude.ai'nin ücretsiz planı kapsam dışıdır. Abonelik olmadan ANTHROPIC_BASE_URL=https://api.kunavo.com ve bir Kunavo anahtarıyla ANTHROPIC_AUTH_TOKEN ayarlanır: Claude Code oturum açmayı atlar ve aylık ücret olmadan, en az US$ 10 yüklenerek oluşturulan ön ödemeli bakiyeden token başına ödeme yapılır. Bu yöntemle iki işlev kaybedilir: Remote Control ve sesli dikte.
Claude Code API anahtarı nerede yapılandırılır: settings.json'da mı, PowerShell'de mi?
Kalıcı kullanım için ~/.claude/settings.json dosyasının env bloğunda (Windows'ta %USERPROFILE%\.claude\settings.json). Test etmek için yalnızca o pencere için geçerli olmak üzere PowerShell penceresinde $env:ANTHROPIC_AUTH_TOKEN ile veya ~/.zshrc ya da ~/.bashrc içinde export ile. Bir projenin .claude/settings.json dosyasında asla tutmayın; bu dosya depo commit'lerine girer. Shell ve ayarlar dosyasında aynı değişken varsa dosyadaki değer geçerlidir. Kunavo anahtarı hem ANTHROPIC_AUTH_TOKEN'da (Authorization: Bearer başlığı, hemen uygulanır) hem de ANTHROPIC_API_KEY'de (x-api-key başlığı; etkileşimli modda bir kez onay ister) kabul eder; bu kılavuz ANTHROPIC_AUTH_TOKEN kullanır. ANTHROPIC_BASE_URL yalnızca alan adını, https://api.kunavo.com, /v1 olmadan içerir.
/model sonnet neden 404 hatası veriyor?
Çünkü Claude Code'un sonnet takma adı, Kunavo'nun sunmadığı Sonnet 5.5'i ister. 3 Ekim 2026 tarihinde incelenen model yapılandırma belgelerine göre Anthropic API'sini kullananlar için takma adlar en yeni modelleri izler: opus, Opus 5.5'e; sonnet ise Sonnet 5.5'e yönelir. ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 ile birlikte ANTHROPIC_MODEL=claude-sonnet-5, ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 ve ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 ayarlandığında her istek, alt aracılar ve opusplan'ın yürütme adımı da dâhil olmak üzere Kunavo'nun sunduğu bir modeli kullanır. Opus 5.5 için Claude Code v2.1.280 veya üzeri gerekir (claude update ile güncellenir). Sık görülen diğer 404 nedeni, /v1 ile biten ve /v1/v1/messages oluşturan bir ANTHROPIC_BASE_URL değeridir.
Claude Code'un abonelik yerine anahtarı kullandığını nasıl anlarım?
Claude Code'da /status yazın. Status sekmesinde Anthropic base URL satırı https://api.kunavo.com göstermeli ve Auth token satırı ANTHROPIC_AUTH_TOKEN belirtmelidir. Login method satırında claude.ai hesabı görünüyorsa değişken okunmamıştır ve oturum aboneliği kullanıyordur. Claude Code başlarken hemen oturum açmanızı isterse hiçbir anahtar okunmamıştır.
Claude Code için MB WAY ile ödeme yapabilir miyim?
Kunavo API bakiyesi için evet: Stripe Checkout euro tutarını gösterdiğinde MB WAY kullanılabilir. MB WAY seçilir, cep telefonu numarası girilir ve satın alma MB WAY uygulamasında onaylanır. Stripe'a göre her MB WAY ödemesi 0,50 € ile 5000 € arasındadır; varsayılan günlük 1000 € limiti uygulamada 10.000 €'ya kadar yükseltilebilir. Doların euroya çevrilmesine %2–4 komisyon dahildir, minimum yükleme tutarı US$ 10 olarak belirlenmiştir ve aylık ücret yoktur. MB WAY yalnızca manuel yüklemelerde kullanılabilir: otomatik yükleme kayıtlı kart veya Link gerektirir. Multibanco referansları, PayPal ve SEPA doğrudan borçlandırma kullanılamaz; Kunavo fatura düzenlemez. Kunavo Checkout'u Claude Pro veya Max aboneliği için ödeme yapmaz; Claude sitesinden satın alınan bu abonelik yalnızca kredi veya banka kartıyla ödenebilir.