Bilgi Tabanı Bölümleri ▾

Navigasyon

▸ Buradan başlayın Rol bazlı

Kategoriler

Araçlar 54
Sözlük 12

Araçlar

Claude Code + DeepSeek V4 Flash: nasıl bağlanır ve bir görev ne kadar eder

Kısacası: Claude Code, DeepSeek ile claude-code-router gibi yerel ara katmanlar olmadan çalışır. İki şekilde bağlanabilirsiniz: Anthropic formatında kendi adresi olan resmi DeepSeek API'si üzerinden veya Gonka ağından açık DeepSeek V4 Flash'ın yanıt verdiği JoinGonka Gateway üzerinden. İkinci durumda kurulum tek komuttur: npx @joingonka/setup --tool claude-code --model deepseek.

İki durumda modeller farklıdır. DeepSeek API'sinde 10 Eylül 2026'dan beri sonraki sürüm çalışıyor — V4.1 Flash; Gonka ağının hizmet verdiği V4 Flash'ı ise DeepSeek kendi API'sinden kaldırdı. Aşağıda her iki kurulum, çalışmada nasıl farklılaştıkları ve bir ajan görevinin ne kadara mal olduğu yer alıyor. 2 Kasım 2026 fiyatlarına göre, 30 model çağrılı bir görev DeepSeek'te yoğun saatlerde yaklaşık $0.09, diğer zamanlarda yaklaşık $0.05, gateway üzerinden ise yaklaşık $0.02 tutar.

Bu Claude değil ve fark yokmuş gibi davranmayacağız: Anthropic açıkça Claude Code'un Claude dışı modellerle çalışmasını hiçbir gateway üzerinden desteklemediğini yazıyor. Teknik olarak her şey çalışıyor — Claude Code 2.1.316'nın gateway ile kombinasyonunu 2 Kasım 2026'da test ettik — ancak sorularınızla Anthropic desteğine değil, bize veya DeepSeek'e başvurun.

Yöntem 1: resmi DeepSeek API'si

DeepSeek'in Anthropic formatında bir adresi var — https://api.deepseek.com/anthropic — ve Claude Code için resmi bir kılavuzu bulunuyor. Anahtar DeepSeek panelinde (platform.deepseek.com) oluşturulur, bakiye önceden yüklenir. DeepSeek kılavuzundaki 2 Kasım 2026 tarihli değişkenler:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-your-deepseek-key
export ANTHROPIC_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432
claude

İlk çalıştırmadan önce bilmeniz gerekenler:

  • Model adı. 10 Eylül 2026'dan itibaren deepseek-flash V4.1 Flash'ı, 17 Ekim'den itibaren ise aynı fiyattan 1017 güncellemesini temsil ediyor. DeepSeek eski deepseek-v4-flash adını hâlâ kabul ediyor, ancak ona da aynı V4.1 Flash ile yanıt veriyor. [1m] son eki Claude Code'a modelin penceresinin 1 milyon token olduğunu bildirirken, CLAUDE_CODE_AUTO_COMPACT_WINDOW geçmişin hangi hacimde sıkıştırılacağını belirliyor.
  • Claude adları. Claude Code'da Claude adlı bir model bırakırsanız, DeepSeek kendi modelini devreye sokar: claude-opus tabanlı adlar V4 Pro'ya yönlendirilir ve V4 Pro fiyatından ücretlendirilir, diğerleri deepseek-flash'a gider. Bu yüzden kılavuzda tüm takma adlar açıkça sabitlenmiştir.
  • Yoğun saatler. 16 Ağustos 2026'dan itibaren DeepSeek, Çin tatilleri hariç hafta içi 01:00–04:00 ile 06:00–10:00 UTC arasında çift fiyat uyguluyor. Pekin saatine göre bu neredeyse tüm iş günü, Avrupa'da sabah, ABD'de akşam ve gece anlamına geliyor.
  • Web araması. Claude Code yerleşik araçla internette arama yaptığında, aramayı DeepSeek'in kendisi gerçekleştiriyor. 31 Ekim 2026'dan itibaren bu ücretli: 1000 başarılı sorgu için $0,75, artı modelin bulunanları okumak için harcadığı tokenlar.

Yöntem 2: JoinGonka Gateway — tek komut

