Claude Code'u yükleme: Windows ve macOS kurulum komutları, Pro/Max paketi olmadan API anahtarı yapılandırması ve kart veya Link ile ödeme

Claude Code'u Pro/Max paketi satın almadan kullanmak için üç şey yapın: resmî bağımsız yükleyici komutuyla kurulum yapın (her terminal türü için hemen aşağıda bir satır), ANTHROPIC_BASE_URL=https://api.kunavo.com (/v1 olmadan) ile birlikte ANTHROPIC_AUTH_TOKEN ve modeli sabitleyen dört değişkeni ayarlayın, ardından Claude Code'un API anahtarıyla çalıştığından emin olmak için /status yazın. Token ücretleri ön ödemeli bakiyeden düşülür; Visa/Mastercard veya Link ile en az 10 USD tutarında bakiye yükleyebilirsiniz. MoMo, ZaloPay ve VNPay kullanılamaz. npm ile kurulum için Node.js 22 veya üzeri gerekir.

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

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

:: Windows Command Prompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Bu yazıdaki kurulum komutları ve değişken adları, Claude Code'un resmi belgelerinden; kurulum sayfası ve ortam değişkenleri listesi dahil, 3 Ekim 2026 tarihinde yeniden kontrol edilmiştir. Anthropic'in bu sayfaların Vietnamca sürümü yoktur (/docs/vi/setup yolu aynı gün 404 hatası verdi), bu nedenle yazıdaki hata mesajı daha kolay arayabilmeniz için İngilizce bırakılmıştır. Kunavo'nun fiyatları ve ödeme yöntemleri 10 Ekim 2026 tarihinde kontrol edilmiştir.

Açık olan terminale göre yükleme komutunu seçin

Tüm yükleme yöntemleri aynı claude programını kurar; fark, güncellemeleri kimin yönettiğidir. Resmi belgeler bağımsız yükleyici yöntemini “Native Install (Recommended)” sekmesine koyar; ayrıca bu yöntem, sizin hiçbir şey yapmanıza gerek kalmadan kendini güncelleyen tek yöntemdir.

# Homebrew (macOS, Linux) – mặc định không tự cập nhật
brew install --cask claude-code

# WinGet (Windows) – mặc định không tự cập nhật
winget install Anthropic.ClaudeCode

Makinenin şu koşulları karşılaması gerekir (yükleme sayfasına göre, 3 Ekim 2026 tarihinde kontrol edildi):

• İşletim sistemi: macOS 13.0 veya üzeri; Windows 10 sürüm 1809 veya üzeri ya da Windows Server 2019 veya üzeri; Ubuntu 20.04+, Debian 10+ veya Alpine Linux 3.19+.
• En az 4 GB RAM, x64 veya ARM64 CPU. 32 bit Windows desteklenmez.
• Shell Bash, Zsh, PowerShell veya CMD olmalı ve İnternet bağlantısı bulunmalıdır.
• Node.js yalnızca npm ile kurulumda gerekir ve sürüm 22 veya üzeri olmalıdır.

Kurulum tamamlandıktan sonra eski pencerede hemen claude yazmayın: o pencere yeni PATH değerini henüz almamıştır. Başka bir terminal açıp şunu çalıştırın:

claude --version   # in ra số phiên bản, kèm chữ (Claude Code)
claude doctor      # chẩn đoán cài đặt và file cấu hình, không mở phiên làm việc

claude --version bir sürüm numarası yazdırıyorsa kurulum tamamlanmıştır; bundan sonraki tüm hatalar yapılandırmayla ilgilidir. Nerede sorun olduğunu bilmiyorsanız claude doctor yararlıdır; herhangi bir oturum başlatmadan hem kurulumu hem de settings dosyalarını kontrol eder.

Windows: sık karşılaşılan beş sorun

