TR ▾

Ana SayfaRehber

Claude Code Proxy Kurulumu: OpenAI Uyumlu API ile

Bu claude code proxy kurulumu beş adım alır: bir anahtar alın, bir LiteLLM yapılandırması yazın, proxy'yi başlatın, iki ortam değişkeni ayarlayın ve bir test çalıştırın. Yaklaşık on dakika sürer.

Bir terminalden bir sunucuya uzanan, adım adım proxy kurulumunu gösteren beş parlak basamak

Temel noktalar

  1. https://api.claudecodeproxyapi.com/v1 adresine yönlendirme yapan yerel bir LiteLLM proxy'si çalıştırın
  2. Claude Code'u ANTHROPIC_BASE_URL ve ANTHROPIC_AUTH_TOKEN ile proxy'ye yönlendirin
  3. Claude Code'un gönderdiği model adını upstream model uncensored'a eşleyin
  4. CLI'yi başlatmadan önce proxy'yi curl ile test edin

İhtiyacınız olanlar

  • Anahtar sayfası'ndan bir API anahtarı. Google veya e-posta ve şifre ile kaydolun, ardından tek tıkla $0,50 deneme kredisi talep edin.
  • Proxy'yi yüklemek için Python 3.9 veya üzeri.
  • Makinenizde Claude Code yüklü ve çalışır durumda.

Neden bir proxy? Claude Code Anthropic Messages formatını kullanır ve API'miz model ID uncensored ile OpenAI Chat Completions formatını kullanır. Proxy bunlar arasında çeviri yapar. Arka planı önce okumak isterseniz proxy hata ayıklama kılavuzuna bakın. Model bir Claude değil, açık ağırlıklı bir modeldir; bu nedenle zor çok adımlı görevlerde farklı davranış bekleyin.

Adım 1: proxy'yi yükleyin

Bağımlılıkların projelerinizden ayrı kalması için sanal bir ortam kullanın:

python3 -m venv ~/litellm-env
source ~/litellm-env/bin/activate
pip install 'litellm[proxy]'

LiteLLM, üçüncü taraf açık kaynaklı bir yazılımdır. Aşağıdaki komutlar ve yapılandırma anahtarları, yazım anındaki genel belgelerine uygundur; ancak bir bayrak değişmişse güncel belgeleri kontrol ediniz.

Adım 2: yapılandırmayı yazın

config.yaml dosyasını oluşturun. model_name, istemcinin gönderdiği addır. litellm_params bloğu, nereye yönlendirileceğini belirtir. openai/ ön eki, LiteLLM'in bir OpenAI uyumlu sunucuya bağlanmasını sağlar.

cat > config.yaml <<'EOF'
model_list:
  - model_name: claude-sonnet
    litellm_params:
      model: openai/uncensored
      api_base: https://api.claudecodeproxyapi.com/v1
      api_key: os.environ/UPSTREAM_KEY
EOF

claude-sonnet takma adı bir örnektir, gereklilik değildir. Claude Code, bir ana model ve arka plan görevleri için daha küçük bir model gibi birkaç farklı model adı gönderebilir. Proxy günlüğünde gördüğünüz her ad için bir model_list girdisi ekleyin ve hepsini aynı upstream'e yönlendirin. Her takma adı uncensored'ye yönlendirmek, yalnızca bir model olduğu için sorun değildir.

Anahtar bir ortam değişkeninden okunur, böylece commit edebileceğiniz bir dosyaya düşmez.

Adım 3: proxy'yi başlatın

export UPSTREAM_KEY="YOUR_KEY"
litellm --config config.yaml --port 4000

Bu terminali açık bırakın. Sunucunun 4000 portunda dinlediğini görmelisiniz. Şimdi, Claude Code'un göndereceği Anthropic formatındaki bir test isteği ile proxy tarafından upstream yolunu kontrol edin:

curl http://localhost:4000/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: sk-local-anything" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet",
    "max_tokens": 200,
    "messages": [{"role": "user", "content": "Reply with the word ready."}]
  }'