Gonka ağında DeepSeek V4 Flash 0731 sürümüyle çalışıyor — MIT lisanslı açık ağırlıklar. Ağ geçidi Claude Code isteklerini doğrudan Anthropic formatında (/v1/messages) kabul eder, aralarında bir katmana gerek yoktur.

Adım 1. Anahtar. JoinGonka Gateway'e kaydol — yeni hesaplara 3M ücretsiz token tanımlanır — ve panelde bir jg-… anahtarı oluştur.

Adım 2. Kurulum aracı.

npx @joingonka/setup --tool claude-code --model deepseek

Kurulum aracı anahtarı sorar, ~/.claude/settings.json dosyasının bir kopyasını saklar ve env bloğuna yalnızca kendi değişkenlerini yazar: ağ geçidi adresi ve anahtar; geçerli ve yeni oturumlar için, opus, sonnet, fable takma adları ve alt ajanlar için model; Claude Code'un arka plan görevlerini yürüttüğü haiku takma adı için MiniMax M2.7; modelin gerçek sınırları — 380 000 token pencere ve 32 768'e kadar yanıt. Diğer ayarlarına dokunmaz ve anahtar dosyasına 600 izinlerini verir. Sonunda kurulum aracı anahtarı canlı bir istekle doğrular. Aynı kurulum aracı başka programları da yapılandırır — sayıları 25, bunlar arasında Codex CLI ve OpenCode da var.

Adım 3. Doğrulama. claude'u başlat ve /status'u aç: orada ağ geçidi adresini içeren Anthropic base URL satırı ve ANTHROPIC_AUTH_TOKEN içeren Auth token satırı olmalı. Sonra bir kod görevi ver, örneğin Read calc.py and tell me in one sentence whether it has a bug.

Elle yapılandır

~/.claude/settings.json dosyasına env bloğunu ekle — bu dosyadaki değerler kabuktaki export'tan önce gelir:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gate.joingonka.ai",
    "ANTHROPIC_AUTH_TOKEN": "jg-your-key",
    "ANTHROPIC_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMaxAI/MiniMax-M2.7",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "380000",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32768"
  }
}

Adres — /v1 olmadan: /v1/messages yolunu Claude Code kendisi ekler. Model adı — tam ve [1m] olmadan: bu sonekle Claude Code pencerenin 1 milyon token olduğunu varsayar, oysa ağdaki DeepSeek V4 Flash'ta 380 000'dir. Son iki satır gerçek pencereyi ve yanıt tavanını bildirir. Model sabitlenmezse Claude Code kendi claude-* adını gönderir ve ağ geçidi varsayılan modelle yanıt verir — şu anda GLM-5.3 Flash (zai-org/GLM-5.3-Flash).

Windows ve yalnızca tek bir proje için yapılandırma dahil tüm kurulum seçenekleri Claude Code kılavuzunda.

Claude Code'da DeepSeek ve JoinGonka API'leri arasındaki fark

DeepSeek APIJoinGonka
ModelV4.1 Flash, sürüm 1017V4 Flash, sürüm 0731
Bağlam penceresi1 milyon token380 bin token
Yanıt üst sınırı384 bin token32 768 token
Görsellerokuyoryalnızca metin
Yanıtta akıl yürütmevar, thinking blokları halindeyok
Claude Code web aramasıkendi araması; 31.10.2026'dan itibaren — 1000 sorgu başına $0.75gateway araması
Token başına fiyatyoğun saatlerde iki kat yüksekher saatte tek fiyat
Önbellekönbellekten okuma, girişten 50 kat ucuztüm giriş tek fiyattan
Anahtardaki diğer modellerV4 ProGLM-5.3 Flash, MiniMax M2.7

Peki bu pratikte ne anlama geliyor:

  • Model sürümü. V4.1 Flash daha yeni ve DeepSeek'in kendi testlerine göre daha güçlü: Terminal-Bench 2.1'de V4.1 Flash 90,6 alırken V4 Flash 0731 82,7'de kalıyor (10 Eylül ve 31 Temmuz sürümlerine göre). Görsel, bir milyon token'lık pencere veya en yeni sürüm gerekiyorsa resmi DeepSeek API'sini tercih edin. Daha çok iş hacminde fiyat ve her saat başı aynı ücret daha önemliyse V4 Flash'ı gateway üzerinden kendi görevlerinizde deneyin; ücretsiz token'larla başlayabilirsiniz.
  • Uzun oturumlar. 380 000 token'lık pencereye bir milyonluktan daha az geçmiş sığar. Günlük kullanım için bu yeterli: Ekim 2026'da gatewayimiz üzerinden DeepSeek V4 Flash'a gönderilen ortalama Claude Code isteği yaklaşık 96 bin token'dı.

