Entegrasyon

Claude Code ve Anthropic SDK

BaseLLM, Anthropic Messages API biçiminde de bir uç nokta sunar: POST /api/v1/messages. Claude Code ve Anthropic SDK'sı kullanan uygulamalar adresi değiştirerek BaseLLM üzerinden çalışır. Model izinleri, takma adlar, limitler, bütçe, kişisel veri koruması ve kayıtlar OpenAI uyumlu uç noktadaki gibi uygulanır.

Nasıl çalışır

İstek Anthropic modeline gidiyorsa gövde Anthropic'e istemcinin gönderdiği gibi iletilir. BaseLLM yalnız kendi kurallarının gerektirdiğini değiştirir: model adı, bağlantının sistem istemi, kişisel veri maskesi ve limit politikasının max_tokens sınırı. Düşünme (thinking), görsel, belge, web araması ve Claude Code'un önbellek ayarları olduğu gibi çalışır. BaseLLM'in eklediği süre birkaç milisaniyedir.

İsteği cevaplayacak ilk model başka bir sağlayıcıdaysa (ör. takma ad bir OpenAI modeline bakıyorsa) istek sohbet biçimine çevrilir; o durumda aşağıdaki tablodaki sınırlar geçerlidir.

Şirket içinde kullanıma almadan önce çalışanlara verilecek bilgilendirme için Claude Code için çalışan aydınlatma metni (örnek) sayfasına bakın.

Claude Code bağlantısı

Geliştiricinin bilgisayarında şu değişkenler tanımlanır:

DeğişkenDeğer
ANTHROPIC_BASE_URLhttps://<BaseLLM adresi>/api
ANTHROPIC_API_KEYProjenin API anahtarı (sk-ffm-...)
ANTHROPIC_MODELİsteğe bağlı; ör. claude-sonnet-4-5 ya da projedeki bir takma ad
ANTHROPIC_DEFAULT_HAIKU_MODELİsteğe bağlı; Claude Code'un arka plan işleri için küçük model
ANTHROPIC_CUSTOM_HEADERSİsteğe bağlı; kişi bazlı limit için "X-FFM-User: ayse"

Anahtar x-api-key başlığında ya da Authorization: Bearer ile gönderilebilir.

Şirket genelinde kurulum

Panelde proje sayfasındaki Claude Code sekmesi, geliştirici bilgisayarlarına dağıtılacak managed-settings.json dosyasını hazırlar. Dosya BaseLLM adresini sabitler ve yalnız BaseLLM'e bağlanmaya izin verir (allowedProviders, Claude Code 2.1.285 ve üstü). Sonnet, Opus ve Haiku adlarını projenin Claude modellerine bağlar. Varsayılan olarak Anthropic'e giden yan trafiği (istatistik, hata raporu, geri bildirim) kapatır. Dosya macOS'ta /Library/Application Support/ClaudeCode/, Windows'ta C:\Program Files\ClaudeCode\, Linux'ta /etc/claude-code/ altına konur ya da MDM ile dağıtılır. Ağda api.anthropic.com geliştirici bilgisayarlarına kapatılınca kural kesinleşir.

Tarayıcıdan giriş

Sekmede tarayıcıdan giriş açılırsa geliştiricilere anahtar dağıtmak gerekmez. Dosyayla birlikte bir anahtar betiği (apiKeyHelper) dağıtılır. Claude Code açılınca betik tarayıcıda BaseLLM'in giriş sayfasını açar. Geliştirici şirket hesabıyla girer (LDAP / AD; dizin yoksa BaseLLM hesabı) ve 12 saatlik bir giriş belgesi alır. Süre dolunca yeniden giriş istenir.

  • Girebilecek AD grupları projede tanımlanabilir; tanımlı değilse dizindeki herkes girebilir.
  • Giriş belgesiyle yapılan isteklerde kişi kimliği giriş yapan geliştiricidir. Kişi bazlı bütçe, limit ve kayıtlar bu kimlikle çalışır; X-FFM-User başlığı yok sayılır.
  • Giriş belgesi yalnız Claude Code'un kullandığı uçlarda (Messages API, count_tokens, model listesi) geçerlidir.
  • Yönetici sekmeden bir geliştiricinin oturumunu kapatabilir; belge en geç 30 saniye içinde çalışmaz olur.

Abonelik modu (Team / Enterprise)

