TR ▾
API anahtarı al

getdeepseekapi.comRehber

Claude Code'da DeepSeek API'si Nasıl Kullanılır: Gerçek Seçenekler

Claude Code'da DeepSeek API'sini nasıl kullanacağınızı inceliyorsanız, bilmeniz gereken ilk şey Claude Code'un Anthropic formatında uç noktalarla konuştuğu, bu hizmetin ise OpenAI formatını konuştuğudur. Küçük bir çeviri proxy'si bu boşluğu kapatır ve bu sayfa bunu nasıl kuracağınızı gösterir.

güncellendi

Temel noktalar

  • Claude Code, Anthropic Messages API'sini bekler; bu hizmet OpenAI uyumlu /v1/chat/completions sunar.
  • LiteLLM gibi yerel bir proxy, iki format arasında çeviri yapabilir.
  • Aider, Continue ve Cline, proxy olmadan doğrudan OpenAI uyumlu bir temel URL'yi kabul eder.
  • Bu, DeepSeek'ın resmi API'si değildir: ID'si uncensored olan bağımsız bir açık ağırlıklı modeldir.
Uyuşmayan iki bağlantı noktası, API formatları arasında çeviri yapan bir proxy'yi gösteren parlak bir adaptörle birleştirilmiş

Ne işe yarayacağını ve neyin işe yaramayacağını bilmekle başlayın

İki açıklama bir saatlik karışıklığı önler. Birincisi, bu hizmet resmi DeepSeek API'si değildir ve DeepSeek veya başka bir sağlayıcı için bir yönlendirme sunucusu değildir. uncensored model kimliği altında bağımsız bir sağlayıcı tarafından yönetilen tek bir açık ağırlıklı modeli barındırır. DeepSeek'in kendi modellerine ihtiyacınız varsa, doğrudan DeepSeek'e gidin. İkincisi, Claude Code, Anthropic'ın Messages API'si etrafında tasarlanmıştır. İsteklerin gönderildiği yeri değiştirebilirsiniz, ancak gönderilenler yine Anthropic formatında JSON'dur.

Bu hizmet, OpenAI formatında POST /v1/chat/completions ve GET /v1/models sunar. Claude Code'u doğrudan buna yönlendirmek işe yaramaz, çünkü yollar ve veri yükleri farklıdır. Çözüm bir çeviri katmanıdır. Makinenizde Claude Code'dan Anthropic formatında çağrıları kabul eden ve bunları https://api.getdeepseekapi.com/v1 adresine OpenAI formatında ileten küçük bir proxy çalıştırırsınız. Tam da bu iş için geliştirilmiş araçlar vardır ve bir sonraki bölüm birini kurar.

Başlamadan önce bir beklenti kontrolü. Claude Code, dosyaları okumak, düzenlemek ve komutlar çalıştırmak için fonksiyon çağırma özelliğini yoğun şekilde kullanır. Bu API fonksiyon çağırma özelliğini destekler, akışlı tool_calls dahil, ancak belirli bir modelin uzun bir ajan döngüsünü ne kadar iyi yönettiği varsayılacak bir şey değil, kendi deposunuzda test edilecek bir şeydir.

Bir anahtar alın ve uç noktayı onaylayın

Google veya e-posta ve şifre ile bir hesap oluşturun, ardından API anahtarı sayfasını açın. Yeni kullanıcılar tek tıkla $0,50 deneme kredisi alabilir. 7 gün sürer, ödeme bilgisi gerektirmez ve aşağıdaki her şeyi test etmek için yeterlidir. Bir deneme anahtarının 2 eşzamanlı istek ve dakikada 60 istek izni verdiğini unutmayın; bu, aynı anda birkaç çağrı yapan ajan araçları için önemlidir.

export UNCENSORED_API_KEY="paste-your-key-here"

curl https://api.getdeepseekapi.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'

Bu bir tamamlama döndürürse, üst uç nokta kısmı tamamdır. Geriye kalan tek şey proxy'yi buna bağlamaktır.

Seçenek 1: Claude Code'un önünde bir LiteLLM proxy'si

LiteLLM, Anthropic uyumlu bir uç nokta sunabilen ve OpenAI uyumlu arka uçlara yönlendirebilen bir proxy sunucusu olan açık kaynaklı bir projedir. Ekosistemin bu kısmı hızlı hareket ettiği için güncel özellik seti için belgelerine bakın.

Yükleyin ve yapılandırın

pip install 'litellm[proxy]'

