Claude Code kurulum rehberi: Windows ve macOS kurulum komutları, hesapla giriş yapmadan API key yapılandırması, Alipay ve WeChat Pay ile bakiye yükleme

Claude Code'u Anthropic'in resmî bağımsız kurulum komutuyla kurmanız önerilir; npm, Node.js 22 veya üzerini gerektiren resmî alternatiftir. Claude hesabına giriş yapmadan da Claude Code kullanılabilir: ANTHROPIC_BASE_URL değişkenini (yalnızca alan adına kadar, /v1 eklemeden) ve ANTHROPIC_AUTH_TOKEN değişkenini ayarlayıp dört satırla modelleri sabitleyerek token başına ücretlendirilen bir API anahtarına geçebilirsiniz. Kunavo API bakiyesi Alipay veya WeChat Pay ile yüklenebilir; minimum tutar $10'dır. Son olarak bağlantıyı doğrulamak için Claude Code içinde /status çalıştırın.

# 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.cmd

Komutları ve ortam değişkenlerini 3 Ekim 2026 tarihinde, Claude Code resmî kurulum belgeleri ve resmî ortam değişkenleri belgeleri temelinde kontrol ettik; fiyatları ve ödeme yöntemlerini ise 10 Ekim 2026 tarihinde doğruladık. Önce şu bilgiyi belirtelim: Anthropic'in desteklediği ülke ve bölgeler listesinde (3 Ekim 2026 tarihinde kontrol edildi) Çin ana karası, Hong Kong ve Makao yer almıyor. Claude Code kurulum belgelerinin sistem gereksinimlerinde de “Bulunduğunuz bölge: Anthropic'in desteklediği ülkeler” ifadesi yer alıyor. Bu sayfa yalnızca resmî belgelerde belirtilen kurulum ve yapılandırma yöntemlerini açıklar; bölge kısıtlamalarını aşmaya yönelik herhangi bir yöntem sunmaz. Kunavo, Çin ana karasında ağ bağlantısını test etmedi. Aşağıda belirtilen indirme adreslerine, npm kaynaklarına ve api.kunavo.com adresine kendi ağınızdan erişilip erişilemediğini kendiniz doğrulamalısınız.

Kurulumdan önce kontrol edin

Yöntem 1: Resmî bağımsız kurulum (önerilen)

Resmî kurulum belgeleri bağımsız kurulumu önerilen yöntem olarak belirtir. Komutlar bu sayfanın başındaki üç bölümdür: macOS, Linux ve WSL için install.sh satırı; Windows PowerShell için irm … | iex; Windows CMD için install.cmd satırı. Bağımsız kurulum arka planda en yeni sürüme otomatik güncellenir; resmî belgeler Homebrew ve WinGet kurulumlarının varsayılan olarak otomatik güncellenmediğini de belirtir.