1. Komut satırını yanlış yapıştırmak. PowerShell'e CMD satırı yapıştırılırsa The token '&&' is not a valid statement separator; CMD'ye PowerShell satırı yapıştırılırsa 'irm' is not recognized as an internal or external command hatası alınır. İsteme bakın: PS varsa irm satırını, yoksa install.cmd satırını kullanın.
2. “Windows PowerShell (x86)” seçeneğini yanlış açmak. Başlat menüsündeki bu seçenek 32 bit işlemdir; 64 bit makinede bile Claude Code does not support 32-bit Windows hatası alınır. (x86) yazmayan seçeneği seçin.
3. Administrator yetkisiyle çalıştırmak gereksizdir. Belgeler bunu istemez; bağımsız sürüm kullanıcı klasörüne kurulur: %USERPROFILE%\.local\bin\claude.exe.
4. claude yazınca “not recognized” hatası almak. Yukarıdaki klasör henüz PATH içine eklenmemiştir. Önce yeni bir terminal deneyin; sorun sürerse yolu denetlemek ve eklemek için aşağıdaki PowerShell bölümünü kullanın. macOS/Linux'ta karşılığı command not found: claude, programın bulunduğu yer ise ~/.local/bin/claude olur.
5. npm npm.ps1 cannot be loaded because running scripts is disabled on this system hatası veriyor. PowerShell'in Execution policy ayarı, npm'nin oluşturduğu .ps1 betiğini engelliyor. Belgeler üç çözüm sunar: geçerli kullanıcı için aşağıdaki Set-ExecutionPolicy komutuyla yerel betiklerin çalışmasına izin vermek, npm.cmd ve claude.cmd kullanarak .ps1 sürümünü atlamak veya npm'yi bırakıp bağımsız yükleyici komutunu kullanmak.

# 1. Kiểm tra thư mục cài đặt đã có trong PATH chưa
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Không có kết quả nào? Thêm vào PATH của người dùng, rồi đóng và mở lại terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Trong terminal mới
claude --version

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

WSL'siz Windows mu, WSL mi? Projeniz Windows'taysa doğrudan Windows'ta çalıştırmak yeterlidir. Bu durumda Git for Windows isteğe bağlıdır: yüklüyse Claude Code komutları Git Bash üzerinden, yüklü değilse PowerShell üzerinden çalıştırır. Git yüklü olduğu halde Claude Code Git Bash'i bulamıyorsa ~/.claude/settings.json'in env bloğunda CLAUDE_CODE_GIT_BASH_PATH'yi tanımlayıp bash.exe'i gösterin (belgelerde C:\Program Files\Git\bin\bash.exe örneği veriliyor). Linux araçlarına ihtiyacınız varsa veya komutların korumalı bir alanda çalışmasını istiyorsanız WSL 2'yi seçin; korumalı alan yalnızca WSL 2'de kullanılabilir, WSL'siz Windows'ta ve WSL 1'de kullanılamaz. WSL 1, yalnızca bilgisayarınızda WSL 2 etkinleştirilemiyorsa bir seçenektir. WSL'yi seçtiyseniz install.sh satırıyla kurun ve claude'ı tamamen WSL terminalinde çalıştırın.

npm ile kurulum: koşullar ve üç not

Komut satırı araçlarını Node ile zaten yönetiyorsanız veya şirket ağınız paket indirmelerine yalnızca npm kayıt defteri üzerinden izin veriyorsa npm uygun bir seçenektir. Gereksinim Node.js 22 veya üzeridir; birçok eski yazıda yer alan Node 18 bilgisi artık geçerli değildir. Eski bir Node sürümü kurulumun başarısız olmasına yol açmaz: npm yalnızca EBADENGINE uyarısı verir, çünkü çalıştırılan asıl şey npm paketinin indirdiği ve Node'a bağımlı olmayan derlenmiş bir ikili dosyadır. Bilgisayarınızda Node yoksa 22 veya üzeri sürümü nodejs.org adresinden indirin.

node -v                                    # cần v22 trở lên
npm install -g @anthropic-ai/claude-code   # không dùng sudo

# nâng cấp bằng @latest, không dùng npm update -g
npm install -g @anthropic-ai/claude-code@latest

• sudo npm install -g kullanmayın: belgeler bu yöntemin izin hatalarına ve güvenlik riskine yol açtığı konusunda uyarıyor.
• npm install -g @anthropic-ai/claude-code@latest ile yeni sürüme geçin; npm update -g önerilen yöntem değildir.
• Derlenmiş program isteğe bağlı bir bağımlılıktan gelir (platformunuza karşılık gelen @anthropic-ai/claude-code-* paketi). --omit=optional bayrağı, .npmrc içindeki optional=false satırı veya --ignore-scripts, bu bağımlılığın eksik kalmasına neden olur; macOS/Linux'ta claude native binary not installed görürsünüz.

VPN gerekli mi? Yükleme betiği indirilirken hata

