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,
systemve mesaj bloklarınıcache_controlile 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ızdacached_tokensdeğerini kontrol edin. - Token sayımı.
/v1/messages/count_tokensolmadan Claude Code karakter tabanlı bir tahmine geri döner; bu yüzden/contextyaklaşı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_WINDOWdeğ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 permittedifadesini veya biranthropic-betadeğerini anan bir400, üst akıştaki bir şeyin yayın öncesi bir alanı reddettiği anlamına gelir. BelgelerCLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1öneriyor. - Düşünme.
MAX_THINKING_TOKENSve 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_tokenssınırına sayılır. Yanıtlar boş geliyorsa çıktı sınırını yükseltin veyareasoning_effortdeğ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.
