TR ▾

Ana SayfaRehber

Claude Code Proxy: OpenAI Uyumlu LLM API'si Kullanın

Bir Claude Code proxy'si, CLI ile model API'si arasında yer alan ve istekleri çeviren küçük bir sunucudur. Buna ihtiyacınız vardır çünkü Claude Code Anthropic formatını konuşur ve bu API OpenAI formatını konuşur.

Bir terminal ile sunucu arasında bir kutu, proxy'nin iki API formatı arasında istekleri dönüştürürken gösteriliyor

Temel noktalar

  1. Claude Code Anthropic tarzı istekler gönderir; bu API OpenAI tarzı istekleri kabul eder
  2. LiteLLM gibi bir çeviren proxy ortada oturur ve model adlarını eşler
  3. Arkadaki model Claude olmayan bir açık ağırlıklı modeldir, bu yüzden kendi görevlerinizde test edin
  4. Girişte 20.000 token ve çıkışta 800 token ile 30 isteklik bir kodlama oturumu yaklaşık $0,10'a mal olur

Proxy'nin yaptığı iş

Bir Claude Code proxy'si, Anthropic'ın kodlama CLI'si ile yanıt veren model arasında çalıştırdığınız herhangi bir sunucudur. Claude Code, API adresi için bir ortam değişkeni okur ve isteklerini oraya gönderir. Bu adres bir proxy ise, proxy gerçekten ne olduğunu belirler: trafiği günlüğe kaydedebilir, kurallar ekleyebilir veya çağrıyı farklı bir modele yönlendirebilir.

Kilit detay iletim formatıdır. Claude Code, Anthropic'ın Messages formatını kullanır. https://api.claudecodeproxyapi.com/v1 API'si, model kimliği uncensored ile OpenAI Chat Completions formatını kullanır. İkisi ruh olarak benzerdir ancak birbirinin yerine kullanılamaz, bu nedenle bizim URL'mizi doğrudan Claude Code'a yapıştıramazsınız. Bir çeviri katmanının, akış parçaları ve araç çağrıları dahil her isteği ve her yanıtı yeniden yazması gerekir.

Nerede ne oturur

ParçaKonuşurGörev
Claude Code CLIAnthropic Messages formatıDüzenlemeleri planlar, araçları çağırır, diff'leri gösterir
Çeviren proxy (yerel)Her iki formatİstekleri ve akışları dönüştürür, model adlarını eşler
Bu APIOpenAI Chat CompletionsAçık ağırlıklı modeli çalıştırır, token başına faturalandırma yapar

Topluluk projeleri ara kısmı halleder. LiteLLM'in proxy'si ve claude-code-router, bu amaç için genel erişime açık şekilde belgelenmiş iki örnektir. İkisi de üçüncü taraf yazılımdır, bu nedenle üzerine inşa etmeden önce desteklenen sürümler ve flag'ler için mevcut dokümantasyonlarını kontrol edin. Yolda bir şeyler ters giderse, proxy sorun giderme kılavuzu başlangıç noktanızdır ve bu site ayrıca ayrı bir adım adım kurulum makalesine de sahiptir.

Kurmadan önce: model konusunda dürüst olun

Claude Code, Anthropic'ın kendi modelleri etrafında oluşturulmuştur. Farklı bir modele geçmek davranışı değiştirir ve hiçbir proxy bunu gizleyemez. Buradaki model, bağımsız bir sağlayıcı tarafından yürütülen ve yasal yetişkin kullanım için içerik reddi olmadan yanıt verecek şekilde ayarlanmış bir açık ağırlıklı modeldir. Claude değildir ve Anthropic'ın veya başka bir satıcının resmi bir API'si değildir.

Agent tarzı işler için size şunları verir:

  • Fonksiyon çağırma ile tools, tool_choice ve akışlı tool_calls, sonuçlar role: "tool" mesajları olarak döndürülür.
  • 100.000 token'lık bağlam penceresi, istem ve tamamlama birlikte.
  • response_format ile JSON modu ve SSE üzerinden akış.