Gerekmez. Vietnam, Anthropic'in hem Claude.ai hem de API için desteklediği ülkeler listesinde yer alıyor (3 Ekim 2026 tarihinde kontrol edildi). Soruna genellikle VPN neden olur: kurulum sorunlarını giderme sayfasına göre (3 Ekim 2026 tarihinde incelendi), kurulum adresi App unavailable in region hatasını döndürdüğünde Claude Code, bağlantınızın göründüğü konumda kullanılamaz. Vietnam'dayken bu mesajla karşılaşırsanız başka bir ülkede bulunan VPN'i veya proxy'yi kapatıp yeniden deneyin.

Kalan iki hatanın kökü aynıdır: syntax error near unexpected token '<' veya curl: (22) The requested URL returned error: 403, betik yerine bir HTML sayfası ya da hata kodu aldığınız anlamına gelir. Proxy veya güvenlik duvarı nedeniyle dosya indirmesini engelleyen şirket ağı ilk şüphelidir. Hemen Homebrew, WinGet veya npm'ye geçmeyin: belgeler önce ağ bağlantısını kontrol etmenizi önerir; çünkü alternatif yükleme yöntemleri de aynı sunucudan indirir. Başka bir ağ deneyin veya BT departmanından engeli kaldırmasını isteyin.

API key yapılandırması: Pro/Max paketi olmadan Claude Code'u çalıştırma

Claude Code iki yöntemden biriyle kimlik doğrular. Aşağıdaki tablo hızlı bir karşılaştırmadır; yazının geri kalanı sağdaki sütunu izler.

Claude Code'u Anthropic dışındaki bir hizmete yönlendirmek bir hile değildir: resmi belgeler ANTHROPIC_BASE_URL'i proxy veya gateway üzerinden geçerken API endpoint'ini geçersiz kılmak için kullanılan değişken olarak tanımlar. Kunavo, Anthropic Messages API protokolünü aynen kullandığından Claude Code'u eklenti veya yama olmadan olduğu gibi kullanabilirsiniz. Tam olarak altı değişken gerekir:

Değişkenler nereye konur

Uzun süreli kullanım için en pratik yöntem, kullanıcının settings dosyasındaki env bloğudur: ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json). Bu dosya tüm projelere uygulanır; zaten içeriği 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"
  }
}

Shell içinde tutmayı tercih ediyorsanız ~/.zshrc veya ~/.bashrc'e ekleyin. Windows'ta aşağıdaki ikinci bölüm ( $env: satırları) hızlı deneme için uygundur; ancak PowerShell penceresi kapanınca değişkenler kaybolur.

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # chỉ tên miền, không thêm /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

# Chỉ có hiệu lực trong cửa sổ PowerShell này, đóng cửa sổ là mất
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Sorun yaşamadan önce bilinmesi gereken üç şey:

• Anahtarı projenin .claude/settings.json'sine koymayın. Ağ geçidi bağlantı belgeleri, bu dosyanın depoya kaydedildiğini ve depoyu klonlayan herkesin erişebildiğini belirtiyor.
• Settings dosyası shell'i geçersiz kılar. Bir değişken her iki yerde de varsa settings dosyasındaki env bloğunun değeri kullanılır. Shell'de değiştirdiğiniz halde fark görmüyorsanız önce settings dosyasına bakın.
• İlk çalıştırmada kullanıcı düzeyinde key gerekir. Etkileşimli modda, projenin .claude/settings.json veya .claude/settings.local.json dosyasındaki env bloğu ancak ilk kurulum sihirbazından ve klasöre güvenilip güvenilmeyeceği sorusundan sonra etkili olur. Key yalnızca oradaysa ilk başlatmada giriş ekranı yine görünür.

ANTHROPIC_AUTH_TOKEN veya ANTHROPIC_API_KEY ve “403 hatası” konusu

Kunavo anahtarı hem Authorization: Bearer'te hem de x-api-key'te okur; bu nedenle iki değişken de bağlantı kurar. Fark, Claude Code tarafındadır. Ortam değişkenleri belgelerine göre (3 Ekim 2026 tarihinde incelendi), ANTHROPIC_AUTH_TOKEN Authorization başlığına Bearer önekiyle gider ve hemen etkinleşir. ANTHROPIC_API_KEY ise X-Api-Key başlığına gider; etkileşimli modda Claude Code, bu anahtarın abonelik yerine kullanılıp kullanılmayacağını bir kez sorar. “Hayır” yanıtını verirseniz anahtar yoksayılır ve tekrar sorulmaz; yeniden etkinleştirmek için /config'e, Use custom API key seçeneğine gidin. Bu yazıda ANTHROPIC_AUTH_TOKEN seçilmesinin tek nedeni, bu onay adımını atlamaktır.

