官方原文 · 截至 2026-11-10

magpie WSL 配置与 Windows 安装：装在哪边（2026 年 11 月）

截至 2026-11-10，magpie 的 README 写明：在 Windows 上，WSL 发行版里的 agent 也会被接线。所以可以把 magpie 装在 Windows、Claude Code 和 Codex 留在 WSL 里，它们在 Agents 页各自显示为独立条目。Windows 安装文件是 magpie-windows-amd64.exe（ARM 为 magpie-windows-arm64.exe），magpie.exe 接受与其他系统相同的命令；官方 reference 还写到 magpie daemon 在 WSL 里和在 Linux 上一样可用。接 QCode 时，三个服务商地址不随 magpie 装在哪里而变。

更新于 2026-11-10

把这个工具接到 QCode 端点：一把 key 调 Claude、GPT 与国产模型。

按 token 计费，实时单价见 /models
支付宝、微信支付、信用卡、加密货币均可付款
充值后自助开通、立刻生效

创建账号查看定价

#magpie WSL#magpie Windows 安装#WSL1 与 WSL2#QCode 地址

官方来源里的四条事实

Windows

Windows：应用文件与 magpie.exe

GitHub 发行版给 Windows 的文件是 magpie-windows-amd64.exe（ARM 为 magpie-windows-arm64.exe），纯终端版是 magpie-cli-windows-amd64.exe；官网写的系统要求是 Windows 10 或更新。magpie.exe 接受与其他系统相同的命令。

WSL

WSL 里的 agent 由 Windows 上的 magpie 接线

README 写明：在 Windows 上，WSL 发行版里的 agent 也会被接线，会话也会被统计。官方接线文档补充：找到的每个 agent 成为独立条目，它的配置文件经该发行版的 \\wsl.localhost 共享来编辑。

daemon · web

装进 WSL：daemon 与 web

reference 写明：开启 systemd（/etc/wsl.conf 里 [boot] systemd=true）后，magpie daemon 在 WSL 里和在 Linux 上一样可用；magpie web 在浏览器里打开应用窗口，reference 把它列给 WSL 和经 SSH 连上的服务器。

3 个地址

QCode 的地址不变

QCode 的 magpie 文档列出 anthropic https://api.qcode.cc/api、chat https://api.qcode.cc/openai/v1、responses https://api.qcode.cc/openai。magpie 装在 Windows 还是 WSL，都填这三个。

magpie 是什么，WSL 在哪一环？

截至 2026-11-10，magpie（GitHub 仓库 yetone/magpie，MIT 协议）在本机运行一个网关，在一处给各个 agent 选模型，仓库描述是“Every agent's model. One place.”。README 写明网关位于 127.0.0.1:3425，支持 OpenAI Chat、OpenAI Responses、Anthropic Messages 和 Gemini；在 Windows 上，WSL 发行版里的 agent 也会被接线。官方 agent 接线文档解释了做法：对每个正在运行的发行版只探测一次，不启动已停止的发行版；按发行版 home 下的目录或那里的命令发现 agent，经 \\wsl.localhost 编辑它的文件；网关地址和密钥随发行版的网络模式（mirrored 或 NAT）而定。网关只监听回环地址时，NAT 下它还会在 Windows 的 WSL 网络地址上提供服务。

2026-10-27：维护者合入 WSL 里 Codex 报 404 的修复

2026-10-27，维护者 yetone 在 issue #2198 里写道：修复已合入，随 v0.1.1763 发布。修复后，Windows 本机 Codex 的 config.toml 没有给出兜底模型时，magpie 会到正在运行、且探到 Codex 的发行版里，找第一个 model_provider = "magpie" 的 config.toml，取它的 model；已停止的发行版不会被打开。他同时写明，真实发行版里的真实 Codex 还没有试过，issue 先开着，等有真实 WSL 环境的人确认后再关。

时间线

2026-10-14

提交 issue #2198：WSL 里的 Codex 请求 magpie 不提供的模型名，得到 404。

2026-10-27

yetone 合入 #2198 的修复；issue 保持打开，等真实 WSL 环境确认。

2026-11-10

2026-11-10 复核 GitHub 与官方文档：#2198、#3333、#3689、#4453 为 open，#3175 已由提出者关闭。

magpie 写明了什么，还有什么没说明

官方文档与维护者写明的

