magpie が動かない？ 401・405 エラーの原因と対処（2026 年 11 月）

公式 FAQ のとおり、実行中のセッションは起動時のモデルを使い続けます。新しいセッションを開き、Codex の場合は Codex アプリも再起動してください。エージェントは起動時に設定を読むため、変更は次のセッションから反映されます。エージェントを元の状態に戻すには、モデル選択でエージェント本来のモデルを選ぶか、magpie にエージェント名と default を続けて実行します（例：magpie claude default）。

これは magpie の Docker ドキュメントに載っている 401 の原文で、コンテナの外からエージェントが送ったキーが有効なゲートウェイキーではないことを示します（LAN 共有でも、別のマシンからのリクエストにはゲートウェイキーが必要です）。ドキュメントは、古いイメージから更新した後、コンテナ外のエージェントが magpie などゲートウェイキーではないキーを送り続けている場合を挙げています。対処は、Gateway → Gateway keys でキーを作成するか、magpie gateway-key add に名前を付けて実行することです（Docker では先頭に docker exec magpie を付けます）。新しい sk-magpie-key-… が表示されるので、エージェントの API キーに入力します。ローカルのループバックでは、どのトークンでも通ります。

issue #425 のタイトルは ZCode provider returns 405 Method Not Allowed で始まり、状態はクローズ済み（not planned）です。作者は 2026-10-01 の回答で、magpie はプロンプトを書き換えず、公式クライアントになりすますこともしないという原則を示しました。v0.1.590 以降、このエラーメッセージは ZCode が自社アプリからのリクエストしか受け付けないことを示し、グループに別のプロバイダーを追加するよう案内します。その案内どおり API キーで使うプロバイダーを追加するなら、QCode は GLM モデル（glm-5.3 など）を Anthropic と OpenAI Chat の両方のインターフェースで提供しています。各モデルは /models で確認できます。

いいえ、anthropic の行に ✓ が付いていれば問題ありません。QCode は Claude モデルを Anthropic Messages エンドポイントだけで提供しています。models の先頭が Claude モデルだと、テストはそのモデルで chat と responses にもリクエストを送るため、設計どおり 400 が返り、Model 'claude-opus-5-5' is not available on this endpoint と表示されます。3 行すべてを ✓ にしたい場合は、magpie provider models でモデルを並べるときに GPT モデル（gpt-6.1-terra など）を先頭にします（QCode が 2026-11-10 に確認）。GPT は magpie codex qcode/gpt-6.1-sol を実行して実際にリクエストを送って確かめることもできます。

QCode の確認では、プロバイダー追加時に models= を指定しないと、magpie は最初の 24 モデルだけを公開します。magpie provider models の後にプロバイダー ID とモデル ID を並べると、一覧がその内容にまるごと置き換わります。1 つだけ追加したいときは、reference にあるとおり +モデル ID と書きます（外すときは -モデル ID）。ほかのモデルはそのまま残ります。一覧が乱雑な場合、作者は 2026-11-05 に X で、ルーティンググループを作成してエージェントではそのグループだけを選ぶよう回答しています。reference には、プロバイダーごとの Only through routing groups スイッチで、プロバイダー全体をルーティンググループ専用にできることも書かれています。

公式 FAQ によると、原因はプロキシアプリ（Surge、Clash、mihomo など。システムプロキシ、TUN、拡張モードが有効なもの）が、エージェントから http://127.0.0.1:3425 へのリクエストを横取りして別の場所へ送っていることで、リクエストは magpie に届いていません。公式の対処は、ほかのルールより前にローカルアドレスを直接通す 2 つのルール IP-CIDR,127.0.0.0/8,DIRECT,no-resolve と IP-CIDR6,::1/128,DIRECT,no-resolve を追加し、エージェントからもう一度リクエストを送ることです。