Modelin kendisi hakkında daha fazlası — Gonka ağında DeepSeek V4 Flash makalesinde.

DeepSeek üzerinde bir Claude Code görevi ne kadara mal olur

Önce 2 Kasım 2026 itibarıyla 1M token başına fiyatlar — DeepSeek fiyat sayfası ve OpenRouter API'sine göre. DeepSeek'in yanında, OpenRouter'ın en ucuz sağlayıcılarındaki aynı V4 Flash 0731 var:

NeredeModelGirişÖnbellekten girişÇıkış
DeepSeek API, yoğun saatlerV4.1 Flash$0.30$0.006$1.20
DeepSeek API, diğer saatlerV4.1 Flash$0.15$0.003$0.60
OpenRouter, DeepInfraV4 Flash 0731$0.06$0.015$0.18
OpenRouter, StreamLakeV4 Flash 0731$0.132$0.0042$0.396
JoinGonka GatewayV4 Flash 0731$0.0062ayrı fiyat yok$0.019

Normal giriş bizde DeepSeek'e kıyasla 24–49 kat daha ucuz, çıkış ise 32–65 kat. Ama DeepSeek'te önbellekten okuma yoğun saatlerde neredeyse bizim giriş fiyatımıza denk, diğer saatlerde ise onun yarısı kadar — ve Claude Code neredeyse sürekli aynı şeyleri yeniden okuyor: sistem promptu, araç tanımları ve oturum geçmişi. Bu yüzden token fiyatını değil, görevin tamamını karşılaştırmak gerekiyor.

Görev. 30 model çağrısından oluşan bir görev ele alalım — örneğin bir hatayı bulmak, kodu düzeltmek ve testleri çalıştırmak. Gatewayimizin Ekim 2026 verilerine göre DeepSeek V4 Flash'a giden bir Claude Code isteği ortalama yaklaşık 96 bin giriş ve 0,9 bin çıkış token'ı içeriyor. Toplamda görev 2,9 milyon giriş ve 27,5 bin çıkış token'ı ediyor. Claude Code her adımda oturumu baştan gönderiyor ve bunun neredeyse tamamı önceki istekle örtüşüyor; bu yüzden DeepSeek ve OpenRouter'da girişin %95'inin önbellekten okunduğunu varsayalım.

NeredeGörev100 böyle görev
DeepSeek API, yoğun saatler~$0.092~$9.20
DeepSeek API, diğer saatler~$0.046~$4.60
OpenRouter, StreamLake — bu görev için en ucuz sağlayıcı~$0.041~$4.10
OpenRouter, DeepInfra~$0.054~$5.40
JoinGonka Gateway~$0.018~$1.80

Tutarlar 2 Kasım 2026 fiyatlarına göre hesaplandı; bu sayfadaki token fiyatımız canlı ve GNK kuruyla birlikte değişiyor. Böyle bir görev için gateway, DeepSeek'in yoğun saat fiyatından yaklaşık 5 kat, diğer saatlerdeki fiyatından 2,5 kat ve aynı modelin OpenRouter'daki en ucuz sağlayıcısından 2,3 kat daha ucuza geliyor.

Fark önbelleğe bağlı. Girişin %98'i önbellekten okunursa DeepSeek bizden yoğun olmayan saatlerde yaklaşık 1,8 kat, yoğun saatlerde 3,7 kat pahalı. %90 ise 3,7 ve 7,4 kat. Bizde önbellek oranı toplam tutarı etkilemiyor: tüm giriş aynı fiyata sahip. Aylık hesap, GLM-5.3 Flash seçeneği ve referans olarak Claude'un kendi fiyatları — “Claude Code daha ucuz” makalesinde.

claude-code-router'a gerek var mı