① Windows 文件：magpie-windows-amd64.exe、magpie-windows-arm64.exe，纯终端版 magpie-cli-windows-amd64.exe；系统要求 Windows 10 或更新。② README：在 Windows 上，WSL 发行版里的 agent 也会被接线，会话也会被统计。③ 接线文档：每个 WSL agent 是独立条目，经 \\wsl.localhost 编辑；列出时不会启动已停止的发行版，但修改其中某个字段会写文件，从而启动它；设置里关掉 Detect agents in WSL 后，magpie 完全不启动 wsl.exe。④ 网关地址和密钥随发行版的网络模式（mirrored 或 NAT）而定；NAT 下网关还会在 Windows 的 WSL 网络地址上提供服务，WSL 能否进来由 Windows 防火墙决定，连不上的发行版会被告知放行用的防火墙规则。⑤ start 文档：magpie 自己的设置、服务商与用量在 Windows 上存放在用户目录下的 .config\magpie。⑥ 维护者 yetone 在 #2198（WSL 里的 Codex 报 404）写道：修复已合入；issue 先开着，等真实 WSL 环境确认后再关。

官方尚未说明的

截至 2026-11-10：① 装在哪边：官方没有分步的 WSL 安装指南，也没有说 magpie 装在 Windows 还是 WSL 更合适；install.sh 有 macOS 与 Linux 两个分支，reference 写到 WSL 里的 magpie daemon 与 magpie web。② WSL1（#3333，open）。issue 里贡献者的观察：WSL 1 与 Windows 共用网络栈，所以给 Claude Code 写 127.0.0.1 才对；他发布了补丁，并说明没在真实的 WSL1 发行版上试过。维护者尚未回复。③ NAT 下在 WSL 里打开的 VS Code（#3689，open）。issue 里贡献者的观察：报告者写道，网络模式设成 Mirrored 可以，NAT 不行。维护者尚未回复。④ #3175 与文档并列：#3175 报告 wsl --shutdown 后 magpie.exe 约每 60 秒调用一次 wsl.exe，2026-10-22 由报告者以 completed 关闭，没有评论；现行接线文档写的是只探测运行中的发行版、不启动已停止的发行版。两者的关系官方没有说明。⑤ Claude Desktop 的 SSH 会话（#4453，open）：一位贡献者写道，写入哪个地址属于产品决策，留给维护者决定。

两种放法

magpie 装在 Windows，agent 在 WSL

安装 Windows 应用，或用终端版 magpie-cli-windows-amd64.exe。按 README，正在运行的 WSL 发行版里的 agent 也会被接线，在 Agents 页显示为独立条目。Windows 上 magpie 不作为系统服务运行，reference 给的是 magpie autostart on：登录时打开 magpie，网关随之运行。

magpie 装进 WSL

在发行版里执行官方安装命令 curl -fsSL https://usemagpie.ai/install.sh | sh；脚本有 Linux 分支，Linux 上没有桌面环境时装终端版。开启 systemd 后用 magpie daemon install 让网关常驻，或用 magpie web 在浏览器里打开应用窗口；reference 写到这两种在 WSL 里的用法。

magpie 配合 WSL 与 QCode 怎么设置

① 在 Windows 上从 usemagpie.ai 或 GitHub Releases 下载 magpie-windows-amd64.exe（ARM 为 magpie-windows-arm64.exe）；reference 提到首次运行前 SmartScreen 可能会询问。② 添加 QCode：在 Providers → Add provider 里填，或在终端执行 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（截至 2026-11-10，按 magpie 0.1.3533 的 Linux 终端版实测，这条命令添加成功）。anthropic 填根路径、不带 /v1；url 即 chat 地址，以 /v1 结尾。③ 启动 WSL 发行版，打开 Agents 页：magpie 列出在运行中的发行版里找到的 Claude Code、Codex 等，每个是独立条目；给 Claude Code 选 qcode/claude-sonnet-5-5，给 Codex 选 qcode/gpt-6.1-sol。④ 列表里缺某个 agent 时，先确认设置里的 Detect agents in WSL 开着；接线文档写明探测用 sh -l（读 ~/.profile、不读 ~/.bashrc），并会到 nvm、fnm、volta、pnpm、bun、~/.local/bin 等位置找命令。⑤ NAT 下发行版连不上网关时，按 magpie 给出的防火墙规则放行。⑥ 想把 magpie 装进 WSL：在发行版里执行 curl -fsSL https://usemagpie.ai/install.sh | sh，开启 systemd（/etc/wsl.conf 里 [boot] systemd=true），再执行 magpie daemon install。⑦ 不经 magpie：按 QCode 环境变量页，在 WSL 的 shell 里设置 ANTHROPIC_BASE_URL=https://api.qcode.cc/api 和 ANTHROPIC_AUTH_TOKEN=cr_xxx。

