Claude Code için Üçüncü Parti API Sonucunu Kullanarak Çinli Açık Kaynak Modeli Gateway Kurulumu

Claude Code, bir Anthropic uyumlu sonucu yerine doğrudan bir sağlayıcı sonucuna bağlanarak yapılandırılabilir. Bu, bir gateway yönetilen iş akışını test etmek ve gateway tarafından sunulan model ID'lerini kullanmak için bir yol sunar, özellikle de ECAIX'nin şu anda model kataloğunda bulunan Çinli açık kaynak modellerini.

Bu kılavuz, sağlayıcı özelleştirilmiş, üçüncü parti uyumlu bir iş akışı hakkında bir bilgi sunar. Anthropic'in resmi Claude Code gateway belgeleri, Claude Code'yi bir gateway aracılığıyla non-Claude modellerle yönlendirmenin desteklenmediğini belirtir. ECAIX, bu iş akışının resmi Anthropic tarafından desteklendiğini iddia etmez ve bir non-Claude model, Claude Code'nun herhangi bir özelliğini sağlayabilir.

Hızlı Başlangıç

Eğer uyumluluk sınırlarını anlıyorsanız, bu kısa yolu deneyebilirsiniz:

1. ECAIX model kataloğuna git ve bir aktif model ID'yi seçin.
2. ECAIX API anahtarı oluşturun ve kaynağa kontrol dışı tutun.
3. ANTHROPIC_BASE_URL değerini https://ecaix.com/api/ai/v1/anthropic olarak ayarlayın.
4. Aşağıdaki tanıma talimatını uygulayın ve HTTP durumu kaydedin.
5. Okuma-yazma test projesi olarak claude -p ile Claude Code'ı çalıştırın.
6. Araçları, akışlı yanıtları, kontekst sınırlarını ve iznileri ayrı ayrı test edin.

Yayın tarihi doğrulama durumu

Bu tablo, bir yapılandırma örneği ile ölçülmüş uyumluluk sonucu arasında bir ayrım yapmak için amaçlanmıştır: bir yapılandırma örneği, ölçülmüş uyumluluk bir sonucu değildir.

Bu yapılandırma ne değiştirir?

Bu yapılandırma dört ayrı parçadan oluşur:

1. Claude Code, kod görevlerini oluşturur ve isteği gönderir.
2. Anthropic uyumlu gateway, Anthropic tarzında bir sonuca isteği alır.
3. Model ID, gateway tarafından sunulan upstream modeli seçer.
4. API anahtarı, isteği kimlik doğrulayarak hesap, kotaları ve iznileri belirler.

Sonuç yolu değiştirilirse, bir non-Claude model bir Claude olmaz. Ancak uyumlu bir API yüzeyi ile isteğin alınması, araç kullanımı, kontekst yönetimi, model aliasleri, akışlı davranış ve izneler akışları farklı versiyonlar ve gateway uygulamaları arasında değişebilir.

Başlamadan Önce

İlk olarak şunları yapmanız gerekiyor:

• Claude Code'ın çevre değişken veya ayarlar tabanlı sonuç yapılandırma desteği olan bir kurulumu.
• Bir ECAIX API anahtarı.
• ECAIX model kataloğunda şu anda mevcut olan bir model ID.
• Bir terminal, küçük bir test isteği yapmak için API anahtarını kaynağa kontrol dışı tutabilecek.

Katalog sürekli değişiyor. Model ID'yi yapılandırma dosyasına kopyalaymadan önce, ECAIX modeller dizini üzerinden modelin aktif ve API tarzınızı kullanmak için kullanılabilir olduğunu doğrulayın.

Gateway sonucunu yapılandırın

Claude Code, birçok kurulumda ~/.claude/settings.json dosyasında ayarları saklar. Tüm ayarlar için geçerli bir başlangıç modeli olarak aşağıdaki yapılandırma örneğini kullanın ve kurulumunuzun belgelerini karşılaştırın.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ecaix.com/api/ai/v1/anthropic",
    "ANTHROPIC_API_KEY": "YOUR_ECAIX_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT": "1"
  },
  "model": "deepseek-v4.1-flash"
}

Bu dosyayı bir kamuya açık depoya komit etmeyiniz, çünkü gerçek bir API anahtarı içerir. Çevre değişkeni, gizli yönetici veya kurulumunuzun önerdiği kredi mekanizması gibi yerel bir çevre değişkeni veya yöneticiyi tercih edin.

Ayrıca test ederken bir shell oturumunda sonuç yolu yapılandırılabilir:

export ANTHROPIC_BASE_URL="https://ecaix.com/api/ai/v1/anthropic"
export ANTHROPIC_API_KEY="YOUR_ECAIX_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"

Bir Claude Code versiyonu tarafından desteklenen değişken isimleri ve ayarlar değişebilir. Eğer ANTHROPIC_MODEL parametresini dikkate almıyorsa, versiyonunuzun belgelerindeki model alanını veya model alias mekanizmasını kullanın. Gateway, son model ID'yi hala tanımalıdır.

Anthropic Uyumlu Sonucu Doğrula