Claude Code Router (CCR) — MIT lisanslı açık bir proje: bilgisayarınızda çalışan yerel bir ağ geçidi, varsayılan olarak http://127.0.0.1:3456. Claude Code ve diğer agent'lar isteklerini ona gönderir, o da seçilen sağlayıcılara iletir: istekleri formatlar arasında (Anthropic Messages, OpenAI Chat ve Responses, Gemini) çevirir, görevleri kurallara göre modellere dağıtır, ana model yanıt vermediğinde yedek modele geçer ve token'larla maliyet tahminini içeren bir istek günlüğü tutar. macOS, Windows ve Linux için uygulama olarak ya da npm install -g @musistudio/claude-code-router komutuyla kurulur (Node.js 22 veya üzeri gerekir).

Tek bir DeepSeek için buna gerek yok: DeepSeek'in Anthropic formatında kendi adresi var ve JoinGonka Gateway de Claude Code isteklerini doğrudan kabul ediyor. CCR şu durumlarda anlamlı:

  • birden fazla sağlayıcıyı ve hangi görevin nereye gideceğine dair kuralları yönetmek istiyorsanız;
  • ana model yanıt vermediğinde otomatik olarak yedek modele geçmek istiyorsanız;
  • istekleri, token'ları ve maliyetleri tek bir yerde görmek istiyorsanız;
  • yalnızca OpenAI formatını anlayan bir sağlayıcı bağlamak istiyorsanız.

Kendi adresinizi (custom endpoint) CCR'ye Anthropic Messages veya OpenAI Chat protokolüyle bağlarsınız ve ağ geçidinde her iki protokol de mevcut: Anthropic için temel adres https://gate.joingonka.ai, OpenAI için https://gate.joingonka.ai/v1. Ayrıntılar için Gonka API dokümantasyonundaki Anthropic Messages bölümüne bakın.

Claude Code'a hangi anahtar girilir ve Claude'a nasıl dönülür

Claude Code, üçüncü taraf API anahtarını iki değişkenden birinden alır:

  • ANTHROPIC_AUTH_TOKEN — anahtar Authorization: Bearer başlığıyla gönderilir ve hemen geçerli olur. Hem DeepSeek rehberi hem de kurulum aracımız bunu kullanır.
  • ANTHROPIC_API_KEY — anahtar x-api-key başlığıyla gönderilir; etkileşimli modda Claude Code bir kez kullanılıp kullanılmayacağını sorar.

DeepSeek ve JoinGonka her iki başlığı da kabul eder. Anahtarın bulunduğu değişken tanımlı olduğu sürece claude.ai aboneliğiniz harcanmaz: Claude Code girişinizi hatırlar ama göndermez ve istekler bu anahtarın bakiyesinden ödenir. Yalnızca adresi anahtar olmadan tanımlarsanız, Claude Code claude.ai girişinizi yeni adrese gönderir ve istek başarısız olur.

Anahtarı ~/.claude/settings.json veya projenizin .claude/settings.local.json dosyasında saklayın; deponun ortak .claude/settings.json dosyasında değil — bu dosya genellikle commit'lenir. --scope local bayrağıyla çalışan kurulum aracı settings.local.json dosyasına yazar ve dosyayı kendisi .gitignore'a ekler.

Claude'a dönmek için env bloğundan DeepSeek'e veya ağ geçidine işaret eden satırları kaldırın ve Claude Code'u yeniden başlatın: claude.ai girişinizi yeniden kullanacaktır.

DeepSeek'i Claude Code'a bağlamanın iki yolu var: resmi DeepSeek API'si — 1 milyon token'lık bağlam penceresine sahip V4.1 Flash ve yoğun saatlerde iki katı fiyat — ya da JoinGonka Gateway: tek bir kurulum komutuyla açık V4 Flash 0731 ve her saat aynı fiyat. Bunun için claude-code-router'a gerek yok. 2 Kasım 2026 fiyatlarına göre, ağ geçidi üzerinden modelle 30 kez etkileşim içeren tipik bir görev DeepSeek'tenekinden 2,5-5 kat daha ucuza geldi. Karşılığında ise 380.000 token'lık bağlam penceresi, yalnızca metin ve önceki model sürümü.

Daha fazla bilgi edinmek ister misiniz?

Diğer bölümleri keşfedin veya şimdi GNK kazanmaya başlayın.

Anahtar ve ücretsiz token al →