---
title: Magpie | RunAPI
description: RunAPI hizmetini Magpie uygulamasına ekleyin ve Claude Code veya Codex
  için modellerini seçin.
url: https://runapi.ai/tr/docs/resources/tool-integrations/magpie.md
canonical: https://runapi.ai/tr/docs/resources/tool-integrations/magpie
locale: tr
---

> HTML sürümü: https://runapi.ai/tr/docs/resources/tool-integrations/magpie
> Ajanlar için site dizini: https://runapi.ai/llms.txt

# Magpie

## Kurulum ve hazırlık

[Magpie][1] uygulamasının en son kararlı sürümünü yükleyin.
Platformunuza özgü kurulum için [resmî başvuru belgesini][2] izleyin.
Claude Code veya Codex uygulamasını ayrıca yükleyin.



[1]: https://usemagpie.ai
[2]: https://github.com/yetone/magpie/blob/main/docs/reference.md

[Kimlik doğrulama kılavuzunda](https://runapi.ai/tr/docs/guides/authentication.md) özel bir
standart API anahtarı oluşturun. [Model kataloğundan](https://runapi.ai/tr/models) 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](https://runapi.ai/tr/docs/guides/llm-api/quickstart.md), desteklenen modeller için
[Model kataloğuna](https://runapi.ai/tr/models) bakın. Magpie resmî başvuru belgesi Grok
Build entegrasyonunu da listeler; bu kılavuz için Grok Build test
edilmedi.

---

## RunAPI hakkında daha fazlası

- [Ana sayfa](https://runapi.ai/tr/.md)
- [Model Kataloğu](https://runapi.ai/tr/models.md)
- [Fiyatlandırma](https://runapi.ai/tr/pricing.md)
- [Sağlayıcılar](https://runapi.ai/tr/models)
- [Dokümantasyon](https://runapi.ai/tr/docs/guides)
- [SDK'lar](https://runapi.ai/tr/sdk.md)
- [CLI](https://runapi.ai/tr/cli.md)
- [MCP Sunucusu](https://runapi.ai/tr/mcp.md)
- [x402](https://runapi.ai/tr/x402.md)
- [Claude Code ve Cursor](https://runapi.ai/tr/claude-code-vs-cursor.md)
- [Cursor API kurulumu](https://runapi.ai/tr/cursor-api-setup.md)
- [RunAPI ve OpenRouter](https://runapi.ai/tr/openrouter-alternative.md)
- [Kurumsal](https://runapi.ai/tr/contact.md)
- [İletişim](https://runapi.ai/tr/contact.md)
- [Şartlar](https://runapi.ai/tr/terms.md)
- [Gizlilik](https://runapi.ai/tr/privacy.md)
- [Ajanlar için site dizini](https://runapi.ai/llms.txt)

İletişim: contact@runapi.ai

## Yapılandırılmış veriler

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "tr",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/tr",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/tr/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "tr",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/tr",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/tricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "tr",
    "@type": "TechArticle",
    "headline": "Magpie",
    "description": "RunAPI hizmetini Magpie uygulamasına ekleyin ve Claude Code veya Codex için modellerini seçin.",
    "url": "https://runapi.ai/tr/docs/resources/tool-integrations/magpie",
    "mainEntityOfPage": "https://runapi.ai/tr/docs/resources/tool-integrations/magpie"
  }
]
```
