magpie の WSL 設定と Windows への導入：どちらで動かすか（2026 年 11 月）

はい。2026-11-10 時点の README によると、Windows では WSL のディストリビューション内のエージェントも接続され、そのセッションも集計されます。magpie は起動中のディストリビューションだけをスキャンし、一覧表示で停止中のものを起動することはありません。設定で Detect agents in WSL をオフにすると、magpie は wsl.exe を一切起動しません。リファレンスには、WSL 内で magpie daemon と magpie web を使う方法も書かれています。

メンテナーの yetone は Issue #2198 で、修正をマージし v0.1.1763 に含めたと書いているため、まず Windows の magpie がこのバージョン以降か確認してください。#2198 は、WSL のディストリビューション内で接続された Codex が magpie の提供していないモデルを要求し、404 になる問題です。修正後は、Windows 側の Codex に代替モデルの指定がない場合、magpie は config.toml に model_provider = "magpie" を含む最初の起動中ディストリビューションを読み、その model を使います。Issue は（再オープンされて）オープンのままです。yetone は、実際のディストリビューションでの実際の Codex はまだ試していないと書いており、実際の WSL 環境を持つ人の確認を待っています。

magpie に wsl.exe を一切起動させたくない場合、公式ドキュメントが示すスイッチは設定の Detect agents in WSL です。オフにすると、WSL 内のエージェントも探さなくなります。この現象は Issue #3175 で報告されました。報告者は 2026-10-21 に、wsl --shutdown の後に magpie.exe が約 60 秒ごとに wsl.exe を呼び出し、ディストリビューションが Running に戻ると書き、スイッチの追加か頻度の低減を求めました。2026-10-22 に本人がコメントなしで completed としてクローズしています。現在の接続ドキュメントには、起動中の各ディストリビューションを一度だけスキャンし、停止中のものは起動しないとあります。両者の関係は公式には説明されていません。

これは Issue #3689 で、2026-11-10 時点でオープンのまま、メンテナーの返信や公式の手順はまだありません。以下は Issue のコントリビューターの観察です。報告者の VS Code では Copilot のモデルのアドレスが 127.0.0.1:3425 になっており、WSL 内の VS Code サーバーが connect ECONNREFUSED 127.0.0.1:3425 で失敗しました。報告者は後に、ネットワーク方式を Mirrored にすると動き NAT では動かないこと、magpie のローカルネットワーク共有をオンにして VS Code に Windows ホストの IP とゲートウェイキーを手動で入れると使えたものの、Agents パネルの再接続ボタンで VS Code の設定が元に戻されることを書いています。NAT について公式ドキュメントは、magpie が接続する WSL のエージェントは WSL ネットワーク上の Windows のアドレスを使い、入れるかどうかは Windows のファイアウォールが決めると説明しています。

2026-11-10 時点で、公式ドキュメントは mirrored、NAT、bridged の各ネットワーク方式のアドレスを説明しており、WSL1 は Issue #3333（オープン）で議論中で、メンテナーはまだ返信していません。報告者の WSL1 では curl http://127.0.0.1:3425/v1/models が通るのに、magpie は Claude Code の ANTHROPIC_BASE_URL にループバック以外のアドレスを書き込みました。Issue のコントリビューターの観察：WSL 1 は Windows とネットワークスタックを共有するので 127.0.0.1 にすべきだとしてパッチを公開しましたが、実際の WSL1 ディストリビューションでは試していないと書いています。

はい。QCode の magpie ガイドにある三つのアドレスで、QCode をプロバイダーとして追加します：anthropic https://api.qcode.cc/api、chat https://api.qcode.cc/openai/v1、responses https://api.qcode.cc/openai。Claude は /api だけを経由します。magpie を Windows で動かしても WSL 内で動かしても、アドレスは同じです。magpie を使わない場合は、QCode の環境変数のページ https://docs.qcode.cc/ja/docs/getting-started/environment に、Claude Code 向けの ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN が載っています。