CC Switch 4.0.21: حالت تجمیع و وارد کردن با یک کلیک
بر اساس وضعیت تا 2026-10-27، آخرین انتشار CC Switch نسخه v4.0.21 است (منتشرشده در 2026-10-26)؛ پیش از آن، 4.0.18–4.0.20 به همین ترتیب Antigravity CLI، Kimi Code و Oh My Pi را اضافه کردند؛ سطر README رسمی درباره تنها وب‌سایت رسمی چنین است: «The Only Official Website: ccswitch.io». در بررسی 2026-10-13، CC Switch 4.0 حالت‌های مستقیم، مسیریابی و تجمیع را به سه زبانه در بالای صفحه هر برنامه تقسیم کرد: یادداشتهای انتشار رسمی حالت تجمیع جدید را چنین توصیف میکنند که مدلهای چند ارائهدهنده را در یک فهرست مدل در Claude Code یا Codex قرار میدهد و هر درخواست به ارائهدهنده مدلی که انتخاب میکنید میرود، بدون نیاز به خروج از کلاینت. هر آنچه این صفحه درباره CC Switch میگوید بر پایه یادداشتهای انتشار GitHub و README آن است: v4.0.0 در 2026-10-04 و v4.0.10 در 2026-10-12 منتشر شدند، جدیدترین مورد در فهرست انتشار رسمی در بررسی قبلی v4.0.11 بود که در 2026-10-13 منتشر شد؛ بر اساس وضعیت تا 2026-10-27 جدیدترین مورد v4.0.21 است (منتشرشده در 2026-10-26)، در حالی که v4.0.20 در 2026-10-24 منتشر شد. خود CC Switch فقط بهصورت یک برنامه دسکتاپ که به رابط گرافیکی نیاز دارد عرضه میشود، و README رسمی برای سرورها، نشستهای SSH و ماشینهای بدون دسکتاپ، CC Switch CLI نگهداری‌شده توسط جامعه را توصیه میکند؛ از v4.0.10 به بعد، پیوند وارد کردن ccswitch:// وقتی برنامه بسته است دیگر از دست نمیرود، می‌تواند قالب API خود را اعلام کند، و می‌تواند بلافاصله پس از وارد کردن بپرسد که آیا تغییر انجام شود.
بهروزرسانی شده 2026-11-14
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدلهای چینی.
- صورتحساب به‌ازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- بهصورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکتهای که باید بدانید
مستقیم / مسیریابی / تجمیع
بر اساس یادداشتهای رسمی، صفحه هر برنامه اکنون با این سه زبانه باز میشود؛ کلیک روی یک زبانه فقط نمای فعلی را تغییر میدهد و به پیکربندی شما دست نمی‌زند، دکمه‌ای که واقعاً حالت‌ها را تغییر میدهد صریحاً میگوید چه اتفاقی می‌افتد، و بازگشت به حالت مستقیم یک مرحله همراه با واگرد است.
نسخه Claude Code موردنیاز برای تجمیع
یادداشتهای تجمیع در README می‌گویند تجمیع جابهجایی خودکار در صورت خرابی ارائه نمیدهد و Claude Code به نسخه 2.1.243 یا بالاتر نیاز دارد؛ پس از تغییر فهرست تجمیعشده، Codex به راهاندازی مجدد نیاز دارد، اما Claude Code نه.
پیوندهای وارد کردن با یک کلیک
تمرکز v4.0.10. عبارت رسمی: کلیک روی یک پیوند در حالی که برنامه اجرا نمی‌شود دیگر آن را از دست نمیدهد — پیوند ابتدا ذخیره میشود و تنها زمانی رسیدگی‌شده به حساب می‌آید که پنجره تأیید ظاهر شود. این پنجره یک گزینه تغییر به این ارائهدهنده پس از وارد کردن گرفت که بهطور پیشفرض خاموش است.
پیوند قالب API را اعلام میکند
یک پارامتر جدید برای صاحب سایت در v4.0.10: یک پارامتر اعلام میکند سرویس با کدام قالب API صحبت میکند (anthropic، openai_chat، openai_responses و دیگران) و CC Switch آن را به فیلدهای اختصاصی هر برنامه نگاشت میکند؛ پیوندهای بدون آن دقیقاً مانند قبل رفتار میکنند.
حالت تجمیع در واقع چه کاری انجام میدهد
تا 2026-10-27، جدیدترین نسخه رسمی منتشرشده v4.0.21 است (2026-10-26)؛ v4.0.20 در 2026-10-24 منتشر شد و در 4.0.18–4.0.20، Antigravity CLI، Kimi Code و Oh My Pi اضافه شدند. در بررسی 2026-10-13، تجمیع سومین حالت اتصال است که CC Switch 4.0 اضافه میکند، و یادداشتهای انتشار آن را حالتی توصیف میکنند که مدلهای چند ارائهدهنده را در یک فهرست مدل در Claude Code یا Codex قرار میدهد تا بتوانید درون کلاینت مدل را جابه‌جا کنید. مشکل اصلی هم به همین اندازه مشخص است — پیش‌تر برای استفاده از مدل ارائه‌دهنده‌ای دیگر باید به CC Switch برمی‌گشتید، ارائهدهنده را عوض می‌کردید و سپس به کلاینت خود بازمی‌گشتید؛ اکنون چند ارائهدهنده اضافه میکنید و مدلهای همه‌شان در انتخاب‌گر مدل کلاینت نمایش داده میشوند، و هر درخواست به ارائهدهنده مدلی میرود که انتخاب میکنید. محدودیت‌های رسمی هم به همین روشنی هستند: تجمیع باید بهصورت دستی روشن شود، در حال حاضر از Claude Code و Codex پشتیبانی میکند، درخواست‌ها را بر اساس مدلی که انتخاب کرده‌اید ارسال میکند و جایگزینی خودکار در صورت خرابی ارائه نمیدهد — تبدیل قالب و جایگزینی خودکار در صورت خرابی متعلق به مسیریابی هستند. README دو پیش‌شرط دیگر نیز اضافه میکند: Claude Code باید 2.1.243 یا جدیدتر باشد، و اشتراکهای رسمی Claude در حال حاضر در تجمیع پشتیبانی نمیشوند. این انتشار همچنین شیوه نوشتن پیکربندی را بازنویسی میکند: تغییر ارائهدهنده اکنون فقط نشانی، اعتبارنامه‌ها، مدل و پروتکل را جایگزین میکند و همه‌چیز دیگر همان‌طور که بود نگه داشته میشود.
نسخه‌های رسمی منتشرشده: 4.0.0 تا 4.0.21
4.0.21 (2026-10-26) فهرست مدل را در فرم ارائهدهنده Codex قابل مرتب‌سازی با کشیدن کرد، و این ترتیب همان ترتیب منوی /model در Codex است؛ 4.0.18 (2026-10-21) Antigravity CLI (agy) را اضافه کرد که یادداشتهای انتشار آن را برنامه شماره 11 که CC Switch مدیریت میکند می‌نامند؛ 4.0.19 (2026-10-23) Kimi Code، یعنی برنامه شماره 12، را اضافه کرد و میگوید نسخه‌های خط فرمان و دسکتاپ آن یک پیکربندی مشترک دارند؛ 4.0.20 (2026-10-24) Oh My Pi، یعنی برنامه شماره 13، را با چند ارائهدهنده که در models.yml آن می‌نویسند اضافه کرد. فهرست کلاینت‌های README چنین است: Claude Code، Claude Desktop، Codex، Gemini CLI، Grok Build، OpenCode، OpenClaw، Hermes Agent، Pi، MiniMax Code، Kimi Code و Oh My Pi؛ README از ccswitch.io به‌عنوان تنها وب‌سایت رسمی نام می‌برد. متن v4.0.0 با این توصیف آغاز میشود که آن را بزرگ‌ترین بهروزرسانی CC Switch تاکنون می‌نامد؛ انتشار GitHub مقدار published_at را 2026-10-04T11:01:01Z با پرچم prerelease روی true ثبت میکند. متن v4.0.10 با عنوان فرعی «ششمین انتشار اصلاحی خط پایدار 4.0» آمده است، published_at آن 2026-10-12T16:38:21Z با prerelease روی false است، و نخستین جمله آن میگوید این انتشار بر لینک عمیق وارد کردن با یک کلیک تمرکز دارد، همراه با راهنمای یکپارچه‌سازی چینی، انگلیسی و ژاپنی و یک تولیدکننده لینک آنلاین. پروژه سپس v4.0.11 را در 2026-10-13 منتشر کرد (published_at برابر 2026-10-13T15:35:29Z، prerelease روی false)، که هنگام بررسی این صفحه جدیدترین مورد در فهرست انتشار رسمی است؛ یادداشتهای آن، آن انتشار را چنین توصیف میکنند: افزودن یک گزینه حذف نصب برای ابزارهای نصب‌شده در صفحه Apps و فعال‌کردن پرس‌وجوی سهمیه پلن بهصورت پیشفرض در همه برنامه‌ها، نه فقط در Claude Code. v4.0.10 همچنین توضیح حالت اتصال را بازنویسی کرد تا با نقطه قوت هر حالت آغاز شود: حالت مستقیم نزدیک‌ترین به تنظیمات خود کلاینت میماند، حالت مسیریابی ارائه‌دهنده‌ها را بهصورت لحظه‌ای جابه‌جا میکند و جایگزینی خودکار در صورت خرابی و تبدیل قالب ارائه میدهد، حالت تجمیع بین مدلهای چند ارائهدهنده درون کلاینت جابه‌جا میشود. یادداشت‌ها زمینه را هم بیان میکنند: CC Switch در اوت 2025 منتشر شد، زمانی که قالب‌های API بسیار بیشتر با هم تفاوت داشتند، بنابراین جابهجایی ارائهدهنده در ابتدا یک بازنویسی کامل بود — اکنون بازسازی شده است تا فقط فیلدهای کلیدی را جایگزین کند.
گاه‌شمار پیرامون 4.0
قدیمی‌ترین ورودی در فهرست رسمی انتشارهای GitHub مربوط به CC Switch، نسخه v2.0.3 است با published_at برابر 2025-08-22T00:12:40Z؛ یادداشتهای انتشار v4.0.0 نیز ظهور CC Switch را در اوت 2025 قرار می‌دهند.
v4.0.0 منتشر میشود، با prerelease برابر true در فراداده GitHub: رابط کاربری از نوار کناری تا سینی سیستم بازسازی میشود، تجمیع از راه می‌رسد، و نوشتن پیکربندی از بازنویسی کامل به جایگزینی فیلدهای کلیدی تغییر میکند.
v4.0.10 با prerelease برابر false منتشر میشود: لینک‌های ccswitch:// پس از بسته شدن برنامه باقی می‌مانند، پارامترهای مالک سایت مانند apiFormat همراه با یک تولیدکننده لینک آنلاین اضافه میشوند، و در حالت مسیریابی، نام مستعار haiku نوشته‌شده در settings.json از claude-haiku-4-5 به claude-haiku-5-5 تغییر میکند.
تأییدشده در مقابل اعلام‌نشده
تأییدشده (بهصورت عین‌به‌عین در یادداشتهای انتشار رسمی و README)
هر مورد زیر را می‌توان کلمه‌به‌کلمه در متن انتشارها و README ثبت‌شده برای این صفحه بررسی کرد: حالت مستقیم، مسیریابی و تجمیع به سه تب تقسیم شده‌اند و کلیک روی یک تب پیکربندی شما را دست‌نخورده باقی می‌گذارد؛ تجمیع، مدلهای چند ارائهدهنده را در Claude Code یا Codex در یک فهرست مدل قرار میدهد و بر اساس مدلی که انتخاب میکنید ارسال میکند؛ تجمیع اختیاری است، در حال حاضر Claude Code و Codex را پوشش میدهد، جایگزینی خودکار ارائه نمیدهد، به Claude Code 2.1.243 یا جدیدتر نیاز دارد و از اشتراکهای رسمی Claude پشتیبانی نمیکند؛ وقتی فهرست تجمیعشده تغییر میکند، Codex به راهاندازی مجدد نیاز دارد اما Claude Code نه؛ روش تغییر ارائهدهنده از بازنویسی کامل به جایگزینی فقط نشانی، اعتبارنامه‌ها، مدل و پروتکل تغییر کرده است؛ v4.0.10 مشکل از دست رفتن پیوند عمیق هنگام بسته بودن برنامه را برطرف میکند، کلید تغییر پس از وارد کردن را در گفت‌وگوی تأیید (بهطور پیشفرض خاموش) و پارامتر apiFormat را اضافه میکند؛ مولد آنلاین ارائه‌دهنده‌ها، MCP، promptها و مهارت‌ها را پوشش میدهد؛ تاریخ‌های انتشار عبارت‌اند از 2026-10-04 برای v4.0.0، 2026-10-12 برای v4.0.10 و 2026-10-13 برای v4.0.11 که همگی از فیلد published_at در GitHub خوانده شده‌اند. علاوه بر این، یادداشتهای انتشار 4.0.18–4.0.20، Antigravity CLI، Kimi Code و Oh My Pi را اپلیکیشن‌های شماره 11، 12 و 13 می‌نامند؛ فهرست کلاینت‌های README شامل Antigravity CLI نیست، در حالی که انتشار 4.0.18 آن را اپلیکیشن شماره 11 می‌نامد، و این دو گزاره در اینجا همان‌گونه که نوشته شده‌اند گزارش میشوند؛ README، ccswitch.io را تنها وب‌سایت رسمی می‌نامد.
تأییدنشده و بیان‌نشده توسط پروژه
سه چیز منبع دست‌اول ندارد، پس برنامه‌ریزی خود را بر پایه آنها قرار ندهید. نخست، نسخه خط فرمان خود CC Switch: README میگوید برنامه فقط بهصورت یک برنامه دسکتاپ ارائه میشود که به رابط گرافیکی نیاز دارد، و تنها استثنایی که نام می‌برد یک CC Switch CLI نگهداری‌شده توسط جامعه است، پروژهای که جداگانه منتشر شده است — بنابراین این صفحه هیچ فرمانی برای کنترل CC Switch از ترمینال منتشر نمیکند. دوم، صفحه‌های انتشار رسمی درباره اینکه چه چیزی پایدار شمرده میشود اختلاف دارند: v4.0.0 مقدار prerelease true را دارد، در حالی که v4.0.10 خط 4.0 را پایدار می‌نامد و prerelease false دارد، و v4.0.11 هم prerelease false دارد؛ این صفحه فقط تاریخ‌های published_at را فهرست میکند و هیچ نتیجه‌ای نمیگیرد. سوم، بحث‌های آنلاین درباره اینکه کدام ابزار مشابه بهتر است منبع قابل تأییدی ندارند و در اینجا تکرار نمیشوند، و هرچند v4.0.10 اعلام میکند ساختار پایگاه داده آن هنوز 20 است، این هیچ تضمین سازگاری برای نسخه‌های بعدی نیست.
اتصال مستقیم، مسیریابی، تجمیع: چگونه انتخاب کنید
اتصال مستقیم در برابر مسیریابی
در تقسیم‌بندی رسمی، اتصال مستقیم کلاینت را مستقیماً به ارائهدهنده وصل میکند و برای استفاده روزمره مناسب است؛ مسیریابی درخواست‌ها را از طریق یک سرویس مسیریابی محلی روی دستگاه شما به یک ارائهدهنده ارسال میکند، می‌تواند قالب‌های API را تبدیل کند و جایگزینی خودکار را تنظیم کند، و برای قالب‌های ناسازگار یا نیازهای جایگزینی خودکار مناسب است. ارائهدهنده Codex که روی QCode تنظیم شده است به آن نیاز ندارد: مستندات QCode می‌گویند کلید نگاشت مسیریابی محلی در ویرایشگر ارائهدهنده Codex برای سرویس‌هایی وجود دارد که فقط با Chat Completions کار میکنند، و برای QCode که خودش پروتکل Responses را ارائه میدهد باید خاموش بماند.
مسیریابی در برابر تجمیع
هر دو از طریق سرویس مسیریابی محلی روی دستگاه شما اجرا میشوند؛ تفاوت در نحوه ارسال است. مسیریابی درخواست‌ها را به یک ارائهدهنده می‌فرستد، تجمیع آنها را بر اساس مدلی که انتخاب میکنید بین چند ارائهدهنده پخش میکند، و این همان چیزی است که هنگام ترکیب مدل‌ها در یک نشست می‌خواهید. تجمیع جایگزینی خودکار ارائه نمیدهد، باید دستی روشن شود، در حال حاضر فقط Claude Code و Codex را پوشش میدهد و از اشتراکهای رسمی Claude پشتیبانی نمیکند. این یادداشت‌ها همچنین هشدار می‌دهند که تغییر مدل در میانه نشست باعث میشود مدل جدید کش prompt خود را بازسازی کند، بنابراین اولین نوبت پس از تغییر بهطور محسوسی بیشتر هزینه دارد.
افزودن QCode در CC Switch 4.0
① نصب یا ارتقا: README رسمی بسته‌های دسکتاپ و فرمانهای مدیر بسته را ارائه میدهد — msi یا zip قابل حمل در Windows 10 و بالاتر، brew install --cask cc-switch در macOS 12 و جدیدتر، paru -S cc-switch-bin در Arch، و ساخت‌های .deb، .rpm یا .AppImage برای سایر توزیع‌های Linux. برای ترمینال‌ها، README صراحت دارد که خود CC Switch فقط بهصورت یک برنامه دسکتاپ گرافیکی عرضه میشود؛ برای سرورها، نشستهای SSH یا ماشینهای بدون محیط دسکتاپ به CC Switch CLI که جامعه آن را نگهداری میکند اشاره میکند؛ پروژهای که جداگانه منتشر شده است با رابط کاربری ترمینال تعاملی و حالت خط فرمان، که با brew install cc-switch-cli قابل نصب است، و هشدار میدهد که این دو بهطور پیشفرض پوشه داده ~/.cc-switch را مشترکاً استفاده میکنند و اینکه نسخه پایگاه داده پشتیبانی‌شده توسط CLI گاهی از برنامه دسکتاپ عقب میماند. ② سمت Claude، مطابق مستندات QCode: CC Switch را اجرا کنید، در جابه‌جاکننده برنامه Claude را انتخاب کنید، برای افزودن ارائهدهنده روی دکمه به‌علاوه کلیک کنید، پیش‌تنظیم سفارشی را انتخاب کنید، ANTHROPIC_BASE_URL را روی https://api.qcode.cc/api و ANTHROPIC_AUTH_TOKEN را روی کلید cr_ از کنسول خودتان قرار دهید، ذخیره کنید، سپس روی Enable در آن کارت کلیک کنید — CC Switch هر دو مقدار را در ~/.claude/settings.json می‌نویسد — و برای بررسی اتصال، claude را در یک ترمینال اجرا کنید. ③ سمت Codex: یک ارائهدهنده سفارشی زیر Codex با Base URL https://api.qcode.cc/openai اضافه کنید؛ config.toml در مستندات، ارائهدهنده را qcode با wire_api responses نام‌گذاری میکند (مستندات حروف کوچک را توصیه میکنند تا به‌عنوان نام کلید TOML کار کند) و gpt-6-sol یا gpt-5.6-terra را به‌عنوان مدل پیشفرض فهرست میکند؛ کلید نگاشت مسیریابی محلی را خاموش بگذارید، و نسخه Codex خود را با codex --version روی ماشین خودتان بگیرید. ④ برای استفاده از تجمیع: زبانه Aggregation را در صفحه Claude یا Codex باز کنید، ارائه‌دهندگانی را که می‌خواهید ترکیب کنید اضافه کنید، سپس یکی را به‌عنوان پیشفرض انتخاب کنید تا درخواست‌هایی که مدل تجمیع‌شده‌ای را نام نمی‌برند به آن ارسال شوند، و وقتی فهرست مدل‌ها تغییر میکند کلاینت را دوباره راهاندازی کنید — بنر Codex CLI می‌تواند سرویس پس‌زمینه آن را با یک کلیک دوباره راهاندازی کند. ⑤ برای وارد کردن از طریق لینک: پس از کلیک روی یک لینک ccswitch://، پنجره تأیید وارد کردن ظاهر میشود؛ اگر می‌خواهید بلافاصله اعمال شود، کلید switch-after-import را روشن کنید — وقتی روشن است، پنجره میگوید که درخواست‌های کلاینت به نشانی داخل لینک ارسال میشوند؛ مستندات QCode می‌افزاید که اولین اجرای ایجادشده توسط deep link پنجره را بازسازی میکند و کمی کندتر است.
در QCode
CC Switch خودش نقطه پایانی استنتاج نیست — فقط فایل پیکربندی هر CLI را می‌نویسد، و کار توسط کلیدی انجام میشود که از QCode می‌گیرید. یک کلید cr_ از کنسول هر دو پروتکل را پوشش میدهد، چون کلید به پروتکل کاری ندارد: مسیر تعیین‌کننده است. ارائهدهنده Claude مقدار ANTHROPIC_BASE_URL را https://api.qcode.cc/api میگیرد (پروتکل Anthropic، مسیر کامل /api/v1/messages)؛ ارائهدهنده Codex مقدار base_url را https://api.qcode.cc/openai با wire_api responses میگیرد. مدلهای Claude فقط روی نقطه پایانی پروتکل Anthropic اجرا میشوند، و قرار دادن یکی در مسیر سازگار با OpenAI خطا برمی‌گرداند. شناسه‌های مدل قابل فراخوانی در QCode شامل claude-sonnet-5، claude-sonnet-5-5، claude-opus-5، claude-opus-5-5، claude-haiku-5-5، gpt-6.1-sol، gpt-6-sol، gpt-5.6-sol و gpt-5.6-terra است. راهاندازی پیش‌پرداختی است: ابتدا حساب را شارژ میکنید و سپس از همان موجودی یک پلن می‌خرید؛ Alipay، WeChat Pay، کارت‌های اعتباری (Visa، Mastercard)، Apple Pay، Google Pay و ارز دیجیتال (کوین‌ها و شبکه‌های متعدد) همه پشتیبانی میشوند، با شارژ حساب با یوان که از ¥30 شروع میشود و شارژ حساب با دلار از $5 تا $2,000. صورتحساب به‌ازای هر توکن محاسبه میشود؛ نرخ‌های هر مدل در /models فهرست شده‌اند.
پرسش‌های متداول
حالت تجمیعی در CC Switch 4.0 چیست؟
مدلهای چند ارائهدهنده را در یک فهرست مدل قرار میدهد. یادداشتهای انتشار رسمی، حالت تجمیع جدید را چنین توصیف میکنند: قرار دادن مدلهای چند ارائهدهنده در همان فهرست مدل در Claude Code یا Codex تا بتوانید داخل کلاینت مدل را تغییر دهید: هر درخواست به ارائهدهنده مدلی که انتخاب میکنید میرود، بدون نیاز به خروج از کلاینت. باید بهصورت دستی روشن شود، در حال حاضر از Claude Code و Codex پشتیبانی میکند، بر اساس مدلی که انتخاب میکنید توزیع میکند، و جابهجایی خودکار در صورت خرابی ارائه نمیدهد.
آیا نسخه CLI از CC Switch وجود دارد؟
مربوط به خود CC Switch نیست. README بهطور مستقیم به پرسش درباره نسخه خط فرمان یا بدون رابط گرافیکی پاسخ میدهد: CC Switch فقط بهصورت یک اپلیکیشن دسکتاپ منتشر میشود که به رابط گرافیکی نیاز دارد. برای سرورها، نشستهای SSH یا ماشینهای بدون محیط دسکتاپ، CC Switch CLI را که جامعه نگهداری میکند توصیه میکند؛ پروژهای جداگانه که هم رابط کاربری تعاملی ترمینال (TUI) و هم حالت خط فرمان ارائه میدهد و با brew install cc-switch-cli نصب میشود؛ بهطور پیشفرض پوشه داده ~/.cc-switch را با اپلیکیشن دسکتاپ مشترک است و README هشدار میدهد که نسخه پایگاه دادهای که CLI پشتیبانی میکند گاهی از اپلیکیشن دسکتاپ عقب میماند. ویژگی دیگر مرتبط با CLI در README صفحه Apps است که نسخه ابزارهای خط فرمان مانند Claude Code و Codex را نمایش میدهد و بهروزرسانی میکند — این مدیریت آن ابزارهاست، نه اجرای CC Switch از ترمینال. بنابراین این صفحه هیچ فرمانی برای اجرای CC Switch از ترمینال فهرست نمیکند؛ فرمانهای نصبی که نقل میکند از خود README است.
آیا لینک درونریزی ccswitch:// هنگام بسته بودن اپلیکیشن از دست میرود؟
نه، از v4.0.10 به بعد از دست نمیرود. یادداشتهای رسمی رفتار قبلی را توصیف میکنند: در Windows و Linux کلیک روی لینک درونریزی در حالی که CC Switch اجرا نبود، برنامه را اجرا میکرد اما هیچ پنجره تأییدی نشان نمیداد، حالت سبک آن را در بازسازی پنجرهها از دست میداد و macOS برای همان لینک دو بار درخواست میکرد. اکنون لینک ابتدا ذخیره میشود و تنها زمانی که پنجره تأیید پدیدار شود پردازششده تلقی میشود، بنابراین یک وقفه آن را از بین نمیبرد و رسیدن دیرهنگام یک لینک قدیمیتر لینک جدیدتر را بازنویسی نمیکند. مستندات QCode اضافه میکند که نخستین اجرای ناشی از پیوند عمیق ccswitch:// پنجره را بازسازی میکند و کمی کندتر است.
کدام نقاط پایانی در ارائهدهندههای Claude و Codex در CC Switch وارد میشوند؟
برای هر کلاینت یک ارائهدهنده QCode ذخیره کنید: ورودی Claude مقدار ANTHROPIC_BASE_URL https://api.qcode.cc/api را با کلید cr_ شما میگیرد و ورودی Codex مقدار base_url https://api.qcode.cc/openai را با wire_api responses. هر دو از همان کلید API QCode.cc استفاده میکنند و مستندات QCode میگوید آنها سهمیه پلن شما را مشترکاً مصرف میکنند و دو بار صورتحساب نمیشوند. مدلهای Claude فقط روی نقطه پایانی پروتکل Anthropic اجرا میشوند و نمیتوان آنها را در نقطه پایانی سازگار با OpenAI وارد کرد.
در حالت تجمیع باید مراقب چه چیزهایی باشم؟
پنج نکتهای که پروژه بیان میکند. Claude Code باید 2.1.243 یا بالاتر باشد؛ تجمیع، جایگزینی خودکار در زمان خرابی ارائه نمیدهد؛ باید دستی فعال شود و در حال حاضر از Claude Code و Codex پشتیبانی میکند و اشتراکهای رسمی Claude فعلاً پشتیبانی نمیشوند؛ پس از تغییر فهرست تجمیعشده، Codex به راهاندازی مجدد نیاز دارد اما Claude Code نه؛ و تغییر مدل در میانه نشست باعث میشود مدل جدید کش prompt خود را بازسازی کند، بنابراین نخستین نوبت پس از تغییر محسوساً گرانتر است.
چگونه از چین سرزمین اصلی حساب QCode را شارژ کنم؟
با Alipay یا WeChat Pay. مستندات پرداخت QCode بیان میکند که برای پرداختهای به یوان از سرزمین اصلی چین، Alipay گزینه اول است — هیچ کارمزدی نمیگیرد — و WeChat Pay جایگزین آن است و هر دو موجودی یوان را شارژ میکنند؛ این صفحه همچنین میگوید حداقل شارژ به یوان ¥30 است. پس از شارژ، کلید cr_ خود را از کنسول در ورودی سفارشی ارائهدهنده CC Switch کپی کنید. صورتحساب بر اساس توکن؛ نرخ هر مدل در /models فهرست شده است.
منابع
سمت CC Switch: متن و فراداده دو انتشار GitHub در مخزن رسمی farion1231/cc-switch — v4.0.0 (published_at 2026-10-04T11:01:01Z، prerelease true) و v4.0.10 (published_at 2026-10-12T16:38:21Z، prerelease false) — به‌همراه README در شاخه main، همه در 2026-10-13 ثبت شده‌اند. سمت QCode: صفحه docs.qcode.cc برای راهاندازی CC Switch (با برچسب بهروزرسانی 2026-10-08)، صفحه نقاط پایانی و مسیرهای API، نمای کلی روش‌های پرداخت (بهروزرسانی 2026-10-01)، در همان روز ثبت شده‌اند. یادداشتهای انتشار v4.0.11 و فهرست رسمی انتشارها در 2026-10-14 بازیابی شدند. بازبینی 2026-10-26 در برابر انتشارهای 4.0.18–4.0.20 (2026-10-21، 10-23، 10-24)، README و ccswitch.io؛ بازبینی 2026-10-27 در برابر v4.0.21 (2026-10-26).
یک کلید API مشترک برای Claude Code و Codex
مقدار https://api.qcode.cc/api را در ورودی Claude و https://api.qcode.cc/openai را در ورودی Codex وارد کنید؛ هر دو ارائهدهنده از یک کلید API QCode.cc یکسان استفاده میکنند و سهمیه پلن شما را مشترکاً مصرف میکنند. صورتحساب بر اساس توکن؛ نرخ هر مدل در /models فهرست شده است.
مطالب مرتبط
سرویس رله API Claude Code: دو متغیر محیطی و صورتحساب
بازبینی‌شده در 2026-11-04: سرویس رله API Claude Code چیست، پروتکل Anthropic و Base URL، کلید و صورتحساب، روش‌های پرداخت و زمان‌های واریز، ویژگی‌ها و باورهای نادرست.
CC Switch CLI: نصب روی سرور و جابهجایی
CLI جامعه‌محور CC Switch که README رسمی آن را توصیه میکند: دستورهای نصب، زیردستورهای رایج، پوشه داده ~/.cc-switch مشترک با اپلیکیشن دسکتاپ، و فیلدهای QCode.
مهاجرت از CC Switch به magpie: دامنه درونریزی و نشستهای Codex (2026-11)
مراحل انتقال از CC Switch به magpie: درونریزی چه چیزهایی را منتقل میکند، چگونه نشستهای قدیمی Codex را مهاجرت دهید، آیا هر دو ابزار را هم‌زمان اجرا کنید، و چگونه سه آدرس QCode را پس از آن بررسی کنید.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
جزئیات این صفحه در 2026-10-13 بررسی شده است؛ سوابق انتشار نسخه فعلی دوباره در 2026-10-14 دریافت و 4.0.18–4.0.21 در 2026-10-27 دوباره بررسی شد. CC Switch یک ابزار متن‌باز شخص ثالث (مجوز MIT) است؛ ویژگی‌ها، متن رابط کاربری و رفتار جابهجایی آن تابع صفحه‌های انتشار رسمی و README است. فیلدهای پیکربندی QCode و روش‌های پرداخت تابع docs.qcode.cc و صفحه‌های سایت هستند و ممکن است بدون اطلاع قبلی تغییر کنند. دسترس‌پذیری مدل همان چیزی است که /models نشان میدهد.