Bazı Vietnamca kılavuzlarda ANTHROPIC_API_KEY'nin Claude Code'un ANTHROPIC_BASE_URL'yi yok saymasına, doğrudan api.anthropic.com'ye gitmesine ve 403 hatası almasına neden olduğu yazıyor. Ne ortam değişkenleri belgeleri ne de ağ geçidi bağlantı belgeleri (3 Ekim 2026 tarihinde incelendi) böyle bir şey söylüyor: bu iki değişken, ANTHROPIC_BASE_URL'de belirtilen aynı ağ geçidine anahtar sağlamanın iki yoludur. Değişkeni değiştirdikten sonra gerçekten 403 hatası alırsanız değişken adlarını dönüşümlü olarak denemek yerine temel URL'yi ve anahtarı yeniden kontrol edin.

Modeli neden sabitlemeli ve her modelin fiyatı nedir

Claude Code takma adları sabit değildir. Model yapılandırma belgelerine göre (3 Ekim 2026 tarihinde incelendi), API kullanıcıları için varsayılan model ve opus takma adı şu anda Opus 5.5'e, sonnet takma adı ise Sonnet 5.5'e yöneliyor; belgeler ayrıca takma adların “zaman içinde güncellendiğini” belirtiyor ve sabitleme gerektiğinde tam model adını veya ANTHROPIC_DEFAULT_*_MODEL değişkenlerini kullanmayı öneriyor. 3 Ekim 2026 itibarıyla Kunavo'da Opus 5.5 var, Sonnet 5.5 ise yok. Sabitleme adımını atlarsanız varsayılan oturum, Claude Sonnet 5'den daha pahalı olan Opus 5.5'i çalıştırır; /model sonnet, opusplan'ın yürütme aşaması ve model: sonnet ile ayarlanmış alt ajan 404 hatası alır; opus takma adı bir sonraki yeni Opus sürümüne geçtiğinde, bu sürüm Kunavo'da henüz bulunmayabilir. Bu nedenle yukarıdaki yapılandırma sonnet takma adını ANTHROPIC_DEFAULT_SONNET_MODEL ile claude-sonnet-5'e, opus takma adını ise Opus 5.5'e (claude-opus-5-5) sabitler. Opus 5.5 için Claude Code v2.1.280 veya üzeri gerekir; daha eski bir sürümde claude update komutunu çalıştırın.

Kunavo fiyatları, milyon token başına (girdi / çıktı): Claude Sonnet 5 1,40 USD / 7,00 USD (Anthropic fiyatları: 2,00 USD / 10,00 USD); Claude Opus 5.5 2,80 USD / 14,00 USD; Claude Haiku 4.5 0,70 USD / 3,50 USD.

/status ile kontrol etme

ANTHROPIC_AUTH_TOKEN okunduğunda claude komutu doğrudan oturuma girer; giriş ekranı gösterilmez (gateway bağlantı belgelerine göre, 3 Ekim 2026 tarihinde kontrol edildi). İlk kullanımda klasöre güvenme sorusu gibi birkaç kurulum adımı yine vardır. Giriş ekranı görüyorsanız key yerine ulaşmamıştır. Oturum içinde /status yazın ve şunları arayın:

• Anthropic base URL: https://api.kunavo.com. Bu satır yalnızca bir gateway adresi olduğunda görünür; yoksa ANTHROPIC_BASE_URL oturuma ulaşamamıştır.
• Auth token: ANTHROPIC_AUTH_TOKEN. Burada Login method ve bir claude.ai hesabı görünüyorsa oturum hâlâ kaydedilmiş giriş yöntemini kullanıyor demektir.

Claude Code'u açmadan önce key'in ve adresin doğru olduğundan emin olmak için tam 1 çıktı token'ı isteyen bir request gönderin (bakiyeden çok küçük bir tutar düşer). Komut değişkenleri mevcut shell'den okur; key yalnızca settings dosyasındaysa önce bu terminalde export yapın. {"id":"msg_ ile başlayan sonuç başarılıdır; 401 ise key 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": "."}]}'

Aynı testin PowerShell sürümü; başarılı olduğunda sonuçtaki id alanı msg_ ile başlar:

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 key ile çalıştırmanın eksileri