在 Windows 或 WSL 的 magpie 里用 QCode

截至 2026-11-10，一把 QCode API Key 同时提供 Anthropic 与 OpenAI 两种兼容接口，QCode 的 magpie 文档列出三个地址：anthropic https://api.qcode.cc/api（根路径，不带 /v1）、chat https://api.qcode.cc/openai/v1、responses https://api.qcode.cc/openai。magpie 无论装在 Windows 还是 WSL 里，地址都相同。Claude 只走 /api，GPT 走 OpenAI 的两个地址，国产型号 chat 与 anthropic 都能走。按 token 计费，各模型单价见 /models。三步开始：① 注册并充值（支付宝等主流支付方式）；② 购买个人套餐或按量包，复制以 cr_ 开头的 API Key；③ 按 https://docs.qcode.cc/docs/ide/magpie 在 magpie 里添加 QCode。不想包月？按量包 ¥26 起买一笔额度，7 天内用完为止；已有个人套餐的用户额度不够时买加油包。

常见问题

magpie 支持 WSL 吗？

支持。截至 2026-11-10，README 写明：在 Windows 上，WSL 发行版里的 agent 也会被接线，会话也会被统计。magpie 只探测正在运行的发行版，列出时不会启动已停止的发行版；设置里关掉 Detect agents in WSL 后，magpie 完全不启动 wsl.exe。reference 还写到 magpie daemon 和 magpie web 可以在 WSL 里使用。

WSL 里的 Codex 报模型名 404 怎么办？

维护者 yetone 在 issue #2198 里写道，修复已合入并随 v0.1.1763 发布，所以先确认 Windows 上的 magpie 是这个版本或更新的版本。#2198 描述的情况是：接线在 WSL 发行版里的 Codex 请求 magpie 不提供的模型名，得到 404。修复后，Windows 本机 Codex 没有给出兜底模型时，magpie 会读取第一个正在运行、且 config.toml 里 model_provider = "magpie" 的发行版，取它的 model。issue 仍是 open（reopened）：yetone 写明真实发行版里的真实 Codex 还没有试过，等有真实 WSL 环境的人确认。

wsl --shutdown 之后发行版又自己启动了？

想让 magpie 完全不启动 wsl.exe，官方文档给的开关是设置里的 Detect agents in WSL：关掉后 magpie 不再启动 wsl.exe，也就不再探测 WSL 里的 agent。这个现象见 issue #3175：报告者 2026-10-21 写道，执行 wsl --shutdown 后 magpie.exe 约每 60 秒调用一次 wsl.exe，发行版随之回到 Running，并请求加开关或降低频率；2026-10-22 他自己以 completed 关闭了 issue，没有评论。现行接线文档写的是：对每个运行中的发行版只探测一次，不启动已停止的发行版。两者的关系官方没有说明。

在 WSL 中打开的 VS Code 无法使用 magpie（ECONNREFUSED 127.0.0.1:3425）？

这是 issue #3689，截至 2026-11-10 仍是 open，维护者尚未回复，也还没有官方步骤。以下是 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 agent 使用 Windows 在 WSL 网络上的地址，能否连上由 Windows 防火墙决定。

WSL1 下 Claude Code 该用哪个地址？

截至 2026-11-10，官方文档写的是 mirrored、NAT 与桥接三种网络模式下的地址，WSL1 还在 issue #3333（open）里讨论，维护者尚未回复。报告者在 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 发行版上试过。

装在 WSL 里的 magpie 能接 QCode 吗？

能。按 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/docs/getting-started/environment 写了 Claude Code 用的 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN。

资料来源

GitHub 上 yetone/magpie 仓库（main 分支）的 README、reference、install.sh、agent 接线与网关路由文档，usemagpie.ai 的首页、docs/start、docs/remote、docs/docker，GitHub Releases API，以及 issue #2198、#3175、#3333、#3689、#4453 及其评论，均于 2026-11-10 读取。QCode：docs.qcode.cc 的 magpie 与环境变量页，qcode.cc/models、/pay-as-you-go 和 /pricing，2026-11-10 抓取。

Windows 或 WSL 里的 magpie，都能接 QCode

一把 QCode API Key 同时用于 Claude Code、Codex 等工具，按 token 计费，各模型单价见 /models。

注册账号

查看模型与实时单价查看套餐