맥파이

맥파이는 Codex, Claude Code, Gemini CLI 같은 코딩 에이전트를 원래 회사가 아닌 다른 업체의 모델이나 로컬 모델로 돌리고 싶을 때 쓰는 오픈소스 로컬 게이트웨이다. 에이전트마다 다른 API 형식을 서로 번역해 주고, 각 에이전트가 쓰는 모델을 메뉴 막대 한 곳에서 바꿀 수 있다.

번역 범위에는 스트리밍, 도구 호출, 추론(reasoning)까지 들어간다.

Codex는 OpenAI Responses, Claude Code는 Anthropic Messages, Gemini CLI는 Google 형식만 쓴다. 맥파이는 127.0.0.1:3425에 게이트웨이를 띄워 이 형식들을 서로 바꿔 준다. Go로 만들었고 MIT 라이선스다.

프로바이더 등록 후 클릭 한 번으로 전환

먼저 쓸 모델 업체를 등록한다. 미리 준비된 업체는 magpie provider add deepseek sk-...처럼 키만 넣으면 되고, 로컬 모델은 magpie provider add ollama로 붙인다. 중계 서버는 url, key, models 값을 직접 적어서 추가한다. magpie providers, magpie models로 등록 상태를 확인할 수 있다.

그다음 메뉴 막대 패널을 열면 내 PC의 에이전트 목록과 각자 지금 쓰는 모델이 보인다. 값을 누르면 등록한 모든 모델이 provider/model 형식으로 검색 목록에 뜨고, 고르면 끝이다. 맥파이는 에이전트 설정 파일에서 모델 키 하나만 원자적으로 고쳐 쓰고, 주석·순서·서식은 그대로 둔다. 화면이 없는 서버라면 magpie tui로 터미널에서 같은 작업을 한다.

프로필과 페일오버로 일하는 흐름 지키기

이미 내는 구독도 연결된다

API 키만 되는 게 아니다. 로그인해 둔 Claude, ChatGPT, Copilot, Gemini, Grok 요금제도 프로바이더로 쓸 수 있어서, 이미 돈을 내는 구독을 다른 에이전트에 연결할 수 있다. 지원하는 업체는 40곳이 넘는다.

바뀌는 속도가 빠르다

공개 후 3주 남짓 동안 커밋이 수천 개 쌓일 만큼 빠르게 바뀌고 있다. 업데이트 뒤에는 쓰던 에이전트와 모델 조합이 잘 돌아가는지 다시 확인하는 게 좋다. 구독을 다른 에이전트에 연결해 쓸 때는 그 서비스 약관도 직접 확인해 두자.

익숙한 에이전트는 그대로, 모델만 갈아 끼운다

가장 흔한 방식은 손에 익은 에이전트를 그대로 쓰면서 뒤의 모델만 바꾸는 것이다. 작업 성격이나 남은 할당량에 따라 메뉴 막대에서 모델을 바꾸거나 프로필을 통째로 전환한다.