Kurulumdan sonra yeni bir terminal penceresi açın (zaten açık olan pencereler yeni PATH'i okuyamaz), ardından doğrulayın:

claude --version   # 正常会打印版本号，后面跟着 (Claude Code)
claude doctor      # 只读的安装与设置诊断，不会开启会话

claude doctor oturum başlatmaz; yalnızca kurulum durumu ve settings dosyası tanılama bilgilerini yazdırır. Bunun kurulumun mu yoksa ayarların mı bozuk olduğunu ayırt etmek için kullanabilirsiniz.

İndirme hatası olduğunda

Terminalde syntax error near unexpected token '<' veya curl: (22) The requested URL returned error: 403 görünürse, resmî kurulum sorunlarını giderme belgelerine (3 Ekim 2026 ile karşılaştırılarak doğrulandı) göre kurulum adresi bir kurulum betiği yerine web sayfası veya hata durum kodu döndürmüştür. Dönen sayfada App unavailable in region yazıyorsa resmî açıklama, Claude Code'un bulunduğunuz ülkede veya bölgede kullanılamadığıdır. Web sayfası içeriği olmayan bir 403 hatası da şirket proxy'si veya güvenlik duvarının indirmeyi engellemesinden kaynaklanabilir. Resmî öneri, desteklenen bir bölgede hâlâ 403 hatasıyla karşılaşıyorsanız önce ağ bağlantısını kontrol etmek, ardından başka kurulum yöntemlerini değerlendirmektir.

Yöntem 2: npm kurulumu (Node.js 22 veya üzeri gerekir)

npm, resmî belgelerde listelenen kurulum yöntemlerinden biri olmaya devam ediyor. Resmî belgelerde npm paketinin Node.js 22 veya üzeri bir sürüm gerektirdiği belirtiliyor. Sürüm daha eskiyse npm EBADENGINE uyarısını yazdırır, ancak işlem başarısız olmaz ve kurulum tamamlanır; çünkü paket, çalışma zamanında Node.js'e bağımlı olmayan derlenmiş bir ikili dosya indirir. Node.js yüklü değilse Node.js resmî sitesinden 22 veya daha yeni bir sürüm kurun.

node -v                                    # 需要 v22 或更高
npm install -g @anthropic-ai/claude-code   # 不要加 sudo

Resmî belgeler açıkça sudo npm install -g kullanmayın der; bu, izin sorunlarına ve güvenlik risklerine yol açar. Yükseltme için npm install -g @anthropic-ai/claude-code@latest kullanın; npm update -g kullanmayın.

Varsayılan kaynaktan indirme başarısız veya çok yavaş olduğunda: npmmirror

Varsayılan npm kaynağından indirme başarısız olursa veya çok yavaşsa npmmirror kullanabilirsiniz. npmmirror ana sayfası (3 Ekim 2026 ile karşılaştırılarak doğrulandı), bunun “eksiksiz bir npmjs.com yansısı” olduğunu, salt okunur çalıştığını ve “resmî hizmetle gerçek zamanlı senkronizasyonu mümkün olduğunca sağlamaya çalıştığını” belirtiyor; ayrıca registry adresini ve ayarlama komutlarını veriyor. Ana sayfada belirli bir senkronizasyon sıklığı belirtilmiyor.

# 只在这一次安装时使用 npmmirror
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 或者把 npmmirror 设为 npm 的默认源（之后所有 npm 安装都会走它）
npm config set registry https://registry.npmmirror.com

# 以后升级用 @latest，不要用 npm update -g
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com

Claude Code'u aynadan kurarken resmî sorun giderme belgelerinden gelen ve kolayca gözden kaçan iki koşul vardır:

• Ayna aynı anda 8 platform paketinin tümünü sağlamalıdır. npm paketi yalnızca bir kabuktur; gerçek program @anthropic-ai/claude-code-* platform paketleri biçiminde isteğe bağlı bağımlılık olarak indirilir. Ayna platform paketlerinden yoksunsa, kurulumdan sonra macOS veya Linux'ta claude çalıştırıldığında claude native binary not installed mesajı görülür (Windows'ta PowerShell veya CMD bu dosyanın çalıştırılamadığını bildirir). 3 Ekim 2026 tarihinde Kunavo Çin ana karası dışındaki bir ağdan kontrol ettiğinde npmmirror'daki ana paket ile Windows x64, macOS ARM64 ve Linux x64 platform paketlerinin npmjs'in en yeni sürümüyle aynı olduğunu gördü; diğer platform paketleri kontrol edilmedi.
• İsteğe bağlı bağımlılıkları atlamayın. Kurulum komutuna --omit=optional eklemeyin ve .npmrc içinde optional=false ayarının bulunmadığını doğrulayın.

Windows'a özel

Windows'ta iki farklı kurulum komutu vardır; fark yalnızca açtığınız terminal türüdür. İstem PS C:\Users\你的用户名> ise PowerShell'dir; PS olmadan yalnızca C:\Users\你的用户名> varsa komut istemidir (CMD). Resmî belgeler kurulumun yönetici olarak çalıştırılmasının gerekmediğini belirtir.

