Magpie

Utwórz dedykowany standardowy klucz API zgodnie z Przewodnikiem uwierzytelniania. Skopiuj identyfikator modelu i obsługiwany przez niego protokół z Katalogu modeli. Przed zmianą dostawców wykonaj kopię zapasową konfiguracji agenta.

Użyj tego wariantu dla modeli obsługujących Chat Completions. Przed uruchomieniem polecenia zastąp oba symbole zastępcze. Adres bazowy url= kończy się na /v1; Magpie dopisuje /chat/completions.

Użyj tego wariantu dla modeli obsługujących Anthropic Messages. Adres bazowy anthropic= nie zawiera /v1; Magpie dopisuje /v1/messages.

Najpierw wybierz jeden wariant. Magpie odrzuca drugiego dostawcę z tym samym kluczem. Aby zachować obu dostawców, utwórz dla każdego inny dedykowany klucz RunAPI. Przechowuj klucze RunAPI w Magpie, poza repozytoriami.

Uruchom Magpie i pozostaw jego bramę włączoną. Na ekranie Agents wybierz Claude Code lub Codex, a następnie model u swojego dostawcy RunAPI. CLI oferuje ten sam wybór. Uruchom jedno polecenie z wybranym dostawcą i identyfikatorem modelu.

W innym terminalu wybierz model.

Dla wariantu Anthropic zastąp runapi-chat wartością runapi-anthropic. Magpie używa lokalnie provider/model i przekazuje oryginalny identyfikator modelu do RunAPI. Agent łączy się z Magpie pod adresem 127.0.0.1:3425; nie potrzebuje klucza RunAPI. Codex korzysta z lokalnego interfejsu Responses, co nie oznacza, że RunAPI otrzymuje żądanie Responses. Te warianty dostawcy wybierają Chat Completions lub Messages po stronie RunAPI.

Sprawdź dostawcę i wybrany model za pomocą tych poleceń, a następnie rozpocznij nową sesję agenta i wyślij krótki prompt.

Potwierdź oczekiwany model i żądanie w rejestrach użycia RunAPI. Sama poprawna odpowiedź agenta nie dowodzi, który dostawca ją obsłużył. Funkcje Test models, Detect APIs oraz test dostawcy w Magpie mogą wysyłać żądania inferencji.

Konfigurację i lokalne trasy sprawdzono z Magpie 0.1.1307 oraz Claude Code 2.1.295 w systemie Linux. Oba warianty dostawcy zwróciły stałą odpowiedź lokalnej atrapy testowej. Na potrzeby tego przewodnika nie testowano rzeczywistej inferencji RunAPI ani inferencji Codex. Przed użyciem modelu do pracy z agentami sprawdź jego protokół i obsługę narzędzi.

Jeśli Magpie informuje, że dostawca z tym kluczem został już dodany, użyj go ponownie lub zastosuj inny dedykowany klucz dla drugiego wariantu. Ten błąd odtworzono lokalnie.

Uruchomienie lokalnej atrapy testowej odtworzyło no model list z connection refused, gdy skonfigurowany serwer był zatrzymany. Sprawdź adres i dostępność serwera, a następnie użyj models= z dokładnym identyfikatorem modelu. Pozostaw Magpie uruchomione, gdy agenci korzystają z jego lokalnej bramy.

Claude Code zgłosił unrecognized_model dla identyfikatorów atrapy testowej, ale mimo to zwrócił jej odpowiedź. Jeśli zobaczysz to ostrzeżenie, sprawdź oryginalny identyfikator modelu i konfigurację modelu w Claude Code. Atrapa nie weryfikowała limitów kontekstu, wywołań narzędzi ani jakości modelu.

Przywróć agenta przed usunięciem jego dostawcy. Te polecenia przywracają poprzednią konfigurację każdego agenta.

Usuń tylko dodanych przez siebie dostawców. Unieważnij dedykowane klucze RunAPI, jeśli już ich nie potrzebujesz. Przywróć kopię zapasową, jeśli wprowadzono dodatkowe ręczne zmiany konfiguracji.

Przykłady publicznych protokołów RunAPI znajdziesz w Szybkim starcie LLM API, a obsługiwane modele w Katalogu modeli. Oficjalna dokumentacja referencyjna Magpie wymienia również integrację z Grok Build; Grok Build nie był testowany na potrzeby tego przewodnika.