راهاندازی Claude Code با magpie: نصب گیت‌وی محلی و انتخاب مدل‌ها (نوامبر 2026)
مستندات رسمی magpie (usemagpie.ai) تا تاریخ 2026-11-10، راهاندازی Claude Code روی magpie را در سه مرحله ارائه می‌کنند: فرمان نصب را اجرا کنید و magpie را راهاندازی کنید؛ یک ارائهدهنده را در بخش Providers با کلید API خودتان اضافه کنید؛ سپس magpie claude را با نام ارائهدهنده/مدل اجرا کنید؛ مدل از نشست بعدی اعمال میشود (برای Codex، magpie codex را اجرا کنید و برنامه Codex را دوباره راهاندازی کنید). magpie (yetone/magpie) یک گیت‌وی روی رایانه خودتان در 127.0.0.1:3425 است که میان OpenAI Chat، OpenAI Responses، Anthropic Messages و Gemini ترجمه انجام میدهد؛ تحت مجوز MIT است و به Apache Magpie وابسته نیست. سه نشانی و فرمان QCode در ادامه آمده است.
به‌روزرسانی شده 2026-11-13
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدل‌های چینی.
- صورت‌حساب به‌ازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- به‌صورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکته از منابع رسمی
متن‌باز تحت مجوز MIT، اثر yetone
مخزن yetone/magpie مجوز MIT را دارد (Copyright (c) 2026 yetone). README با این جمله پایان می‌یابد: magpie به Apache Magpie یا Apache Software Foundation وابسته نیست.
نشانی گیت‌وی محلی
این گیت‌وی از OpenAI Chat، OpenAI Responses، Anthropic Messages و Gemini پشتیبانی میکند و میان آنها ترجمه انجام میدهد؛ شامل پخش جریانی، فراخوانی ابزار و استدلال است.
پلتفرم‌ها و شکل‌ها
README میگوید که این برنامه روی macOS، Windows و Linux (برنامه نوار منو، پنجره، TUI، web UI و CLI)، در Docker و روی Termux اجرا میشود.
محل نگهداری کلیدهای شما
کلیدها در ~/.config/magpie/providers.json قرار می‌گیرند و فقط توسط شما قابل خواندن هستند. magpie هرگز کلیدها را از محیط shell شما نمی‌خواند: از همان چیزی استفاده میکند که شما اضافه میکنید.
magpie چیست؟
مستندات magpie تا تاریخ 2026-11-10 آن را یک نقطه واحد برای انتخاب مدلی توصیف می‌کنند که هر یک از عامل‌های شما استفاده میکند. شما ارائه‌دهنده‌هایی را که دارید اضافه میکنید، برای هر عامل یک مدل انتخاب میکنید و magpie آن را در پیکربندی خود همان عامل می‌نویسد. در پشت آن، یک گیت‌وی کوچک روی دستگاه شما در 127.0.0.1:3425 قرار دارد که با APIهای OpenAI، Anthropic و Gemini صحبت میکند و میان آنها ترجمه انجام میدهد؛ بنابراین عاملی که فقط Anthropic Messages را می‌فهمد، مانند Claude Code، می‌تواند از مدل‌های GPT یا مدل‌های چینی نیز استفاده کند. نویسنده yetone است، وب‌سایت usemagpie.ai و مخزن yetone/magpie است.
فرمان‌های نصب و حذف
تا تاریخ 2026-11-10، فرمان رسمی نصب curl -fsSL https://usemagpie.ai/install.sh | sh است. این فرمان، فرمان magpie را در ~/.local/bin و برنامه را در /Applications روی Mac یا در منوی برنامه شما در Linux قرار میدهد؛ go install github.com/yetone/magpie@latest نیز کار میکند. در Windows، فایل magpie-windows-amd64.exe (برای ARM فایل magpie-windows-arm64.exe) را از آخرین انتشار دانلود کنید؛ magpie.exe همان فرمان‌ها را می‌پذیرد و magpie-cli-windows-amd64.exe نسخه فقط ترمینال است. یک ایمیج Docker نیز وجود دارد، ghcr.io/yetone/magpie؛ مستندات رسمی Docker را ببینید. برای حذف، فرمان curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall را اجرا کنید: magpie ابتدا هر عامل را قطع میکند و آنچه هر یک داشته را برمی‌گرداند؛ تنظیمات و ارائه‌دهنده‌های شما در ~/.config/magpie باقی می‌مانند و --purge آنها را نیز حذف میکند.
گاه‌شمار
مخزن yetone/magpie در GitHub ایجاد میشود.
مستندات QCode آزمون magpie با Claude Code و Codex را به پایان می‌رسانند و مقاله راهاندازی magpie را در docs.qcode.cc منتشر می‌کنند.
QCode با نسخه ترمینال magpie همان روز دوباره آزمایش شد: یک فرمان magpie provider add، QCode را اضافه کرد و آزمون ارائهدهنده از هر سه نشانی پاسخ گرفت. همان روز: README، مستندات رسمی (شروع کار، افزودن به magpie، Docker و صفحه‌های مدل Claude Code و Codex)، مرجع و انتشارهای GitHub بررسی شدند؛ مستندات می‌گویند magpie چند بار در روز منتشر میشود.
آنچه مستندات بیان می‌کنند و آنچه باز می‌گذارند
بیان‌شده در مستندات رسمی
① برای یک مدل از طریق magpie، دروازه همراه با برنامه اجرا میشود. ② یک نشست در حال اجرا همان مدلی را نگه میدارد که با آن شروع شده است؛ عامل‌ها هنگام شروع، پیکربندی خود را می‌خوانند، بنابراین مدل جدید از نشست بعدی اعمال میشود، و Codex هم باید برنامهاش دوباره راهاندازی شود. ③ انتخاب یک مدل فقط کلیدهایی را تغییر میدهد که magpie در پیکربندی عامل لازم دارد؛ کامنت‌ها، ترتیب و تورفتگی باقی می‌مانند، و نوشتن‌ها اتمی هستند. ④ Claude Code: magpie مقادیر ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN را در ~/.claude/settings.json می‌نویسد، و توکن همان کلید دروازه است، نه کلید ارائهدهنده شما؛ Codex: جدول [model_providers.magpie] و مدل در ~/.codex/config.toml. ⑤ لازم نیست خودتان OPENAI_BASE_URL یا ANTHROPIC_BASE_URL را export کنید. ⑥ یک لینک import تا وقتی Add را نزنید چیزی ذخیره نمیکند، و وقتی id از قبل گرفته شده باشد، دکمه Replace را نشان میدهد. ⑦ مدل‌های magpie در فهرست‌های /model در Claude Code و Codex هم نمایش داده می‌شوند (در Claude Code با via magpie مشخص می‌شوند)، بنابراین می‌توانید از داخل خود عامل هم مدل را عوض کنید.
آنچه مستندات روشن نکرده‌اند
تا تاریخ 2026-11-10: ① صفحه اصلی رسمی، حداقل نسخه macOS را به دو شکل بیان میکند (macOS 12+ و macOS 11 یا جدیدتر)، بنابراین شرطی را که هنگام دانلود نمایش داده میشود رعایت کنید. ② فهرست عامل‌های پشتیبانی‌شده در README از فهرست موجود در Get started طولانی‌تر است و همچنان رشد میکند؛ اینکه عامل شما شناسایی میشود یا نه، در خروجی magpie ls نشان داده میشود. ③ صفحه رسمی import میگوید بدون پارامتر models، magpie مدلهایی را فهرست میکند که /v1/models ارائهدهنده برمی‌گرداند؛ در آزمون QCode در 2026-11-10، ارائه‌دهنده‌ای که بدون models= افزوده شده بود فقط 24 مدل اول را نمایش داد (خروجی 24 مدل نمایش‌داده‌شده از 28 را نشان می‌داد)، بنابراین پس از افزودن آن، مدل‌های موردنیاز خود را با magpie provider models انتخاب کنید.
سه روش برای افزودن ارائهدهنده
لینک import یا خود برنامه
یک لینک import به شکل magpie://import? به‌همراه پارامترهاست؛ در وب از https://usemagpie.ai/import# با همان پارامترها استفاده کنید و هر مقدار را با URL کدگذاری کنید. فیلدها شامل name (یا preset)، chat، responses، anthropic، gemini، key و models است. اگر لینک کلیدی نداشته باشد، یک کلید را در دیالوگ جای‌گذاری میکنید. در برنامه، مسیر آن Providers → Add provider است.
یک فرمان در ترمینال
برای یک preset فقط magpie provider add با شناسه preset و کلید لازم است (مثال رسمی: deepseek و sk-…)؛ یک نشانی سفارشی پارامترهای url= (سازگار با OpenAI)، anthropic= (سازگار با Anthropic)، responses=، models= و key= را می‌پذیرد. در ترمینال، magpie import همراه با یک لینک خلاصه‌ای نشان میدهد و ابتدا می‌پرسد، و -y از پرسش صرف‌نظر میکند؛ مستندات QCode دریافت که لینک بدون کلید در آنجا فقط پیش‌نمایش میشود و ذخیره نمیشود، بنابراین در ترمینال magpie provider add آن را در یک مرحله انجام میدهد.
راهاندازی magpie: نصب، افزودن ارائهدهنده، انتخاب مدل برای Claude Code و Codex
① نصب: در macOS و Linux فرمان curl -fsSL https://usemagpie.ai/install.sh | sh را اجرا کنید؛ در Windows فایل magpie-windows-amd64.exe را دانلود کنید؛ سپس magpie را اجرا کنید تا دروازه در حال اجرا باشد. ② افزودن ارائهدهنده: در تب Providers دکمه + Add provider را بزنید، برای یک preset کلید جای‌گذاری کنید، یا برای هر نشانی دیگری Custom · any compatible URL را انتخاب کنید؛ فرم ترمینالی در کارت بالا آمده است، و فرمان کامل QCode پایین‌تر است. ③ انتخاب مدل: در تب Agents روی مدل عامل کلیک کنید، یا magpie claude deepseek/deepseek-v4-pro یا magpie codex deepseek/deepseek-v4-pro را اجرا کنید؛ مدل‌های عبوری از magpie به شکل provider/model نام‌گذاری می‌شوند. ④ یک نشست جدید شروع کنید تا عامل پیکربندی جدید را بخواند؛ Codex هم باید برنامهاش دوباره راهاندازی شود. ⑤ بررسی: magpie ls تنظیمات فعلی هر عامل را فهرست میکند، و magpie provider test همراه با شناسه ارائهدهنده، برای هر API یک درخواست کوچک می‌فرستد و تأخیر را نشان میدهد. ⑥ برای بازگشت به تنظیمات خود عامل: magpie claude default یا magpie codex default.
افزودن QCode به magpie
تا تاریخ 2026-11-10، مقاله magpie در QCode سه نشانی ارائه میدهد: anthropic برابر است با https://api.qcode.cc/api، chat برابر است با https://api.qcode.cc/openai/v1 و responses برابر است با https://api.qcode.cc/openai (نمونه‌های magpie برای responses با /v1 پایان می‌یابند؛ صفحه نقطه پایانی QCode بیان میکند که /openai/responses و /openai/v1/responses معادل هستند). Claude از طریق نشانی anthropic، GPT از طریق chat و responses، و مدل‌های چینی از طریق anthropic یا chat کار می‌کنند؛ برای نقاط دسترسی آسیا و آمریکای شمالی، دامنه را با asia.qcode.cc یا us.qcode.cc جایگزین کنید و مسیرها را حفظ کنید. ساده‌ترین راه، دکمه «Import to CC Switch / magpie» در کنسول است: آنجا روی «Import to magpie» کلیک کنید؛ Claude و GPT یک‌جا تنظیم می‌شوند، سپس مدل‌ها را با magpie claude qcode/claude-sonnet-5-5 یا magpie codex qcode/gpt-6.1-sol انتخاب کنید. تنظیم فقط مدل اصلی، جایگاه opus در Claude Code را روی همان مدل قرار میدهد؛ برای اختصاص Opus به آن، دستور magpie claude opus qcode/claude-opus-5-5 را نیز اجرا کنید. کلیدهای QCode مستقل از پروتکل هستند، بنابراین یک کلید هم به رابط Anthropic و هم به رابط سازگار با OpenAI برای Claude Code، Codex و ابزارهای دیگر سرویس میدهد؛ صورت‌حساب به‌ازای هر توکن محاسبه میشود و نرخ هر مدل در /models آمده است. هنوز برای پلن ماهانه آماده نیستید؟ بسته‌های پرداخت به‌ازای مصرف از $4 شروع می‌شوند و شامل سهمیه‌ای یک‌باره هستند که ظرف 7 روز مصرف میکنید؛ اگر از قبل پلن شخصی دارید، وقتی به سهمیه بیشتری نیاز داشتید، یک بسته تقویتی اضافه کنید.
پرسش‌های متداول
چرا magpie پس از سوئیچ کردن اعمال نمیشود؟
به احتمال زیاد نشست راهاندازی مجدد نشده است: نشست در حال اجرا مدلی را که با آن شروع شده است نگه میدارد، مدل جدید از نشست بعدی اعمال میشود و Codex هم به راهاندازی مجدد برنامهاش نیاز دارد. سپس مطمئن شوید gateway در حال اجراست: برای مدلی که از طریق magpie اجرا میشود، gateway همراه برنامه اجرا میشود و magpie healthcheck زمانی که gateway پاسخ میدهد با کد 0 خارج میشود. magpie ls تنظیمات فعلی هر عامل را نشان میدهد و magpie provider test بررسی میکند که آیا ارائهدهنده پاسخ میدهد؛ سایر خطاها در /magpie-errors-and-fixes پوشش داده شدهاند.
آیا magpie باید باز بماند؟
برای مدلی که از طریق magpie اجرا میشود، بله: gateway همراه برنامه اجرا میشود. بستن پنجره آن را در نوار منو یا سینی سیستم در حال اجرا باقی میگذارد؛ magpie tray فقط آیکون را راهاندازی میکند، magpie serve فقط gateway را اجرا میکند و magpie daemon install آن را بهعنوان سرویس در حال اجرا نگه میدارد (systemd در Linux، launchd در Mac). عاملی که روی مدل خودش است از magpie عبور نمیکند.
magpie کلید من را کجا ذخیره میکند و آیا امن است؟
کلیدها در ~/.config/magpie/providers.json قرار دارند و فقط توسط شما قابل خواندن هستند، و magpie هرگز کلیدها را از محیط shell شما نمی‌خواند. مستندات میگوید عامل‌ها هرگز کلیدهای شما را نمی‌بینند: ANTHROPIC_AUTH_TOKEN در پیکربندی Claude Code کلید gateway است. یک لینک import وب پارامترهای خود را پس از # نگه میدارد که مرورگرها آنها را به سرور نمی‌فرستند. همچنین ماسک حریم خصوصی وجود دارد: وقتی روشن باشد، کلیدها، گذرواژه‌ها و ایمیل‌های داخل prompt پیش از خروج درخواست از رایانه شما با جای‌نگهدارها جایگزین می‌شوند و در پاسخ بازگردانده می‌شوند؛ این ویژگی بهطور پیش‌فرض خاموش است و در Settings → Privacy روشن میشود.
چگونه magpie را حذف نصب کنم یا پیکربندی اصلی خود را بازگردانم؟
برای بازگردانی: دستور magpie claude default یا magpie codex default را اجرا کنید؛ magpie آنچه نوشته است را حذف میکند و مقادیری را که جایگزین کرده بود، مانند ANTHROPIC_BASE_URL که قبلاً داشتید، بازمی‌گرداند. برای حذف نصب یک نصب اسکریپتی، دستور curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall را اجرا کنید؛ تنظیمات و ارائه‌دهنده‌های شما در ~/.config/magpie باقی می‌مانند و --purge آنها را نیز حذف میکند.
آیا میتوان از magpie و CC Switch با هم استفاده کرد؟
بله، میتوان آنها را کنار هم نصب کرد: در 2026-11-09، yetone، نویسنده magpie، در X پاسخ داد که استفاده از هر دو با هم اشکالی ندارد، و README میگوید Import در magpie ارائهدهندهها را از CC Switch وارد میکند. هر دو ابزار فایلهای پیکربندی Claude Code و Codex را مینویسند؛ نحوه تقسیم کار میان آنها و تنظیماتی که هنگام اجرای هر دو باید به آنها توجه کنید در صفحه مقایسه /magpie-vs-cc-switch آمده است.
چگونه QCode را در magpie اضافه کنم؟
یکی از سه روش را انتخاب کنید. سریعترین راه، دکمه Import to magpie در کنسول است؛ در ترمینال، دستور 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 را اجرا کنید که در آزمایش QCode در 2026-11-10 در یک مرحله QCode را افزود؛ در برنامه، زیر Providers → Add provider گزینه Custom را انتخاب کنید و Base URL سازگار با OpenAI (نشانی chat)، نشانی سازگار با Anthropic (نشانی anthropic) و کلید cr_ خود را وارد کنید. بدون models=، magpie تنها 24 مدل نخست را ارائه میکند، پس مدلهایی را که استفاده میکنید با magpie provider models qcode gpt-6.1-sol claude-sonnet-5-5 claude-opus-5-5 claude-haiku-5-5 انتخاب کنید (بدون +، فهرست بهطور کامل جایگزین میشود)؛ اگر مدل GPT اول باشد، magpie provider test در هر سه سطر ✓ نشان میدهد: chat، responses و anthropic. برای جایگزینی کلید یک ارائهدهنده QCode ذخیرهشده، magpie provider key را با qcode و کلید جدید اجرا کنید.
منابع
README، LICENSE و مرجع مخزن yetone/magpie در GitHub، GitHub API، اطلاعات انتشار magpie-releases، صفحه اصلی usemagpie.ai، و مستندات رسمی Get started، Add to magpie، Docker و صفحه‌های مدل Claude Code و Codex، همه خوانده‌شده در 2026-11-10؛ پاسخ yetone، نویسنده magpie، در X در 2026-11-09. QCode: مقاله magpie و صفحه نقطه دسترسی در docs.qcode.cc، qcode.cc/models و qcode.cc/pay-as-you-go، بازیابی‌شده در 2026-11-10، و آزمایش QCode با نسخه ترمینالی magpie در 2026-11-10؛ متن دکمه Import در کنسول از متن سایت خود QCode گرفته شده است.
Claude و GPT در magpie با یک کلید
یک کلید API QCode برای Claude Code، Codex و موارد دیگر، با صورت‌حساب به‌ازای هر توکن؛ نرخ هر مدل در /models آمده است.
مطالب مرتبط
بسته‌های پرداخت به‌ازای مصرف
بسته‌های سهمیه یک‌باره، معتبر به مدت 7 روز، بدون اشتراک؛ نرخ هر مدل در /models آمده است.
magpie در برابر CC Switch: چگونه انتخاب کنید
تفاوت این دو در شیوه کار، کلاینت‌ها، ترجمه پروتکل، انتقال در صورت خرابی، پوشاندن داده‌های خصوصی و مجوز، و نحوه اتصال هر یک به QCode.
کار نکردن magpie: خطاهای 401 و 405 و راه‌حل‌ها (2026-11)
علت و راه‌حل رسمی خطاهای رایج magpie: سوییچی که اعمال نمیشود، خطای 401 در Docker، خطای 405 در ZCode، خطای 400 در provider test و مدل‌های ناموجود.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
ادعاهای این صفحه در 2026-11-10 با مخزن، سایت و مستندات magpie بررسی شده است؛ صفحه‌های رسمی اولویت دارند. نسخه بررسی‌شده: آزمایش QCode در 2026-11-10 از magpie 0.1.3533 استفاده کرد؛ magpie چند بار در روز منتشر میشود، بنابراین نام منوها و دستورها تابع نسخه‌ای است که نصب میکنید. موجود بودن مدل‌های QCode تابع /models است.