magpie کار نمی‌کند؟ خطاهای 401 و 405 و راه‌حل‌ها (نوامبر 2026)

یک نشست در حال اجرا همان مدلی را نگه می‌دارد که با آن شروع شده است؛ همان‌طور که در پرسش‌های متداول رسمی آمده است. نشست جدیدی شروع کنید و برای Codex برنامه Codex را نیز دوباره راه‌اندازی کنید. عامل‌ها هنگام شروع، پیکربندی خود را می‌خوانند؛ بنابراین تغییر برای نشست بعدی اعمال می‌شود. برای بازگرداندن یک عامل به حالت قبلی، یکی از مدل‌های خودش را در انتخاب‌گر انتخاب کنید، یا magpie را به‌همراه نام عامل و default اجرا کنید؛ برای نمونه magpie claude default.

این متن 401 است که در مستندات Docker مربوط به magpie نقل شده است: کلیدی که عاملی از بیرون کانتینر فرستاده، یک کلید درگاه فعال‌شده نیست (با اشتراک‌گذاری LAN، درخواست‌های ماشین‌های دیگر نیز به کلید درگاه نیاز دارند). مستندات به یک مورد اشاره می‌کند: پس از ارتقا از image قبلی، عاملی بیرون کانتینر هنوز magpie یا کلید دیگری را می‌فرستد که کلید درگاه نیست. راه‌حل: یک کلید در Gateway → Gateway keys بسازید، یا با magpie gateway-key add و یک نام (در Docker، docker exec magpie را جلو قرار دهید) کلیدی بسازید؛ این دستور یک sk-magpie-key-… جدید چاپ می‌کند. سپس آن را در عامل به‌عنوان کلید API آن قرار دهید. روی loopback محلی هر توکنی کار می‌کند.

عنوان مورد #425 با ZCode provider returns 405 Method Not Allowed آغاز می‌شود و این مورد بسته شده است (برنامه‌ای برای انجام آن نیست). پاسخ نویسنده در 2026-10-01 این اصل را بیان کرد که magpie prompt‌های شما را بازنویسی نمی‌کند و خود را به‌جای کلاینت رسمی جا نمی‌زند. از v0.1.590 این پیام خطا می‌گوید ZCode فقط درخواست‌های برنامه خودش را می‌پذیرد و پیشنهاد می‌کند ارائه‌دهنده دیگری به گروه اضافه کنید. اگر آن را دنبال کنید و ارائه‌دهنده‌ای اضافه کنید که با کلید API کار می‌کند، QCode مدل‌های GLM مانند glm-5.3 را هم روی رابط Anthropic و هم روی رابط OpenAI Chat ارائه می‌دهد؛ برای هر مدل به /models مراجعه کنید.

نه، تا زمانی که خط anthropic علامت تیک داشته باشد. QCode مدل‌های Claude را فقط روی نقطه پایانی Anthropic Messages ارائه می‌دهد؛ وقتی مدل اول یک مدل 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، کل فهرست را با فهرست شما جایگزین می‌کند؛ برای نمایش فقط یک مدل بیشتر، مرجع از +model-id استفاده می‌کند (و -model-id یک مدل را حذف می‌کند) و بقیه را همان‌طور که هستند باقی می‌گذارد. برای فهرست درهم‌وبرهم، پاسخ نویسنده در X در 2026-11-05 این است که یک گروه مسیریابی بسازید و در عامل فقط همان گروه را انتخاب کنید؛ مرجع همچنین سوئیچ Only through routing groups را روی ارائه‌دهنده‌ای توضیح می‌دهد که کل ارائه‌دهنده را برای گروه‌های مسیریابی نگه می‌دارد.

علت در پرسش‌های متداول رسمی: یک برنامه پروکسی (Surge، Clash، mihomo و موارد مشابه، با فعال بودن پروکسی سیستم، TUN یا حالت تقویت‌شده) درخواست عامل را که به http://127.0.0.1:3425 فرستاده شده بود، گرفته و به جای دیگری فرستاده است، بنابراین هرگز به magpie نمی‌رسد. راه‌حل رسمی: دو قاعده اضافه کنید که آدرس‌های محلی را مستقیم بفرستند، پیش از سایر قواعد شما، IP-CIDR,127.0.0.0/8,DIRECT,no-resolve و IP-CIDR6,::1/128,DIRECT,no-resolve؛ سپس از عامل بخواهید درخواست جدیدی بفرستد.