magpie の使い方：Claude Code と Codex にローカルゲートウェイを導入（2026 年 11 月）
2026-11-10 時点の magpie 公式ドキュメント（usemagpie.ai）によると、Claude Code で magpie を使う手順は三つです。インストールコマンドを実行して magpie を起動し、Providers で自分の API キーを使ってプロバイダーを追加し、magpie claude に「プロバイダー/モデル」を付けて実行してモデルを選びます。新しいモデルは次のセッションから反映されます（Codex は magpie codex を使い、Codex アプリを再起動します）。magpie（yetone/magpie）はお使いのパソコン上の 127.0.0.1:3425 で動くローカルゲートウェイで、OpenAI Chat、OpenAI Responses、Anthropic Messages、Gemini の四つの API を相互に変換します。MIT ライセンスのオープンソースで、Apache Magpie とは無関係です。QCode の三つのアドレスとコマンドは以下にあります。
更新日 2026-11-10
このツールを QCode エンドポイントに接続。Claude・GPT・中国系モデルを 1 キーで。
- トークン単位の課金・最新単価は /models
- カード（Visa / Mastercard）・Apple Pay・Google Pay・暗号資産で支払い可能
- チャージ後すぐにセルフサービスで開通
公式情報にある四つの事実
MIT ライセンスのオープンソース（作者 yetone）
yetone/magpie リポジトリは MIT License を採用しています（Copyright (c) 2026 yetone）。README の末尾には、magpie は Apache Magpie とも Apache Software Foundation とも無関係であると書かれています。
ローカルゲートウェイのアドレス
ゲートウェイは OpenAI Chat、OpenAI Responses、Anthropic Messages、Gemini を扱い、相互に変換します。ストリーミング、ツール呼び出し、推論内容も含まれます。
対応プラットフォームと形態
README によれば、macOS、Windows、Linux で動作します（メニューバーアプリ、ウィンドウ、TUI、Web UI、CLI）。Docker や Termux でも動かせます。
キーの保存場所
キーは ~/.config/magpie/providers.json に保存され、読めるのはあなただけです。magpie はシェル環境変数からキーを読み取ることはありません。追加したものがそのまま使われます。
magpie とは？
2026-11-10 時点で、magpie のドキュメントは magpie を「各エージェントが使うモデルを一か所で選べるもの」と説明しています。お持ちのプロバイダーを追加し、エージェントごとにモデルを選ぶと、magpie がそのエージェント自身の設定ファイルに書き込みます。その背後には、お使いのマシンの 127.0.0.1:3425 で動く小さなゲートウェイがあり、OpenAI、Anthropic、Gemini の API を扱って相互に変換します。そのため Claude Code のように Anthropic Messages しか扱えないエージェントでも、GPT や中国のモデルを使えます。作者は yetone、サイトは usemagpie.ai、リポジトリは yetone/magpie です。
インストールとアンインストールのコマンド
2026-11-10 時点で、公式のインストールコマンドは curl -fsSL https://usemagpie.ai/install.sh | sh です。magpie コマンドは ~/.local/bin に、アプリは Mac では /Applications、Linux ではアプリメニューに入ります。go install github.com/yetone/magpie@latest でも導入できます。Windows では最新リリースの magpie-windows-amd64.exe（ARM は magpie-windows-arm64.exe）をダウンロードします。magpie.exe は同じコマンドを受け付け、ターミナル専用版は magpie-cli-windows-amd64.exe です。Docker イメージ ghcr.io/yetone/magpie もあり、詳しくは公式の Docker ドキュメントをご覧ください。アンインストールは curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall を実行します。magpie はまず各エージェントを切り離して元の設定に戻し、~/.config/magpie の設定とプロバイダーは残します。--purge を付けるとそれらも削除されます。
タイムライン
yetone/magpie リポジトリが GitHub 上に作成されました。
QCode のドキュメントが magpie と Claude Code、Codex の動作確認を終え、docs.qcode.cc に magpie 導入記事を公開しました。
QCode がその日の magpie ターミナル版で再テストし、magpie provider add の一行で QCode を追加でき、provider test では三つのアドレスすべてが応答しました。同日に README、公式ドキュメント（Get started、Add to magpie、Docker、Claude Code と Codex のモデルページ）、リファレンス、GitHub のリリースも確認しました。ドキュメントによれば magpie は一日に数回リリースされます。
ドキュメントに書かれていることと、書かれていないこと
公式ドキュメントに明記されていること
① magpie 経由でモデルを使う場合、ゲートウェイはアプリとともに動きます。② 実行中のセッションは開始時のモデルを使い続けます。エージェントは起動時に設定を読むため、新しいモデルは次のセッションから反映され、Codex は Codex アプリの再起動も必要です。③ モデルを選ぶと、エージェントの設定のうち magpie が必要とするキーだけが変わります。コメント、順序、インデントは保たれ、書き込みはアトミックです。④ Claude Code：magpie は ~/.claude/settings.json の ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN を書き込みます。このトークンはゲートウェイのキーで、プロバイダーのキーではありません。Codex：~/.codex/config.toml の [model_providers.magpie] テーブルとモデルを書き込みます。⑤ OPENAI_BASE_URL や ANTHROPIC_BASE_URL を自分で export する必要はありません。⑥ インポートリンクは Add を押すまで何も保存せず、同じ id が既にある場合はボタンが Replace になります。⑦ magpie のモデルは Claude Code と Codex 自身の /model 一覧にも表示され（Claude Code では via magpie と表示）、エージェントの中からも切り替えられます。
ドキュメントで明示されていないこと
2026-11-10 時点：① 公式ホームページは macOS の最低バージョンを二通りに書いています（macOS 12+ と macOS 11 or later）。ダウンロード時に表示される要件に従ってください。② README の対応エージェント一覧は Get started の一覧より長く、今も増えています。お使いのエージェントが認識されるかどうかは magpie ls の出力で確認できます。③ 公式の import ページは、models パラメータがない場合はプロバイダーの /v1/models が返すモデルを一覧にすると説明しています。QCode が 2026-11-10 に試したところ、models= を指定せずに追加すると最初の 24 個だけが公開されました（出力は 24 exposed of 28）。追加後に magpie provider models で使うモデルを選んでください。
プロバイダーを追加する三つの方法
インポートリンクまたはアプリ
インポートリンクは magpie://import? にパラメータを付けたものです。Web では同じパラメータで https://usemagpie.ai/import# を使い、各値を URL エンコードします。項目は name（または preset）、chat、responses、anthropic、gemini、key、models です。リンクに key がない場合は、ダイアログで貼り付けます。アプリでは Providers → Add provider が入口です。
ターミナルでの一行コマンド
プリセットなら magpie provider add にプリセット id とキーを付けるだけです（公式の例は deepseek と sk-…）。独自アドレスは url=（OpenAI 互換）、anthropic=（Anthropic 互換）、responses=、models=、key= で指定します。ターミナルで magpie import にリンクを渡すと、まず概要を表示して確認を求め、-y で確認を省けます。QCode のドキュメントの実測では、キーのないリンクはターミナルではプレビューだけで保存されないため、ターミナルでは magpie provider add を使うのがいちばん早い方法です。
magpie の設定：インストール、プロバイダー追加、Claude Code と Codex へのモデル選択
① インストール：macOS と Linux では curl -fsSL https://usemagpie.ai/install.sh | sh を実行し、Windows では magpie-windows-amd64.exe をダウンロードします。その後 magpie を起動してゲートウェイを動かします。② プロバイダーを追加：Providers タブで ＋ Add provider を押し、プリセットならキーを貼り付けるだけ、それ以外のアドレスは Custom · any compatible URL を選びます。ターミナルでの書き方は上のターミナルのカードに、QCode 用の完全なコマンドは後述します。③ モデルを選ぶ：Agents タブでエージェントのモデルをクリックするか、magpie claude deepseek/deepseek-v4-pro や magpie codex deepseek/deepseek-v4-pro を実行します。magpie 経由のモデル名は「プロバイダー/モデル」の形です。④ 新しいセッションを始めると、エージェントが新しい設定を読み込みます。Codex は Codex アプリの再起動も必要です。⑤ 確認：magpie ls で各エージェントの現在の設定を一覧でき、magpie provider test にプロバイダー id を付けると API ごとにごく小さなリクエストを一つずつ送り、遅延を表示します。⑥ エージェント本来の設定に戻すには magpie claude default または magpie codex default を実行します。
magpie に QCode を追加する
2026-11-10 時点で、QCode の magpie 記事は三つのアドレスを挙げています。anthropic は https://api.qcode.cc/api、chat は https://api.qcode.cc/openai/v1、responses は https://api.qcode.cc/openai です（magpie の例では responses が /v1 で終わりますが、QCode のエンドポイントページには /openai/responses と /openai/v1/responses は同等と明記されています）。Claude は anthropic アドレス、GPT は chat と responses、中国のモデルは anthropic か chat を通ります。アジアと北米の接続ポイントではドメインを asia.qcode.cc または us.qcode.cc に替え、パスはそのままです。いちばん簡単なのはコンソールの「CC Switch / magpie に取り込む」ボタンで、その中の「magpie に取り込む」を押せば Claude と GPT が一度に設定されます。あとは magpie claude qcode/claude-sonnet-5-5 や magpie codex qcode/gpt-6.1-sol でモデルを選びます。メインモデルだけを設定すると Claude Code の opus スロットも同じモデルになるため、Opus を使うには magpie claude opus qcode/claude-opus-5-5 も実行します。QCode のキーはプロトコルに依存しないので、一つのキーで Anthropic と OpenAI の両方の互換インターフェースを使え、Claude Code や Codex などで共用できます。課金はトークン単位で、モデルごとの単価は /models にあります。月額プランをご希望でない場合は、クォータパックが $4 から。7 日以内に使い切る一度限りの枠です。個人プランをお使いで枠が足りないときはブースターパックを追加できます。
よくある質問
magpie で切り替えても反映されないのはなぜですか？
多くの場合、セッションを開き直していないことが原因です。実行中のセッションは開始時のモデルを使い続け、新しいモデルは次のセッションから反映されます。Codex は Codex アプリの再起動も必要です。次にゲートウェイが動いているか確認します。magpie 経由でモデルを使う間、ゲートウェイはアプリとともに動き、magpie healthcheck が終了コード 0 を返せばゲートウェイは応答しています。magpie ls で各エージェントの現在の設定を、magpie provider test でプロバイダーが応答するかを確認できます。そのほかのエラーは /magpie-errors-and-fixes にまとめています。
magpie は常に開いておく必要がありますか？
magpie 経由でモデルを使う場合は、はい。ゲートウェイはアプリとともに動きます。ウィンドウを閉じてもメニューバーやトレイに残って動き続けます。magpie tray はアイコンだけを起動し、magpie serve はゲートウェイだけを動かし、magpie daemon install はサービスとして常駐させます（Linux は systemd、Mac は launchd）。エージェントが自分のモデルを使う場合は magpie を経由しません。
magpie はキーをどこに保存し、安全ですか？
キーは ~/.config/magpie/providers.json に保存され、読めるのはあなただけです。magpie はシェルの環境変数からキーを読み取りません。ドキュメントによれば、エージェントからあなたのキーは見えません。Claude Code の設定にある ANTHROPIC_AUTH_TOKEN はゲートウェイのキーです。Web のインポートリンクはパラメータを # の後ろに置き、ブラウザはその部分をサーバーに送りません。さらにプライバシーマスキングがあり、有効にするとプロンプト内のキー、パスワード、メールアドレスがリクエスト送信前にパソコン上でプレースホルダーに置き換えられ、応答で元に戻されます。初期状態ではオフで、Settings → Privacy で有効にします。
magpie をアンインストールする、または元の設定に戻すには？
元に戻すには：magpie claude default または magpie codex default を実行します。magpie は書き込んだ内容を削除し、置き換えた元の値（例えば以前の ANTHROPIC_BASE_URL）を復元します。スクリプトでインストールしたものをアンインストールするには、curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall を実行します。設定とプロバイダーは ~/.config/magpie に残り、--purge を付けるとそれらも削除されます。
magpie と CC Switch は併用できますか？
併用できます。magpie の作者 yetone は 2026-11-09 に X で両方を併用してもよいと返信しており、README にも magpie の Import で CC Switch のプロバイダーを取り込めると書かれています。どちらも Claude Code と Codex の設定ファイルを書き換えるので、役割分担と併用時に注意する設定は比較ページ /magpie-vs-cc-switch をご覧ください。
magpie に QCode を追加するには？
三つの方法から選べます。いちばん早いのはコンソールの「magpie に取り込む」ボタンです。ターミナルでは magpie provider add QCode anthropic=https://api.qcode.cc/api url=https://api.qcode.cc/openai/v1 responses=https://api.qcode.cc/openai key=cr_xxx を実行します。QCode の 2026-11-10 のテストでは、この一行で追加できました。アプリでは Providers → Add provider で Custom を選び、OpenAI 互換のアドレス（chat）と Anthropic 互換のアドレス（anthropic）、cr_ から始まるキーを入力します。models= を指定しないと magpie は最初の 24 個のモデルだけを公開するため、magpie provider models qcode gpt-6.1-sol claude-sonnet-5-5 claude-opus-5-5 claude-haiku-5-5 のように使うモデルを選びます（+ を付けないと一覧全体が置き換わります）。GPT モデルを先頭にすると、magpie provider test の chat、responses、anthropic の三行すべてに ✓ が表示されます。保存済みの QCode のキーを替えるには、magpie provider key に qcode と新しいキーを付けて実行します。
情報源
GitHub の yetone/magpie リポジトリの README、LICENSE、リファレンス、GitHub API、magpie-releases のリリース情報、usemagpie.ai のトップページ、公式ドキュメントの Get started、Add to magpie、Docker、Claude Code と Codex のモデルページ（いずれも 2026-11-10 に確認）、magpie の作者 yetone による 2026-11-09 の X での返信。QCode：docs.qcode.cc の magpie 記事と接続ポイントのページ、qcode.cc/models、qcode.cc/pay-as-you-go（2026-11-10 取得）、QCode が 2026-11-10 に magpie のターミナル版で行ったテスト。コンソールの取り込みボタンの文言は QCode のサイトの文言によります。
関連記事
クォータパック
一度限りの枠を 7 日間使えるパックで、サブスクリプションは不要です。モデルごとの単価は /models にあります。
magpie と CC Switch の選び方
動作、対応クライアント、プロトコル変換、フェイルオーバー、プライバシーマスキング、ライセンスの比較と、それぞれの QCode 接続方法。
magpie が動かない：401・405 エラーの原因と対処（2026-11）
magpie のよくあるエラーの公式の原因と対処：切り替えが反映されない、Docker の 401、ZCode の 405、provider test の 400、モデルが見えない。
暗号資産チャージガイド
9 通貨・56 ネットワーク、手数料 0 で AI コーディング API クレジットを購入。
記載内容は 2026-11-10 に magpie のリポジトリ、サイト、ドキュメントと照合しており、公式ページを優先します。確認に使ったバージョン：QCode の 2026-11-10 のテストは magpie 0.1.3533 で行いました。magpie は一日に数回リリースされるため、メニュー名やコマンドはお使いのバージョンに従います。QCode のモデルの提供状況は /models に準じます。