İçeriğinde "ready" kelimesi geçen bir JSON yanıtı, çevirinin uçtan uca çalıştığını gösterir: Anthropic formatı içeri, OpenAI formatı https://api.claudecodeproxyapi.com/v1'a ve geri. LiteLLM yapılandırmasında bir master anahtar ayarlarsanız, sk-local-anything yerine onu kullanın.

Adım 4: Claude Code'u proxy'ye yönlendirin

Claude Code API adresini ve token'ı ortam değişkenlerinden okur. Bunları CLI'yi başlattığınız kabukta ayarlayın:

export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_AUTH_TOKEN="sk-local-anything"
export ANTHROPIC_MODEL="claude-sonnet"
claude

CLI kendi yolunu eklediği için proxy adresini /v1 soneki olmadan kullanın. Token yalnızca proxy'yi memnun etmelidir, çünkü gerçek upstream anahtarı UPSTREAM_KEY olarak dışa aktardığınız anahtardır. Ortam değişkenleri için kabuk yerine CLI'nin ayarlar dosyasını kullanıyorsanız, aynı üç adı oraya yazın. Claude Code için ortam değişkeni adları sürümler arasında değişebilir, bu nedenle bir şey yok sayılırsa güncel Claude Code belgelerine göre doğrulayın.

Adım 5: ilk görevi çalıştırın ve logları izleyin

Küçük başlayın. CLI'den bir dosyayı açıklamayı veya bir fonksiyona yorum eklemeyi isteyin. Proxy terminalinde adım başına bir istek görmelisiniz. Beliren her model adını not edin; eğer biri model_list içinde değilse, proxy bir hata döndürür, bu yüzden onu ekleyip yeniden başlatın.

Araç çağırma burada önemlidir, çünkü CLI dosyaları okur ve kodu araçlar aracılığıyla düzenler. API tools, tool_choice ve akışlı tool_calls destekler ve proxy bunları dönüştürür. Bir araç şemasına zayıf uyum, başarısız bir düzenleme veya tekrarlanan adım olarak görünür. Bu olduğunda, kurulumun bozuk olduğuna karar vermeden önce görevi kısaltıp tekrar deneyin.

Bağlam penceresi 100.000 token kapasitesindedir; istem ve tamamlama birlikte. Bu sınırı aşan uzun oturumlar başarısız olur, bu yüzden yeni bir görev için yeni bir oturum başlatın. Maliyetler çok düşüktür: 1M girdi token başı $0,15 ve 1M çıktı token başı $0,50'dir. 20.000 token giren ve 800 token çıktı veren bir istek $0,003 + $0,0004 = $0,0034 tutarındadır. Bakiye yüklemek için fiyatlandırma sayfasına bakın; bu sitede ödemeler kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile yapılır.

Sorun Giderme

Ne görürsünüzNedenÇözüm
Bağlantı reddedildiProxy çalışmıyor veya port farklıBaşlatın ve portu ANTHROPIC_BASE_URL ile eşleştirin
Proxy 404 veya "model bulunamadı"CLI'nin gönderdiği model adı yapılandırmada yokBu adı model_list'e ekleyin
Upstream 401Yanlış veya boş UPSTREAM_KEYAnahtarı proxy'nin kabuğunda yeniden dışa aktarın ve yeniden başlatın
concurrency ile 4298'den fazla eşzamanlı istek (deneme süresinde 2)Eşzamanlı ajanları azaltın
rate_limited ile 429Dakikada 300 istekten fazla (denemede 60)Geri çekilin ve yeniden deneyin
429 ile Retry-After: 5Geçici aşırı yüklenmeBeş saniye sonra tekrar deneyin
Takılı akışAkışlı bir istek, sonlanana kadar slotunu tutarSlotu serbest bırakmak için CLI'de iptal edin

Burada kapsanmayan her şey için, destek yazarken X-Request-Id yanıt başlığını ekleyin. dokümantasyon her desteklenen parametreyi listeler.

