Claude Code kurulumu, resmî bağımsız yükleyiciyi tek satır çalıştırmaktan ibarettir. Mac, Linux ve WSL için install.sh, Windows'ta PowerShell için install.ps1, CMD için install.cmd kullanılır (npm ile de yüklenebilir; bu durumda Node.js 22 veya üzeri gerekir). Genellikle bundan sonra Pro veya Max gibi bir planla giriş yapılır; abonelik yapmak istemiyorsanız ANTHROPIC_BASE_URL=https://api.kunavo.com (/v1 eklemeyin), API anahtarını içeren ANTHROPIC_AUTH_TOKEN ve modeli sabitleyen dört değişkeni ayarlayarak giriş yapmadan başlatabilirsiniz. Çalışıp çalışmadığını /status ile doğrulayın. API bakiyesi JCB gibi kartlar, Apple Pay, Google Pay ve Link ile $10 tutarından başlayarak önceden yüklenebilir; ödeme ekranı tutarı yen olarak gösterir.
# macOS・Linux・WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows コマンドプロンプト(CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdKurulum adımlarının birincil kaynağı, Japonca okunabilen Anthropic'in resmî belgeleridir (Kurulum, Kurulum sorunlarını giderme, 3 Ekim 2026 tarihinde kontrol edildi). Bu sayfa söz konusu içeriği tekrarlamak yerine Japonca açıklama yazılarındaki tutarsız noktalara (Node.js sürümü, Windows yönetici izinleri ve Git) ve resmî belgelerin ele almadığı konulara — oturum açmadan API anahtarıyla çalıştırma ayarına ve Japonya'dan ödeme yapmaya — odaklanıyor. Fiyatlar ve ödeme yöntemleri 10 Ekim 2026 tarihindeki bilgilerdir. Japonya, Anthropic'in hem Claude.ai hem de API için desteklenen ülkeler listesinde yer alıyor (3 Ekim 2026 tarihinde kontrol edildi).
Önce karar verin: abonelikle giriş mi, API anahtarıyla çalıştırma mı?
Kurulum aynıdır; fark ilk başlatmadan sonradır. Claude Code başlatıldığında kimlik doğrulama ister. Kararsızsanız şu üç ölçüte göre karar verebilirsiniz.
- Pro, Max, Team veya Enterprise aboneliğiniz zaten varsa ya da Console hesabınız bulunuyorsa: doğrudan giriş yaparak kullanabilirsiniz. Bu sayfadaki API anahtarı ayarlarına gerek yoktur. Ücretsiz plana Claude Code dahil değildir.
- Her ay sabit ücret ödemek istemiyor, kullanımınız aydan aya büyük ölçüde değişiyorsa: API anahtarıyla çalışıp yalnızca kullandığınız tokenlar için ödeme yapmak size uygundur. Karşılaştırma için Claude aboneliği Pro'da aylık 20 $ (yıllık ödemede 200 $, ayda yaklaşık 17 $), Max'te ise ayda 100 $'dan başlar; her ikisi de vergiler hariçtir (Claude fiyatlandırma sayfası, 3 Ekim 2026 tarihinde kontrol edildi). Hangi seçeneğin daha ucuz olacağına ilişkin eşik Claude Code fiyatlandırması bölümünde hesaplanmıştır.
- Remote Control veya sesli girişi kullanmak istiyorsanız: ikisi de claude.ai hesabı gerektirdiğinden API anahtarıyla kullanılamaz. Girişi seçin.
Ödeme yöntemleri de farklıdır. Anthropic'in web sitesinden alınan abonelikler yalnızca kredi veya banka kartıyla ödenir; iPhone ya da Android uygulamasından alınan aboneliklerde ödemeyi App Store veya Google Play işler (Anthropic yardım sayfası, İngilizce sürümü, 3 Ekim 2026 tarihinde kontrol edildi). Kunavo API bakiyesine JCB dahil kartlar, Apple Pay, Google Pay ve Link ile para yükleyebilirsiniz (ayrıntılar, ilerideki ödeme bölümünde).
Kurulum öncesi kontrol
Koşullar resmî belgelerdeki gibidir (3 Ekim 2026 tarihinde kontrol edildi). Sağ sütun, bunları yerel olarak doğrulama yöntemini gösterir.
| Öğe | Koşul | Doğrulama yöntemi |
|---|---|---|
| İşletim sistemi | macOS 13.0 veya üzeri / Windows 10 1809 veya üzeri, Windows Server 2019 veya üzeri / Ubuntu 20.04 veya üzeri, Debian 10 veya üzeri, Alpine Linux 3.19 veya üzeri | Mac'te Apple menüsü > “Bu Mac Hakkında”; Windows'ta winver |
| CPU ve bellek | x64 veya ARM64, 4 GB veya üzeri RAM | 32 bit Windows ve PowerShell kullanılamaz |
| Kabuk | Bash, Zsh, PowerShell, CMD | Windows'ta istemin başında PS varsa PowerShell'dir |
| Node.js | Yalnızca npm ile kurulumda 22 veya üzeri gerekir. Bağımsız yükleyici için gerekmez | node -v |
| Kullanılacak ülke | Anthropic'in desteklediği ülkeler (Japonya desteklenir) | Yurt dışı üzerinden VPN kullanılmadığından emin olun |
Kurulum yöntemi
Resmî belgelerde “önerilen” yöntem bağımsız yükleyicidir. Diğer yöntemlerden temel farkı güncellemelerin yapılma biçimidir.
| Yöntem | Güncelleme | Ön koşul |
|---|---|---|
| Bağımsız yükleyici (önerilir) | Arka planda otomatik güncelleme | Yok (komut sayfanın başında) |
| Homebrew ve WinGet (Windows) | Varsayılan olarak otomatik güncellenmez. Paket yöneticisiyle kendiniz güncelleyin veya CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 ile etkinleştirin | Her paket yöneticisi |
| npm | @latest ekleyerek yeniden yükleyin | Node.js 22 veya üzeri |
# Homebrew(既定では自動更新されない)
brew install --cask claude-code
# WinGet(Windows・既定では自動更新されない)
winget install Anthropic.ClaudeCodeHer yöntemde işlem bittikten sonra terminali yeniden açın ve doğrulayın. Kurulumdan önce açık olan pencereler yeni PATH değerini yüklememiş olabilir. claude doctor bir oturum başlatmadan yalnızca kurulum ve yapılandırma durumunu gösterir; çalışmadığında sorunu ayırmak için kullanılabilir.
claude --version # 2.1.211 (Claude Code) のようなバージョン番号が出れば OK
claude doctor # セッションを開かずに、インストールと設定を診断するnpm ile kurulum hakkında not
Japonca açıklama yazılarında hâlâ sıkça “Node.js 18 veya üzeri” ifadesi görülse de resmî belgelerdeki gereksinim Node.js 22 veya üzeridir (resmî belgeler, 3 Ekim 2026 tarihinde kontrol edildi). Eski Node.js sürümünde npm yalnızca EBADENGINE uyarısı verir, kurulumu durdurmaz ve claude komutu yine başlar; ancak bir uyarı görürseniz Node.js sürümünü yükseltmeniz daha güvenlidir. Sürümleri nvm veya Volta gibi araçlarla değiştiriyorsanız kurulum yapacağınız kabukta node -v komutuyla sürümü kontrol edin.
node -v # v22 以上であること
npm install -g @anthropic-ai/claude-code # sudo は付けない
# 更新は @latest で(npm update -g は使わない)
npm install -g @anthropic-ai/claude-code@latestResmî belgeler sudo npm install -g kullanılmaması gerektiğini açıkça belirtir. Ayrıca ana ikili dosya isteğe bağlı bağımlılık olarak kurulduğundan, --omit=optional veya .npmrc içindeki optional=false ile isteğe bağlı bağımlılıklar atlanırsa Mac ve Linux'ta claude native binary not installed görünür ve başlatılamaz.
Windows'a kurulumla ilgili önemli noktalar
Öncelikle internette sıkça görülen iki adım gerekmiyor. “PowerShell'i yönetici olarak çalıştır” ve “Önce Git for Windows'ı yükle” adımlarının ikisi de resmî belgelerde gereksinim olarak yer almıyor. Yönetici izinleri gerekmez, Git for Windows isteğe bağlıdır; yüklenmemişse Claude Code komutları PowerShell'de çalıştırır (Windows kurulumu, 3 Ekim 2026 tarihinde kontrol edildi).
Bununla birlikte komutu yapıştırmadan önce yalnızca iki şeyi kontrol edin.
- Şu anda açık olan PowerShell mi, CMD mi? İstem
PS C:\Users\ユーザー名>ise PowerShell içinirmsatırını;PSiçermeyenC:\Users\ユーザー名>ise CMD içininstall.cmdsatırını kullanın. Karıştırırsanız PowerShell'de&&ayraç olarak tanınmadı hatası, CMD'de iseirmtanınmadı hatası alırsınız (Japonca Windows'ta mesaj Japonca görünebilir). - “Windows PowerShell (x86)” açık değil mi? Başlat menüsündeki (x86) sürümü 32 bit bir işlemdir; 64 bit bilgisayarda bile
Claude Code does not support 32-bit Windowshatasıyla durur.
Windows üzerinde çalıştırmanın üç yolu vardır. Kararsızsanız doğrudan Windows'ta başlayabilirsiniz.
| Çalışma ortamı | Korumalı alan | Kimler için |
|---|---|---|
| WSL'siz Windows (PowerShell ve CMD) | Desteklenmiyor | Kod ve araçlar Windows tarafındadır. Ek bir şey yüklemek gerekmez |
| WSL 2 | Destekleniyor | Linux araçlarını kullanmak veya komutları yalıtılmış çalıştırmak isteyenler. Mac-Linux satırını WSL terminalinde çalıştırır ve claude'u da orada başlatır |
| WSL 1 | Desteklenmiyor | WSL 2'nin kullanılamadığı ortamlar |
Git for Windows kurulu olduğu hâlde Claude Code Git Bash'i bulamıyorsa, kullanıcı ayar dosyasındaki env içinde CLAUDE_CODE_GIT_BASH_PATH için bash.exe konumunu yazın.
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}Kurulumdan sonra claude çalışmıyorsa
'claude' is not recognized (Mac ve Linux'ta command not found: claude) yükleme konumunun PATH içinde olmadığını gösterir. Bağımsız yükleyicinin konumu Windows'ta %USERPROFILE%\.local\bin\claude.exe, Mac ve Linux'ta ~/.local/bin/claude'dir. Terminali yeniden açmak da sorunu çözmezse resmî belgelerdeki adımlarla PowerShell'den kontrol edip ekleyin.
# 1. インストール先が PATH に入っているか確認する
$env:PATH -split ';' | Select-String '\.local\\bin'
# 2. 何も出なければユーザーの PATH に追加し、ターミナルを開き直す
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# 3. 新しいターミナルで
claude --versionnpm ile yüklediğinizde npm.ps1 cannot be loaded because running scripts is disabled on this system (başlatma sırasında claude.ps1) mesajının görünmesinin nedeni, PowerShell yürütme ilkesinin npm'nin .ps1 betiğini engellemesidir (resmî belgeler, 3 Ekim 2026 tarihinde kontrol edildi). Yalnızca geçerli kullanıcı için yerel betik çalıştırmaya izin veren aşağıdaki komut sorunu çözer. İlkeleri değiştirmek istemiyorsanız npm.cmd ve claude.cmd komutlarını kullanın veya PowerShell için bağımsız yükleyiciye geçin.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserGiriş yapmadan API anahtarıyla çalıştırma ayarı
Kunavo, Anthropic'in kendisi değil; Claude gibi modellere API erişimini ön ödemeyle sunan bağımsız bir API ağ geçididir. Claude Code'da isteklerin gönderileceği hedefi değiştiren resmî ANTHROPIC_BASE_URL değişkeni bulunur ve resmî belgelerde “Claude Code'u bir LLM ağ geçidine bağlama” başlıklı bir sayfa vardır. Eklenti veya değiştirilmiş sürüm kullanmayız. Bu değişken yalnızca isteklerin gönderildiği hedefi değiştirir; yanıtı hangi modelin vereceği ayrı bir değişkenle belirlenir (Model ayarları, 3 Ekim 2026 tarihinde kontrol edildi).
Aşağıdaki 6 ayarı yapılandırmanız gerekir.
| Değişken | Değer | Kolay karıştırılan noktalar |
|---|---|---|
ANTHROPIC_BASE_URL | https://api.kunavo.com | Yalnızca alan adına kadar. Claude Code /v1/messages eklediğinden, /v1 dahil yazarsanız istek /v1/v1/messages'e gönderilir ve 404 alınır |
ANTHROPIC_AUTH_TOKEN | sk-kn- ile başlayan anahtar | ANTHROPIC_API_KEY kullanımına göre daha güvenilir (aşağıda açıklanır) |
ANTHROPIC_MODEL | claude-sonnet-5 | Ana model (Claude Sonnet 5). Kunavo model listesindeki adla tamamen eşleşmelidir |
ANTHROPIC_DEFAULT_OPUS_MODEL | claude-opus-5-5 | opus takma adının hedefini Claude Opus 5.5 olarak sabitleyin. Claude Code v2.1.280 veya üzeri gerekir (eskiyse claude update) |
ANTHROPIC_DEFAULT_SONNET_MODEL | claude-sonnet-5 | sonnet takma adının hedefi. Ayarlanmazsa Kunavo'da bulunmayan Sonnet 5.5 çağrılır ve /model sonnet, opusplan yürütme aşaması ile sonnet belirtilen alt aracılar 404 döndürür |
ANTHROPIC_DEFAULT_HAIKU_MODEL | claude-haiku-4-5 | haiku takma adı ve arka plan işlemlerinin modeli. Ayarlanmazsa Kunavo'da bulunmayan bir model kimliği (v2.1.293 ve sonrasında Haiku 5.5) çağrılır; /model haiku ve haiku olarak belirtilen alt ajanlar 404 hatası verir. Özetler gibi arka plan işlemleri de ana modelde çalışır. |
Mac ve Linux'ta kabuk yapılandırma dosyanıza (~/.zshrc veya ~/.bashrc) ekleyin ve terminali yeniden açın.
export ANTHROPIC_BASE_URL=https://api.kunavo.com # ドメインだけ。/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-5Yalnızca Windows'ta denemek için PowerShell penceresinde aşağıdakini çalıştırın. Pencereyi kapatırsanız silinir.
# このウィンドウの中だけで有効(閉じると消える)
$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 seferinde girmek istemiyorsanız kullanıcı ayar dosyasındaki ~/.claude/settings.json (Windows'ta %USERPROFILE%\.claude\settings.json) env bölümüne yazın. Tüm projeler için geçerli olur ve Mac ile Windows'ta aynı sözdizimi kullanılabilir. Dosyada başka ayarlar 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"
}
}Nereye yazılacağıyla ilgili dikkat edilmesi gereken üç nokta vardır.
- Projenin
.claude/settings.jsondosyasına anahtar yazmayın. Bu dosya depoya kaydedilir ve depoyu kopyalayan herkes anahtara erişebilir (resmî belgeler). - Aynı değişken hem kabukta hem yapılandırma dosyasında varsa yapılandırma dosyasındaki değer kullanılır.
exportyaptığınız hâlde değişmiyorsa yapılandırma dosyasını kontrol edin. - VS Code uzantısıyla kullanırken aynı değişkenleri VS Code kullanıcı ayarlarındaki
claudeCode.environmentVariablesbölümüne ekleyin.
ANTHROPIC_AUTH_TOKEN kullanma nedeni
ANTHROPIC_AUTH_TOKEN, Authorization: Bearer başlığıyla gönderilir ve ayarlandığı anda etkinleşir. Buna karşılık ANTHROPIC_API_KEY, x-api-key başlığıyla gönderilir ve etkileşimli modda ilk kullanımda bir kez kullanım onayı ister. Reddederseniz anahtar daha sonra hiçbir şey gösterilmeden yok sayılır ve /config içindeki Use custom API key ile yeniden etkinleştirilene kadar kullanılmaz. Kunavo her iki başlıkla gönderilen anahtarları kabul ettiğinden ANTHROPIC_API_KEY ile de çalışır; ancak bu tuzak bulunmadığı için ANTHROPIC_AUTH_TOKEN daha güvenilirdir. Resmî belgeler de anahtar türü belirtilmemişse ANTHROPIC_AUTH_TOKEN kullanılmasını önerir.
Modeli sabitleme nedeni (3 Ekim 2026 itibarıyla)
Resmî belgelere göre (3 Ekim 2026 tarihinde kontrol edildi), API anahtarı kullanıldığında varsayılan model ile opus takma adı Opus 5.5'e, sonnet takma adı ise Sonnet 5.5'e karşılık gelir. Yeni modeller çıktıkça takma adların hedefi değişir; ancak bu modellerin Kunavo'da aynı gün kullanıma sunulması garanti değildir. Nitekim 3 Ekim 2026 tarihi itibarıyla Kunavo Sonnet 5.5'i sunmuyor; bu yüzden modeli sabitlemeden /model sonnet seçerseniz 404 hatası alırsınız. opusplan yürütme aşaması ile model: sonnet belirtilen alt ajanlarda da aynı durum geçerlidir. Bu nedenle yukarıdaki ayar, ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 ile sonnet takma adını da sabitler. opus takma adı da hedefi bir sonraki Opus modeli olarak değiştiğinde sorun yaşamamak için ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 ile Claude Opus 5.5 modeline sabitlenmiştir. Claude Opus 5.5 için Claude Code v2.1.280 veya üzeri gerekir; eski bir sürümünüz varsa claude update komutuyla güncelleyin.
Modeli sabitlemek, maliyetleri öngörmeyi de kolaylaştırır. Hiçbir model belirtmezseniz varsayılan model Claude Opus 5.5 olur ve ana model olarak Claude Sonnet 5 kullanmaya kıyasla token başına ücret yükselir. Kunavo fiyatları (1 milyon token başına, giriş / çıkış) şöyledir: Claude Haiku 4.5 $0,70 / $3,50, Claude Sonnet 5 $1,40 / $7,00(Anthropic fiyatları $2,00 / $10,00), Claude Opus 5.5 $2,80 / $14,00. ANTHROPIC_DEFAULT_HAIKU_MODEL ayarlanmazsa ANTHROPIC_AUTH_TOKEN ile bağlanan bir oturumda claude --resume için konuşma özetleri gibi arka plan işlemleri de ana modelde çalışır (ağ geçidi uyumluluk rehberi, 3 Ekim 2026 tarihinde kontrol edildi). Anthropic'in fiyatlandırma sayfasında ana model olarak sabitlenen Sonnet 5, “Eski modeller” bölümüne taşınmıştır (3 Ekim 2026 tarihinde kontrol edildi).
Çalışmayı üç aşamada doğrulayın
1. Başlatmadan önce yalnızca URL'yi ve anahtarı test edin
Resmî belgelerdekiyle aynı, yalnızca 1 çıktı token'ı isteyen istektir (bakiyeden çok küçük bir tutar düşülür). Kabuk değişkenlerini okuduğundan, anahtarı yalnızca yapılandırma dosyasına yazdıysanız bu terminalde önce export yapıp çalıştırın. {"id":"msg_ ile başlayan JSON ve 200 dönüyorsa URL ve anahtar normaldir; 401 dönüyorsa anahtar reddedilmiştir.
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'de şu şekildedir; dönen id msg_ ile başlıyorsa başarılıdır.
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": "."}]}'2. claude'u başlatın ve giriş ekranının görünmediğini doğrulayın
İlk çalıştırmada başlangıç sihirbazı ve klasör güveni onayı görünür; ancak bundan sonra tarayıcıda giriş istenmez. Giriş istenirse anahtar ulaşmamıştır.
Yaygın neden, anahtarın yalnızca projenin .claude/settings.json veya .claude/settings.local.json dosyasına yazılmasıdır. Etkileşimli oturumlarda proje ayarlarındaki env, sihirbaz ve klasör güveni onayı tamamlandıktan sonra okunur; bu nedenle ilk başlatmada anahtar yokmuş gibi davranılır. Anahtarı kabukta export ile ayarlayın veya kullanıcıya ait ~/.claude/settings.json dosyasına taşıyın.
3. /status içindeki iki satıra bakın
Bir oturumda /status komutunu çalıştırın ve Status sekmesini kontrol edin (resmî belgeler, 3 Ekim 2026 tarihinde kontrol edildi).
Anthropic base URLiçindehttps://api.kunavo.comgörünmelidir. Bu satır yalnızca ağ geçidi yapılandırıldığında görünür; satır yoksaANTHROPIC_BASE_URLoturuma ulaşmamıştır.Auth tokeniçindeANTHROPIC_AUTH_TOKENgörünmelidir. Bunun yerine claude.ai hesabınınLogin methodbilgisi görünüyorsa kayıtlı girişle çalışıyorsunuz.
API anahtarıyla çalıştırıldığında değişenler
- Remote Control ve sesli giriş kullanılamaz. İkisi de claude.ai kimliği gerektirdiğinden,
ANTHROPIC_AUTH_TOKENgibi ağ geçidi kimlik bilgileri etkin olduğu sürece devre dışıdır. v2.1.196 ve sonrasındaANTHROPIC_BASE_URLAnthropic dışındaki bir ana bilgisayarı gösteriyorsa Remote Control devre dışı kalır. /fastdevre dışı olarak görünür.Yalnızca bearer token ile kimlik doğrulaması yapıldığında Claude Code, hızlı modun kullanılabilirliğini sorgulamadan bu modu devre dışı kabul eder veFast mode has been disabled by your organizationmesajını gösterir./contextkomutundaki sayılar yaklaşık değerlerdir. Kunavo/v1/messages/count_tokensuç noktasını sunmadığı için Claude Code karakter sayısına dayalı tahmine geçer (ağ geçidi uyumluluk rehberi, 3 Ekim 2026 tarihinde kontrol edildi).
Kunavo tarafındaki ayrıntılı ayarlar Claude Code entegrasyon belgelerinde ve ANTHROPIC_BASE_URL belgelerinde bulunur (ikisi de İngilizcedir).
API bakiyesi ödemesi: JCB, Apple Pay, Google Pay ve Link
Japonya'dan ödeme yaparken sık sorulan noktaları önce özetleyelim.
| Merak edilen konu | Yanıt |
|---|---|
| JCB kabul ediliyor mu? | Kabul edilir. Stripe ödeme ekranında kullanılabilen kartlar Visa, Mastercard, American Express, JCB ve UnionPay'dir. Banka kartı da kart olarak girilebilir |
| Başka hangi yöntemler kullanılabilir? | Apple Pay (Safari veya iPhone gibi desteklenen ortamlarda), Google Pay (Chrome veya Android'de yapılandırılmışsa), Link (Stripe'a kaydedilmiş ödeme bilgilerini çağıran sistem) |
| Yen ile ödeme yapılabilir mi? | Japonya'dan açtığınızda tutar yen olarak gösterilir. Fiyatlar ABD doları cinsindendir ve yen karşılığında alıcının ödediği %2–4 oranında bir ücret bulunur. Ödeme ekranında doları seçerseniz bu ücret alınmaz; ancak kart şirketiniz kendi döviz kurunu ve ücretlerini uygulayabilir (Stripe belgeleri, 3 Ekim 2026 tarihinde kontrol edildi). |
| Market ödemesi ve PayPay nasıl? | Desteklenmez. Banka havalesi ve operatör ödemesi de kullanılamaz |
| Otomatik yükleme nasıl? | Yalnızca kayıtlı kart veya Link ile yapılandırılabilir |
| Uygun fatura (invoice) nasıl? | Düzenlenmez |
| Claude Pro / Max ödemesinde kullanılabilir mi? | Kullanılamaz. Yüklenen tutar Kunavo API bakiyesidir |
İşlem dört adımdır. Önce Kunavo'ya kaydolun (e-posta adresi veya Google hesabı; kayıt sırasında kart bilgisi istenmez). Ardından kontrol panelindeki Billing bölümünden yüklenecek tutarı seçin. Minimum tutar $10'dir; aylık ücret yoktur ve yüksek tutarlara bonus eklenir ($100 karşılığında $110 bakiye, $1.000 karşılığında $1.200 bakiye ve $5.000 karşılığında $6.250 bakiye). Stripe ödeme ekranında yukarıdaki yöntemlerden biriyle ödeme yaptıktan sonra API Keys bölümünde sk-kn- anahtarı oluşturup ANTHROPIC_AUTH_TOKEN değişkenine ekleyin. Anahtar yalnızca oluşturulduğu anda bir kez gösterilir; hemen kopyalayın.
Bakiyenin son kullanma tarihi yoktur ve başarısız isteklerden ücret alınmaz. Claude aboneliğini Japonya'da öderken hangi yöntemlerin kullanılabildiğini (App Store ve Google Play dahil) kaynaklarıyla birlikte Claude ödeme yöntemleri sayfasında derledik.
Yaklaşık maliyet (hesaplama)
API anahtarıyla çalışan Claude Code, token başına kullanım ücretine tabidir. Claude Code her istekte konuşma bağlamının tamamını gönderir; ancak öncekiyle aynı başlangıç kısmı önbellek okuma fiyatından ücretlendirilebilir. Aşağıdaki tablo, istek başına girdinin 40.000 token (bunun 36.000 kadarı = %90 önbellek okuması, kalan 4.000 önbellek yazması), çıktının 1.000 token ve bir çalışmanın 50 istek olduğu varsayılarak hesaplanmıştır. Arka plandaki Claude Haiku 4.5 çağrıları dahil değildir. Kunavo'nun önbellek fiyatında Claude Sonnet 5 için okuma, girdi birim fiyatının 10% kadarı; yazma ise 1,25 katıdır (tablodaki her model kendi oranıyla hesaplanmıştır). Bu değerler ölçüm sonucu veya üst sınır değildir.
| Model | 1 istek | 50 istek | 50 istek (önbellek hiç devreye girmediğinde) |
|---|---|---|---|
| Claude Sonnet 5 | $0,019 | $0,95 | $3,15 |
| Claude Opus 5.5 | $0,033 | $1,65 | $6,30 |
Gerçek tutar bağlam uzunluğuna, önbelleğin ne kadar kullanıldığına, yanıt uzunluğuna ve her işte /clear yapılıp yapılmadığına göre değişir. Tüm modellerin birim fiyatlarını fiyatlandırma sayfasında, kendi kullanımınıza göre tahmini Claude token maliyeti hesaplayıcısında (İngilizce), model bazında API birim fiyatlarını ise Claude API fiyatlandırmasında kontrol edebilirsiniz.
Yaygın hatalar ve çözümleri
| Aşama | Gösterim ve belirti | Neden ve çözüm |
|---|---|---|
| Yükleme | The token '&&' is not a valid statement separator | CMD satırını PowerShell'e yapıştırıyorsunuz. irm … | iex satırını kullanın. |
| Yükleme | 'irm' is not recognized as an internal or external command | PowerShell satırını CMD'ye yapıştırıyorsunuz. install.cmd satırını kullanın. |
| Yükleme | PowerShell'de -fsSL veya bash hakkında hata | Mac-Linux satırını Windows'ta çalıştırıyorsunuz. PowerShell satırını kullanın. |
| Yükleme | syntax error near unexpected token '<'、curl: (22) The requested URL returned error: 403 | Yükleyici URL'si betik yerine HTML veya hata yanıtı döndürüyor (resmî belgeler, 3 Ekim 2026 tarihinde kontrol edildi). Şirket proxy'si veya güvenlik duvarından şüpheleniyorsanız başka bir ağda deneyin ya da şirket yöneticinize danışın. |
| Yükleme | App unavailable in region | Desteklenmeyen bir ülkeden bağlandığınız belirlenmiş. Japonya desteklenen bir ülke olduğundan yurt dışı üzerinden VPN veya proxy'yi devre dışı bırakın. |
| Yükleme | EBADENGINE uyarısı | Node.js 22'nin altında. Kurulum tamamlanır; ancak Node.js'i güncelleyin. |
| Yükleme | npm.ps1 cannot be loaded | PowerShell yürütme ilkesi. Set-ExecutionPolicy komutunu çalıştırın veya bağımsız yükleyiciye geçin. |
| Başlatma | command not found: claude、'claude' is not recognized | Kurulum konumu PATH içinde değil. Terminali yeniden açın; Windows'ta yukarıdaki PowerShell adımlarıyla ekleyin. |
| Başlatma | claude native binary not installed (Mac-Linux) | npm ile isteğe bağlı bağımlılıklar atlanıyor (--omit=optional, optional=false). Ayarı kaldırıp yeniden yükleyin. |
| Başlatma | Claude Code does not support 32-bit Windows | “Windows PowerShell (x86)” ile çalıştırıyorsunuz. (x86) içermeyen sürümü açın. |
| Başlatma | Anahtarı ayarladığım hâlde giriş ekranı görünüyor | Anahtar yüklenmemiş. Proje ayarlarına değil, kabuğa veya ~/.claude/settings.json'a yazıp yeni terminalde başlatın. ANTHROPIC_API_KEY kullanıyor ve daha önce onayı reddettiyseniz /config içindeki Use custom API key ile etkinleştirin veya ANTHROPIC_AUTH_TOKEN değişkenine geçin. |
| Bağlantı | 401 | Anahtar reddediliyor. sk-kn- anahtarını boşluk olmadan sonuna kadar kopyaladığınızı ve API Keys bölümünde silmediğinizi kontrol edin. |
| Bağlantı | 402 | Bakiye yetersiz veya anahtar için belirlenen aylık kullanım sınırına ulaşıldı. Billing bölümünden yükleme yapın veya anahtar sınırını gözden geçirin. |
| Bağlantı | 404 | ANTHROPIC_BASE_URL'un sonunda /v1 bulunuyor ya da model sabitlenmediği için Kunavo'da bulunmayan bir model (Sonnet 5.5 gibi) çağrılıyor. |
Bu yöntemin uygun olmadığı durumlar
- Gider bildirimi için uygun fatura zorunlu. Kunavo ödeme ekranında fatura veya vergi kayıt numarası içeren uygun fatura düzenlenmez.
- Market ödemesi veya PayPay ile ödeme yapmak istiyorum. Bunların yanı sıra banka havalesi ve operatör ödemesi de desteklenmez. Otomatik yükleme yalnızca kayıtlı kart veya Link ile yapılabilir.
- Remote Control veya sesli giriş kullanmak istiyorum. API anahtarıyla kullanılamaz ve
/fastde devre dışı görünür. Abonelikle giriş yapın. - Sonnet 5.5 kullanmak istiyorum. Kunavo bunu 3 Ekim 2026 itibarıyla sunmamaktadır.
- Ayarları yalnızca Japonca belgelerle tamamlamak istiyorum. Claude Code'un resmî belgeleri Japonca okunabilir; ancak Kunavo'nun entegrasyon belgeleri yalnızca İngilizcedir.
Sonraki adım
/status ile doğruladıktan sonra çalışacağınız proje dizininde claude'u başlatın ve önce /init ile CLAUDE.md oluşturun. CLAUDE.md'ye ne yazılacağı, onay iletişim kutularının nasıl azaltılacağı ve özel komutların nasıl oluşturulacağı Claude Code'u kullanma sayfasında sırayla açıklanır.
Sık sorulan sorular
Claude Code nasıl yüklenir? Mac ve Windows'ta farklı mı?
Kullanılan komutlar farklıdır; her ikisi de resmî bağımsız yükleyiciyle tek satırda kurulur. Mac, Linux ve WSL için curl -fsSL https://claude.ai/install.sh | bash; Windows PowerShell için irm https://claude.ai/install.ps1 | iex; Komut İstemi (CMD) için curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd kullanılır. Kurulum tamamlandıktan sonra yeni bir terminalde claude --version komutunu çalıştırın; sürüm numarası görünüyorsa işlem tamamdır. Bağımsız sürüm arka planda otomatik olarak güncellenir.
Windows'a yüklerken yönetici izinleri, Git for Windows veya WSL gerekli mi?
Bunların hiçbiri zorunlu değildir. Resmî belgelerde (3 Ekim 2026 tarihinde kontrol edildi) yönetici olarak çalıştırmak gerekmediği ve Git for Windows'un isteğe bağlı olduğu belirtilir (kurulu değilse Claude Code komutları PowerShell'de çalıştırır). WSL de gerekli değildir; PowerShell veya CMD'den doğrudan kurulabilir. Yalnızca korumalı alan ya da Linux araçlarını kullanmak istiyorsanız WSL 2'yi seçin ve WSL terminalinde Mac-Linux satırını çalıştırın. “Windows PowerShell (x86)” 32 bit çalıştığından kullanılamaz.
npm install -g @anthropic-ai/claude-code ile de yüklenebilir mi? Node.js 18 yeterli mi?
Yüklenir; ancak resmî gereksinim Node.js 22 veya üzeridir (3 Ekim 2026 tarihinde kontrol edildi). “18 veya üzeri” yazan makaleler güncel değildir. 22'nin altında npm, EBADENGINE uyarısı verir (kurulum yine tamamlanır). sudo kullanmayın; güncelleme için npm update -g yerine npm install -g @anthropic-ai/claude-code@latest çalıştırın. Node.js kullanmayı planlamıyorsanız bağımsız yükleyici daha zahmetsizdir.
Claude Code abonelik olmadan (Pro / Max sözleşmeden) kullanılabilir mi?
Kullanılabilir. Giriş yaparak kullanmak için Pro, Max, Team veya Enterprise planı ya da Console hesabı gerekir; ücretsiz plana Claude Code dahil değildir. Giriş yapmadan ANTHROPIC_BASE_URL=https://api.kunavo.com ve ANTHROPIC_AUTH_TOKEN'u (Kunavo API anahtarını) ayarlarsanız aylık ücret olmadan kullanabilir, yalnızca kullandığınız tokenların bedeli ön ödemeli bakiyeden düşülür. Bunun yerine Remote Control ve sesli giriş kullanılamaz.
API anahtarını ANTHROPIC_API_KEY'e koymamak mı gerekir?
Çalışır; ancak ANTHROPIC_AUTH_TOKEN önerilir. ANTHROPIC_AUTH_TOKEN, Authorization: Bearer başlığıyla gönderilir ve ayarlandığı anda etkin olur. ANTHROPIC_API_KEY, x-api-key başlığıyla gönderilir; etkileşimli modda ilk seferde bir kez onay istenir ve reddederseniz bundan sonra sessizce yok sayılır (/config içindeki Use custom API key ile yeniden etkinleştirilebilir). Kunavo her iki başlıktaki anahtarları da kabul eder. Anahtarı kabuk yapılandırma dosyasına veya ~/.claude/settings.json'a yazın; projenin .claude/settings.json dosyasına yazmayın.
/model sonnet'e geçince 404 aldım. Neden?
API anahtarıyla kullanıldığında sonnet takma adı en yeni Sonnet 5.5'i gösterir (resmî belgeler, 3 Ekim 2026 tarihinde kontrol edildi). Kunavo, 3 Ekim 2026 itibarıyla Sonnet 5.5 sunmadığından takma ad olduğu gibi bırakılırsa 404 alınır. opusplan'ın yürütme aşaması ve model: sonnet belirtilen alt aracılar da aynıdır. ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 ekleyin (bu sayfadaki ayarlarda bulunur). Aynı nedenle bu sayfadaki ayarlar ana modeli claude-sonnet-5'e, opus'u claude-opus-5-5'e (Opus 5.5; Claude Code v2.1.280 veya üzeri gerekir, eskiyse claude update ile güncelleyin), haiku'yu claude-haiku-4-5'e sabitler. ANTHROPIC_BASE_URL sonuna /v1 eklemek de 404'e neden olur.
API anahtarıyla çalıştığını nasıl doğrularım?
Claude Code içinde /status komutunu çalıştırın. “Anthropic base URL” https://api.kunavo.com ve “Auth token” ANTHROPIC_AUTH_TOKEN ise API anahtarıyla çalışıyorsunuz. claude.ai hesabının “Login method” satırı görünüyorsa değişkenler yüklenmemiştir.
Ödeme için JCB kullanılabilir mi? Market ödemesi veya PayPay nasıl?
JCB kullanılabilir. Kunavo Stripe ödeme ekranında Visa, Mastercard, American Express, JCB ve UnionPay kartları, desteklenen cihazlarda Apple Pay ve Google Pay ile Link seçilebilir; Japonya'dan açıldığında tutar yen olarak gösterilir (yen dönüşümüne Stripe'ın %2–4 ücreti dahildir; dolar ile öderseniz bu ücret alınmaz). Yükleme $10 tutarından başlar; aylık ücret yoktur ve bakiyenin son kullanma tarihi yoktur. Market ödemesi, PayPay, banka havalesi ve operatör ödemesi desteklenmez. Bu yükleme API bakiyesine yapılır; Claude Pro / Max ödemelerinde kullanılamaz.
Gider bildirimi için uygun fatura (invoice) düzenleniyor mu?
Düzenlenmez. Kunavo ödeme ekranında vergi kayıt numarası içeren uygun fatura çıkarılmaz. Şirket gideri olarak işlemek için uygun fatura zorunluysa karar vermeden önce Anthropic'e doğrudan ödeme seçeneğiyle karşılaştırın. Otomatik yükleme için kayıtlı kart veya Link gerekir.