Kendiniz doğrulamanız gerekenler: uzun bir ajan döngüsünü ne kadar iyi takip ettiği, ne sıklıkla hatalı fonksiyon çağrıları yaptığı ve dilinizi ve çerçevenizi nasıl ele aldığıdır. Tüm bir iş akışını taşımadan önce deponuzdan üç veya dört gerçek görev çalıştırın. Kayıttan sonra tek tıkla talep edilen $0,50 deneme kredisi bunun için yeterlidir.

Üst akışı önce test edin

Claude Code'a dokunmadan önce, agent'lar buna bağlı olduğu için bir araç çağrısı dahil düz bir istekle API tarafının çalıştığını onaylayın:

curl https://api.claudecodeproxyapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the files in the src folder."}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "list_files",
        "description": "List files in a directory",
        "parameters": {
          "type": "object",
          "properties": {"path": {"type": "string"}},
          "required": ["path"]
        }
      }
    }],
    "tool_choice": "auto"
  }'

İyi bir yanıt, tool_calls girişinde list_files ve bir JSON argüman dizesi içerir. Bunu görürseniz, üst akım hazırdır ve sonraki tüm sorunlar proxy veya CLI yapılandırmasına aittir.

İki rota ve ne zaman seçeceğiniz

Rota 1: Claude Code için çeviren bir proxy

Claude Code arayüzünü, izin istemlerini ve iş akışını beğeniyor ve arkasında farklı bir model istiyorsanız bunu seçin. Proxy'yi yerel olarak çalıştırın, CLI'yi ona yönlendirin ve CLI'nin gönderdiği model adlarını uncensored ile eşleyin. Tam değişkenler dokümantasyonda ve kurulum makalesinde ele alınmıştır.

Rota 2: zaten OpenAI konuşan bir istemci

Aider, Continue ve Cline dahil birçok açık kaynaklı kodlama asistanı ve editör uzantısı, herhangi bir OpenAI uyumlu uç noktasını doğrudan kullanabilir. Base URL'yi, anahtarı ve model adını girersiniz ve sürdürülecek bir çeviri katmanı yoktur. Özellikle Claude Code arayüzüne ihtiyacınız yoksa, bu daha kısa bir yoldur ve kırılabilen parçalar daha azdır.

Bir kural olarak: modelin kod üzerinde hızlı bir denemesi için 2. rotayı seçin ve ekibiniz zaten Claude Code iş akışına bağlı olduğunda 1. rotayı seçin.

Bir kodlama oturumunun maliyeti

Ajanlar çok fazla bağlamı yeniden gönderir, bu nedenle girdi tokenları faturayı belirler. 30 isteklik bir oturum alın, her biri 20.000 girdi tokenı (dosyalar, geçmiş, fonksiyon çıktısı) ve 800 çıktı tokenı ile:

  • Girdi: 30 x 20.000 = 600.000 token, bu da 0,6 x $0,15 = $0,09
  • Çıkış: 30 x 800 = 24.000 token, bu da 0,024 x $0,50 = $0,012
  • Toplam: $0,102

Fiyatlar 1M girdi tokenı başına $0,15 ve 1M çıktı tokenı başına $0,50'dir. Faturalandırma ön ödemeli krediden yapılır, abonelik yoktur, başarısız veya reddedilen istekler için ücret alınmaz ve kredi süresi dolmaz. Bakiye yükleme $20 ile $500 arasındadır, $50'den +%5, $100'den +%10 ve $200'den +%15 bonuslar vardır. Bu site kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile bakiye yüklemeyi kabul eder. Fiyatlandırma sayfası tam tabloyu içerir ve anahtar sayfası Google veya e-posta ile kayıt yapabileceğiniz yerdir.

Agent döngülerini etkileyen limitler