Kalıcı hale getirin

Her seferinde exports yazmak sıkıcı olur. Proxy başlatmasını küçük bir betiğe ve istemci değişkenlerini bir takma ada yazın, böylece tek komut her şeyi başlatır:

cat > ~/start-proxy.sh <<'EOF'
. ~/litellm-env/bin/activate
export UPSTREAM_KEY="YOUR_KEY"
exec litellm --config ~/config.yaml --port 4000
EOF
chmod +x ~/start-proxy.sh

alias claude-uncensored='ANTHROPIC_BASE_URL=http://localhost:4000 ANTHROPIC_AUTH_TOKEN=sk-local-anything ANTHROPIC_MODEL=claude-sonnet claude'

Değişkenler yalnızca o tek komut için ayarlandığından, normal claude komutu varsayılan ayarlara karşı çalışmaya devam eder. Takma adı kabuk profilinize ekleyin. Betiği dosya izinleri (örneğin chmod 700) ile koruyun, çünkü anahtarı içerir.

Geri geçiş

Değişkenleri mevcut kabukta dışa aktardıysanız, unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL çalıştırın ve CLI'yi yeniden başlatın. API tarafında hiçbir şey değişmedi, bu nedenle geri alınacak bir şey yok.

Bakiyenizi ve harcamalarınızı izleyin

API'den gelen her yanıt X-Balance-USD taşır; bu, anahtarınızdaki kalan kredidir. Bazı kurulumlarda LiteLLM upstream başlıklarını geçirebilir, ancak bakiyenizi görmek için en kesin yol, ara sıra doğrudan upstream'e istek göndermektir:

curl -i https://api.claudecodeproxyapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY" | grep -i x-balance-usd

Agent oturumları sessizce büyür. Her adım, çalışan bağlamı yeniden gönderir; bu nedenle uzun bir oturum, kısa bir oturuma göre istek başına daha yüksek maliyete neden olur. Her görev için yeni bir oturum başlatmak, girdiyi küçük ve faturayı düşük tutar. Yayınlanan fiyatlarla (1M girdi başına $0,15 ve 1M çıktı başına $0,50), 50.000 token girdisi ve 1.000 token çıktısı olan bir istek 50.000 x $0,15 / 1M = $0,0075 artı $0,0005, yani $0,008'e mal olur. Yirmi böyle istek toplam $0,16 eder.

Bakiye yükleme işlemleri $20 ile $500 arasında tam miktarlarda yapılır ve bu sitede kripto (USDT, USDC) ile ödenir. Kredi süresi dolmaz, bu nedenle +%5, +%10 veya +%15 bonuslu daha büyük bir bakiye yükleme, bakiyenize bir süre eklemez.

Sorular ve cevaplar

Claude Code için proxy hangi ortam değişkenlerini gerektirir?

Proxy adresi için ANTHROPIC_BASE_URL ve proxy'nin kabul ettiği bir token için ANTHROPIC_AUTH_TOKEN. ANTHROPIC_MODEL, tanımladığınız takma adın adını içerebilir. Değişiklikler için güncel Claude Code dokümantasyonunu kontrol edin.

ANTHROPIC_BASE_URL'e /v1 eklemeli miyim?

Hayır. CLI uygulaması kendi yolunu eklediğinden proxy adresini (örneğin http://localhost:4000) kullanın. /v1 yalnızca proxy yapılandırmasındaki upstream api_base'e aittir.

LiteLLM dışındaki bir proxy kullanabilir miyim?

Evet. Anthropic Messages isteklerini OpenAI Chat Completions'a dönüştüren herhangi bir proxy çalışır; örneğin claude-code-router. Upstream'i https://api.claudecodeproxyapi.com/v1 adresine ve model olarak uncensored'a ayarlayın.

Upstream anahtarım yapılandırmada güvende mi?

Yukarıdaki yapılandırmada gösterildiği gibi, anahtarı bir dosyaya değil bir ortam değişkeninde tutun. Anahtarı bir depoya commit etmeyin.

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.