magpie をチームで共有：ゲートウェイキー、LAN 共有、複数台の同期（2026 年 11 月）
magpie をチームや複数のパソコンで使うには？ 2026-11-10 時点の magpie 公式リファレンスによると、ゲートウェイを動かすパソコンで Settings → Network and sharing → Share on local network をオンにし、同僚やパソコンごとにゲートウェイキーを作ります（magpie gateway-key add）。キーごとに上限と使えるモデルを設定でき、有効なゲートウェイキーのない他のマシンからのリクエストは 401 になります。相手のパソコンでも magpie を動かしているなら、このパソコンを Remote magpie として追加します。パソコンの移行や複数台の同期には magpie backup と magpie restore、または Settings → Sync and backup を使います。ゲートウェイキーはプロバイダーに保存した API キーとは別物です。QCode の場合、チームに必要な QCode のキーは 1 本で、ゲートウェイを動かすパソコンに置いておきます。
更新日 2026-11-10
このツールを QCode エンドポイントに接続。Claude・GPT・中国系モデルを 1 キーで。
- トークン単位の課金・最新単価は /models
- カード（Visa / Mastercard）・Apple Pay・Google Pay・暗号資産で支払い可能
- チャージ後すぐにセルフサービスで開通
複数人・複数台で使う 4 つの方法
1 人 1 本、上限とモデルを個別に設定
Settings → Network and sharing → Share on local network をオンにし、Gateway → Gateway keys → Add gateway key を開きます。ターミナルでは magpie gateway-key add、list、limit、models です。ゲートウェイキーはプロバイダーの API キーとは別で、API キーはゲートウェイのパソコンにだけ残ります。
別のパソコンからこのゲートウェイを使う
相手のパソコンでも magpie を動かしている場合は、その追加画面で Another computer's magpie を選び、このパソコンのアドレスとゲートウェイキーを入力します。各パソコンの magpie は自分のエージェントを引き続き設定し、プロバイダー、ルーティンググループ、利用量は共有側のものを使います。
サーバーや NAS に置く
公式イメージは ghcr.io/yetone/magpie で、3425 がエージェント用のゲートウェイ、3430 がブラウザ UI です。MAGPIE_WEB_KEY を設定すると UI のキーが再起動後も変わりません。コンテナの外からのリクエストは、ホスト自身のものも含めて有効なゲートウェイキーが必要です。
パスフレーズで暗号化、サーバーには暗号文だけ
magpie backup でパスフレーズ暗号化したバックアップを作り、別のパソコンで magpie restore で戻します。Settings → Sync and backup は WebDAV、S3、非公開の GitHub リポジトリを使い、ゲートウェイの動作中は 3 分ごとに各パソコンをそろえます。
magpie のチーム共有とは
同僚に渡すのはゲートウェイキーで、プロバイダーの API キーではありません。2026-11-10 時点の magpie 公式リファレンスには、ゲートウェイがクライアント向けにゲートウェイキー（gateway keys）を発行し、プロバイダーの API キーとは別に管理すると書かれています。プロバイダーのキー（たとえば QCode の cr_ キー）はゲートウェイを動かすパソコンにだけ保存し、同僚やパソコンごとに名前付きのゲートウェイキーを作ります。同僚のツールは base URL をこのゲートウェイのアドレスに向け、API キーにそのゲートウェイキーを入れます。Anthropic 互換のクライアントはアドレスそのまま、OpenAI 互換のクライアントは同じアドレスに /v1 を付けます（公式 Docker ページの例は http://192.168.1.20:3425 と http://192.168.1.20:3425/v1）。モデル ID は「プロバイダー/モデル」の形です。ループバックのリクエストにゲートウェイキーは不要ですが、LAN 共有をオンにすると他のマシンからのリクエストには有効なゲートウェイキーが必要になり、Docker で公開したポートや NAT 下の WSL ディストリビューションもリモート扱いです。
ゲートウェイキー：画面の場所とコマンド
2026-11-10 時点のリファレンスの画面パスは Settings → Network and sharing → Share on local network で、オンにすると Gateway → Gateway keys → Add gateway key が現れます。Issue #1496 での作者の回答も同じで、共有をオンにすると Gateway ページに Gateway keys が表示され、Add gateway key で名前付きのキーをいくつでも作れます。ターミナルのコマンドは公式の記載どおりです。magpie gateway-key add team-a で 1 本作成（新しいキーは一度だけ表示）、magpie gateway-key list で id、名前、有効状態、マスクしたキーを一覧、magpie gateway-key limit team-a week --tokens 2m --cost 5 で週ごとの上限、magpie gateway-key models team-a qcode/* で qcode プロバイダーのモデルだけを許可します（パターンは「プロバイダー/モデル」か「プロバイダー/*」、all はすべてのモデル）。キーを受け取った同僚は、ゲートウェイに接続するアドレスの末尾に /me を付けてブラウザで開き、自分のキーを入力すると、自分の上限、今日と 7 日・30 日の利用量、使えるモデル、Claude Code と Codex 用の設定例を確認できます。
時系列
Issue #28（WebDAV で全設定を同期したい）に作者が回答：第一段階として、パスフレーズで暗号化するバックアップと復元を v0.1.28 で公開。コマンドは magpie backup と magpie restore です。
Issue #28 がクローズ：作者によると、v0.1.76 で設定画面に Sync and backup が加わり WebDAV 同期に対応、ほかのパソコンは同じパスフレーズで参加します。
Issue #1496（ゲートウェイで複数の API キーを使い、キーごとにトークン量を集計したい）がクローズ：作者の回答は、それがゲートウェイキーの機能で、キーごとに上限とモデルを設定でき、利用量もキーごとに集計されるというものです。
公式に書かれていること、まだオープンの Issue
公式ドキュメントに書かれていること
① リモートのリクエストは、有効なゲートウェイキーを Bearer、x-api-key、x-goog-api-key、?key= のいずれかで送ります。ループバックではどのトークンでも通ります。② 上限はトークン数、推定コスト（米ドル）、またはその両方で、期間は日・週・月、または N 日ごと・N 時間ごとです。1 本のキーに最大 5 つの上限を設定でき、使い切るとそのキーのリクエストは 429 になり、ほかのキーには影響しません。コストは Usage ページの価格での推定です。このパソコンからゲートウェイキーなしで送るリクエストは上限の対象外です。③ キーは個別に名前の変更、無効化、ローテーション、削除ができ、削除するとリモートアクセスが取り消されます。ローテーションでは名前、有効状態、上限、利用履歴が保たれます。④ バックアップはパスフレーズでローカルに暗号化され（AES-256-GCM、鍵は PBKDF2-SHA256 でパスフレーズから導出）、パスフレーズなしでは中身を読めません。magpie backup --no-keys で作ったファイルには API キーが含まれず、復元時は復元先にあるゲートウェイキーがそのまま残ります。⑤ 同期はゲートウェイの動作中に 3 分ごとに行われ、サーバーには暗号文だけが保存されます。GitHub 同期には非公開リポジトリが必要です。⑥ 同期されたエージェントのモデルをあるパソコンで元に戻すと、その項目はそのパソコン独自になります。Settings → Sync の Kept on this computer に表示され、Follow the others で同期の値に戻せます。
まだオープンの Issue
2026-11-10 時点で Issue #2269 はオープンのままです。タイトルの趣旨は、読み込めない settings.json がバックアップと同期に既定値として持ち出され、ほかのパソコンの設定を上書きするというものです。作者は 2026-10-15 に修正済みと回答しています。修正後は、settings.json を読めないときにバックアップ、GUI のエクスポート、同期がエラーで止まり、何も封入・送信されず、同期の状態にそのエラーが表示されます。修正は次のリリースに入り、それまで Issue はオープンのままです。作者は、別の Windows プログラムが settings.json を開いている場合や、実際の WebDAV、S3、GitHub サーバーではまだ試していないとも書いています。
同僚がゲートウェイに直接つなぐか、相手も magpie を動かすか
同僚のツールがこのゲートウェイに直接つなぐ
同僚が Claude Code、Codex など base URL を入力できるツールだけを使う場合に向きます。ゲートウェイキーを 1 本渡し、Anthropic 互換のクライアントはゲートウェイのアドレスそのまま、OpenAI 互換のクライアントは /v1 を付けて使います。モデル ID は「プロバイダー/モデル」で、GET /v1/models で一覧できます。キーごとに上限とモデルを設定でき、利用量もキーごとに集計されます。
相手のパソコンも magpie を動かしている
共有側を Remote magpie として追加します。リファレンスの例は magpie provider add remote-magpie sk-magpie-… url=http://192.168.1.20:3425 id=office で、sk-magpie-… を作成したゲートウェイキーに、アドレスを自分のものに置き換えます。相手の magpie は引き続き自分のエージェントの設定を書き、プロバイダー、ルーティンググループ（office/group/…）、利用量は共有側のものを使います。共有側がそのキーに設定した上限は、相手のパソコンの Usage ページにも表示されます。
チームと複数台で使う 5 ステップ
① ゲートウェイを動かすパソコンに magpie をインストールし、QCode を追加します（3 つのアドレスとインポートリンクは /magpie-claude-code-guide）。② Settings → Network and sharing → Share on local network をオンにし、Gateway → Gateway keys で同僚ごとにキーを作ります。ターミナルでは magpie gateway-key add team-a、magpie gateway-key limit team-a week --tokens 2m --cost 5、magpie gateway-key models team-a qcode/* です（qcode は QCode を追加したときに magpie が付けるプロバイダー id）。③ 同僚のツールにはこのパソコンの LAN アドレス（公式の例は http://192.168.1.20:3425、OpenAI 互換のクライアントは /v1 を付ける）を、API キーにはゲートウェイキーを入力します。同僚も magpie を使うなら、上の Remote magpie の書き方に切り替えます。④ 移行やバックアップ：magpie backup（パスフレーズを 2 回入力）、新しいパソコンで magpie restore magpie.magpie-backup。API キーを含めないなら magpie backup --no-keys ~/b.magpie-backup です。複数台を継続してそろえるには Settings → Sync and backup を使います。⑤ サーバーに置く方法は下の Docker の質問を、Windows と WSL は /magpie-wsl-windows-setup、エラーは /magpie-errors-and-fixes、CC Switch からの移行は /magpie-migrate-from-cc-switch をご覧ください。
チームに必要な QCode のキーは 1 本、ゲートウェイのパソコンに
2026-11-10 時点で、QCode の magpie 用ドキュメントは 3 つのアドレスを示しています。anthropic は https://api.qcode.cc/api、chat は https://api.qcode.cc/openai/v1、responses は https://api.qcode.cc/openai です。コンソールの「magpie に取り込む」ボタンで一度取り込めば、Claude と GPT の両方が設定されます。QCode の API キー 1 本で Anthropic 互換と OpenAI 互換の両方のインターフェースを使え、課金はトークン単位、モデルごとの単価は /models にあります。チームでの使い方：QCode のキーは magpie の中に置き、同僚が受け取るのはゲートウェイキーで、QCode のキーではありません。チーム全員がゲートウェイ経由でこのキーの枠と同時実行数を分け合います（個人プランのキーは同時実行 5、アルティメットは 10）。利用量は QCode コンソールの「使用統計」で確認できます。人ごとに枠と使用量を管理したいなら、チーム版でメンバーごとにサブキーを 1 本ずつ配り、それぞれに個別のクォータを持たせます（/claude-code-team-shared-keys）。月額プランをご希望でない場合は、クォータパックが $4 から。7 日以内に使い切る一度限りの枠です。個人プランをお使いで枠が足りないときはブースターパックを追加できます。
よくある質問
magpie を同僚に使ってもらうには？
自分のパソコンで Settings → Network and sharing → Share on local network をオンにし、同僚用のゲートウェイキーを作って（magpie gateway-key add に名前を付ける）、同僚のツールの base URL をこのゲートウェイの LAN アドレスに、API キーをそのゲートウェイキーにしてもらいます。プロバイダーのキーは magpie の中に残り、同僚には渡しません。同僚も magpie を使っているなら、こちらを Remote magpie として追加してもらいます。インストールと QCode の追加は /magpie-claude-code-guide をご覧ください。
magpie で一人ひとりの利用量を制限できますか？
できます。ゲートウェイキーごとに上限を設定でき、トークン数、推定コスト、またはその両方を、日・週・月、または N 日ごと・N 時間ごとに最大 5 つまで指定できます。使えるモデルを絞ることもできます。使い切るとそのキーは 429 になり、ほかの人には影響しません。作者は Issue #1496 で、利用量はキーごとに集計されると説明しています。Usage → Overview → Gateway keys でキー別のトークンとコスト、Usage → Requests でキー別の絞り込みができ、エクスポートした CSV には caller_key_id と caller_key_name の列があります。同僚はゲートウェイのアドレスに /me を付けて開き、キーを入力すれば自分の上限と利用量を確認できます。
magpie の設定を複数のパソコンで同期するには？
方法は 2 つです。一度だけなら、magpie backup でパスフレーズ暗号化したバックアップを作り、別のパソコンで magpie restore magpie.magpie-backup を実行します。継続して同期するなら、Settings → Sync and backup で WebDAV、S3、非公開の GitHub リポジトリを選ぶと、ゲートウェイの動作中は 3 分ごとに各パソコンが更新され、サーバーには暗号文だけが保存されます。作者は Issue #28 で、WebDAV 同期は v0.1.76 から使え、ほかのパソコンは同じパスフレーズで参加すると書いています。同期に関する Issue #2269 は 2026-11-10 時点でもオープンで、作者は修正が次のリリースに入ると回答しています（上記参照）。
LAN やリモートから magpie にアクセスすると 401 になります
リクエストに有効なゲートウェイキーを付けます。LAN 共有をオンにする（またはゲートウェイをネットワークに置く）と、他のマシンからのリクエストには有効なゲートウェイキーが必要で、ないと 401 になります。ループバックでは不要です。magpie gateway-key add でその同僚やパソコン用のキーを作り、相手のツールの API キーに入れます。magpie が Docker で動いているなら、コマンドの前に docker exec magpie を付けます。401 のエラー文とほかのエラーへの対処は /magpie-errors-and-fixes をご覧ください。
チームで共有すると、全員に API キーを渡すことになりますか？
全員に渡すのはゲートウェイキーです。プロバイダーの API キー（たとえば QCode の cr_ キー）はゲートウェイを動かすパソコンにだけ保存されます。ゲートウェイキーはいつでも無効化、ローテーション、削除でき、削除するとそのキーのリモートアクセスが取り消され、ローテーションでは名前、上限、利用履歴が保たれます。QCode 側でも人ごとにキーと枠を分けたい場合は /claude-code-team-shared-keys をご覧ください。チーム版ではメンバーごとにサブキーを 1 本ずつ配り、それぞれに個別のクォータがあります。
magpie をサーバーにインストールできますか？
できます。公式の Docker イメージは ghcr.io/yetone/magpie（linux/amd64 と linux/arm64）で、3425 がゲートウェイ、3430 がブラウザ UI です。環境変数 MAGPIE_WEB_KEY を設定すると UI のキーが再起動後も変わりません。クライアントごとのキーはブラウザ UI の Gateway → Gateway keys か、docker exec magpie magpie gateway-key add "Docker client" で作ります。コンテナ内では LAN 共有をオンにする必要はなく、コンテナの外からのリクエストには必ず有効なゲートウェイキーが必要です。コンテナを使わない場合、magpie daemon install で magpie serve をバックグラウンドサービスにできます（Linux は systemd のユーザーサービス、macOS は launchd）。Windows では magpie autostart on でログイン時に magpie が起動し、ゲートウェイを提供します。
出典
2026-11-10 に確認：GitHub の yetone/magpie にある docs/reference.md（ゲートウェイキー、Remote magpie、バックアップと同期、バックグラウンドサービスの各節）、usemagpie.ai の Docker ドキュメント、Issue #28（2026-09-25 クローズ）、#1496（2026-10-12 クローズ）、#2269（オープン）での作者 yetone の回答。QCode：magpie 用ドキュメント、エンドポイントページ、コンソールの「magpie に取り込む」ボタン、チーム共有キーガイド、2026-11-10 の magpie ターミナル版での動作確認。モデルは /models に従います。
関連記事
クォータパック
一度購入する枠、7日有効、サブスク不要。追加分は同じキーに加算
magpie の使い方：Claude Code と Codex のローカルゲートウェイ（2026-11）
magpie の設定：インストールとアンインストールのコマンド、プロバイダーを追加する三つの方法、Claude Code と Codex へのモデル選択、QCode の三つのアドレス。
Claude Code チーム共有キーガイド
一人一本のサブ API キー、キーごとの日次クォータ、qot_ による使用量照会、退職時の回収、Anthropic Team のシート・Claude Code・毎月の API クレジットとの比較。2026-10-27 に確認。
暗号資産チャージガイド
9 通貨・56 ネットワーク、手数料 0 で AI コーディング API クレジットを購入。
このページの内容は 2026-11-10 に magpie のリファレンス、Docker ドキュメント、関連 Issue に照らして確認しました。公式ページが優先されます。確認に使ったバージョン：QCode の 2026-11-10 の動作確認は magpie 0.1.3533 で行いました。magpie は 1 日に何度もリリースされるため、メニュー名とコマンドはインストールしたバージョンに従ってください。QCode のモデルは /models に従います。