Kısa cevap: Claude Code, terminalinize uygun tek bir satırla kurulur. macOS, Linux ve WSL'de install.sh, Windows PowerShell'de irm … | iex, Komut İstemi'nde (CMD) install.cmd satırını çalıştırırsınız; üçü hemen aşağıda. Bu yol Node.js istemez, npm ile kurmak isterseniz Node.js 22 veya üstü gerekir. Kurulumdan sonra iki seçenek var: Claude hesabıyla giriş (Pro, Max, Team, Enterprise ya da Console; ücretsiz plan Claude Code'u kapsamıyor) ya da abonelik almadan bir API anahtarı. Anahtar yolunda ANTHROPIC_BASE_URL=https://api.kunavo.com (sonuna /v1 eklemeden), ANTHROPIC_AUTH_TOKEN ve modelleri sabitleyen dört değişkeni tanımlarsınız; oturumda /status anahtarın devrede olup olmadığını gösterir. Yalnızca harcanan token'lar ücretlenir. Bakiyeyi USDT veya USDC ile en az 10 USD yüklersiniz; taksit ve Papara seçeneği yok.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows – Komut İstemi (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdBu satırları ve aşağıdaki değişken adlarını Claude Code'un kurulum ve gateway bağlantısı belgelerinden 3 Ekim 2026 tarihinde aldık. Anthropic bu belgeleri Türkçe yayımlamıyor; hata mesajlarını bu yüzden İngilizce asıllarıyla veriyoruz. Kunavo fiyatlarını ve ödeme yöntemlerini en son 13 Kasım 2026 tarihinde kontrol ettik. VPN ya da yurt dışı proxy'si aramanıza gerek yok: Anthropic'in desteklenen ülkeler sayfası Türkiye'yi hem Claude.ai hem API için sayıyor (kontrol: 3 Ekim 2026).
Hangi satır, hangi terminal?
Kurulumda takılanların çoğu komutta değil, terminalde yanılıyor. Aşağıdaki tablo ortamınızı doğru satırla eşleştiriyor. Windows kullanıyorsanız terminali nasıl tanıyacağınızı bir sonraki bölümde anlatıyoruz.
| Ortamınız | Kullanacağınız yol | Güncelleme |
|---|---|---|
| macOS, Linux, Windows'ta WSL | install.sh satırı (bağımsız yükleyici, önerilen) | Arka planda kendiliğinden |
| Windows PowerShell | irm https://claude.ai/install.ps1 | iex | Arka planda kendiliğinden |
| Windows Komut İstemi (CMD) | install.cmd satırı | Arka planda kendiliğinden |
| Homebrew (macOS) ya da WinGet (Windows) | Paket yöneticisi (aşağıda) | Varsayılan olarak yok; paket yöneticisinden siz yaparsınız |
| Node.js 22 veya üstü kurulu | npm (aşağıda) | npm install -g @anthropic-ai/claude-code@latest ile |
Sistem gereksinimleri
Resmi kurulum belgesinin istedikleri (3 Ekim 2026 itibarıyla):
- İşletim sistemi: macOS 13.0 ya da daha yeni; Windows 10 sürüm 1809 ve sonrası veya Windows Server 2019 ve sonrası; Linux tarafında Ubuntu 20.04, Debian 10 ve Alpine Linux 3.19 ya da daha yenisi.
- Donanım: en az 4 GB RAM ve x64 ya da ARM64 işlemci. 32 bit Windows desteklenmiyor.
- Kabuk: Bash, Zsh, PowerShell veya CMD.
- Node.js: bağımsız yükleyici için gereksiz; yalnızca npm yolunda 22 veya üstü.
- Hesap: giriş yapacaksanız Pro, Max, Team, Enterprise veya Console. API anahtarıyla ne abonelik ne giriş gerekir.
İnternette dolaşan Türkçe anlatımların bir kısmı bu listenin eski hâlini kopyalıyor: npm için Node.js 18, Linux için Ubuntu 18.04 ya da CentOS 7 yazanlar hâlâ var. Bugünkü belge en düşük sürüm olarak Node.js 22'yi ve Ubuntu 20.04'ü veriyor. “ABD çıkışlı sabit bir proxy olmadan her adım hata verir” uyarısı da Türkiye için geçerli değil; tersine, açık bir VPN kurulumu bölge hatasına düşürebilir (macOS ve Linux bölümündeki indirme hatalarına bakın).
Claude Code Windows kurulumu
Windows'ta yönetici yetkisine, WSL'e ya da Git'e ihtiyacınız yok. Resmi belge terminalin yönetici olarak açılmasını istemiyor; bazı Türkçe videolardaki “PowerShell'i yönetici olarak çalıştırın” adımını atlayabilirsiniz. Bilmeniz gereken tek şey hangi terminalde olduğunuz:
- İstem
PS C:\Users\KullaniciAdi>gibiPSile başlıyorsa PowerShell'desiniz:irm … | iexsatırını kullanın. - Başında
PSyoksa, yalnızcaC:\Users\KullaniciAdi>görünüyorsa Komut İstemi'ndesiniz:install.cmdsatırını kullanın. - Başlat menüsündeki “Windows PowerShell (x86)” kaydını açmayın. 32 bitlik bir süreç olduğu için 64 bit bilgisayarda da
Claude Code does not support 32-bit Windowshatasını verir; eki olmayan “Windows PowerShell”i seçin.
Satırı yanlış pencereye yapıştırmak Windows'taki hataların başında geliyor ve mesajlar bunu açıkça söylemiyor. PowerShell'e yapıştırılan CMD satırı The token '&&' is not a valid statement separator ile döner. CMD'ye yapıştırılan PowerShell satırı Türkçe Windows'ta “'irm' iç ya da dış komut, çalıştırılabilir program ya da toplu iş dosyası olarak tanınmıyor.” der (İngilizce sistemde 'irm' is not recognized as an internal or external command). macOS'un curl … | bash satırını PowerShell'de denerseniz A parameter cannot be found that matches parameter name 'fsSL' ya da 'bash' is not recognized as the name of a cmdlet görürsünüz; Türkçe sistemde bu metinler Türkçe çıkabilir. Üç durumda da çözüm aynı: bulunduğunuz terminalin satırını alın.
Git for Windows ve WSL gerekli mi?
İkisi de isteğe bağlı. Git for Windows kuruluysa Claude Code kabuk komutlarını onunla gelen Git Bash'te çalıştırır, değilse PowerShell aracına geçer; belge Git'i öneriyor ama şart koşmuyor. Git kurulu olduğu hâlde Git Bash bulunamıyorsa ~/.claude/settings.json dosyasının env bloğunda CLAUDE_CODE_GIT_BASH_PATH değişkenine bash.exe dosyasının tam yolunu verin (belgedeki örnek: C:\Program Files\Git\bin\bash.exe).
WSL'i seçmek için iki neden var: Linux araçlarına ihtiyaç duymak ya da komutları korumalı alanda (sandbox) çalıştırmak istemek. Yerel Windows kurulumunda sandbox yok:
| Kurulum | Önkoşul | Sandbox | Kimin için |
|---|---|---|---|
| WSL'siz Windows | Yok (Git for Windows isteğe bağlı) | Desteklenmez | Projesi ve araçları Windows'ta olanlar |
| WSL 2 | Etkin WSL 2 | Desteklenir | Linux araçlarıyla ya da sandbox içinde çalışmak isteyenler |
| WSL 1 | Etkin WSL 1 | Desteklenmez | WSL 2'yi kullanamayanlar |
WSL'de kalacaksanız kurulumu da kullanımı da WSL terminalinde yapın: macOS/Linux satırı orada çalışır, claude da oradan açılır.
“claude” komutu bulunamıyor
Kurulum bittiği hâlde 'claude' is not recognized (macOS ve Linux'ta command not found: claude) görüyorsanız, büyük ihtimalle kurulumdan önce açılmış bir pencerede çalışıyorsunuz: yükleyici PATH değişkenini günceller ama eski terminal bunu görmez. Önce terminali kapatıp yeniden açın. Program Windows'ta %USERPROFILE%\.local\bin\claude.exe, macOS ve Linux'ta ~/.local/bin/claude konumunda durur. Windows'ta yeni pencere de işe yaramazsa klasörü belgedeki komutlarla kullanıcı PATH değişkeninize ekleyin:
# 1. Kurulum klasörü PATH içinde mi?
$env:PATH -split ';' | Select-String '\.local\\bin'
# 2. Sonuç yoksa kullanıcı PATH'ine ekleyin, terminali kapatıp yeniden açın
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# 3. Yeni terminalde
claude --versionnpm.ps1 cannot be loaded
Bu mesaj yalnızca npm yolunda çıkar: npm, PowerShell için bir .ps1 başlatıcı yazar ve sistemin betik yürütme ilkesi (execution policy) onu engeller. Belge üç çıkış yolu veriyor: komutları npm.cmd ve claude.cmd adlarıyla çalıştırmak, PowerShell'de yerel yükleyiciye geçmek ya da yalnızca kendi kullanıcınız için yerel betiklere izin vermek:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUsermacOS ve Linux'ta kurulum
Yukarıdaki install.sh satırı resmi belgede “Native Install (Recommended)” sekmesinde duruyor ve WSL'de de aynen çalışıyor. Bu yolla kurulan Claude Code yeni sürümleri arka planda kendisi indirir. Paket yöneticisi kullanmayı tercih ederseniz Homebrew ve WinGet de resmî seçenekler; ancak belgeye göre bu kurulumlar varsayılan olarak kendini güncellemez, yeni sürümü paket yöneticisi üzerinden siz alırsınız:
# Homebrew – stable kanalı; varsayılan olarak kendini güncellemez
brew install --cask claude-code
# WinGet (Windows) – varsayılan olarak kendini güncellemez
winget install Anthropic.ClaudeCodeBetik yerine HTML ya da 403 gelirse
syntax error near unexpected token '<' mesajı, bash'e betik yerine bir HTML sayfasının gittiğini gösterir; curl: (22) The requested URL returned error: 403 ise sunucunun indirmeyi reddettiğini. Kurulum sorunları belgesi (kontrol: 3 Ekim 2026) ikisini de yükleyici adresinin betik döndürmemesine bağlıyor. Sayfada App unavailable in region yazıyorsa istek, belgeye göre Claude Code'un sunulmadığı bir ülkeden gelmiş görünüyor. Türkiye listede olduğuna göre bu mesajı Türkiye'den alıyorsanız trafiğiniz büyük ihtimalle bir VPN ya da proxy üzerinden başka bir ülkeye çıkıyordur; kapatıp yeniden deneyin. İçeriksiz bir 403 genellikle şirket proxy'sinden ya da güvenlik duvarından gelir: başka bir ağdan deneyin veya BT ekibinizden bu adrese izin vermesini isteyin.
npm ile kurulum: Node.js 22 şart
npm yolu kaldırılmadı, resmi belgede hâlâ anlatılıyor; ama paketin istediği sürüm artık Node.js 22 ve üstü. node -v daha eski bir sürüm gösteriyorsa npm kurulumu durdurmaz, yalnızca bir EBADENGINE uyarısı basar. Yine de en temizi Node.js'i nodejs.org üzerinden 22 veya üstüne yükseltmek.
node -v # v22 veya üstü olmalı
npm install -g @anthropic-ai/claude-code # sudo kullanmadan
# güncelleme: npm update -g değil, @latest
npm install -g @anthropic-ai/claude-code@latestBu yolda üç alışkanlık sorun çıkarıyor:
sudoile kurmak. Belgesudo npm install -giçin izin sorunları ve güvenlik riski konusunda uyarıyor.npm update -gile güncellemek. Doğrusunpm install -g @anthropic-ai/claude-code@latest.- İsteğe bağlı bağımlılıkları kapatmak. Asıl çalıştırılabilir dosya, platforma özel bir
@anthropic-ai/claude-code-*paketiyle isteğe bağlı bağımlılık olarak gelir.--omit=optionalbayrağı ya da.npmrciçindekioptional=falsebu paketi atlatır: kurulum hatasız biter, ama macOS ve Linux'taclaudeaçılırkenclaude native binary not installedder.
Kurulum çalıştı mı?
Hangi yolu seçtiyseniz yeni bir terminal açıp şu iki komutu çalıştırın:
claude --version # sürüm numarasını yazar, ör. 2.1.211 (Claude Code)
claude doctor # oturum açmadan kurulum ve ayar teşhisiclaude --version bir sürüm numarası yazıyorsa program yerinde demektir. claude doctor ise oturum açmadan kurulumun durumunu ve ayar dosyalarındaki sorunları listeler; sonraki adımda bir şey ters giderse sorunun kurulumda mı yoksa yapılandırmada mı olduğunu buradan ayırırsınız.
Abonelik olmadan: Claude Code'a API anahtarı tanımlamak
claude ilk açıldığında kimlik ister. Claude planınız varsa giriş yapıp devam edersiniz; planınız yoksa ya da sabit aylık ücret yerine kullandığınız kadar ödemek istiyorsanız Claude Code'u bir API anahtarıyla çalıştırırsınız. İki yolun farkı:
| Ölçüt | Claude hesabıyla giriş | Kunavo API anahtarı |
|---|---|---|
| Gerekenler | Pro, Max, Team, Enterprise ya da Console hesabı. Ücretsiz Claude.ai planı yetmez. | sk-kn-… anahtarı ve birkaç ortam değişkeni. Abonelik ya da giriş yok. |
| Ücret | Pro aylık 20 dolar; yıllık alınırsa aylık 17 dolar, yani peşin 200 dolar. Max aylık 100 dolardan başlıyor. Vergi hariç (Claude fiyat sayfası, kontrol: 3 Ekim 2026). | Harcanan token kadar, ön ödemeli bakiyeden. Alt sınır 10 USD; aylık ücret yok, bakiye süresiz. |
| Ödeme yolu | Sitesinden alınan planlar yalnızca kredi veya banka kartıyla (Claude ücretli plan SSS, kontrol: 3 Ekim 2026). | USDT veya USDC ya da 7 pazarda yerel bir yöntem; kartlar devreye alınıyor |
| Çalışmayanlar | — | Remote Control ve sesli dikte. Fatura düzenlenmez (e-Arşiv dahil). |
Anahtar yolu Anthropic'in öngördüğü bir yapılandırma: ANTHROPIC_BASE_URL Claude Code'un yerleşik değişkeni ve resmi gateway belgesi, Claude Code'u bir proxy ya da gateway arkasında çalıştırmayı bu değişkenle anlatıyor. Eklenti, yama ya da değiştirilmiş bir istemci kurmazsınız. macOS ve Linux'ta altı satırı kabuk dosyanıza (~/.zshrc veya ~/.bashrc) ekleyin:
export ANTHROPIC_BASE_URL=https://api.kunavo.com # yalnızca alan adı, /v1 yok
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 ayarları kalıcı yapmadan önce tek bir PowerShell oturumunda deneyin; pencere kapanınca değişkenler de gider:
# Yalnızca bu PowerShell penceresinde geçerli – pencereyi kapatınca kaybolur
$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"
claudeHer terminalde geçerli olsun istiyorsanız aynı değerleri kullanıcı ayar dosyasının env bloğuna yazın. Belgeye göre bu dosya bütün projelerinize uygulanır; Windows'taki yeri %USERPROFILE%\.claude\settings.json. Bazı yapay zekâ özetlerinde geçen %APPDATA%\Claude\settings.json resmi belgedeki yol değil. Dosya zaten varsa içindekileri silmeden 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"
}
}Altı değişken ve dikkat edilecekler
| Değişken | Görevi | Dikkat |
|---|---|---|
ANTHROPIC_BASE_URL | İsteklerin gideceği sunucu | Yalnızca https://api.kunavo.com. Claude Code /v1/messages yolunu kendisi ekler; sona /v1 yazarsanız istek /v1/v1/messages adresine gider ve 404 alırsınız. |
ANTHROPIC_AUTH_TOKEN | sk-kn- ile başlayan anahtar | Authorization: Bearer başlığıyla gider ve hemen devreye girer (ayrıntı aşağıda). |
ANTHROPIC_MODEL | Ana model | Burada Claude Sonnet 5, yani claude-sonnet-5. Ad, Kunavo model listesindekiyle harfi harfine aynı olmalı. |
ANTHROPIC_DEFAULT_OPUS_MODEL | opus takma adının modeli | claude-opus-5-5, yani Claude Opus 5.5. Bu model Claude Code v2.1.280 veya üstünü ister; eski bir sürümdeyseniz claude update çalıştırın. Ayarlanmazsa takma ad Anthropic'in en yeni Opus modeline kayar. |
ANTHROPIC_DEFAULT_SONNET_MODEL | sonnet takma adının modeli | claude-sonnet-5. Ayarlanmazsa takma ad Kunavo'nun sunmadığı Sonnet 5.5'i ister; /model sonnet, opusplan'ın yürütme aşaması ve model: sonnet alt ajanları 404 alır. |
ANTHROPIC_DEFAULT_HAIKU_MODEL | haiku takma adı ve arka plan işleri | claude-haiku-4-5. Belgeye göre arka plan işlevleri de bu modelle çalışır. Ayarlanmazsa takma ad Kunavo'nun sunmadığı bir kimlik ister (v2.1.293'ten itibaren Haiku 5.5); /model haiku ve model: haiku alt ajanları 404 alır. |
ANTHROPIC_AUTH_TOKEN mı, ANTHROPIC_API_KEY mı? Kunavo anahtarı iki başlıktan da kabul eder: Authorization: Bearer ve x-api-key. Fark Claude Code'un davranışında. ANTHROPIC_AUTH_TOKEN Bearer başlığına gider ve soru sormadan çalışır. ANTHROPIC_API_KEY ise x-api-key başlığına gider ve etkileşimli modda ilk seferde onayınızı ister; o soruya “hayır” derseniz anahtar uyarı vermeden yok sayılır, geri açmak için /config → Use custom API key yolunu bulmanız gerekir. Bu rehberde ANTHROPIC_AUTH_TOKEN kullanmamızın nedeni bu.
Modelleri neden sabitliyoruz? Model yapılandırma belgesine göre (kontrol: 3 Ekim 2026) API ile çalışan Claude Code, hiçbir şey ayarlanmamışsa varsayılan model ve opus takma adı için Opus 5.5'i, sonnet takma adı için Sonnet 5.5'i ister; Anthropic yeni model çıkardıkça bu takma adlar da kayar. Kunavo 3 Ekim 2026 itibarıyla Sonnet 5.5'i sunmuyor, dolayısıyla sabitlenmemiş bir sonnet isteği 404 ile döner. Claude Opus 5.5 Kunavo'da çalışıyor, ama tarifesi ($2,80 / $14,00) Claude Sonnet 5 tarifesinden ($1,40 / $7,00) yüksek; sabitlemezseniz farkında olmadan daha pahalı modelle çalışırsınız. Yukarıdaki blokta ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 satırı bu yüzden var: /model sonnet, opusplan'ın yürütme aşaması ve model: sonnet olarak ayarlanmış alt ajanlar Sonnet 5.5 yerine Claude Sonnet 5 ile çalışır. opus takma adını ise Claude Opus 5.5 modeline (claude-opus-5-5) sabitliyoruz; bu model Claude Code v2.1.280 veya üstünü ister, eski bir sürümdeyseniz claude update çalıştırın.
Kunavo'daki tarifeler (girdi / çıktı, 1 milyon token başına): Claude Sonnet 5 $1,40 / $7,00 (Anthropic tarifesi: $2,00 / $10,00); Claude Opus 5.5 $2,80 / $14,00; arka plan işlerini üstlenen Claude Haiku 4.5 $0,70 / $3,50.
Anahtar nereye yazılmaz, hangi değer kazanır?
Projenin kendi .claude/settings.json dosyası anahtar için yanlış yer: gateway belgesi bu dosyanın depoya commit edildiğini hatırlatıyor, yani anahtar depoyu klonlayan herkese gider. Aynı değişken hem kabukta hem ayar dosyasının env bloğunda tanımlıysa çoğu durumda ayar dosyasındaki geçerli olur; kabukta değiştirdiğiniz bir değer etki etmiyorsa önce oraya bakın. Ayar dosyasındaki model anahtarı bu kuralın dışında: ANTHROPIC_MODEL değişkeni ondan önce gelir, model yalnızca değişken yoksa kullanılır. VS Code eklentisinde değişkenler, VS Code kullanıcı ayarlarındaki claudeCode.environmentVariables alanına girer.
İlk açılış ve /status kontrolü
Değişkenler doğru yerdeyse claude komutu giriş ekranını hiç göstermeden oturumu açar; gateway belgesi (kontrol: 3 Ekim 2026) ANTHROPIC_AUTH_TOKEN ayarlıyken davranışı böyle tarif ediyor. Karşınıza giriş ekranı çıkıyorsa Claude Code anahtarı görmemiştir. Sık rastlanan neden, anahtarın yalnızca proje ayarlarında durması: etkileşimli modda projenin .claude/settings.json ya da .claude/settings.local.json dosyasındaki env bloğu, ilk çalıştırma sihirbazı ve klasöre güven sorusu geçildikten sonra okunur. Anahtar, sihirbazdan önce okunan bir yerde olmalı: kabukta export, kullanıcı düzeyindeki ~/.claude/settings.json ya da yönetilen ayarlar (managed settings).
Oturum açıldığında /status yazın. İki satır yeterli bilgi verir:
Anthropic base URL: yalnızca özel bir adres tanımlıysa görünür vehttps://api.kunavo.comyazmalıdır. Satır hiç yoksaANTHROPIC_BASE_URLoturuma ulaşmamıştır.Auth token: yanındaANTHROPIC_AUTH_TOKENadı yazıyorsa istekler API anahtarıyla gidiyor. Onun yerine claude.ai hesabınızı gösteren birLogin methodsatırı varsa Claude Code hâlâ kayıtlı girişi kullanıyor; oturumu kapatın, yeni bir terminal açın ve değişkenleri nereye yazdığınızı kontrol edin.
Claude Code'u açmadan sınamak
Adresi ve anahtarı Claude Code'dan bağımsız olarak da deneyebilirsiniz. Resmi belgedeki yöntem, tek çıktı token'lık bir istek göndermek; bakiyenizden çok küçük bir tutar düşer. Komut değişkenleri o anki kabuktan okur, anahtar yalnızca ayar dosyasındaysa önce bu terminalde export edin. Yanıt {"id":"msg_ ile başlıyorsa adres ve anahtar sağlam; 401 anahtarın reddedildiğini gösterir.
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 karşılığı aşağıda; başarılıysa yanıtta msg_ ile başlayan bir id alanı olur:
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": "."}]}'API anahtarıyla neler değişir?
- Remote Control ve sesli dikte yok. Belgeye göre ikisi de claude.ai kimliği ister ve
ANTHROPIC_API_KEY,ANTHROPIC_AUTH_TOKENya da birapiKeyHelperetkinken çalışmaz. v2.1.196'dan itibaren Remote Control,ANTHROPIC_BASE_URLAnthropic dışında bir sunucuyu gösterdiğinde de kapalı. /fastkapalı görünür. Belgeye göre yalnızca bir bearer token tanımlıyken Claude Code hızlı modun (fast mode) durumunu sormaz, kapalı varsayar.- MCP araç araması varsayılan olarak devre dışı. MCP belgesi (kontrol: 3 Ekim 2026) özel bir
ANTHROPIC_BASE_URLayarını, tool search kullanılmayan yapılandırmalar arasında sayıyor. /contextrakamları yaklaşıktır. Kunavo/v1/messages/count_tokensuç noktasını sunmuyor; bu durumda Claude Code, gateway uyumluluk belgesine göre (kontrol: 3 Ekim 2026) bağlam kullanımını karakter sayısından tahmin eder.
Entegrasyonun teknik ayrıntıları İngilizce Claude Code entegrasyon belgesinde; bu rehberin İngilizce karşılığı Install Claude Code.
Kunavo bakiyesi nasıl yüklenir
- Her yerden: TRON üzerinde USDT (TRC-20) veya Base üzerinde USDC; yükleme sayfasının verdiği adrese, gösterilen tutarın tam aynısı gönderilir.
- Yerel para birimiyle: Alipay (Çin anakarası), AlipayHK (Hong Kong), Pix (Brezilya), GCash (Filipinler), Touch 'n Go eWallet / Boost (Malezya), PayNow (Singapur) ve K PLUS / LINE Pay (Tayland); yükleme sayfası tutarı ödemeden önce o para biriminde gösterir.
- Kartla ödeme şu anda devreye alınıyor ve henüz kullanılamıyor.
Burada ödediğiniz şey bir abonelik değil, Claude Code'un token başına harcadığı ön ödemeli API bakiyesi. Anthropic'in sitesinden alınan Pro ve Max ise yalnızca kredi veya banka kartıyla ödenebiliyor (Claude ücretli plan SSS, kontrol: 3 Ekim 2026). Kunavo'ya yaptığınız yükleme bu planların yerine geçmez ve onları ödemez. Adımlar:
- Kunavo'ya kaydolun. E-posta adresi ya da Google hesabı yeterli; kayıtta kart bilgisi sorulmaz.
- Billing sayfasında tutarı seçin. Alt sınır 10 USD; abonelik ya da aylık ücret yok. Yüksek tutarlarda bonus eklenir: 100 USD yükleyene 110 USD bakiye, 1.000 USD yükleyene 1.200 USD bakiye ve 5.000 USD yükleyene 6.250 USD bakiye.
- Ardından API Keys sayfasında
sk-kn-ile başlayan bir anahtar üretin. Anahtar yalnızca bir kez gösterilir; kopyalayıp hemenANTHROPIC_AUTH_TOKENdeğerine yazın.
Taksit, Papara, havale ve Troy
- Taksit yok, ödeme tek çekim. Türk kartlarıyla yurt dışı sitelerden yapılan harcamalar sonradan da taksite bölünemiyor (enuygunfinans.com, kontrol: 3 Ekim 2026).
- Papara, havale/EFT ve PayPal yok. Ödeme sayfasında bu seçenekler çıkmaz.
- Fatura yok. Kunavo e-Arşiv dahil hiçbir fatura düzenlemez; yüklemelerinizin dökümü Billing sayfasında durur.
Bakiyenin son kullanma tarihi yoktur, başarısız istekler ücretlendirilmez. Bütün modellerin tarifeleri Claude API fiyatları rehberinde.
Bir çalışma oturumu kaça mal olur?
Anahtar yolunda maliyet tamamen token sayısına bağlı. Claude Code her istekte konuşmanın bağlamını baştan gönderir; bağlamın değişmeyen baş kısmı önbellekten okunduğunda ise çok daha düşük tarifeden sayılır. Aşağıdaki tablo bir ölçüm değil, açık varsayımlarla yapılmış bir hesap; üst sınır olarak da okunmamalı. Varsayımlar:
- istek başına 40.000 girdi token'ı; bunların 36.000 tanesi (%90) önbellekten okunuyor, kalan 4.000 tanesi önbelleğe yazılıyor;
- istek başına 1.000 çıktı token'ı;
- oturumda 50 istek; arka plandaki Claude Haiku 4.5 çağrıları hesaba katılmadı;
- Claude Sonnet 5 için önbellekten okuma girdi tarifesinin %10 oranında, önbelleğe yazma ise 1,25 katı üzerinden ücretlendiriliyor. Tablodaki her model kendi oranlarıyla hesaplandı.
| Model | Bir istek | 50 istek | 50 istek, önbellek isabeti olmadan |
|---|---|---|---|
| Claude Sonnet 5 | $0,019 | $0,95 | $3,15 |
| Claude Opus 5.5 | $0,033 | $1,65 | $6,30 |
Gerçek tutarı bağlamın uzunluğu, önbellek isabeti, yanıtların uzunluğu ve konu değiştirirken sohbeti temizleyip temizlemediğiniz belirler. Resmi maliyet belgesi (kontrol: 3 Ekim 2026) iki ayrıntı ekliyor: Claude Code siz bir şey yazmasanız da arka planda az miktarda token harcar, genellikle oturum başına 0,04 dolardan az; API anahtarında önbellek ömrü varsayılan olarak beş dakika, dolayısıyla daha uzun bir aradan sonraki ilk mesaj önbelleği ıskalar ve bağlamın tamamı yeniden işlenir. Konu değiştirirken /clear, uzun oturumlarda /compact bu maliyeti düşürür.
Tüm tarifeler fiyat sayfasında. Kendi kullanımınızı Claude token maliyet hesaplayıcısıyla (İngilizce) tahmin edebilirsiniz. Abonelik mi daha uygun, API mi, sorusunu Claude Code fiyatı rehberi ele alıyor.
Hata mesajları ve çözümleri
| Mesaj | Neden ve çözüm |
|---|---|
The token '&&' is not a valid statement separator | CMD satırı PowerShell'e yapıştırılmış. irm … | iex satırını kullanın. |
“'irm' iç ya da dış komut, çalıştırılabilir program ya da toplu iş dosyası olarak tanınmıyor.” (İngilizce: 'irm' is not recognized as an internal or external command) | PowerShell satırı CMD'ye yapıştırılmış. install.cmd satırını kullanın. |
A parameter cannot be found that matches parameter name 'fsSL', 'bash' is not recognized as the name of a cmdlet | macOS/Linux komutu Windows'ta çalıştırılmış. PowerShell satırını kullanın. |
syntax error near unexpected token '<', 403, App unavailable in region | Yükleyici adresi HTML sayfası ya da hata kodu döndürmüş. VPN, proxy ve güvenlik duvarını kontrol edin; Türkiye desteklenen ülkeler arasında. |
command not found: claude, 'claude' is not recognized | Kurulum klasörü PATH içinde değil. Yeni terminal açın; Windows'ta yolu yukarıdaki PowerShell komutlarıyla ekleyin. |
EBADENGINE uyarısı | Node.js sürümü 22'den eski. Kurulum durmaz ama Node.js'i güncellemeniz iyi olur. |
claude native binary not installed (macOS, Linux) | npm isteğe bağlı bağımlılıkları (--omit=optional ya da optional=false) veya kurulum betiklerini (--ignore-scripts) atlamış. Bu ayarları kaldırıp yeniden kurun. |
npm.ps1 cannot be loaded | PowerShell yürütme ilkesi npm betiğini engelliyor. Set-ExecutionPolicy komutunu çalıştırın ya da bağımsız yükleyiciyi kullanın. |
Claude Code does not support 32-bit Windows | PowerShell (x86) açık. Normal “Windows PowerShell”i açın. |
| Anahtar ayarlı olduğu hâlde giriş ekranı | Claude Code anahtarı okumamış. Değişkenleri yalnızca proje ayarlarına değil, kabuğa ya da ~/.claude/settings.json dosyasına yazın ve yeni bir terminal açın. |
401 | Anahtar reddedilmiş. sk-kn- anahtarının eksiksiz ve boşluksuz kopyalandığını, /app/keys sayfasında silinmediğini ve ANTHROPIC_AUTH_TOKEN içinde olduğunu kontrol edin. |
404 | ANTHROPIC_BASE_URL /v1 ile bitiyor ya da istenen model Kunavo'da yok; örneğin modelleri sabitleyen dört değişken ayarlanmamış ve sonnet takma adı Sonnet 5.5'i istiyor. |
Bilmeniz gereken kısıtlar
- Kunavo fatura düzenlemez; e-Arşiv de yok.
- Bu bir Claude Pro ya da Max aboneliği değil, token başına ödenen bir API. Anahtar yolunda Remote Control ve sesli dikte çalışmaz,
/fastkapalı görünür, MCP araç araması varsayılan olarak devre dışıdır. - Kunavo 3 Ekim 2026 itibarıyla Sonnet 5.5'i sunmuyor; modeller sabitlenmezse
sonnettakma adı 404 döner. - Claude Code'un resmi belgeleri ve Kunavo entegrasyon belgesi yalnızca İngilizce (kontrol: 3 Ekim 2026).
Sık sorulan sorular
Claude Code nasıl kurulur?
En kolayı, Anthropic'in belgede önerdiği bağımsız yükleyici. macOS, Linux ve WSL'de curl -fsSL https://claude.ai/install.sh | bash komutunu çalıştırın. Windows'ta PowerShell'de irm https://claude.ai/install.ps1 | iex, Komut İstemi'nde (CMD) ise curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd satırını kullanın. Ardından yeni bir terminal açıp claude --version ile kurulumu kontrol edin. Bağımsız kurulum arka planda kendini günceller. npm ile kurmak isterseniz Node.js 22 veya üstü gerekir; sudo kullanmayın, güncellemeyi npm install -g @anthropic-ai/claude-code@latest ile yapın.
Claude Code Windows'a nasıl kurulur? Yönetici olarak mı çalıştırmalıyım, WSL ve Git şart mı?
Yönetici yetkisi gerekmez; resmi belge bunu açıkça söylüyor. WSL ve Git de şart değil: PowerShell ya da CMD için olan kurulum satırını normal bir terminalde çalıştırmanız yeterli. Git for Windows isteğe bağlı ama önerilir; kuruluysa Claude Code komutları Git Bash ile, değilse PowerShell ile çalıştırır. Linux araçlarına ya da komutları korumalı alanda (sandbox) çalıştırmaya ihtiyacınız varsa WSL 2 seçin; o zaman claude'u WSL terminalinde kurup orada başlatın. Başlat menüsündeki “Windows PowerShell (x86)” 32 bitlik bir süreçtir ve 64 bit bilgisayarda bile 32-bit Windows hatası verir, onu açmayın.
Claude Code ücretsiz mi, abonelik olmadan kullanılabilir mi?
Ücretsiz Claude.ai planı Claude Code'u kapsamıyor; Claude hesabıyla giriş için Pro, Max, Team, Enterprise ya da Console hesabı gerekiyor. Abonelik olmadan da kullanabilirsiniz: ANTHROPIC_BASE_URL=https://api.kunavo.com ve API anahtarınızla ANTHROPIC_AUTH_TOKEN ayarladığınızda Claude Code giriş ekranı göstermeden açılır ve harcadığı token'ları Kunavo'daki ön ödemeli bakiyeden öder. Aylık ücret yoktur. Bu modda Remote Control ve sesli dikte çalışmaz, çünkü ikisi de claude.ai kimliği ister.
Claude Code'a API anahtarı nereye girilir? ANTHROPIC_BASE_URL /v1 ile mi bitmeli? AUTH_TOKEN mı, API_KEY mi?
Sonunda /v1 olmamalı. Claude Code /v1/messages yolunu kendisi ekler; adres /v1 ile biterse istek /v1/v1/messages'a gider ve 404 döner. Değişkenleri kabuk dosyanıza (~/.zshrc, ~/.bashrc ya da PowerShell'de $PROFILE) veya kullanıcı ayar dosyası ~/.claude/settings.json içindeki env bloğuna yazın; Windows'ta yol %USERPROFILE%\.claude\settings.json, %APPDATA% değil. Projenin .claude/settings.json dosyasına asla yazmayın, o dosya depoya commit edilir. Kunavo anahtarı hem Authorization: Bearer hem x-api-key başlığından okur, yani iki değişken de çalışır. ANTHROPIC_AUTH_TOKEN'ı öneriyoruz çünkü hemen devreye girer; ANTHROPIC_API_KEY ise etkileşimli modda bir kez onay ister ve reddedilirse sessizce yok sayılır (yeniden açmak için /config → Use custom API key).
ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL ve ANTHROPIC_DEFAULT_SONNET_MODEL neden ayarlanmalı?
Ayarlamazsanız Claude Code, Anthropic'in yeni modelleriyle birlikte kayan takma adları (alias) kullanır. Resmi model yapılandırma belgesine göre (kontrol: 3 Ekim 2026) API kullanıcıları için varsayılan model ve opus takma adı Opus 5.5'i, sonnet takma adı Sonnet 5.5'i gösterir. Kunavo Sonnet 5.5'i şu an (3 Ekim 2026 itibarıyla) sunmuyor, bu yüzden sonnet isteği 404 döner: /model sonnet, opusplan'ın yürütme aşaması ve model: sonnet olarak ayarlanmış alt ajanlar (subagent) çalışmaz. Varsayılan Opus 5.5 ise çalışır ama Claude Sonnet 5 modelinden pahalıdır. Sabitledikten sonra ana model ve sonnet takma adı claude-sonnet-5, opus takma adı claude-opus-5-5, haiku takma adı ve arka plan işleri claude-haiku-4-5 olur; hangi modelin yanıt verdiğini ve hangi tarifeden ödediğinizi bilirsiniz. Opus 5.5 için Claude Code v2.1.280 veya üstü gerekir; eski bir sürümdeyseniz claude update çalıştırın.
Claude Code'un API anahtarını kullandığını /status ile nasıl kontrol ederim?
Claude Code oturumunda /status yazın. “Anthropic base URL” satırı https://api.kunavo.com göstermeli ve “Auth token” satırında ANTHROPIC_AUTH_TOKEN adı yazmalı. Bunun yerine claude.ai hesabıyla bir “Login method” satırı görüyorsanız değişkenler okunmamış demektir: oturumu kapatın, yeni bir terminal açın ve değişkenleri nereye yazdığınızı kontrol edin.