Bir interaktif kod sesyonu başlatmadan önce, bir küçük isteği gönderin. Bu, sonuç yolu, kimlik doğrulama ve model ID sorunlarını ayırmak için ayrı ayrı Claude Code özelliği davranışından ayrı bir ayrım yapar.

Aşağıdaki komut, yanıt başlıklarını ve yanıt gövdesini ayrı ayrı kaydeder ve HTTP durumu basarır. Bir gerçek yetkilendirilmiş anahtarla yalnızca yerel shell kullanın; asla bir makale, sorun, paylaşılan log veya paylaşılan shell tarihine kopyalayın.

curl -sS -D /tmp/ecaix-anthropic-headers.txt \
  -o /tmp/ecaix-anthropic-response.json \
  -w '\nHTTP %{http_code}\n' \
  "${ANTHROPIC_BASE_URL}/messages" \
  -H "x-api-key: ${ANTHROPIC_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 128,
    "messages": [
      {"role": "user", "content": "Reply with one short sentence."}
    ]
  }'

Beşeri yorum:

• 200: yanıt şeklini ve döndürülen model veya kullanım alanlarını inceleyin.
• 401 veya 403: anahtar, başlık, hesap ve izneler konusunda kontrol edin.
• 404: taban URL, /messages sonu ve sonuç yolu uygulamasını kontrol edin.
• 400: isteği en küçük geçerli gövdeye indirin ve model özelleştirme alanlarını kontrol edin.
• 5xx veya zaman aşımı: isteğin süresini ve yanıt gövdesini kaydedin ve gateway, upstream ve client zaman aşımını ayrı ayrı inceleyin.

Bir başarılı yanıt, anahtar, sonuç yolu, istek formatı ve model ID'nin bu isteğe birlikte çalıştığını doğrular. Ancak, Claude Code'nun herhangi bir özelliğinin çalıştığını garanti etmez.

Model ID Seçimi

ECAIX kataloğu, Çin sağlayıcılarından gelen model ailelerinden oluşur. Görevinize göre değil, sadece model adıyla başlayın.

Kodlama ve genel geliştirme

Kataloğunda görülen bir DeepSeek, Qwen, GLM veya Seed kodlama yeteneğine sahip modelden başlayın. Örneğin, kataloğunda deepseek-v4.1-flash, qwen3.8-flash, glm-5.3 veya seed-2.0-code gibi ID'ler bulunabilir. Kullanılabilirlik ve yetenekler değişebilir, bu nedenle yayınlanmadan önce model sayfasını doğrulayın.

Uzun kontekst ve depolar için geliştirme

Büyük depolar veya uzun teknik belgeler için, model kataloğunda gösterilen kontekst uzunluğunu karşılaştırın. Daha büyük bir kontekst penceresi, depolar için daha iyi sonuçlar elde etmenizi sağlayabilir mi? Konteksyon yapısı, araç desteği, çıktı sınırları ve gateway'in istek sınırları da önemli rol oynar.

Araç çağrısı ve agent iş akışları

Araç çağrısı veya araçlar gerektiren bir iş akışı için, model ve sonuç yolu belgelerini kontrol edin. Bazı sağlayıcılar, OpenAI uyumlu API'leri aracılığıyla araç çağrısını sunar, ancak bazıları farklı alan isimleri veya araç davranışının bir alt kümesi destekler. Bir küçük araç çağrısı testinden önce bir gerçek depoya veya dış sistemlere erişim izni verin.

Çin dili geliştirme işleri

Çin dili açık kaynak modelleri, kod tabanı, belgeler, sorun takibi veya takım iş akışında Çin dili içerikli materyaller varsa faydalı olabilir. Modeli kendi prompları ve depolarınızla değerlendirin, genel sıralamalara sadece güvenmeyin.

Claude Code'ı API isteği başarılı olduğunda test edin

API isteği başarılı olduğunda, bir okuma-yazma veya düşük riskli komutu başlatın:

claude -p "Explain what this repository does without editing files."

Sonra, bir dar alanlı görev test edin. Örneğin:

claude -p "List the likely entry points for the web application. Do not modify files."

Güçlü testleri artırarak başlayın:

1. Tek metin yanıtı.
2. Kısa kod açıklaması.
3. Depo navigasyonu.
4. Bir disposable branşta kontrolü yapılan bir düzenleme.
5. Araç kullanımı veya çok adımlı bir görev.
6. Akışlı ve uzun kontekst davranışı.

Tek bir başarılı metin yanıtı, izneler, araç çağrısı, akışlı yanıtlar, kontekst sınırları ve dosya düzenlemesi davranışının Claude Code sesyonuna tam olarak aynı olduğunu garanti etmez.

Doğru API yolu seçimi

Claude Code sadece bir client iş akışıdır. İhtiyacınız olan özellik seti ve uygun API yolu, hangi seçeneği seçmeniz gerektiğini belirler:

ECAIX için, Anthropic Mesajlar belgeleri Anthropic tarzı yolu için ve Chat Completions belgeleri OpenAI uyumlu client'ler için kullanın. Modeller dizini için güncel model ve fiyat sayfası için güncel fiyatları doğrulayın.

Uyumluluk tablosu

Aşağıdaki tablo, yayın tarihi kanıt sınırı olarak, herhangi bir özellikin desteklendiğini iddia etmez: