BroadRouter
Başlayın

Claude Code ile açık modeller: proxy, yerel uç noktalar ve sınırlar

BroadNet Inference ekibi · 6 dk okuma · Yayımlandı

Claude Code, Anthropic Messages API isteklerini ANTHROPIC_BASE_URL adresine gönderir. OpenAI uyumlu bir sağlayıcı kullanmak için LiteLLM gibi çeviri yapan bir proxy çalıştırıp Claude Code'u ona yönlendirin ya da DeepSeek veya Z.ai gibi kendi Anthropic biçimli uç noktası olan bir sağlayıcı seçin. Anthropic, Claude Code'da Claude dışı modelleri desteklemiyor; araçları, önbelleklemeyi ve bağlam sınırlarını kendiniz test edin.

Claude Code her isteği Anthropic Messages API biçiminde, ANTHROPIC_BASE_URL neyi gösteriyorsa onun /v1/messages yoluna gönderir. BroadNet Inference dahil açık model sağlayıcılarının çoğu ise OpenAI biçimini konuşur. Bu yüzden ya ikisi arasında çeviri yapan bir proxy’ye ya da kendi Anthropic biçimli uç noktasını yayımlayan bir sağlayıcıya ihtiyacınız var. Bu yazı ikisini de ve buna değip değmeyeceğini belirleyen sınırları ele alıyor.

Claude Code neden OpenAI uyumlu bir API’yi doğrudan çağıramıyor?

Claude Code’un ağ geçidi uyumluluk rehberi, bir ağ geçidinin sunması gereken biçimleri listeliyor. Düz bir temel URL için bu Anthropic Messages’tır: /v1/messages, isteğe bağlı olarak /v1/messages/count_tokens, ve iletilen anthropic-beta ile anthropic-version başlıkları. OpenAI uyumlu bir API ise farklı bir istek ve yanıt yapısıyla /v1/chat/completions sunar. Claude Code’u doğrudan böyle bir API’ye yönlendirirseniz istekler başarısız olur.

Başlamadan önce bilmeniz gereken bir şey daha var. Claude Code’un kendi belgeleri, Anthropic’in “doesn’t support routing Claude Code to non-Claude models through any gateway” (BroadRouter çevirisi: Claude Code’u herhangi bir ağ geçidi üzerinden Claude dışı modellere yönlendirmeyi desteklemediğini) söylüyor. Birçok kişi yine de yapıyor, ama Anthropic’te kimse bunu sizin için ayıklamayacak.

Üç seçeneğiniz nedir?

Yol Nasıl çalışır En uygun olduğu durum Ödünleşim
Çeviri yapan proxy (LiteLLM) Claude Code yerel bir proxy’ye Anthropic biçiminde konuşur; proxy OpenAI uyumlu sağlayıcıyı çağırır BroadNet gibi belirli bir OpenAI uyumlu sağlayıcıyı kullanmak Çalıştırılıp güncellenecek bir süreç daha; çeviri boşlukları
Yerel Anthropic biçimli uç nokta Sağlayıcı /v1/messages isteklerini kendisi kabul eder Geliştiricilerinden DeepSeek veya GLM modelleri Her biri bazı alanları eşler veya yok sayar
Farklı bir ajan OpenAI uyumlu temel URL kabul eden bir ajan kullanın Özellikle Claude Code’a ihtiyacı olmayan herkes Claude Code’un arayüzünden ve özelliklerinden vazgeçersiniz

Claude Code LiteLLM üzerinden nasıl çalıştırılır?

LiteLLM’in Anthropic dışı modeller için eğitimi şöyle işler: proxy’yi kurun, modelleri config.yaml içinde tanımlayın, başlatın, ardından Claude Code’da iki değişken ayarlayın. LiteLLM biçimler arasında çeviri yaptığı için Claude Code Anthropic istekleri göndermeye devam eder.

BroadNet modellerini LiteLLM rehberindeki gibi openai/ öneki ve api_base ile tanımlayın:

model_list:
  - model_name: glm
    litellm_params:
      model: openai/broadnet/glm-5.3
      api_base: https://inference.broadnet.ai/v1
      api_key: os.environ/BROADNET_API_KEY
      rpm: 30
  - model_name: qwen
    litellm_params:
      model: openai/broadnet/qwen3.8-27b
      api_base: https://inference.broadnet.ai/v1
      api_key: os.environ/BROADNET_API_KEY
      rpm: 30

general_settings:
  master_key: os.environ/LITELLM_MASTER_KEY

Proxy’yi başlatın:

uv tool install 'litellm[proxy]'
export BROADNET_API_KEY='your-broadnet-key'
export LITELLM_MASTER_KEY='sk-any-local-secret'
litellm --config config.yaml   # listens on http://0.0.0.0:4000

Ardından Claude Code’u ona yönlendirin. ANTHROPIC_AUTH_TOKEN, LiteLLM’in okuduğu biçim olan Authorization: Bearer başlığı olarak gönderilir:

export ANTHROPIC_BASE_URL=http://0.0.0.0:4000
export ANTHROPIC_AUTH_TOKEN="$LITELLM_MASTER_KEY"
export ANTHROPIC_MODEL=glm                  # main model
export ANTHROPIC_DEFAULT_HAIKU_MODEL=qwen   # background tasks
export ANTHROPIC_DEFAULT_SONNET_MODEL=glm   # the sonnet alias
export ANTHROPIC_DEFAULT_OPUS_MODEL=glm     # the opus alias
export CLAUDE_CODE_SUBAGENT_MODEL=glm       # subagents
claude

Claude Code’da /status çalıştırın. Anthropic base URL satırı proxy adresini göstermeli.

Model değişkenleri önemli. LiteLLM’in Claude Code sayfası, yapılandırmanızda tanımlı olmayan yerleşik bir Claude adını seçmenin “Invalid model name passed in” (BroadRouter çevirisi: geçersiz model adı iletildi) hatasıyla sonuçlandığı konusunda uyarıyor. Claude Code’un ortam değişkenleri referansına göre ANTHROPIC_DEFAULT_HAIKU_MODEL arka plan işlevleri için de kullanılıyor; bu yüzden onu da eşleyin, yoksa arka plan istekleri proxy’nin tanımadığı bir Haiku adı ister. CLAUDE_CODE_SUBAGENT_MODEL alt ajanlar için varsayılan modeli belirler, ancak Claude’un bir alt ajan başlatırken ilettiği model (çoğu zaman sonnet veya haiku gibi bir takma ad) önceliklidir. sonnet ve opus takma adlarını da eşlemek, bu isteklerin de proxy’nin tanıdığı bir modele çözülmesini sağlar. BroadNet anahtarınızı proxy’nin ortamında tutun; asla bir projenin depoya işlenen .claude/settings.json dosyasına koymayın.

Hangi DeepSeek ve GLM uç noktaları proxy olmadan çalışır?

İki model geliştiricisi Anthropic biçimli temel URL’ler yayımlıyor:

Sağlayıcı Temel URL Model işleme (belgelerinden, 2026-11-15’te kontrol edildi)
DeepSeek https://api.deepseek.com/anthropic claude-sonnet* ve claude-haiku* adları deepseek-flash’a, claude-opus* adları deepseek-v4-pro’ya eşlenir; claude ile başlamayan adlar 400 döndürür
Z.ai (GLM Coding Plan) https://api.z.ai/api/anthropic Anahtar ANTHROPIC_AUTH_TOKEN içinde; manuel kurulum örneği Opus ve Sonnet’i glm-5.3[1m]’e, Haiku’yu glm-5.3-flash[1m]’e eşliyor

DeepSeek’in 10 Eylül 2026 tarihli sürüm notu, deepseek-flash adının DeepSeek-V4.1-Flash’ı sunduğunu söylüyor. Anthropic API sayfası ayrıca yok saydıklarını listeliyor: diğerlerinin yanı sıra cache_control, budget_tokens, disable_parallel_tool_use ve anthropic-version başlığı. deepseek-flash’ta asistan mesajlarındaki görseller 400 döndürüyor; deepseek-v4-pro ise görselleri “[Unsupported Image]” metniyle değiştiriyor.

Claude Code’da yalnızca DeepSeek veya GLM istiyorsanız bu yerel uç noktalar en kısa yoldur. İkisinin fiyatları ve plan sınırları Claude API alternatifleri sayfasında karşılaştırılıyor.

Claude dışı bir modelde neler bozulur veya değişir?

Çeviri isteklerin akmasını sağlar, ama Claude Code’un bazı özellikleri bir proxy’nin veya başka bir modelin aktarmayabileceği şeylere dayanır. Claude Code’un belgeleri bunları sayıyor:

  • İstem önbellekleme. Claude Code, system ve mesaj bloklarını cache_control ile işaretler. Ağ geçidi veya üst akış (upstream) bunu düşürürse hata olmaz, ama her tur önbelleksiz girdi olarak faturalandırılır. OpenAI uyumlu bir üst akışta önbellekleme o sağlayıcının kendi kurallarına göre işler. BroadNet, usage bloğu bir önbellek isabeti bildirdiğinde önbellekli girdiyi daha düşük fiyattan faturalandırır; kayıtlarınızda cached_tokens değerini kontrol edin.
  • Token sayımı. /v1/messages/count_tokens olmadan Claude Code karakter tabanlı bir tahmine geri döner; bu yüzden /context yaklaşık değer gösterir.
  • Bağlam penceresi. Claude Code, tanımadığı model adlarına kendi varsayılan penceresini uygular. Modele uyması için CLAUDE_CODE_AUTO_COMPACT_WINDOW değerini (100.000 ile 1.000.000 token arası) ayarlayın. 262.144 token bağlamlı Qwen3.8 27B için bunu bu değerin epey altına ayarlayın.
  • Bilinmeyen alanlar. Extra inputs are not permitted ifadesini veya bir anthropic-beta değerini anan bir 400, üst akıştaki bir şeyin yayın öncesi bir alanı reddettiği anlamına gelir. Belgeler CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 öneriyor.
  • Düşünme. MAX_THINKING_TOKENS ve uyarlanabilir düşünme Claude özellikleridir. BroadNet’te DeepSeek V4.1 Flash, GLM 5.3 ve Qwen3.8 27B yanıt vermeden önce akıl yürütür ve bu akıl yürütme token’ları max_tokens sınırına sayılır. Yanıtlar boş geliyorsa çıktı sınırını yükseltin veya reasoning_effort değerini low gönderin. Bkz. akıl yürütme modelleri neden boş yanıt döndürür.
  • Görseller. GLM 5.3, BroadNet’te yalnızca metin destekler. Ekran görüntüsü yapıştırıyorsanız Qwen3.8 27B kullanın.

Güvenmeden önce dosya düzenlemeleri, kabuk komutları ve uzun bir oturumla gerçek bir görevi uçtan uca test edin.

Claude Code’un arkasında hangi BroadNet modeli durmalı?

Claude Code dosyaları araç çağrıları üzerinden okur, düzenler ve komut çalıştırır. BroadNet’in API referansı araçları, yapılandırılmış çıktıyı ve akıl yürütmeyi iki model için belgeliyor:

Model 1M token başına girdi / çıktı Bağlam Görsel Araçlar belgelenmiş
GLM 5.3 $0.78 / $3.46 1.048.576 Hayır Evet
Qwen3.8 27B $0.175 / $2.17 262.144 Evet Evet
DeepSeek V4.1 Flash $0.175 / $0.52 1.048.576 Evet Belgelenmemiş

Büyük depolar için doğal ana model GLM 5.3. Qwen3.8 27B girdi token’ı başına daha ucuz ve görseller ile daha hafif arka plan çağrıları için iş görür. İkisi de bakiye yükleme gerektirir; $5 başlangıç kredisi kapsamında değiller. GLM 5.3 ve Qwen3.8 27B karşılaştırması ikisini yan yana gösteriyor.

BroadNet’in sabit fiyatlı planını Claude Code ile kullanabilir misiniz?

Belgelenmiş bir kullanım değil ve bunu satın almadan önce bilmek daha iyi. Full Moon, Orbit ve Meteor planları yalnızca DeepSeek V4.1 Flash’ı kapsıyor ve BroadNet bu model için araç çağırmayı belgelemiyor. Ayrıca her plan oturumu aynı anda tek istek çalıştırır. Claude Code ana döngünün yanında alt ajanlar ve arka plan görevleri çalıştırabilir; bu istekler tek bir oturumda sıraya girer.

İstediğiniz sabit bir fiyatsa, BroadNet’in planla birlikte belgelediği bir ajan kullanın; örneğin Aider. Claude Code için kullandıkça öde GLM 5.3 veya Qwen3.8 27B kullanın; bunlar anahtar başına dakikada 30 isteğe ve aynı anda 4 uçuştaki isteğe izin verir. 429 aldığınızda hatalar ve yeniden denemeler rehberindeki gibi geri çekilin.

Farklı bir ajan ne zaman daha iyi seçimdir?

Claude Code’un kendisine ihtiyacınız yoksa proxy’yi atlayın. opencode, Cline, Roo Code, Continue ve Aider; OpenAI uyumlu temel URL’yi, anahtarı ve model kimliğini doğrudan alır. Her birinin alan adları kodlama ajanlarında açık modeller yazısında; opencode ve Cline için kurulum rehberleri de var. Daha az hareketli parça, daha az çeviri hatası demektir. Bu iş için modelleri karşılaştırmak için kodlama ajanları için en iyi açık model yazısına bakın.

İşiniz genişletilmiş düşünme (extended thinking), Anthropic istem önbellekleme veya en yeni Claude Code betaları gibi Claude’a özgü özelliklere bağlıysa Claude modellerinde kalın. Bu durumda modeli değiştirmek yerine Claude Code içinde maliyetleri düşürün.

BroadNet Inference nereye oturuyor?

BroadNet Inference OpenAI uyumlu bir API’dir; bu yüzden Claude Code’a yalnızca LiteLLM gibi bir proxy üzerinden ulaşır. Bir proxy’nin arkasında GLM 5.3 ve Qwen3.8 27B, araç çağırması belgelenmiş iki modeldir; token başına faturalandırılır ve istekten sonra hiçbir içerik saklanmaz. Yerel bir Anthropic biçimli uç nokta istiyorsanız DeepSeek ve Z.ai daha basit. BroadNet’in sabit planını istiyorsanız onu OpenAI biçimini konuşan bir ajanla eşleştirin.

Sık sorulan sorular

Claude Code DeepSeek ile kullanılabilir mi?

Evet, iki yolla. DeepSeek, claude-sonnet ve claude-haiku adlarını deepseek-flash'a, claude-opus adlarını deepseek-v4-pro'ya eşleyen Anthropic biçimli bir temel URL yayımlıyor: https://api.deepseek.com/anthropic. Ya da DeepSeek modellerini barındıran OpenAI uyumlu herhangi bir sağlayıcının önüne LiteLLM gibi çeviri yapan bir proxy koyarsınız.

Claude Code OpenAI uyumlu bir API ile çalışır mı?

Doğrudan çalışmaz. Claude Code, Anthropic Messages API isteklerini /v1/messages adresine gönderir. LiteLLM gibi bir proxy bu istekleri kabul edip OpenAI tarzı bir /chat/completions uç noktasına iletir, ardından yanıtı geri çevirir.

Claude Code'u başka modellerle kullanmak Anthropic tarafından destekleniyor mu?

Hayır. Claude Code'un ağ geçidi belgeleri, Anthropic'in Claude Code'u herhangi bir ağ geçidi üzerinden Claude dışı modellere yönlendirmeyi desteklemediğini söylüyor. Pratikte birçok kişi için çalışıyor, ama bu yoldaki hataları ayıklamak size kalıyor.

Claude Code'un arkasında hangi BroadNet modelini kullanmalıyım?

GLM 5.3 veya Qwen3.8 27B. BroadNet araç çağırmayı yalnızca bu ikisi için belgeliyor ve Claude Code dosyaları araçlar üzerinden düzenleyip komut çalıştırıyor. GLM 5.3'ün bağlamı 1.048.576 token; Qwen3.8 27B'ninki 262.144 ve görsel kabul ediyor.

Claude Code'u BroadNet'in sınırsız planıyla çalıştırabilir miyim?

Belgelenmiş bir kullanım değil. Sabit planlar yalnızca DeepSeek V4.1 Flash'ı kapsıyor ve BroadNet bu model için araç çağırmayı belgelemiyor. Ayrıca bir plan oturumu aynı anda tek istek çalıştırırken Claude Code alt ajanları paralel çalıştırabilir.

Claude Code LiteLLM üzerinden neden Invalid model name diyor?

Claude Code, config.yaml dosyanızda tanımlı olmayan bir model adı istedi; çoğu zaman yerleşik bir Claude takma adı veya arka plandaki Haiku modeli. ANTHROPIC_MODEL ve ANTHROPIC_DEFAULT_HAIKU_MODEL değişkenlerini model_list içindeki adlara ayarlayın.

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor