İçeriğe geç
Geliştirici Kaynakları
Geliştirici Kaynakları

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.

SHELL
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.

SHELL
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.

SHELL
magpie serve

Başka bir terminalde modeli seçin.

SHELL
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.

SHELL
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.

SHELL
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.