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ça | Konuşur | Görev |
|---|---|---|
| Claude Code CLI | Anthropic 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 API | OpenAI Chat Completions | Açı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_choiceve akışlıtool_calls, sonuçlarrole: "tool"mesajları olarak döndürülür. - 100.000 token'lık bağlam penceresi, istem ve tamamlama birlikte.
response_formatile 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.
