Magpie
RunAPI hizmetini Magpie uygulamasına ekleyin ve Claude Code veya Codex için modellerini seçin.
Kurulum ve hazırlık
Magpie uygulamasının en son kararlı sürümünü yükleyin. Platformunuza özgü kurulum için resmî başvuru belgesini izleyin. Claude Code veya Codex uygulamasını ayrıca yükleyin.
Kimlik doğrulama kılavuzunda özel bir standart API anahtarı oluşturun. Model kataloğundan bir model kimliğini ve desteklediği protokolü kopyalayın. Sağlayıcıyı değiştirmeden önce ajan yapılandırmanızı yedekleyin.
OpenAI uyumlu sağlayıcı ekleme
Chat Completions destekleyen modeller için bu yolu kullanın. Komutu
çalıştırmadan önce her iki yer tutucuyu da değiştirin. url= temel
adresi /v1 ile biter; Magpie buna /chat/completions ekler.
magpie provider add runapi-chat url=https://runapi.ai/v1 key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID
Anthropic uyumlu sağlayıcı ekleme
Anthropic Messages destekleyen modeller için bu yolu kullanın.
anthropic= temel adresinde /v1 bulunmaz; Magpie buna /v1/messages
ekler.
magpie provider add runapi-anthropic anthropic=https://runapi.ai key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID
Önce bir yol seçin. Magpie aynı anahtarla ikinci bir sağlayıcı eklenmesini reddeder. Her iki sağlayıcıyı da tutmak için her birine farklı bir özel RunAPI anahtarı oluşturun. RunAPI anahtarlarını depolarınızın dışında, Magpie içinde tutun.
Ajana model atama
Magpie uygulamasını başlatın ve ağ geçidini çalışır durumda tutun. Agents ekranında Claude Code veya Codex seçin, ardından RunAPI sağlayıcınızın altındaki modeli seçin. CLI da aynı seçimi sunar. Seçtiğiniz sağlayıcı ve model kimliğiyle tek bir komut çalıştırın.
magpie serve
Başka bir terminalde modeli seçin.
magpie models
magpie claude runapi-chat/YOUR_RUNAPI_MODEL_ID
magpie codex runapi-chat/YOUR_RUNAPI_MODEL_ID
Anthropic yolu için runapi-chat yerine runapi-anthropic kullanın.
Magpie yerel olarak provider/model kullanır ve özgün model kimliğini
RunAPI hizmetine iletir. Ajan, 127.0.0.1:3425 üzerinden Magpie
uygulamasına bağlanır; RunAPI anahtarına ihtiyaç duymaz. Codex yerel
Responses arayüzünü kullanır; bu, RunAPI hizmetinin Responses isteği
aldığı anlamına gelmez. Bu sağlayıcı yolları RunAPI tarafında Chat
Completions veya Messages seçer.
Yapılandırmayı doğrulama
Bu komutlarla sağlayıcıyı ve seçili modeli kontrol edin, ardından yeni bir ajan oturumu başlatıp kısa bir istem gönderin.
magpie version
magpie providers
magpie claude
magpie codex
RunAPI kullanım kayıtlarında beklenen modeli ve isteği doğrulayın. Ajanın başarılı yanıt vermesi tek başına isteği hangi sağlayıcının işlediğini kanıtlamaz. Magpie uygulamasındaki Test models, Detect APIs ve sağlayıcı testi çıkarım istekleri gönderebilir.
Yapılandırma ve yerel rotalar Linux üzerinde Magpie 0.1.1307 ve Claude Code 2.1.295 ile kontrol edildi. Her iki sağlayıcı yolu da sabit bir yerel fixture yanıtı döndürdü. Bu kılavuz için gerçek RunAPI çıkarımı ve Codex çıkarımı test edilmedi. Ajan görevlerinde kullanmadan önce seçili modelin protokolünü ve araç desteğini kontrol edin.
Sorun giderme
Magpie bu anahtarla zaten bir sağlayıcı eklendiğini bildirirse mevcut sağlayıcıyı kullanın veya ikinci yol için farklı bir özel anahtar kullanın. Bu hata yerel olarak yeniden üretildi.
Yerel fixture çalıştırmasında, yapılandırılan sunucu durdurulduğunda no model list ve connection refused hatası yeniden üretildi. Adresi ve
sunucunun kullanılabilirliğini kontrol edin, ardından tam model
kimliğiyle models= kullanın. Ajanlar yerel ağ geçidini kullanırken
Magpie uygulamasını çalışır durumda tutun.
Claude Code, fixture kimlikleri için unrecognized_model bildirdi ancak
yine de fixture yanıtını döndürdü. Bu uyarıyı görürseniz özgün model
kimliğini ve Claude Code model yapılandırmasını kontrol edin. Fixture;
bağlam sınırlarını, araç çağrılarını veya model kalitesini doğrulamadı.
Önceki yapılandırmayı geri yükleme
Sağlayıcısını kaldırmadan önce ajanı eski yapılandırmasına döndürün. Bu komutlar her ajanı önceki yapılandırmasına döndürür.
magpie claude default
magpie codex default
magpie provider rm runapi-chat
magpie provider rm runapi-anthropic
Yalnızca eklediğiniz sağlayıcıları kaldırın. Artık ihtiyacınız yoksa özel RunAPI anahtarlarını iptal edin. Elle başka yapılandırma değişiklikleri yaptıysanız yedeğinizi geri yükleyin.
Sonraki adımlar
RunAPI genel protokol örnekleri için LLM API hızlı başlangıç kılavuzuna, desteklenen modeller için Model kataloğuna bakın. Magpie resmî başvuru belgesi Grok Build entegrasyonunu da listeler; bu kılavuz için Grok Build test edilmedi.