Windows'ta yaygın bir hata yanlış terminal satırını yapıştırmaktır: PowerShell'de CMD satırı çalıştırılırsa The token '&&' is not a valid statement separator görülür; CMD'de PowerShell satırı çalıştırılırsa 'irm' is not recognized as an internal or external command görülür. Her iki durumda da ilgili satıra dönün. Ayrıca Başlat menüsünde “Windows PowerShell” ve “Windows PowerShell (x86)” olmak üzere iki giriş vardır; ikincisi 32 bit işlemdir ve Claude Code does not support 32-bit Windows hatasını verir. (x86) içermeyen girişi açın.

Git for Windows isteğe bağlıdır: Yüklüyse Claude Code komutları çalıştırmak için onunla birlikte gelen Git Bash'i kullanır; yüklü değilse PowerShell araçlarını kullanır. Yüklü olduğu hâlde Git Bash bulunamıyorsa ~/.claude/settings.json dosyasındaki env bölümünde CLAUDE_CODE_GIT_BASH_PATH değerini bash.exe dosyasını gösterecek şekilde ayarlayın. Resmî örnek yol C:\Program Files\Git\bin\bash.exe şeklindedir.

WSL'yi seçerseniz macOS/Linux satırını WSL terminalinde çalıştırın ve claude komutunu da PowerShell veya CMD yerine WSL'de başlatın.

npm yönteminde çalıştırma ilkesi hatası

PowerShell'de npm ile kurulum veya çalıştırma sırasında npm.ps1 cannot be loaded because running scripts is disabled on this system görürseniz PowerShell'in çalıştırma ilkesi, npm'in oluşturduğu .ps1 başlatma betiğini engelliyordur. Resmî olarak üç çözüm vardır: yerel betiklerin mevcut kullanıcı için çalıştırılmasına izin vermek (aşağıdaki satır); npm.cmd veya claude.cmd kullanmak; ya da PowerShell'in bağımsız kurulum komutuna geçmek.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Kurulumdan sonra claude bulunamıyor

command not found: claude veya 'claude' is not recognized hatası görünüyorsa kurulum dizini PATH içinde yer almıyor demektir. Bağımsız kurulum, programı macOS/Linux'ta ~/.local/bin/claude, Windows'ta ise %USERPROFILE%\.local\bin\claude.exe konumuna yerleştirir. Önce yeni bir terminal açıp tekrar deneyin; Windows'ta hâlâ çalışmıyorsa resmi sorun giderme belgesindeki talimatları izleyerek PowerShell ile kurulum dizinini kontrol edin ve kullanıcı PATH'ine 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 --version

API anahtarını yapılandırma: Claude hesabına giriş yapmadan

ANTHROPIC_BASE_URL, Claude Code ile birlikte gelen bir ortam değişkenidir; resmî belgeler bunu isteklerin proxy veya ağ geçidinden geçmesini sağlayan API uç noktasını geçersiz kılma olarak tanımlar. Bu nedenle Claude Code'u Anthropic Messages API sağlayan bir uç noktaya yönlendirmek, eklenti veya değiştirilmiş program gerektirmeyen resmî olarak desteklenen bir yapılandırmadır. macOS/Linux'ta shell yapılandırma dosyasına yazı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-5

Windows'ta önce bir PowerShell penceresinde denemek için:

# 只对当前 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"
claude

Uzun süreli kullanım için kullanıcı düzeyindeki ~/.claude/settings.json dosyasının env alanına yazmanız önerilir (Windows'ta %USERPROFILE%\.claude\settings.json). Buraya yazıldığında her terminal ve arka plan görevi okuyabilir; dosyada başka ayarlar varsa env alanını bunlarla birleştirin:

{
  "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"
  }
}

Bu altı satırın her birinde kolayca yanlış ayarlanabilecek bir nokta vardır:

• ANTHROPIC_BASE_URL yalnızca alan adına kadar yazılmalıdır. Claude Code sonuna kendisi /v1/messages ekler; /v1 de eklenirse /v1/v1/messages olur ve 404 döner.
• ANTHROPIC_AUTH_TOKEN kullanın, ANTHROPIC_API_KEY kullanmayın. Resmî belgeler ANTHROPIC_AUTH_TOKEN değerinin Authorization başlığı olarak gönderildiğini ve başına otomatik olarak Bearer eklendiğini belirtir; ayarlandıktan hemen sonra etkili olur. ANTHROPIC_API_KEY ise etkileşimli modda bir kez onay gerektirir; onay sırasında reddedilirse bu anahtar daha sonra sessizce yok sayılır (yeniden etkinleştirmek için /config içindeki Use custom API key seçeneğini kullanın).
• ANTHROPIC_MODEL ana modeli belirler. Burada Claude Sonnet 5 (claude-sonnet-5) olarak sabitlenmiştir. Model adı Kunavo'nun model listesiyle tamamen aynı olmalıdır; tarih son eki taşıyan eski adlar otomatik olarak eşleştirilmez.
• ANTHROPIC_DEFAULT_OPUS_MODEL, opus takma adını belirler. Resmî model yapılandırma belgelerine göre (3 Ekim 2026 tarihinde doğrulandı), API kullanıcılarının varsayılan modeli ve opus takma adı en yeni Opus sürümünü (şu anda Opus 5.5), sonnet takma adı ise Sonnet 5.5'i işaret eder; takma adlar Anthropic'in yeni sürümleriyle birlikte değişir. Resmî belgeler, takma adların «zaman içinde güncellendiğini» açıkça belirtir. Sürümü sabitlemek için tam model adını yazın veya ANTHROPIC_DEFAULT_OPUS_MODEL gibi değişkenleri ayarlayın. Kunavo şu anda Sonnet 5.5'i sunmuyor. Anthropic gelecekte yeni bir Opus sürümü yayımladığında, bu sürüm Kunavo'da henüz kullanıma sunulmamış olabilir; kullanıma sunulmamış modeller 404 döndürür. Ana modeli ve hem opus hem de sonnet takma adlarını sabitlemek gerekmesinin nedeni budur. Burada opus takma adı Claude Opus 5.5 (claude-opus-5-5) olarak sabitlenmiştir. Bunun için Claude Code v2.1.280 veya daha yeni bir sürüm gerekir; eski bir sürüm kullanıyorsanız önce claude update komutunu çalıştırarak güncelleyin.
• ANTHROPIC_DEFAULT_SONNET_MODEL sonnet takma adını belirler. Resmî belgeler bu değişkenin sonnet takma adının hangi modele işaret edeceğini ve opusplan için plan modu dışındaki yürütme aşamasında hangi modelin kullanılacağını belirttiğini açıklar. sonnet takma adı varsayılan olarak Sonnet 5.5'e istek gönderir; Kunavo bunu şu anda sunmadığından bu satır ayarlanmazsa /model sonnet, opusplan yürütme aşaması ve model: sonnet belirten alt aracılar 404 döndürür. Burada da Claude Sonnet 5 (claude-sonnet-5) olarak sabitlenmiştir.
• ANTHROPIC_DEFAULT_HAIKU_MODEL haiku takma adını belirler.haiku takma adı Kunavo'nun sunmadığı bir model kimliği ister: v2.1.293'ten itibaren Haiku 5.5, daha eski sürümlerde ise tarih soneki taşıyan Haiku 4.5 adı. Bu nedenle bu satır ayarlanmazsa /model haiku ve model: haiku olarak belirtilen alt ajanlar (Claude Code'un kendi başlattığı claude-code-guide dâhil) 404 hatası verir. Burada claude-haiku-4-5 olarak sabitlenmiştir.
• ANTHROPIC_DEFAULT_HAIKU_MODEL arka plan görevlerini de yönetir. Resmî belgeler bu değişkenin haiku takma adını belirlediğini ve arka plan özelliklerinde de kullanıldığını belirtir. Claude Haiku 4.5 için Kunavo'da milyon token başına giriş $0,70, çıkış $3,50 tutarındadır; ana model Claude Sonnet 5 için fiyat $1,40 / $7,00(Anthropic'in resmi fiyatı $2,00 / $10,00); opus takma adı için Claude Opus 5.5 fiyatı $2,80 / $14,00 şeklindedir.