cat > litellm-config.yaml <<'EOF'
model_list:
  - model_name: uncensored
    litellm_params:
      model: openai/uncensored
      api_base: https://api.getdeepseekapi.com/v1
      api_key: os.environ/UNCENSORED_API_KEY
EOF

litellm --config litellm-config.yaml --port 4000

openai/ ön eki, LiteLLM'in OpenAI uyumlu adaptörü kullanmasını sağlar; ardından gelen isim model olarak gönderilir. Terminali çalışır durumda tutun.

Claude Code'u proxy'ye yönlendirin

Claude Code, uç nokta ve kimlik bilgilerini ortam değişkenlerinden okur. İkinci bir terminalde:

export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_AUTH_TOKEN="any-local-string"
export ANTHROPIC_MODEL="uncensored"
export ANTHROPIC_SMALL_FAST_MODEL="uncensored"
claude

Buradaki kimlik doğrulama token'ı yalnızca yerel proxy'nizin beklediği şeydir; gerçek anahtar proxy'nin ortamında kalır. Küçük ve hızlı modeli ayarlamak da önemlidir, çünkü Claude Code hafif arka plan görevleri için ikinci bir model kullanır. Bunu ayarlamazsanız, proxy'nin tanımadığı bir Anthropic model adını çağırmaya çalışabilir. Daha yeni sürümler bu ayara farklı bir ad verebilir, bu nedenle bir değişken yok sayılıyorsa claude --help çalıştırın veya mevcut Claude Code ayarları belgelerine bakın.

Seçenek 2: OpenAI temel URL'sini doğrudan alan araçlar

Hedefiniz Claude Code'un kendisi yerine bir AI kodlama asistanı ise, OpenAI formatını zaten destekleyen birçok araç proxy'yi atlar. Her biri özel bir temel URL ve model adı ayarlamanıza olanak tanır.

  • Aider bir terminal eşli programlama aracıdır. OPENAI_API_BASE ve OPENAI_API_KEY okur ve modeli openai/ ile ön eklersiniz.
  • Continue bir editör uzantısıdır; model girişi bir apiBase ve OpenAI tarzı bir sağlayıcı taşıyabilir.
  • Cline ayarlarında temel URL, anahtar ve model kimliği için alanlar içeren OpenAI Uyumlu bir sağlayıcı sunar.

Aider ile tüm kurulum üç satırdan oluşur:

export OPENAI_API_BASE="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="$UNCENSORED_API_KEY"
aider --model openai/uncensored

Bu araçlar menülerini sık sık değiştirir, bu nedenle yukarıdaki alan adlarını bir rehber olarak kullanın ve her projenin güncel belgelerine başvurun. İhtiyacınız olan değerler hiç değişmez: temel URL https://api.getdeepseekapi.com/v1, anahtarınız ve model kimliği uncensored.

Kendi ince ajan döngünüzü yazın

Tam bir kodlama asistanı gereğinden fazla geldiğinde, fonksiyon çağırma içeren kısa bir betik geniş bir yelpazeyi kapsar. Bu betik, modelin bir dosyayı okumak için istekte bulunmasını ve ardından dosya içeriğini role: "tool" mesajı olarak geri beslemesini sağlar.

import json, os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.getdeepseekapi.com/v1",
    api_key=os.environ["UNCENSORED_API_KEY"],
)

tools = [{
    "type": "function",
    "function": {
        "name": "read_file",
        "description": "Read a text file from the project",
        "parameters": {
            "type": "object",
            "properties": {"path": {"type": "string"}},
            "required": ["path"],
        },
    },
}]

messages = [{"role": "user", "content": "What does main.py do? Read it first."}]

for _ in range(5):
    r = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
    msg = r.choices[0].message
    messages.append(msg)
    if not msg.tool_calls:
        print(msg.content)
        break
    for call in msg.tool_calls:
        args = json.loads(call.function.arguments)
        with open(args["path"]) as f:
            result = f.read()
        messages.append({"role": "tool", "tool_call_id": call.id, "content": result})

Beş yinelemelik döngü sınırı, kafa karışıklığına düşen modelin sonsuza kadar çalışmasını engeller. Gerçek bir araçta, modelin proje dışındaki dosyaları okuyamaması için yolları da doğrulamalısınız.

Hız limitleri, maliyet ve 429 hatalarını düzeltme

