Claude Code Üçüncü Taraf Sağlayıcı Kullanım Kılavuzu - Derinlemesine Analiz ve En İyi Uygulamalar

Claude Code Üçüncü Taraf Sağlayıcı Kullanım Kılavuzu

Giriş

Bu makale, Claude Code’u uzun süredir kullanma deneyimlerime dayanarak, üçüncü taraf sağlayıcıları verimli bir şekilde yapılandırmanın nasıl yapılacağı ve yaygın yapılandırma tuzaklarından nasıl kaçınılacağı hakkında paylaşımda bulunur. Sadece resmi bilgileri ileten自媒体’dan farklı olarak, buradaki içerikler gerçek hayatta denenmiş ve doğrulanmış pratik tekniklerden oluşur.

Ortam Değişkeni Yapılandırması

Temel Yapılandırma (çoğu eğitimde bahsedilen)

ANTHROPIC_BASE_URL=sağlayıcınızın API adresi
ANTHROPIC_AUTH_TOKEN=doğrulama tokeniniz
ANTHROPIC_MODEL=varsayılan model adı

ANTHROPIC_SMALL_FAST_MODEL artık kullanım dışıdır ve yerini ANTHROPIC_DEFAULT_HAIKU_MODEL almıştır.

Gelişmiş Yapılandırma (daha az bahsedilen)

Claude Code şu anda farklı görevler için farklı modellerin seçilmesini desteklemektedir:

# Farklı seriler için ayrı ayrı yapılandırma
ANTHROPIC_DEFAULT_OPUS_MODEL=opus serisi modeli
ANTHROPIC_DEFAULT_SONNET_MODEL=sonnet serisi modeli
ANTHROPIC_DEFAULT_HAIKU_MODEL=haiku serisi modeli

# Alt ajansların kullandığı model
CLAUDE_CODE_SUBAGENT_MODEL=alt ajans modeli
# Zaman aşımı süresini ayarlama
BASH_DEFAULT_TIMEOUT_MS=10000
# Gereksiz trafiği devre dışı bırakma
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# Ücret uyarısını devre dışı bırakma, aksi takdirde her 5 dolarlık Claude sonnet kullanımında uyarı verilir
DISABLE_COST_WARNINGS=1
# Gereksiz model çağrılarını devre dışı bırakma
DISABLE_NON_ESSENTIAL_MODEL_CALLS=1
# Telemetriyi devre dışı bırakma
DISABLE_TELEMETRY=1

Daha fazla yapılandırma için: https://docs.claude.com/en/docs/claude-code/settings#environment-variables

Plan Modu Kullanım Teknikleri

Claude Code’un Plan Modu, AI’nın dosyaları doğrudan değiştirmeden daha fazla düşünmesini sağlayan çok faydalı bir özelliktir. Bu mod, özellikle DeepSeek’in Reasoner modeliyle birlikte kullanıldığında çok etkili olur. Plan modunda şunlar yapılabilir:

• Gereksiz dosya değişikliklerini azaltma
• Daha detaylı düşünme süreçleri sunma
• Karmaşık kod incelemeleri ve tasarım kararları için uygundur

Üçüncü Taraf Sağlayıcıların Hızlı Geçişi

Claude Code Router aracını kullanarak üçüncü taraf model sağlayıcılarını Claude Code’a bağlayanlar ve ortam değişkeni geçişini sağlayanlar var. Bu ek işlemler kullanılmamasını şiddetle tavsiye ederim. Gerçekten ihtiyacınız olan tek şey VS Code ayarlarını açmak ve terminal.integrated.env aramak, ardından ilk üç ayarlanabilir öğeyi yapılandırmaktır.

Şuna benzer:

Daha sonra VS Code içinde yeni bir terminal açıldığında, yeni ortam değişkenlerini kullanır. Ek üçüncü taraf araçları kullanmaya gerek yoktur, sadece elinizdeki VS Code’u yapılandırmanız yeterlidir.

Neden API Dönüşüm Araçlarını Kullanmamalıyız

Birçok kullanıcı, Claude Code’u kolayca kullanmak için Claude Code Router’ı veya dönüşüm betikleri yazmayı dener, ancak bu yöntemler genellikle VS Code ve API arayüzleri hakkında yetersiz bilgiden kaynaklanır.

Öneri: Kendiniz API dönüşümü yapmak yerine, Anthropic API’yi resmi olarak destekleyen sağlayıcıları seçin. Bunun nedenleri şunlardır:

• Anthropic API dönüşümü karmaşık olup mükemmel bir şekilde uyum sağlamak zordur
• Resmi destek sağlayan sağlayıcılar daha kararlı bir hizmet sunar
• Uyumluluk sorunlarından ve gereksiz hata ayıklama zamanından kaçınılabilir

Normal API’den Anthropic API’ye dönüşüm büyük bir uçurum yaratır ve bu DeepSeek’in resmi Anthropic API dönüşüm uyumluluk tablosudur: DeepSeek-anthropic_api#anthropic-api-uyumluluk-detayları

Resmi dönüşüm bile bu kadar uyumsuzluk içeriyorken, kendi dönüşümünüzden bahsetmeye gerek yoktur. Bu tür işlere zaman harcamamanızı tavsiye ederim.

Claude Code’u Destekleyen Çinli Üçüncü Taraf Sağlayıcılar

Şu anda Çin’de Anthropic API’yi doğrudan destekleyen sağlayıcılar şunlardır:

• DeepSeek - Genel performansı mükemmel
• Z-AI - İyi API desteği sunar
• Moonshot - Büyük parametre miktarı
• ModelScope - Sadece GLM-4.5 sorunsuz çalışır

Bunların hiçbiri Claude Code’u mükemmel bir şekilde desteklemiyor ve çeşitli sorunlarla karşılaşıyorlar, örneğin deepseek alt ajansları desteklemiyor, dört sağlayıcı da resim ve belgeleri desteklemiyor. Claude Code’un tam gücünü hissetmek istiyorsanız, en düşük giriş seviyesi 100 dolarlık Max’tır, 20 dolarlık Pro değildir çünkü Pro Opus modelini kullanamaz.

DeepSeek

"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-reasoner",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-reasoner",

Z-AI

"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
"CLAUDE_CODE_SUBAGENT_MODEL": "glm-4.5",

Moonshot

"ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_MODEL": "kimi-k2-turbo-preview",

ModelScope

"ANTHROPIC_BASE_URL": "https://api-inference.modelscope.cn",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-R1-0528",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "ZhipuAI/GLM-4.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "Qwen/Qwen3-Coder-480B-A35B-Instruct",
"CLAUDE_CODE_SUBAGENT_MODEL": "ZhipuAI/GLM-4.5",

Sonuç

AI ile ilgili belgeler yayınladığımda, makalenin altında her zaman birileri ilanlar yapıştırır. Burada herkese ciddi bir hatırlatma yapmak istiyorum, kesinlikle herhangi bir yönlendirme API’si kullanmayın, büyük güvenlik riskleri vardır.

Özellikle güvenlik sorunları için bakınız: Model Yönlendirici Güvenlik Riski Analizi

• ←Önceki
• Sonraki→