Claude Code'da DeepSeek Kullanımı: V4 Flash / Pro Kurulum Rehberi

APIMaster üzerinden Claude Code'da DeepSeek V4 Flash ve Pro'yu çalıştırın. Ağ geçidini ve API anahtarını ayarlayın, modelleri değiştirin, dosya okuma araçlarını doğrulayın ve yapılandırma hatalarını düzeltin.

Claude Code DeepSeek kullanabilir mi? Claude Code 2.1.239 ile yaptığımız testler, APIMaster'ın Messages uç noktası üzerinden deepseek-v4-flash ve deepseek-v4-pro kullanımını başarıyla gerçekleştirdi. ANTHROPIC_BASE_URL değerini https://apimaster.ai olarak ayarlayın, bir APIMaster anahtarı sağlayın ve modeli açıkça seçin. Bu yapılandırma, istemci Claude Code olarak adlandırılsa bile DeepSeek'i çalıştırır.

Son test: 2026-09-07, Claude Code 2.1.239, Linux. Her iki model de beklenen metni döndürdü ve dosya okuma aracı turunu tamamladı. Tüm çalıştırmalar 0 çıkış koduyla sonlandı. CLI unrecognized_model yazdırdı, ancak test edilen istekler başarılı oldu. Bu kontroller, her Claude Code özelliğini, uzun oturumları veya gelecekteki sürümleri desteklediğini garanti etmez. Windows / macOS kurulum komutları dahildir; kaydedilen test Linux üzerinde gerçekleştirildi.

1. CLI ve API anahtarını hazırlayın

Kurulum için ortam rehberini ve Claude Code kurulum rehberini izleyin. Sürümünüzü kontrol edin:

claude --version

Seçilen DeepSeek modeline erişimi ve yeterli kotası olan bir APIMaster API anahtarı edinin. Bu eğitim için aşağıdaki oturum ayarlarını kullanın; normal settings.json dosyanızın üzerine yazmanıza gerek yoktur.

2. Ağ geçidini ve anahtarı ayarlayın

Bu ayarları normal CLI oturumunuzdan ayırmak için yeni bir terminal açın.

macOS / Linux:

export ANTHROPIC_BASE_URL='https://apimaster.ai'
export ANTHROPIC_API_KEY='YOUR_APIMASTER_API_KEY'
unset ANTHROPIC_AUTH_TOKEN

Windows PowerShell:

$env:ANTHROPIC_BASE_URL = 'https://apimaster.ai'
$env:ANTHROPIC_API_KEY = 'YOUR_APIMASTER_API_KEY'
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue

Burada site kökünü kullanın, /v1 olmadan: Claude Code /v1/messages ekler. API anahtarı APIMaster'dan gelmelidir. Bu komutlar bu terminali ve alt süreçlerini etkiler, kayıtlı giriş dosyalarınızı değil. Gerçek bir anahtarı paylaşılan bir ayar dosyasına veya depoya koymayın.

3. Minimal bir test isteği gönderin

claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools "" --output-format json -p "Reply with exactly: DEEPSEEK_TEST_OK"

Beklenen: is_error false, result DEEPSEEK_TEST_OK ve süreç 0 çıkış koduyla sonlanır. --model değerini deepseek-v4-pro olarak değiştirin ve tekrar çalıştırın.

Test edilen sürümün --bare modu açık API anahtarı kimlik doğrulaması kullanır ve normal arka plan entegrasyonlarını atlar. --setting-sources "" kayıtlı ayar kaynaklarını hariç tutar, --tools "" ise bu tek metin testi için araçları devre dışı bırakır. Bunlar kasıtlı tanılama ayarlarıdır, normal kullanımda araçları devre dışı bırakma gereksinimi değildir. Eski CLI sürümleri tüm bu bayrakları kabul etmeyebilir.

4. Dosya okuma araçlarını doğrulayın

Geçerli dizinde probe.txt dosyasını şu içerikle oluşturun:

TOOL_PROBE_739182