Anahtarı proje içindeki .claude/settings.json dosyasına yazmayın: resmî belgeler bu dosyanın gönderilebileceğini ve klonlanan depodaki herkesle paylaşılacağını hatırlatır. Ayrıca bir öncelik kuralı vardır: shell ve settings dosyası aynı değişkeni ayarlarsa settings dosyasındaki değer geçerlidir. Shell değişkenini değiştirmenize rağmen etkili olmuyorsa önce settings dosyasını kontrol edin.

İlk çalıştırmada ne olur

Resmî ağ geçidine bağlanma belgelerine (3 Ekim 2026 ile karşılaştırılarak doğrulandı) göre, ANTHROPIC_AUTH_TOKEN ayarlandıktan sonra claude komutunu çalıştırmak oturumu doğrudan açar ve giriş sayfasını göstermez. Bu değişken hemen etkili olur; ANTHROPIC_API_KEY değişkeninden farklı olarak önce bir kez onaylanması gerekmez. Açıldığında giriş sayfası görünüyorsa Claude Code kimlik bilgilerini okumamış demektir.

Kimlik bilgileri, Claude Code'un ilk kurulumdan önce okuyacağı bir yerde bulunmalıdır: shell içindeki export veya kullanıcı düzeyindeki ~/.claude/settings.json dosyasının env alanı. Resmî belgeler etkileşimli modda proje içindeki .claude/settings.json veya .claude/settings.local.json dosyalarının env alanının ancak ilk kurulum sihirbazı ve klasör güveni uyarısından sonra etkili olduğunu belirtir; bu nedenle anahtar proje düzeyindeki ayarlardaysa ilk başlatmada yine giriş sayfası görülür.

Oturuma girdikten sonra /status çalıştırın ve Status sayfasında şu iki satıra bakın:

• Anthropic base URL: yalnızca ağ geçidi adresi ayarlandığında görünür ve https://api.kunavo.com göstermelidir. Bu satır yoksa ANTHROPIC_BASE_URL bu oturuma aktarılmamıştır.
• Auth token: ANTHROPIC_AUTH_TOKEN yazıyorsa kayıtlı claude.ai girişi yerine API anahtarı kullanıldığı anlamına gelir. Login method ile birlikte bir claude.ai hesabı görüyorsanız değişken etkili olmamıştır.