Ajan araçları çok sayıda istek gönderir. Tek bir görev, artan bir bağlamı yeniden gönderen onlarca isteği tetikleyebilir. Tam bir anahtarla 8 eşzamanlı istek ve dakikada 300 istek alırsınız. concurrency ile 429, çok fazla çağrının örtüştüğü anlamına gelir ve rate_limited ile 429, dakikada çok fazla istek olduğu anlamına gelir. Kısa süreli aşırı yüklenme sırasında Retry-After: 5 ile 429 göreceksiniz. LiteLLM, bir yeniden deneme ayarı eklerseniz otomatik olarak yeniden deneyebilir; belgelerine bakın.

Maliyet düşüktür çünkü fiyatlandırma 1M girdi tokenı başına $0,15 ve 1M çıktı tokenı başına $0,50'dir. Bir ajan oturumunun, her biri 30.000 token bağlam gönderen ve 600 token geri alan 40 çağrı yaptığını varsayalım. Girdi 1.200.000 token'dır, bu da 1,2 x $0,15 = $0,18'e mal olur. Çıktı 24.000 token'dır, bu da 0,024 x $0,50 = $0,012'ye mal olur. Tüm oturum $0,192'ye mal olur. Bağlam penceresi 100.000 token'dır, bu nedenle yüklediğiniz dosyaları odaklı tutun.

Deneme süresi bittiğinde, bakiyenizi kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile $20 ile $500 arasında tam bir tutardan yükleyin. Bonuslar $50'den +5%, $100'den +10% ve $200'den +15%'dir. Detaylar için fiyatlandırma sayfasına ve belgelere bakın.

Proxy kurulumu için sorun giderme

BelirtiNedenNe denenmeli
Claude Code bilinmeyen model bildiriyorArka plan model adı eşleştirilmemişKüçük hızlı model değişkenini de uncensored olarak ayarlayın
Bağlantı reddedildiProxy çalışmıyor veya port farklıLiteLLM'i başlatın ve ANTHROPIC_BASE_URL içindeki portu eşleştirin
Üst uç noktadan 401Proxy ortamında yanlış anahtarUNCENSORED_API_KEY değerini yeniden dışa aktarın ve proxy'yi yeniden başlatın
Araç çağrıları başarısız oluyor veya döngüye giriyorModel ajan formatıyla zorlanıyorSıcaklığı düşürün, istemi kısaltın veya bunun yerine Aider'ı kullanın
Sık 429 hatasıDeneme anahtarında eşzamanlı istek sınırı 28 eşzamanlı slotlu tam bir anahtar için bakiye yükleyin

Kurulumu güvenli tutmak için iki alışkanlık edinmeniz gerekir. Proxy'yi yalnızca localhost üzerinde çalıştırın, böylece ağınızda başka kimse kredinizi harcayamaz ve gerçek anahtarı sürüm kontrolüne giren bir proje dosyasında değil, proxy'nin ortam değişkenlerinde tutun. Ayrıca ilk uzun oturumunuz sırasında X-Balance-USD yanıt başlığını gözlemleyin, çünkü ajan döngüleri beklediğinizden daha fazla token kullanabilir. Bakiye yukarıdaki tahminden daha hızlı düşerse, eklediğiniz dosyaları kısaltın veya adım sayısını sınırlandırın.

Başarısız olan istekler için ücret alınmaz, bu nedenle deneme yapmak ucuzdur. İstemler eğitim için kullanılmaz. Diğer ağ geçitleriyle karşılaştırma yapmak için API anahtarı genel bakışımızı okuyun.

Sorular ve cevaplar

Claude Code bu API'ye doğrudan bağlanabilir mi?

Hayır. Claude Code, Anthropic'in Messages formatını kullanır ve bu API OpenAI'nin chat completions formatını kullanır. Araya LiteLLM gibi bir çeviri proxy'si koyun.

Bu resmi DeepSeek API'si mi?

Hayır. uncensored kimliği altında bağımsız bir açık ağırlıklı model barındırır ve DeepSeek veya başka herhangi bir satıcı ile bağlantılı değildir.

Proxy olmadan hangi araçlar çalışır?

Aider, Continue ve Cline gibi OpenAI uyumlu bir sağlayıcı ayarı olan araçlar. Temel URL'yi, anahtarı ve model kimliğini uncensored olarak ayarlayın.

Fonksiyon çağırma çalışıyor mu?

Evet, akışlı tool_calls ve role: tool mesajları olarak gönderilen sonuçlar dahil. Modelin bunu nasıl işlediğini görmek için kendi ajan iş akışınızı test edin.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın ve temel URL'yi değiştirin. Kurulum bu kadar basit.

API anahtarı al