Çalıştırın:

claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools Read --allowedTools Read --output-format json -p "Use the Read tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."

Beklenen: CLI dosyayı okur ve TOOL_PROBE_739182 döndürür. deepseek-v4-pro ile tekrarlayın. Bu, modelin bir araç isteyebileceğini, sonucunu alabileceğini ve ardından yanıt verebileceğini kontrol eder. Bu test için yalnızca Read aracı etkindir.

Aynı terminal ayarlarıyla normal etkileşimli çalışma için:

claude --bare --setting-sources "" --model deepseek-v4-flash

Pro ile başlamak için:

claude --bare --setting-sources "" --model deepseek-v4-pro

Etkileşimli komutlar --tools "" içermez, böylece varsayılan araçlar kullanılabilir. İzin istemlerini her zamanki gibi inceleyin. --bare, kancalar ve otomatik proje talimatları gibi kolaylıkları atlar; normal ayarlarınızı minimal kurulum çalıştıktan sonra bilinçli olarak etkinleştirin ve ağ geçidini veya modeli geçersiz kılmadıklarını kontrol edin. Bitirdiğinizde bu oturumun ortamını geride bırakmak için bu terminali kapatın.

Sorun Giderme

Belirti	Kontrol edilecekler
`unrecognized_model`	2.1.239'da her iki DeepSeek kimliği için de gözlemlendi. İsteklerimizin tamamlanmasını engellemedi. Uyarıyı tek başına hata olarak ele almak yerine nihai sonucu kontrol edin.
401 veya beklenmeyen bir giriş istemi	`ANTHROPIC_API_KEY` değerinin ayarlandığını doğrulayın, bu terminalde çakışan bir `ANTHROPIC_AUTH_TOKEN` değişkenini kaldırın ve bare modunu yeniden deneyin.
404	`ANTHROPIC_BASE_URL` `https://apimaster.ai` olmalıdır, tam `/v1/messages` uç noktası veya `/v1` ile biten bir taban değil.
Bilinmeyen `--bare` seçeneği	Sürümünüzü test edilen 2.1.239 ile karşılaştırın. Uygunsa genel kurulum rehberini kullanarak güncelleyin.
`probe.txt` okunamıyor	Dosyanın dizininden çalıştırın. Araç testi için `--tools ""` kullanmak yerine Read'i etkinleştirin.
Farklı bir model seçildi	`--model` ile tam model kimliğini iletin ve kayıtlı ayarları veya model takma adı geçersiz kılmalarını etkinleştirmeden önce kontrol edin.
Hız sınırı, yetersiz kota veya üst akış hatası	Hata gövdesini okuyun, kota ve model izinlerini kontrol edin ve destek için zaman damgasını kaydedin.

Sıkça sorulan sorular

Bu, Claude modeli kullanmakla aynı şey mi?

Hayır. Claude Code burada istemcidir; seçilen model DeepSeek'tir. Belirli bir Claude modeline bağlı özellikler bu kurulumla otomatik olarak kapsanmaz.

Temel URL neden Python SDK örneğinden farklı?

Python OpenAI SDK https://apimaster.ai/v1 kullanır ve /chat/completions ekler. Claude Code https://apimaster.ai kullanır ve /v1/messages ekler. Her istemcinin belgelenmiş temel biçimini kullanın.

Bu ağ geçidiyle DeepSeek resmi anahtarını kullanabilir miyim?

Bu eğitim APIMaster tarafından verilen bir anahtar gerektirir. Anahtarlar, onları veren sağlayıcıya özeldir; yalnızca uç noktayı değiştirmek kimlik bilgilerini veya kotayı aktarmaz.

Gerçek araç kullanımı mı test edildi, yoksa yalnızca metin yanıtı mı?

Her iki model için de her ikisi test edildi. Araç testi yerel bir dosyayı okudu ve içeriğini döndürdü. Tüm araçların, arka plan aracılarının veya uzun kodlama görevlerinin desteklendiğini garanti etmez.