개발자 리소스

Magpie

Magpie에 RunAPI를 추가하고 Claude Code 또는 Codex에서 사용할 모델을 선택하세요.

설치 및 준비

Magpie에서 최신 안정 버전을 설치하세요. 플랫폼별 설치 방법은 공식 레퍼런스를 따르세요. Claude Code 또는 Codex는 별도로 설치하세요.

인증 가이드에 따라 전용 표준 API 키를 만드세요. 모델 카탈로그에서 모델 ID와 지원 프로토콜을 확인하고 복사하세요. 공급자를 변경하기 전에 에이전트 설정을 백업하세요.

OpenAI 호환 공급자 추가

Chat Completions를 지원하는 모델에는 이 방식을 사용하세요. 명령을 실행하기 전에 두 자리표시자를 모두 바꾸세요. url= 기본 주소는 /v1으로 끝나며 Magpie가 /chat/completions를 덧붙입니다.

SHELL

magpie provider add runapi-chat url=https://runapi.ai/v1 key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID

Anthropic 호환 공급자 추가

Anthropic Messages를 지원하는 모델에는 이 방식을 사용하세요. anthropic= 기본 주소에는 /v1이 없으며 Magpie가 /v1/messages를 덧붙입니다.

SHELL

magpie provider add runapi-anthropic anthropic=https://runapi.ai key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID

먼저 한 가지 방식을 선택하세요. Magpie는 같은 키를 사용하는 두 번째 공급자를 거부합니다. 두 공급자를 모두 유지하려면 각각 다른 전용 RunAPI 키를 만드세요. RunAPI 키는 저장소 외부의 Magpie에 보관하세요.

에이전트에 모델 할당

Magpie를 시작하고 게이트웨이를 계속 실행하세요. Agents 화면에서 Claude Code 또는 Codex를 선택하고 RunAPI 공급자 아래의 모델을 선택하세요. CLI에서도 같은 선택을 할 수 있습니다. 선택한 공급자와 모델 ID로 명령 하나를 실행하세요.

SHELL

magpie serve

다른 터미널에서 모델을 선택하세요.

SHELL

magpie models
magpie claude runapi-chat/YOUR_RUNAPI_MODEL_ID
magpie codex runapi-chat/YOUR_RUNAPI_MODEL_ID

Anthropic 방식에서는 runapi-chat을 runapi-anthropic으로 바꾸세요. Magpie는 로컬에서 provider/model을 사용하고 원래 모델 ID를 RunAPI로 전달합니다. 에이전트는 127.0.0.1:3425의 Magpie에 연결하며 RunAPI 키가 필요하지 않습니다. Codex는 로컬 Responses 인터페이스를 사용하지만, 이것이 RunAPI가 Responses 요청을 받는다는 뜻은 아닙니다. 이 공급자 설정은 RunAPI 측에서 Chat Completions 또는 Messages를 선택합니다.

설정 확인

이 명령으로 공급자와 선택한 모델을 확인한 다음 새 에이전트 세션을 시작하고 짧은 프롬프트를 보내세요.

SHELL

magpie version
magpie providers
magpie claude
magpie codex

RunAPI 사용 기록에서 예상한 모델과 요청을 확인하세요. 에이전트가 정상적으로 응답했다는 사실만으로는 어떤 공급자가 처리했는지 알 수 없습니다. Magpie의 Test models, Detect APIs 및 공급자 테스트는 추론 요청을 보낼 수 있습니다.

설정과 로컬 경로는 Linux에서 Magpie 0.1.1307 및 Claude Code 2.1.295로 확인했습니다. 두 공급자 설정 모두 고정된 로컬 픽스처 응답을 반환했습니다. 이 가이드에서는 실제 RunAPI 추론과 Codex 추론을 테스트하지 않았습니다. 에이전트 작업에 사용하기 전에 선택한 모델의 프로토콜과 도구 지원을 확인하세요.

문제 해결

Magpie가 해당 키로 공급자가 이미 추가되었다고 알리면 해당 공급자를 재사용하거나 두 번째 방식에 다른 전용 키를 사용하세요. 이 오류는 로컬에서 재현되었습니다.

로컬 픽스처 실행에서 설정된 서버를 중지했을 때 connection refused와 함께 no model list가 재현되었습니다. 주소와 서버 가용성을 확인한 다음 정확한 모델 ID로 models=를 사용하세요. 에이전트가 로컬 게이트웨이를 사용하는 동안 Magpie를 계속 실행하세요.

Claude Code는 픽스처 ID에 대해 unrecognized_model을 보고했지만 픽스처 응답은 반환했습니다. 이 경고가 표시되면 원래 모델 ID와 Claude Code의 모델 설정을 확인하세요. 픽스처는 컨텍스트 한도, 도구 호출 또는 모델 품질을 검증하지 않았습니다.

이전 설정 복원

공급자를 제거하기 전에 에이전트를 복원하세요. 이 명령은 각 에이전트를 이전 설정으로 되돌립니다.

SHELL

magpie claude default
magpie codex default
magpie provider rm runapi-chat
magpie provider rm runapi-anthropic

직접 추가한 공급자만 제거하세요. 전용 RunAPI 키가 더 이상 필요하지 않으면 폐기하세요. 수동으로 설정을 추가 변경했다면 백업을 복원하세요.

다음 단계

RunAPI 공개 프로토콜 예시는 LLM API 빠른 시작을, 지원 모델은 모델 카탈로그를 참조하세요. Magpie 공식 레퍼런스에는 Grok Build 연동도 나와 있지만 이 가이드에서는 Grok Build를 테스트하지 않았습니다.