Tam bir anahtar 8 eşzamanlı istek ve dakikada 300 istek izni verir. Deneme anahtarı dakikada 2 eşzamanlı ve 60 istek izni verir. Alt görevleri dağıtan ajanlar eşzamanlılık sınırına ilk olarak ulaşabilir. API ardından HTTP 429 yanıtını concurrency koduyla verir, istek hızı sınırı ise rate_limited döndürür. Geçici bir aşırı yüklenme de Retry-After: 5 ile 429 döndürür. İyi bir proxy gecikmeden sonra 429'da yeniden dener ve akışlı bir istek, akış bitene kadar slotunu tutar, bu nedenle takılan akışlar sizin aleyhinize sayılır.

İstek gövdesi 8 MB'a kadar olabilir. Aracınız büyük dosyaları istemlere yapıştırıyorsa bunu göz önünde bulundurun ve tüm istemi 100.000 tokenlık bağlam penceresinin altında tutun.

Yerel proxy için güvenlik notları

Bir proxy, üst akış anahtarınızı tutar, bu nedenle onu herhangi bir kimlik bilgisi gibi ele alın. Diğer makinelerin buna ulaşması gerçekten gerekmedikçe, tüm ağ arayüzlerine değil, yalnızca localhost'a bağlayın. Anahtarı sürüm kontrolüne giren bir dosyada değil, bir ortam değişkeninde veya bir gizli bilgi yöneticisinde saklayın. Bir proxy'yi bir ekip arasında paylaşıyorsanız, üst akış anahtarına dokunmadan onu değiştirebilmeniz için kendi ana anahtarını verin.

Ayrıca bir ajanın ne gönderdiğini de unutmayın. Bir kodlama CLI'si dosya içeriklerini, komut çıktılarını ve istemlerinizi modele iletir. İstemler burada eğitim için kullanılmaz, ancak özel anahtarlar ve .env dosyaları gibi gizli bilgileri ajanın okuyabildiği çalışma dizininden uzak tutmalısınız.

Modeli kodunuzda değerlendirmek için adil bir yol

Gerçek bir depodan artan zorlukta üç görev seçin: tek dosyalık bir düzeltme, üç dosyayı etkileyen bir değişiklik ve testlerle küçük bir yeniden düzenleme. Her birini aynı istemle iki kez çalıştırın, birini mevcut modelinizle ve birini uncensored ile, ve dört şey hakkında notlar tutun: düzenlemeler temiz uygulandı mı, fonksiyon çağrıları ayrıştırıldı mı, kaç yeniden deneme gerekti ve her çalıştırma neye mal oldu. Bunun için harcanan bir saat, herhangi bir liderlik tablosundan daha fazla şey söyler.

Açık ağırlıklı model en zor görevde yetersiz kalırsa, yine de testler hazırlama, commit mesajları yazma veya yabancı kodu açıklama gibi daha ucuz işler için uygun olduğunu bulabilirsiniz. Faturalandırma abonelik olmadan, ön ödemeli krediden kullandıkça öde esasıyla yapıldığından, yalnızca bu işler için kullanmanın bir cezası yoktur.

Sorular ve cevaplar

Claude Code, proxy olmadan bu API'yi kullanabilir mi?

Hayır. Claude Code Anthropic formatında istekler gönderir ve bu API OpenAI formatında istekleri kabul eder, bu nedenle aralarında bir çeviri katmanı gerekir.

Model, Claude gibi davranacak mı?

Hayır. Bağımsız bir sağlayıcıdan açık ağırlıklı bir modeldir. Ona güvenmeden önce kendi görevlerinizde test edin.

API fonksiyon çağırmayı destekliyor mu?

Evet. Araçları, tool_choice'u ve akışlı tool_calls'i destekler ve sonuçları role: tool mesajları olarak döndürürsünüz.

Proxy'den daha kolay bir seçenek var mı?

Evet. Aider, Continue veya Cline gibi OpenAI uyumlu bir uç nokta kabul eden kodlama asistanları, base URL'ye doğrudan bağlanabilir.

Denemek ne kadara mal olur?

Yeni kullanıcılar kayıt sonrası tek tıkla $0,50 deneme kredisi alabilir. 7 gün boyunca geçerlidir ve kart gerektirmez.

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

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