magpie 不生效、401、405 报错怎么办（2026 年 11 月）

已在运行的会话保持启动时的模型，这是官方 FAQ 的答复。开一个新会话；如果是 Codex，也请重启 Codex 应用。agent 在启动时读取配置，所以改动对下一个会话生效。想把 agent 恢复原样，在选择列表里选回 agent 自带的模型，或运行 magpie 加 agent 名再加 default，例如 magpie claude default。

这是 magpie 的 Docker 文档写明的 401 原文：agent 从容器外发来的 key 不是启用的网关密钥（局域网共享时，来自其他机器的请求同样要带网关密钥）。文档点名了一种情形：从旧镜像升级后，容器外的 agent 还在发 magpie 或其他不是网关密钥的 key。处理：在「网关 → 网关密钥」生成一个，或用 magpie gateway-key add 加一个名字生成（Docker 里前面加 docker exec magpie），它会打印新的 sk-magpie-key-…，把它填进 agent 的 API key。本机回环地址上任何 token 都能用。

issue #425 的标题以 ZCode provider returns 405 Method Not Allowed 开头，状态是已关闭（not planned）。作者 2026-10-01 答复的原则是：magpie 不改写你的提示词，也不冒充官方客户端。v0.1.590 起，这条错误提示改为说明 ZCode 只接受自家 App 的请求，并建议在分组里再加一个服务商。按这条提示加一个用 API key 接入的服务商时，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。想让三行都是 ✓，用 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，会把列表整个替换成你列的这些；只想多放出一个，按 reference 写成 +型号 ID（拿掉一个用 -型号 ID），其余不变。列表太乱时，作者 2026-11-05 在 X 上的答复是新建路由分组，agent 里只选这个分组；reference 还写明，服务商的 Only through routing groups 开关可以让整个服务商只通过路由分组使用。

官方 FAQ 的原因：代理软件（Surge、Clash、mihomo 等，开了系统代理、TUN 或增强模式）把 agent 发往 http://127.0.0.1:3425 的请求接走了，请求根本没到 magpie。官方处理：在其他规则之前加两条让本机地址直连的规则，IP-CIDR,127.0.0.0/8,DIRECT,no-resolve 和 IP-CIDR6,::1/128,DIRECT,no-resolve，然后让 agent 再发一次请求。