오픈소스 도구 Magpie: 메뉴바에서 Claude Code와 Codex 모델을 자유롭게 전환

Magpie는 다양한 AI 코딩 에이전트의 모델 전환과 계정 관리를 메뉴바 하나로 통합해 주는 무료 오픈소스 로컬 프록시 도구입니다. Claude Code에서 Kimi를 쓰거나 Codex에서 DeepSeek을 호출하는 작업을 복잡한 설정 파일 수정 없이 손쉽게 처리할 수 있습니다.

어떤 기능을 제공하나

Claude Code, Codex, Gemini CLI 같은 도구들은 각자 다른 위치에 제각각의 포맷으로 설정을 저장합니다. 이 때문에 구독 계정을 다른 에이전트와 공유하기 어렵고, 사용량 한도에 도달하면 터미널 세션이 그대로 튕기는 불편함이 있었습니다.

Magpie는 로컬 머신(127.0.0.1:3425)에 프록시 게이트웨이를 띄워 이 문제를 해결합니다. OpenAI Chat, Anthropic Messages, Gemini 프로토콜 간의 변환을 지원하며 스트리밍, 툴 호출, 추론 출력까지 매끄럽게 중계합니다.

메뉴바에서 원하는 모델을 클릭하면 Magpie가 해당 에이전트의 설정 파일을 원자적으로 수정해 줍니다. Anthropic, OpenAI, DeepSeek, Kimi, Zhipu GLM 등 주요 제공업체 프리셋을 지원하며, 이미 로그인된 Claude나 ChatGPT, Copilot 계정도 감지해 다른 에이전트에서 활용할 수 있게 연결합니다.

라우팅 그룹을 통한 자동 페일오버도 지원합니다. 특정 계정의 쿼터가 소진되면 백그라운드에서 다음 계정이나 대체 모델로 자동 전환되어 작업이 끊기지 않습니다. 갱신 시점이 임박한 계정을 먼저 소진하는 스마트 라우팅 등 세부 옵션도 갖췄습니다.

보안을 위해 로컬 프롬프트 마스킹 기능도 내장했습니다. 기능을 켜면 프롬프트에 포함된 API 키, 비밀번호, 카드번호 등을 컴퓨터 내에서 임시 식별자로 치환해 전송하고, 응답을 받을 때 다시 복원합니다. 주소나 이름 같은 비정형 데이터는 1.6 GB 용량의 로컬 CPU 모델로 감지할 수 있습니다.

어떻게 써볼 수 있나

Magpie는 macOS, Windows, Linux를 모두 지원하며 메뉴바 앱, 데스크톱 창, TUI, 웹 UI, Docker 및 Termux 환경을 지원합니다. macOS 빌드는 공증과 자동 업데이트가 적용되어 있습니다.

공식 웹사이트 usemagpie.ai에서 다운로드하거나 터미널에서 다음 명령어를 실행해 설치할 수 있습니다: curl -fsSL https://usemagpie.ai/install.sh | sh

설치 후 Providers 메뉴에서 API 키나 구독 계정을 추가하고, Agents 탭에서 각 도구에 연결할 모델을 지정하면 바로 적용됩니다. 마스킹 기능은 설정의 개인정보 보호 탭에서 활성화할 수 있습니다.

왜 중요한가

여러 코딩 에이전트를 번갈아 쓰면서 다양한 API 크레딧과 구독을 동시에 굴리는 개발자라면, 흩어져 있던 환경 변수와 계정 관리 문제를 깔끔하게 정리해 주는 Magpie가 매우 유용합니다.

다만 마스킹 기능을 켜면 모델이 실제 토큰 값을 읽을 수 없으므로, 키 오류 자체를 디버깅할 때는 예외 목록에 등록해야 합니다. 평소 단일 에이전트의 공식 구독만 사용하는 사용자라면 굳이 설치할 필요는 없습니다.