Claude Code'u açmadan önce adresi ve anahtarı ayrı olarak test etmek isterseniz resmî belgelerdeki yöntemi kullanarak yalnızca 1 çıkış tokenı isteyen bir istek gönderin (token başına ücretlendirilir ve çok az bakiye harcar). Bu komut shell'deki değişkenleri okur; anahtarı settings dosyasına yazmış olsanız bile mevcut terminalde önce bir kez export çalıştırmanız gerekir. {"id":"msg_ ile başlayan JSON dönmesi adres ve anahtarın doğru olduğunu; 401 dönmesi anahtarın tanınmadığını gösterir.

curl -sS -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": "."}]}'

API anahtarı kullanıldığında ne değişir

• Remote Control ve sesli giriş kullanılamaz. Resmî belgeler bu iki özelliğin claude.ai kimliğine bağlı olduğunu ve ANTHROPIC_AUTH_TOKEN ayarlandığında kullanılamadığını belirtir; ANTHROPIC_BASE_URL Anthropic dışı bir adresi gösteriyorsa Remote Control da kapatılır.
• /fast fast modunun kapalı olduğunu gösterir. Resmî belgelere göre yalnızca bearer token varken Claude Code fast modunu doğrudan kapalı kabul eder ve kullanılabilirlik kontrolü göndermez.
• MCP araç araması varsayılan olarak kapalıdır. Resmî belgelere göre ANTHROPIC_BASE_URL Anthropic dışı bir adresi gösterdiğinde MCP araç araması varsayılan olarak kapatılır.
• /context içindeki sayı yerel bir tahmindir.Kunavo şu anda /v1/messages/count_tokens sağlamıyor. Resmî ağ geçidi uyumluluk belgelerine (3 Ekim 2026 ile karşılaştırılarak doğrulandı) göre ağ geçidinde bu uç nokta yoksa Claude Code, karakter sayısına göre tahmin kullanır ve /context yaklaşık bir değer gösterir.

Eksiksiz entegrasyon açıklaması Claude Code entegrasyon belgelerinde (İngilizce) yer alır.

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC tam olarak neyi kapatır

Resmî ortam değişkenleri belgelerine (3 Ekim 2026 ile karşılaştırılarak doğrulandı) göre bu değişken, Claude Code'un gerekli olmayan ağ trafiğini kapatır. Resmî belgelerde şunlar listeleniyor:

• Otomatik güncellemeler, telemetri ve hata raporları;
• /feedback komutu ve Claude'un hazırladığı geri bildirim;
• Sürüm notları, PR/MR durum rozeti kontrolleri;
• fast modu ve diğer kullanılabilirlik kontrolleri;
• Özellik bayrağı çekme; bu nedenle Remote Control ve özellik bayraklarına bağlı diğer işlevler kullanılamaz;
• Eklenti command kaynağının arka planda yeniden çalıştırılması (bu bir ağ trafiği değil, bağımlılık kurulumunu tetikleyebilecek yerel bir komuttur).

Resmî olarak belirtilen birkaç ayrıntı daha vardır: 0 veya false olarak ayarlamak da etkin kabul edilir; çoğu anahtar değişkeninin aksine yalnızca bu değişken silinirse geri yüklenir. Resmî eklenti mağazasının otomatik kurulumu bunun kapsamına girmez; ağ geçidi model keşfini etkilemez. Resmî ağ geçidi belgeleri bunun WebFetch aracının alan adı güvenlik kontrolünü etkilemediğini, bu kontrolün hâlâ api.anthropic.com adresine eriştiğini belirtir; kapatmak için ayarlara ayrıca skipWebFetchPreflight: true eklenmelidir. Resmî belgeler bu değişkeni hesap risk kontrolüyle ilgili bir ayar olarak tanımlamaz.

Kunavo bu değişkenin ayarlanmasını gerektirmez ve değişkenin Kunavo'ya gönderilen model istekleri üzerinde etkisi yoktur. Bu değişkenin hangi durumda yararlı olabileceğini resmî ağ geçidine bağlanma belgeleri (3 Ekim 2026 ile karşılaştırılarak doğrulandı) şöyle açıklıyor: ANTHROPIC_BASE_URL bir ağ geçidine işaret etse bile Claude Code, sürüm kontrolleri, telemetri ve sürüm notları gibi arka plan isteklerini Anthropic ve GitHub gibi üçüncü taraflara göndermeye devam eder. Ağınız yalnızca ağ geçidi adresine erişime izin veriyorsa bu istekler başarısız olur ve giden trafik izleme sisteminde engellenen bağlantılar olarak görünebilir. Resmî öneri, bu değişkeni ağ geçidi değişkeniyle birlikte ayarlamaktır.

Etkinleştirmenin bedeli otomatik güncellemelerin durmasıdır; resmî öneri ayrıca bir güncelleme yöntemi planlamaktır. npm kurulumu için manuel yükseltmede @latest kullanın (yukarıdaki npmmirror bölümünün son satırına bakın).

# 可选：关闭 Claude Code 的非必要网络流量（会同时关闭自动更新）
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# 想恢复时删掉这个变量；设成 0 或 false 仍然算开启
unset CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

Alipay veya WeChat ile bakiye yükleyip anahtar alma

Anthropic'in resmî web aboneliğinde yalnızca kredi veya banka kartları kabul edilir (Claude ücretli planlarının faturalandırılması hakkında sık sorulan sorular, 3 Ekim 2026 ile karşılaştırılarak doğrulandı). Kunavo'ya bakiye yüklerken Alipay veya WeChat Pay kullanabilirsiniz. Adımların özeti aşağıda; tüm adımlar için Claude API'ye Alipay veya WeChat Pay ile bakiye yükleme rehberine bakın:

1. Kunavo hesabı oluşturun; e-posta veya Google hesabı kullanılabilir ve kayıt sırasında kart bağlamak gerekmez.
2. Faturalandırma bölümünde yükleme tutarını seçin; minimum $10 ve aylık ücret yoktur. Daha fazla yüklemede bonus alınır: $100 yüklemeye karşılık hesabınıza $110 geçer, $1000 yüklemeye karşılık hesabınıza $1200 geçer ve $5000 yüklemeye karşılık hesabınıza $6250 geçer.
3. Stripe ödeme sayfasında Alipay veya WeChat Pay'i seçip QR kodunu tarayarak ödeme yapın. Çin ana karasından açıldığında tutar RMB cinsinden gösterilir; ödeme sayfasındaki rakamı esas alın.
4. /app/keys bölümüne giderek sk-kn- ile başlayan bir anahtar oluşturun (yalnızca bir kez gösterilir, hemen kaydedin) ve yukarıdaki ANTHROPIC_AUTH_TOKEN alanına yazın.

Alipay ve WeChat Pay yalnızca manuel yükleme için kullanılabilir; otomatik yükleme yalnızca banka kartı veya Link bağlanarak yapılabilir. Kunavo Çin KDV faturası düzenlemez; yükleme kayıtları Billing sayfasında görülebilir.

Yaklaşık ne kadar harcanır (örnek hesaplama)

Claude Code token başına ücretlendirilir; her istekte konuşma bağlamı yeniden gönderilir ve önceki istekle aynı olan ön ek önbellekten okunarak ücretlendirilebilir. Aşağıdakiler yalnızca örnek bir token hesabıdır; gerçek bir fatura veya ücret üst sınırı değildir. Tüm varsayımlar şöyledir:

• Her istekte 40.000 giriş tokenı vardır; bunların 36.000 tokenı (%90) önbellekten okuma olarak, kalan 4.000 tokenı ise önbelleğe yazma olarak ücretlendirilir;
• Her istekte 1.000 çıkış tokenı;
• Bir çalışma süresinde bu tür 50 istek gönderilir; Claude Haiku 4.5 için arka plan çağrıları dahil değildir;
• Kunavo fiyatları: önbellekten okuma fiyatı, giriş fiyatının 10% oranındadır; önbelleğe yazma fiyatı giriş fiyatının 1,25 katıdır (bunlar Claude Sonnet 5 için geçerli oranlardır; tablodaki her model kendi oranlarıyla hesaplanır).

Gerçek maliyet bağlamın uzunluğuna, önbellek isabetine, çıktının uzunluğuna ve görevler arasında konuşmayı temizlemek için /clear kullanıp kullanmadığınıza bağlıdır. Claude Code aboneliği ile API arasında nasıl seçim yapılacağı ve aylık yaklaşık maliyet için Claude Code fiyatlarına; tüm modellerin fiyatları için Claude API fiyatlarına ve fiyatlandırma sayfasına bakın. Kendi kullanımınıza göre tahmin yapmak için Claude token maliyeti hesaplayıcısını (İngilizce) kullanabilirsiniz.

Yaygın hata karşılaştırması

Bilinmesi gereken sınırlamalar

• Kunavo Çin KDV faturası düzenlemez.
• Alipay ve WeChat Pay yalnızca manuel yükleme için kullanılabilir; otomatik yükleme yalnızca banka kartı veya Link bağlanarak yapılabilir.
• Bu, Claude Pro/Max aboneliği değil, token başına ücretlendirilen bir API'dir; API anahtarı kullanıldığında Remote Control ve sesli giriş kullanılamaz. İki seçenek arasındaki fark için Claude Code fiyatlarına bakın.
• Kunavo Çin ana karasında ağ bağlantısı testi yapmamıştır. claude.ai kurulum adreslerine, npm kaynağına, npmmirror'a ve api.kunavo.com adresine ağınızdan erişilip erişilemediğini ve hızını kendiniz doğrulamanız gerekir.
• Anthropic'in desteklediği ülke ve bölgeler listesinde (3 Ekim 2026 tarihinde kontrol edilmiştir) Çin ana karası, Hong Kong ve Makao yoktur; Claude Code'un resmî kurulum belgeleri bulunduğunuz bölgeyi sistem gereksinimlerinden biri olarak belirtir.

Sık sorulan sorular