• Remote Control ve sesli giriş claude.ai kimliği gerektirir; bu nedenle ANTHROPIC_AUTH_TOKEN etkin olduğunda çalışmaz. ANTHROPIC_BASE_URL, api.anthropic.com'den farklı bir sunucuya yöneliyorsa Remote Control da devre dışı kalır.
• /fast Fast mode has been disabled by your organization bildiriyor: gateway bağlantı belgelerine göre fast mode denetimi claude.ai girişi veya Anthropic API key'i gerektirir; bu nedenle bearer token kullanıldığında Claude Code bunu devre dışı kabul eder ve sunucuya sormaz.
• MCP tool search, base URL Anthropic'e ait olmadığında varsayılan olarak kapalıdır.
• /context'deki sayılar tahminidir: Kunavo'da /v1/messages/count_tokens uç noktası yoktur ve ağ geçidi protokol belgelerine göre (3 Ekim 2026 tarihinde incelendi), bu uç nokta bulunmadığında Claude Code token sayısını karakter sayısına göre tahmin eder.

Entegrasyon ayrıntıları Claude Code entegrasyon belgelerinde (İngilizce) yer alır; İngilizce karşılık gelen yazı Install Claude Code'dur.

Vietnam'dan bakiye yükleme: kart veya Link, yerel elektronik cüzdan yok

Açıkça belirtelim: Kunavo MoMo, ZaloPay, VNPay veya banka havalesi kabul etmez. Yalnızca Napas ağında çalışan yerel ATM kartları da Visa veya Mastercard olmadığı için kullanılamaz. Kunavo'nun Stripe ödeme sayfası, Vietnam'daki alıcılar için şu seçenekleri sunar:

• Visa veya Mastercard; uluslararası kredi veya banka kartlarının ikisi de kabul edilir.
• Stripe cüzdanı olan Link, gelecekteki ödemeleri hızlandırmak için ödeme yöntemini kaydeder (Link belgeleri, 3 Ekim 2026 tarihinde incelendi).
• Apple Pay veya Google Pay, yalnızca cüzdanı ayarlanmış cihaz ve tarayıcılarda görünür; çünkü ödeme cüzdanda kayıtlı kartla yapılır. Apple Pay 08/08/2023'ten beri Vietnam'da kullanılabiliyor ve çevrimiçi alışverişte kullanılabiliyor (Apple Newsroom Vietnam, 3 Ekim 2026 tarihinde incelendi).

Anthropic tarafında da durum benzer: Anthropic'in web sitesinden satın alınan Claude planlarında yalnızca kredi veya banka kartı kabul edilir (Claude ödeme SSS'si, 3 Ekim 2026 tarihinde incelendi); bu nedenle Vietnam'daki dijital cüzdanlarla doğrudan ödeme yapılamaz. iOS veya Android uygulamasından alınan planlarda ise App Store ya da Google Play ödeme yöntemleri kullanılır. Fark şu: Kunavo'ya yüklenen para API bakiyesi olur ve anahtarı yukarıda anlatıldığı gibi yapılandırdıktan sonra Claude Code bu bakiyeden kullandığı tokenlar kadar düşer.

VND veya USD ile ödeme

Kunavo fiyatlarını USD cinsinden listeler. Vietnam, Stripe Adaptive Pricing pazarları arasında bulunduğundan (3 Ekim 2026 tarihinde incelendi) ödeme sayfasında tutar VND'ye çevrilmiş olarak gösterilebilir; kesin tutar onaylamadan önce her zaman görünür. Stripe'ın sunduğu döviz kuru, alıcının ödediği %2–4'lük dönüşüm ücretini içerir. USD cinsinden ödeme seçeneği bu ücreti ortadan kaldırır, ancak kartı veren banka kendi döviz kurunu ve ücretlerini uygulayabilir.

VND ile ödeme yapmak da mutlaka daha ucuz değildir: bazı bankalar, yurt dışında kayıtlı satıcılara VND ile kartla ödeme yapıldığında ücret alır. Örneğin Techcombank, 13/08/2023'ten itibaren Visa banka kartları için işlem tutarının %1,1'i kadar “yurt dışında yerel para birimi işlem ücreti” alıyor (KDV dahil) (Techcombank SSS, 3 Ekim 2026 tarihinde incelendi). Bu, yalnızca bir bankaya ait örnektir ve Kunavo, bankanın Kunavo işlemlerini bu kategoriye alıp almadığını doğrulayamamıştır; VND veya USD seçmeden önce kartınızın ücret tarifesini kontrol edin.