Geliştiriciler şirketin claude.ai aboneliğiyle girmeye devam ediyorsa istekler doğrudan Anthropic'e gider; BaseLLM araya girmez. Bu modda koruma geliştiricinin bilgisayarında, Claude Code'un hook'larıyla çalışır. Kurulum sekmesinde "Abonelik" seçilince üretilen managed-settings.json:

  • Her prompt'u BaseLLM'e taratır; kişisel veri varsa prompt gönderilmez ve geliştirici uyarılır (hook prompt'u değiştiremez, yalnız durdurabilir).
  • Okunan dosya, komut ve MCP çıktısını modele gitmeden projenin kişisel veri politikasıyla maskeler.
  • .env, secrets/, *.pem ve *.key okumasını yasaklar; yalnız yöneticinin hook'ları çalışır, BaseLLM erişilemezse işlem durur (Claude Code 2.1.295+).
  • Kullanımı OpenTelemetry ile BaseLLM'e gönderir: kişi bazında oturum, istek, token, maliyet tahmini, satır ve commit; prompt ve cevap metni gelmez.
  • İsteğe bağlı olarak yalnız şirketin Anthropic organizasyonuyla girişe izin verir; ağda anthropic-allowed-org-ids başlığıyla kişisel hesaplar da engellenebilir (Enterprise).

Hook'lar yalnız tarama yapabilen bir guard anahtarıyla gelir; yönetici anahtarı yenileyince eskisi çalışmaz. Masaüstü uygulamasında abonelikle Sohbet ve Cowork için bu koruma yoktur; masaüstünde tam koruma için API anahtarı modunu kullanın.

Projede gerekenler

  • Araç desteği açık olmalı. Claude Code her istekte araç tanımı gönderir; kapalıysa istek tools_not_enabled hatası alır.
  • Claude Code'un istediği model adları projede çözülmeli. Anthropic bağlantısında model seçimini açıp claude-* gibi bir desen verin ya da takma ad tanımlayın. Model seçimi kapalıysa model adı yok sayılır ve projenin ilk modeli cevap verir.
  • Kişi bazlı bütçe ve limit kullanılacaksa her geliştirici kendi X-FFM-User değerini gönderir; kişi imzası açık projede imza da gerekir.

Desteklenen ve desteklenmeyenler

AlanAnthropic modelineBaşka sağlayıcıya
system, messages, max_tokensOlduğu gibiDesteklenir
tools, tool_choiceOlduğu gibiDesteklenir; disable_parallel_tool_use iletilir
streamAnthropic olayları aynenAnthropic olay biçimine çevrilir
temperature, top_p, stop_sequencesOlduğu gibiDesteklenir; en çok 4 durdurma dizisi
thinkingDesteklenir; imzalı bloklar aynen geri giderDesteklenmez; geçmişten çıkarılır
Görsel ve belge bloklarıDesteklenirModele iletilmez; yerine kısa bir not konur
Sunucu araçları (web araması)DesteklenirModele sunulmaz
cache_controlİstemcinin ayarı geçerliÖnbelleği BaseLLM kendisi ayarlar
anthropic-beta başlığıİletilirYok sayılır
POST /api/v1/messages/count_tokensAnthropic'in gerçek sayımıYaklaşık sayı (≈ 4 karakter = 1 token)

Anthropic modeline giden isteklerde yedek model, projenin model zincirindeki Anthropic modelleri arasından seçilir; zincirdeki diğer sağlayıcılar bu isteklerde denenmez, çünkü düşünme blokları ve Anthropic'e özel içerik orada geçersizdir. Claude'un Azure, Bedrock ya da Vertex üzerindeki kopyaları için ayrı Anthropic bağlantısı tanımlanırsa onlar yedek olabilir. Konuşma hafızası, yanıt önbelleği ve akıllı yönlendirme bu yolda devre dışıdır: Claude Code konuşmayı kendisi yönetir, bunlar konuşmayı değiştirirdi.

Kişisel veri koruması görsellerin içindeki yazıyı okuyamaz; görseller olduğu gibi iletilir. Düşünme bloklarına dokunulmaz: Anthropic imzalıdır ve değişirse istek reddedilir. Model zaten maskeli metni gördüğü için bloklarda gerçek değer bulunmaz.

Hatalar

Hatalar Anthropic biçiminde döner: type: error ve error.type (invalid_request_error, authentication_error, rate_limit_error, api_error...). BaseLLM'in kendi hata kodu error.code alanındadır; ör. budget_exceeded, api_key_expired, model_not_allowed.