
magpie
公式収録あらゆるコーディングエージェントにあらゆるモデルを使わせるローカルAPIゲートウェイ。
magpie
magpieはローカルで動くマルチモデルAPIゲートウェイ+コーディングエージェントのモデルスイッチャーです(GitHub yetone/magpie、MITライセンス、Go実装)。特定のペインポイントを解決します。CodexはOpenAI Responsesプロトコルしか話せず、Claude CodeはAnthropic Messagesしか話せず、Gemini CLIはGoogle形式で話します。magpieは127.0.0.1:3425でローカルゲートウェイを起動し、3つのプロトコルすべてを受け付け、双方向に翻訳(ストリーミング、ツール呼び出し、推論を含む)することで、どのエージェントもどのベンダーのモデルでも呼び出せます。
主な機能
- プロトコル翻訳ゲートウェイ:
/v1/chat/completions、/v1/responses、/v1/messages、/v1/messages/count_tokens、/v1beta/models/{model}:generateContent、/v1/modelsなどの標準パスを公開し、カスタムベースURLに対応する任意のクライアントが接続できます(OPENAI_BASE_URL/ANTHROPIC_BASE_URL/GOOGLE_GEMINI_BASE_URL。ゲートウェイキーは任意の値で可) - 外科的なエージェント設定の書き換え: ユーザーが変更したキーだけを変え、コメント、キー順序、インデントをアトミック書き込みで保持します。
~/.claude/settings.json、~/.codex/config.toml、opencode、gooseなどをカバーし、ネイティブモデルへ戻すときは正確に復元します - サブスクリプションの再利用: ログイン済みのClaude Code(Pro/Max/Team)、Codex(ChatGPT Plus/Pro/Business)、Copilot、Grok、Cursor、Devinのセッションをプロバイダーとして使い、そのモデルが他のエージェントのモデルセレクターに
claude/…、codex/…、copilot/…の接頭辞付きで現れ、キーのコピーは不要です - ベンダープリセットと動的モデルリスト: 約20の内蔵プリセット(Anthropic、OpenAI、Gemini、DeepSeek、Kimi、GLM、MiniMax、Qwen、Mistral、Groq、xAI、OpenRouter、Together、Fireworks、SiliconFlow、AiHubMix、302.AI、Ollama、LM Studioなど)。キーがあればベンダーからリアルタイムにモデルリストを取得し、名前と推論レベルはmodels.devディレクトリで補完します
- ルーティンググループとスマートルーティング: 複数のアカウント/キーを1つの
group/<id>に統合し、意図ベースのルーティング(小型モデルの分類器が判定)、逐次、ラウンドロビン、使用頻度最小優先の戦略に加え、レート制限の認識(ベンダーごとのRetry-After)、残高枯渇、フェイルオーバーに対応します - Profiles設定スナップショット: 各エージェントの設定を名前付きプロファイル(「Budget」「Focus」など)として保存し、ワンクリックで一括切り替えできます
- 複数エントリーと軽量: メニューバーのデスクトップアプリ(Wails + システムWebView、Electronではない)、TUI(
magpie tui)、CLI。macOS / Windows / Linuxに対応し、デスクトップ版は15MB未満、ターミナル版は約7MB - 二次的な機能:
magpie://importのインポートリンク(パラメータはURLフラグメントに置かれ、ブラウザがサーバーへ送ることはありません)、利用統計(トークン/キャッシュヒット/コスト)、セルフアップデート、暗号化バックアップ
活用シーン 2つ以上のAIコーディングエージェント(Claude Code + Codex + Gemini CLIなど)を同時に動かし、統一されたモデル切り替えと既存サブスクの再利用を求めるローカル開発者、特にmacOSユーザーに適しています。エージェントが1つだけのユーザーや、コンプライアンスと認証情報のセキュリティに極めて敏感な企業チームには得るものが少ないです。
名称の区別(重要): この項目はyetone/magpie(usemagpie.ai)であり、Windowsの画面拡大鏡であるBlinue/Magpieではなく、magpie.im、magpie.report、AMD Magpie、Postgresやデータツール系の同名Magpieプロジェクト各種でもありません。
リスク警告: (1) 他のエージェントの認証情報ファイルを読み取り、サブスクのログインをエージェント間で再利用し、リセット期間ごとにアカウントを「ウォームアップ」します。README自身が「失ってもよいアカウントを使え」と助言しており、ベンダーの規約違反とアカウントBANのリスクを伴います。(2) サイトの/termsと/privacyはどちらも404で、利用規約もプライバシーポリシーもありません。(3) プロジェクトは極めて初期段階です(リポジトリ作成は2026-09-23、バージョン0.1.x、1日でv0.1.218からv0.1.223へ反復)。(4) 単一メンテナー(作者yetoneが401コミット、他の11人のコントリビューターは各1〜8コミット)で、法人主体もサポートの約束もありません。(5) curl | shでのインストールと無言の自動アップデートがあり、Windows/Linux版は署名なしです。プラス面として、本物の完全なMITのGoソースであり、ゲートウェイはループバックのみでリッスンし、キーは0600権限でローカル保存され、READMEにテレメトリの言及はなく、コミュニティの評判は良好です(1,242スター/69フォーク)。
料金
### 💰 定价模式:完全免费 + 开源(MIT) **起步价**:免费(MIT 开源,无付费层级、无账号体系、无托管云版本) #### 主要方案 - **开源版(本机)**:免费 —— MIT 许可,Go 源码完整公开于 `yetone/magpie`,二进制发布在 `yetone/magpie-releases`。无 per-request 费、无座位上限、无企业规模门槛 - **无托管 / SaaS 版本**:官方**不提供**任何托管代理服务,也没有账号体系,不存在付费档位 - **实际成本**:仅在模型厂商侧——用户自带 API Key,或复用自己已付费的 Claude / ChatGPT / Copilot / Grok 等订阅额度 #### 计费要点 - 官网与文档中**不存在** pricing / plans 页面,也无 Terms / Privacy 页面 - 安装方式完全免费:官网下载、`curl -fsSL https://usemagpie.ai/install.sh | sh`,或 `go install github.com/yetone/magpie@latest` - 第三方来源口径一致:myaiexp 称「magpie itself is free: MIT licensed, open source, no account」,claudeers.com 标注「License MIT, Pricing open-source」 > ⚠️ 已实测 `https://usemagpie.ai/pricing`、`/plans`、`/terms`、`/privacy`、`/sitemap.xml` **全部返回真实 HTTP 404**(非 SPA 软 404,返回空响应体),故 pricing_url 为 null——这是「开源免费、本就没有定价页」,不是抓取失败。
よくある質問
magpieとは何ですか?
magpieは自分のマシン上で動く、マルチモデルAPIゲートウェイ兼コーディングエージェントのモデルスイッチャーです。ローカルゲートウェイを127.0.0.1:3425で起動し、OpenAI、Anthropic、Google GeminiのAPIプロトコル間を双方向に翻訳するため、Codex、Claude Code、Gemini CLIなどのエージェントが使うモデルをひとつのインターフェースから切り替えられます。
OpenRouterやLiteLLMとはどう違いますか?
OpenRouterはクラウド集約サービス(トラフィックとキーがそのサーバーを経由)で、LiteLLMはサーバーサイドのSDK/プロキシ配備に寄ります。magpieは自分のマシンで動くデスクトッププログラムで、ゲートウェイはループバックのみでリッスンし、キーはローカル保存されます。さらにエージェント設定ファイルの外科的な書き換え、ログイン済みサブスクの再利用、メニューバーGUIを提供し、サーバー配備ではなくローカル開発者向けです。
どのプロトコルとベンダーに対応していますか?
プロトコル面では、OpenAI Chat/Responses、Anthropic Messages、Google Gemini間の双方向翻訳に対応(ストリーミング、ツール呼び出し、推論を含み)し、/v1/chat/completions、/v1/responses、/v1/messages、/v1beta/models/{model}:generateContentなどの標準パスを公開します。ベンダー面では約20のプリセットを同梱し、Anthropic、OpenAI、Gemini、DeepSeek、Kimi、GLM、MiniMax、Qwen、Mistral、Groq、xAI、OpenRouter、SiliconFlow、Ollama、LM Studioなどをカバーします。
本当に完全に無料ですか?
はい。magpie自体は完全無料のMITオープンソースで、有料枠もアカウント制度も公式ホストのクラウド版もなく、/pricingや/plansなどのパスは本物の404です。唯一のコストはモデルベンダーへの支払いで、自分のAPIキーを持参するか、すでに払っているサブスクを再利用します。
APIキーはアップロードされますか?
READMEによれば、ゲートウェイはループバック(127.0.0.1:3425)のみでリッスンし、キーは0600権限でローカル保存され、シェルの環境変数は読まず、テレメトリのアップロードにも言及がありません。ただし、サブスク再利用のために他のエージェントの認証情報ファイルを読みます。それが設計なので、その挙動を受け入れられるかは自分で評価してください。
Claude/ChatGPTのサブスクの再利用は安全ですか?
明確なリスクがあります。magpieはサブスクのログインをエージェント間で再利用し、リセット期間ごとにアカウントを「ウォームアップ」します。README自身が「失ってもよいアカウントを使え」と警告しており、ベンダーの利用規約に違反してアカウントBANにつながる可能性があります。公式サイトには利用規約もプライバシーポリシーもなく、頼れるものもありません。
どのシステムに対応していますか?インストール方法は?
macOS、Windows、Linuxに対応します。インストールは3つの方法があります。公式サイトからのダウンロード、curl -fsSL https://usemagpie.ai/install.sh | sh の実行、go install github.com/yetone/magpie@latest。macOS版は署名と公証があり、Windows/Linux版は署名なしから、SmartScreenの警告が出ることがあります。
バージョン番号がまだ低いのはなぜですか?
プロジェクトは非常に初期段階です。GitHubリポジトリは調査時点の5日前の2026-09-23に作られ、バージョンは0.1.xで、1日のうちにv0.1.218からv0.1.223へ移りました。現在は主に作者yetone個人がメンテナーです(401コミット、他のコントリビューターは各1-8コミット)。個人の試用は問題ありませんが、チームはバージョンを固定し、先にコンプライアンスリスクを評価すべきです。