Kartların reddedilmesinin yaygın nedeni, bankacılık uygulamasında çevrim içi veya uluslararası ödemelerin etkinleştirilmemiş olmasıdır. Etkinleştirip yeniden deneyin ya da Link'e veya bu cüzdanın desteklediği bir kartla Apple Pay/Google Pay'e geçin.

Kayıttan key'e kadar

1. Kunavo'ya kaydolun — e-posta veya Google hesabı kullanabilirsiniz; bu adımda kart sorulmaz.
2. Billing'i açın ve yükleme tutarını seçin (en düşük 10 USD). Daha yüksek tutarlara ek bakiye eklenir: 100 USD yükleyerek bakiyeye 110 USD eklenir; 1.000 USD yükleyerek bakiyeye 1.200 USD eklenir; 5.000 USD yükleyerek bakiyeye 6.250 USD eklenir.
3. Stripe sayfasında kartı, Link'i veya cihazda bulunan cüzdanı seçin; tutarı gözden geçirip onaylayın.
4. API Anahtarları sayfasına gidip sk-kn-… biçiminde bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir; bu nedenle hemen ANTHROPIC_AUTH_TOKEN değişkenine kopyalayın.

Bakiye azaldığında otomatik yükleme yapmak için kayıtlı bir kart veya Link kullanmanız gerekir. Bakiyenin son kullanma tarihi yoktur ve başarısız request'lerden ücret alınmaz. Kunavo, Vietnam mevzuatına uygun elektronik fatura dahil KDV faturası düzenlemez; yükleme geçmişini Billing bölümünde görebilirsiniz. Bu bakiye yalnızca Kunavo API'si için kullanılabilir; Claude Pro, Claude Max veya ChatGPT Plus ödemesinde kullanılamaz.

Bir kodlama oturumu yaklaşık ne kadar tutar?

Her istekte Claude Code tüm konuşma bağlamını yeniden gönderir; bu nedenle maliyet cache'e büyük ölçüde bağlıdır: tekrarlanan bağlam bölümü çok daha ucuz cache okuma fiyatıyla ücretlendirilir. Aşağıdaki tablo, belirtilen varsayımlarla yapılan teorik bir hesaplamadır; gerçek ölçüm veya üst sınır değildir:

• request başına 40.000 giriş token'ı: 36.000 token (90) cache'den okunur, 4.000 token cache'e yazılır;
• request başına 1.000 çıkış token'ı;
• bir oturumda 50 request; arka planda çalışan Claude Haiku 4.5 görevleri dahil değildir;
• Kunavo'da Claude Sonnet 5 için önbellek okuma fiyatı, giriş fiyatının 10% oranındadır; önbellek yazma fiyatı ise giriş fiyatının 1,25 katıdır. Tablodaki her model kendi oranını kullanır.

Son sütun cache'in ne kadar önemli olduğunu gösterir. Uzun bağlam, uzun yanıtlar veya farklı işler arasında /clear'i unutmak tutarı artırır. Abonelik ile API'yi karşılaştırma ve aylık tahmin için Claude Code fiyatları yazısına; model fiyatları için Claude API fiyatlandırma tablosuna veya fiyatlandırma sayfasına; kendi verilerinizi girmek için Claude token maliyeti hesaplama aracına (İngilizce) bakın.

Mesaja göre sorun giderme

Bakiye yüklemeden önce

• Yalnızca Visa/Mastercard, Link ve kartla çalışan cüzdanlar kullanılabilir; MoMo, ZaloPay, VNPay veya banka havalesi yoktur.
• Otomatik yükleme yalnızca kayıtlı kart veya Link ile çalışır. Kunavo KDV faturası düzenlemez.
• Bu, Claude Pro/Max paketi değil, token başına ücretlendirilen bir API'dir: Remote Control ve sesli giriş yoktur, /fast devre dışı görünür ve MCP tool search varsayılan olarak kapalıdır.
• 3 Ekim 2026 itibarıyla Kunavo'da Sonnet 5.5 yoktur; bu nedenle sabitlenmemiş sonnet alias'ı 404 döndürür.
• Claude Code belgeleri ve Kunavo entegrasyon belgeleri şu anda yalnızca İngilizcedir.

Sık sorulan sorular