مهاجرت از CC Switch به magpie: دامنه درون‌ریزی و جلسات قدیمی Codex (نوامبر 2026)
تا 2026-11-10، README ابزار magpie میگوید درون‌ریزی، ارائهدهندهها را از CC Switch، Claude Code، Codex و Alma وارد میکند. برای مهاجرت: magpie را نصب کنید، صفحه ارائهدهندهها را باز کنید، روی افزودن ارائهدهنده و سپس درون‌ریزی… بزنید، ارائه‌دهنده‌هایی را که میخواهید منتقل کنید علامت بزنید و در صفحه عامل‌ها مدل‌ها را برای Claude Code و Codex انتخاب کنید. اگر جلسات قدیمی Codex موجود نیستند، از مسیر جلسات ← Codex گزینه «انتقال به magpie…» را به کار ببرید. نویسنده magpie در 2026-11-09 در X گفت که پیکربندی CC Switch با یک کلیک درون‌ریزی می‌شود و استفاده از هر دو هم کار میکند. اگر QCode از قبل در CC Switch راه‌اندازی شده است، پس از درون‌ریزی آدرس‌های anthropic، chat و responses را بررسی کنید.
به‌روزرسانی شده 2026-11-14
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدل‌های چینی.
- صورت‌حساب به‌ازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- بهصورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکته از منابع رسمی
CC Switch یک منبع درون‌ریزی است
README ابزار magpie: درون‌ریزی، ارائهدهندهها را از CC Switch، Claude Code، Codex و Alma وارد میکند. وقتی صفحه ارائهدهندهها را باز میکنید، magpie آن برنامه‌ها را نیز برای پیکربندی‌های محلی‌ای که میتواند درون‌ریزی کند بررسی میکند، و تا زمانی که انتخاب خود را تأیید نکنید چیزی اضافه نمیشود.
جلسات قدیمی Codex را میتوان منتقل کرد
مورد #887 گزارش داد که جلسات قدیمی Codex پس از انتقال از CC Switch از دید خارج می‌شوند. نویسنده magpie در 2026-10-05 پاسخ داد که از v0.1.999، مسیر جلسات ← Codex میتواند آن‌ها را بهصورت دستی به magpie منتقل کند، و تنها نشانگر ارائهدهنده هر جلسه تغییر میکند، در حالی که پیام‌ها، شناسه‌های جلسه، عنوان‌ها و وضعیت بایگانی همان‌طور که هستند می‌مانند. این مورد در 2026-10-14 به‌عنوان تکمیل‌شده بسته شد.
گروه‌بندی جلسات Codex در CC Switch
CC Switch v4.0.28 (2026-11-08) میگوید از Codex desktop 26.1103 و CLI 0.167، جلسات مربوط به اشتراک رسمی و ارائهدهندههای شخص ثالث اکنون کاملاً تفکیک شده‌اند؛ می‌توانید از حالت Routing یا Aggregation استفاده کنید، یا «Unified Codex session history» را روشن کنید.
نویسنده: استفاده از هر دو هم کار میکند
نویسنده magpie، yetone، در 2026-11-09 در X (به چینی) پاسخ داد که پیکربندی CC Switch با یک کلیک درون‌ریزی می‌شود، استفاده از هر دو هم کار میکند، و اینکه پیش از تصمیمگیری آن را امتحان کنید. او تفاوت را در این می‌داند که درخواست‌ها به کجا می‌روند: CC Switch عمدتاً پیکربندی هر عامل را ویرایش میکند، در حالی که magpie یک دروازه محلی است که همه عامل‌ها به آن متصل می‌شوند.
مهاجرت از CC Switch به magpie شامل چه مواردی است؟
تا 2026-11-10، این مهاجرت به چهار مورد خلاصه می‌شود: نصب magpie، استفاده از درون‌ریزی… برای آوردن ارائه‌دهنده‌هایتان از CC Switch، انتخاب یک مدل برای هر کلاینت، و رسیدگی به جلسات قدیمی Codex. آنچه منتقل می‌شود پیکربندی ارائهدهنده است، بهصورت یک کپی: مستندات magpie میگوید تغییرات بعدی در برنامه مبدأ دوباره کپی نمیشوند. پس از انتخاب مدل‌ها، magpie آن‌ها را در فایل پیکربندی خود هر کلاینت می‌نویسد: Claude Code به دروازه محلی در 127.0.0.1:3425 متصل می‌شود و به config.toml مربوط به Codex یک جدول [model_providers.magpie] اضافه می‌شود. فقط جلسات جدید از تنظیمات جدید استفاده می‌کنند و دروازه magpie باید در حال اجرا باشد. در ادامه به جلسات قدیمی Codex پرداخته می‌شود.
2026-11-08: CC Switch v4.0.28 با گروه‌بندی جدید جلسات Codex سازگار می‌شود
CC Switch v4.0.28 در 2026-11-08 منتشر شد و یادداشت‌های انتشار آن می‌گویند عمدتاً به به‌روزرسانی ناسازگار Codex در 8 نوامبر می‌پردازد. آن‌ها بیان می‌کنند که Codex جلسات را بر اساس شناسه ارائهدهنده ثبت میکند: اشتراک رسمی زیر openai توکار ثبت می‌شود، و ارائهدهندههای شخص ثالثی که CC Switch می‌نویسد زیر custom ثبت می‌شوند. Codex جدید فقط میتواند جلسات را در همان گروه ارائهدهنده فعلی ادامه دهد؛ گروه دیگر فقط‌خواندنی است و ادامه دادن یکی از آن‌ها «model provider mismatch» را گزارش میکند. در سمت magpie، صفحه جلسات همین موضوع را علامت‌گذاری میکند: میگوید چند جلسه Codex با ارائهدهنده دیگری (مانند custom) ساخته شده‌اند و دیگر در تاریخچه Codex نمایش داده نمیشوند، و پیشنهاد میکند آن‌ها را منتقل کنید (به پایین مراجعه کنید).
گاه‌شمار
Issue #887 در magpie: جلسات قدیمی Codex که از طریق CC Switch استفاده می‌شدند، پس از اتصال به magpie دیگر در تاریخچه Codex نمایش داده نمیشوند، و گزارش‌دهنده درخواست مهاجرت دستی زیر جلسات ← Codex را میکند. نویسنده همان روز پاسخ می‌دهد که این قابلیت اضافه شده است.
CC Switch v4.0.28 منتشر می‌شود و با گروه‌های جلسه در Codex جدید سازگار می‌شود.
نویسنده magpie تفاوت این دو ابزار را در X توضیح می‌دهد و میگوید پیکربندی CC Switch با یک کلیک درون‌ریزی می‌شود و استفاده از هر دو هم کار میکند.
آنچه مستندات بیان می‌کنند و آنچه بی‌پاسخ می‌گذارند
مستندشده توسط پروژه‌ها
① README: «Import» ارائهدهندهها را از CC Switch، Claude Code، Codex و Alma وارد میکند. ② مرجع: وقتی صفحه Providers را باز میکنید، magpie در Alma، CC Switch، Claude Code و Codex به دنبال پیکربندی‌های محلی ارائهدهنده می‌گردد که قابل درون‌ریزی باشند، و تا زمانی که انتخاب را تأیید نکنید چیزی افزوده نمیشود؛ ارائه‌دهنده‌هایی که در برنامه مبدأ خاموش شده‌اند و ورودی‌هایی که شناسه‌هایشان تداخل دارد از پیشنهاد خودکار کنار گذاشته می‌شوند اما از طریق درون‌ریزی دستی در دسترس می‌مانند. ③ ارائهدهندههای منتقل‌شده کپی هستند؛ تغییرات بعدی در برنامه مبدأ دوباره کپی نمیشوند. ④ پس از انتخاب مدل‌ها، magpie آن‌ها را در فایل پیکربندی مخصوص هر کلاینت می‌نویسد و فقط کلیدهایی را که لازم دارد تغییر می‌دهد: برای Claude Code این کلیدها عبارت‌اند از ANTHROPIC_BASE_URL، ANTHROPIC_AUTH_TOKEN و متغیرهای مدل در بلوک env فایل ~/.claude/settings.json، و برای Codex جدول [model_providers.magpie] در ~/.codex/config.toml. ⑤ یک نشست در حال اجرا مدلی را که با آن آغاز شده نگه می‌دارد و نشست بعدی از تنظیمات جدید استفاده میکند؛ برای Codex برنامه را نیز دوباره راه‌اندازی کنید. ⑥ برای بازگشت، magpie claude default و magpie codex default را اجرا کنید؛ magpie آنچه نوشته را حذف میکند و مقادیری را که جایگزین کرده بود برمی‌گرداند، مانند ANTHROPIC_BASE_URL که پیش‌تر داشتید. ⑦ برای حذف نصب، از فرمان رسمی curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall استفاده کنید؛ magpie اتصال هر کلاینت را قطع میکند و آنچه را که هرکدام در ابتدا داشته است برمی‌گرداند، تنظیمات و ارائهدهندههای شما در ~/.config/magpie باقی می‌مانند، و --purge آن‌ها را نیز حذف میکند.
آنچه مستندات باز می‌گذارند
بر اساس اطلاعات تا 2026-11-10: ① README و مستندات magpie می‌گویند «Import» ارائهدهندهها را وارد میکند؛ اما فهرست نمی‌کنند که کدام فیلدها از CC Switch می‌آیند، یا آیا صف جایگزینی خودکار، تنظیمات Routing یا Aggregation، سرورهای MCP، Skills و Prompts در CC Switch نیز منتقل می‌شوند یا نه. پیش از انتقال، در CC Switch تصمیم بگیرید کدام‌یک از این‌ها را هنوز لازم دارید، و پس از درون‌ریزی هرکدام را در magpie بررسی کنید. ② برای استفاده هم‌زمان از هر دو ابزار، مراحل راه‌اندازی رسمی و کاملی وجود ندارد؛ نویسنده فقط میگوید استفاده از هر دو نیز کار میکند و پیش از تصمیمگیری آن را امتحان کنید. ③ نویسنده در پاسخ خود در تاریخ 2026-10-05 در گزارش #887 یاد‌آور شد که این نسخه هنوز روی تاریخچه واقعی CC Switch اجرا نشده است، فقط روی یک پوشه Codex که برای آزمایش ساخته شده بود؛ این گزارش در 2026-10-14 بسته شد چون از زمان انتشار بازخورد بیشتری نیامده بود، و نویسنده از هر کسی که پس از به‌روزرسانی هنوز تحت تأثیر است خواست همان‌جا پاسخ دهد. README، مستندات و مرجع magpie به گروه‌بندی نشست Codex 26.1103 اشاره نمی‌کنند.
چه کسی چه کاری میکند، پیش و پس
CC Switch (قبل)
README: جابه‌جایی فقط جزئیات اتصال (نقطه پایانی، کلید و مدل) را جایگزین میکند، و افزونه‌ها، هوک‌ها، MCP و کامنت‌هایی که افزوده‌اید همان‌طور می‌مانند. Direct ابزار را مستقیم به ارائهدهنده متصل میکند، Routing درخواست‌ها را از طریق دستگاه شما هدایت میکند، و حالت Aggregation نیز وجود دارد.
magpie (بعد)
README: درگاه روی 127.0.0.1:3425 با OpenAI Chat، OpenAI Responses، Anthropic Messages و Gemini صحبت میکند و میان آن‌ها ترجمه انجام می‌دهد؛ کلاینت‌ها به درگاه متصل می‌شوند و کلید شما در magpie، در ~/.config/magpie/providers.json قرار دارد.
نحوه انتقال از CC Switch به magpie
① نصب: curl -fsSL https://usemagpie.ai/install.sh | sh را اجرا کنید، یا برنامه را از usemagpie.ai دانلود کنید. ② Providers را باز کنید، روی Add provider کلیک کنید، سپس در بالا Import… را بزنید، ارائه‌دهنده‌هایی را که میخواهید منتقل کنید علامت بزنید و تأیید کنید؛ صفحه Providers ممکن است پیوند «Import local configurations» را نیز نشان دهد، که آن هم تا زمانی که تأیید نکنید چیزی اضافه نمی‌کند. ③ پس از درون‌ریزی، ورودی QCode را باز کنید و سه نشانی آن را بررسی کنید: anthropic https://api.qcode.cc/api، chat https://api.qcode.cc/openai/v1، responses https://api.qcode.cc/openai، و هرکدام را که نیست پر کنید؛ اگر کلیدی وجود ندارد، magpie provider key qcode cr_xxx را اجرا کنید (qcode شناسه ورودی در magpie است، همان‌گونه که magpie providers فهرست میکند). ④ برای کلاینت‌هایتان مدل انتخاب کنید، برای مثال magpie claude qcode/claude-sonnet-5-5 و magpie codex qcode/gpt-6.1-sol، سپس نشست جدیدی آغاز کنید و برنامه Codex را دوباره راه‌اندازی کنید. ⑤ اگر نشست‌های قدیمی Codex وجود ندارند، Sessions → Codex را باز کنید، در اعلان بالای فهرست روی «Move to magpie…» کلیک کنید و در پیش‌نمایش تأیید کنید؛ اعلان پس از انتقال یک Undo دارد. ⑥ درگاه magpie را در حال اجرا نگه دارید؛ برای بازگشت به تنظیمات قبلی‌تان، magpie claude default و magpie codex default را اجرا کنید.
استفاده از کلید QCode پس از انتقال
از تاریخ 2026-11-10، یک کلید QCode هم نقاط پایانی سازگار با Anthropic و هم سازگار با OpenAI را در اختیار شما می‌گذارد، صورت‌حساب به‌ازای هر توکن محاسبه می‌شود و نرخ هر مدل در /models آمده است. سه ورودی در magpie عبارت‌اند از: anthropic https://api.qcode.cc/api (مدل‌های Claude از این نقطه پایانی استفاده می‌کنند و مدل‌های چینی هم می‌توانند)، chat https://api.qcode.cc/openai/v1 (مدل‌های GPT و چینی)، و responses https://api.qcode.cc/openai (GPT). سه مرحله: ① ثبت‌نام و شارژ حساب (Alipay، WeChat Pay، کارت‌ها، رمزارز و موارد دیگر)؛ ② کلید API خود را که با cr_ شروع می‌شود کپی کنید؛ ③ اگر QCode از قبل در CC Switch تنظیم شده است، پس از وارد کردن، سه ورودی بالا را بررسی کنید یا در داشبورد QCode روی «Import to magpie» بزنید؛ وقتی magpie از قبل QCode را دارد، وارد کردن دوباره کلید قدیمی را جایگزین نمی‌کند. مقاله مستندات QCode در https://docs.qcode.cc/en/docs/ide/magpie مراحل کامل را دارد. آماده پلن ماهانه نیستید؟ بسته‌های پرداخت به‌ازای مصرف از $4 شروع می‌شوند برای سهمیه‌ای یک‌باره که ظرف 7 روز مصرف میکنید؛ اگر از قبل پلن شخصی دارید، هر وقت به سهمیه بیشتری نیاز داشتید یک بسته تقویتی اضافه کنید. جزئیات: /pay-as-you-go.
پرسش‌های متداول
آیا magpie میتواند پیکربندی CC Switch من را با یک کلیک وارد کند؟
میتواند پیکربندی ارائهدهنده شما را وارد کند. README مربوط به magpie میگوید Import ارائهدهندهها را از CC Switch، Claude Code، Codex و Alma وارد میکند، و در Providers، زیر Add provider → Import…، تا زمانی که گزینهها را علامت نزنید و تأیید نکنید چیزی اضافه نمیشود. ارائهدهندههای واردشده کپی هستند، بنابراین تغییرات بعدی در برنامه مبدأ دوباره کپی نمیشوند. نویسنده نیز در 2026-11-09 در X گفت که پیکربندی CC Switch را میتوان با یک کلیک وارد کرد.
تاریخچه Codex من پس از انتقال به magpie ناپدید شد. چه کاری باید انجام دهم؟
در magpie، Sessions → Codex را باز کنید، در اعلان بالای فهرست روی «Move to magpie…» بزنید و در پیش‌نمایش تأیید کنید (از v0.1.999 در دسترس است). در issue #887، گزارش‌دهنده توضیح داد که از Codex از طریق CC Switch استفاده کرده است، بنابراین نشست‌های قدیمی مقدار model_provider را custom دارند؛ وقتی Codex به magpie متصل می‌شود، ارائهدهنده فعلی آن magpie است و فهرست تاریخچه پیش‌فرض Codex نشست‌های ارائهدهنده قبلی را فیلتر میکند؛ بنابراین به نظر می‌رسد تاریخچه از بین رفته است، در حالی که فایل‌های نشست هنوز وجود دارند. نویسنده در 2026-10-05 پاسخ داد: پس از تأیید شما، فقط نشانگر ارائهدهنده در فایل‌های نشست و در جدول threads در state_*.sqlite تغییر میکند؛ ابتدا نسخه‌های اصلی در پوشه سطل زباله magpie پشتیبان‌گیری می‌شوند، اعلان یک Undo دارد، نشست‌هایی که در یک دقیقه اخیر در آن‌ها نوشته شده است نادیده گرفته می‌شوند و هیچ چیز به‌طور خودکار منتقل نمیشود.
آیا magpie و CC Switch می‌توانند هم‌زمان نصب شوند؟
بله. نویسنده magpie در 2026-11-09 در X (به چینی) نوشت که استفاده از هر دو نیز کار میکند و پیش از تصمیمگیری آن را امتحان کنید. این دو پروژه نقش خود را این‌گونه توصیف می‌کنند: README مربوط به CC Switch میگوید تعویض فقط جزئیات اتصال (نقطه پایانی، کلید و مدل) را در پیکربندی هر ابزار جایگزین میکند؛ README و مستندات magpie می‌گویند کلاینت‌ها به درگاه محلی 127.0.0.1:3425 متصل می‌شوند و magpie مدلی را که انتخاب میکنید در فایل پیکربندی خود کلاینت می‌نویسد.
پس از انتقال، چگونه به CC Switch برگردم؟
ابتدا magpie claude default و magpie codex default را اجرا کنید: magpie آنچه را نوشته است حذف میکند و مقادیری را که جایگزین کرده بود بازمی‌گرداند، مانند ANTHROPIC_BASE_URL که قبلاً داشتید. سپس دوباره ارائهدهنده خود را در CC Switch انتخاب کنید و تعویض کنید. برای حذف نصب magpie، دستور curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall را اجرا کنید؛ این دستور اتصال هر کلاینت را قطع میکند و آنچه هرکدام در ابتدا داشتند بازمی‌گرداند، تنظیمات شما در ~/.config/magpie باقی می‌ماند و --purge آن‌ها را حذف میکند. مرجع magpie میگوید جدول [model_providers.magpie] در config.toml مربوط به Codex باقی می‌ماند تا یک thread که با magpie آغاز شده همچنان بتواند باز شود.
آیا پس از انتقال باید کلید QCode را دوباره وارد کنم؟
ابتدا بررسی کنید که ورودی QCode واردشده کلید دارد یا نه. magpie کلیدها را در ~/.config/magpie/providers.json نگه می‌دارد که فقط توسط شما قابل خواندن است، و مستندات آن فهرست نمی‌کند که وارد کردن از CC Switch چه چیزهایی را منتقل میکند. اگر کلیدی وجود ندارد، magpie provider key qcode را به‌همراه کلید cr_ خود اجرا کنید، یا در داشبورد QCode روی «Import to magpie» بزنید. وقتی magpie از قبل QCode را دارد، وارد کردن مجدد از داشبورد کلید قدیمی را جایگزین نمی‌کند؛ بنابراین کلید را با دستور بالا تغییر دهید. همچنین سه آدرس را بررسی کنید: anthropic https://api.qcode.cc/api، chat https://api.qcode.cc/openai/v1، responses https://api.qcode.cc/openai.
اگر فقط ارائهدهنده را عوض میکنم، آیا انتقال ارزش دارد؟
لزوما اینطور نیست. صفحه مقایسه خود magpie میگوید CC Switch زمانی مناسب است که بیشتر هر ابزار را بهصورت دستی بین ارائهدهندگان جابهجا میکنید و میخواهید تنظیمات آن نزدیک به همان چیزی بماند که نوشتهاید، و magpie زمانی مناسب است که از چند عامل استفاده میکنید و میخواهید هر کدام روی مدل متفاوتی باشند. نویسنده همچنین میگوید استفاده از هر دو کار میکند و پیش از تصمیمگیری آن را امتحان کنید. برای آگاهی از بدهبستانهای این دو ابزار، صفحه ما با عنوان «magpie در برابر CC Switch: چگونه انتخاب کنید» را ببینید.
منابع
magpie: README، docs/reference.md و رشته‌های رابط صفحه Sessions (internal/gui/assets/plugins/sessions/i18n.js) در مخزن yetone/magpie در GitHub، صفحه‌های Get started، Add to magpie و مقایسه در usemagpie.ai، و issue #887 همراه با نظرات آن (GitHub API)، که همه در 2026-11-10 خوانده شدند. CC Switch: README مخزن farion1231/cc-switch و یادداشت‌های انتشار v4.0.28 (چینی، انگلیسی و ژاپنی). پاسخ yetone، نویسنده magpie، در X در 2026-11-09 که از طریق fxtwitter بایگانی شده است. QCode: qcode.cc/models، qcode.cc/pricing و صفحه‌های magpie و Endpoints در docs.qcode.cc، بازیابی‌شده در 2026-11-10.
اجرای Claude Code و Codex در magpie با یک کلید QCode
آدرس‌های anthropic، chat و responses را وارد کنید تا مدل‌های Claude، GPT و چینی همگی با همان کلید اجرا شوند؛ صورت‌حساب به‌ازای هر توکن محاسبه می‌شود و نرخ هر مدل در /models آمده است.
مطالب مرتبط
بسته‌های پرداخت به‌ازای مصرف
بسته‌های سهمیه یک‌باره که به مدت 7 روز معتبرند، بدون اشتراک؛ نرخ هر مدل در /models آمده است.
magpie در برابر CC Switch: چگونه انتخاب کنید
پیش از تصمیم به جابه‌جایی، ببینید این دو در مسیر درخواست، کلاینت‌ها و ترجمه پروتکل چه تفاوتی دارند.
راه‌اندازی Claude Code در magpie: دروازه محلی برای Claude Code و Codex (2026-11)
راه‌اندازی magpie: دستورهای نصب و حذف نصب، سه روش برای افزودن ارائهدهنده، انتخاب مدل برای Claude Code و Codex، و سه آدرس QCode.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
مطالب این صفحه در 2026-11-10 با مخازن و مستندات رسمی magpie و CC Switch بررسی شده‌اند؛ صفحات رسمی اولویت دارند. نسخه‌های استفاده‌شده در بررسی: magpie v0.1.3533 و CC Switch v4.0.28؛ نام منوها و گزینهها تابع نسخه‌ای است که نصب میکنید. موجود بودن مدل‌های QCode تابع /models است.