راهنمای CC Switch: تغییر APIهای Claude Code و Codex با یک کلیک
بر اساس اطلاعات تا 2026-10-13، تغییر API در Claude Code با CC Switch به این صورت انجام می‌شود: در صفحه Claude، در بالا سمت راست روی + کلیک کنید تا یک پیکربندی سفارشی بسازید، ANTHROPIC_BASE_URL را روی https://api.qcode.cc/api و ANTHROPIC_AUTH_TOKEN را روی کلید شما که با cr_ شروع می‌شود قرار دهید، ذخیره کنید، سپس روی «فعال‌سازی» در کارت کلیک کنید. CC Switch هر دو مقدار را در ~/.claude/settings.json می‌نویسد و کلیک روی «فعال‌سازی» در کارت دیگر شما را به آن کارت جابه‌جا می‌کند. برای Codex، در صفحه Codex یک پیکربندی دوم با Base URL https://api.qcode.cc/openai ایجاد کنید. خط 4.0 اکنون انتشارهای پایدار دارد: بر اساس اطلاعات تا 2026-10-13، جدیدترین نسخه پایدار v4.0.11 است که در 2026-10-13 منتشر شده است (v4.0.10 قبلی در 2026-10-12 منتشر شد)؛ 4.0 حالت Aggregation را اضافه می‌کند، v4.0.10 مربوط به لینک‌های واردسازی یک‌کلیکی ccswitch:// است و v4.0.11 حذف نصب ابزارهای نصب‌شده از صفحه Apps را اضافه می‌کند که در ادامه به آن پرداخته شده است. این صفحه نصب، پیکربندی، جابه‌جایی و مشکلات رایج را بر اساس مستندات QCode و README رسمی CC Switch پوشش می‌دهد.
به‌روزرسانی شده 2026-11-14
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدل‌های چینی.
- صورت‌حساب به‌ازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- به‌صورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکته که پیش از شروع باید بدانید
نشانی Claude Code
ANTHROPIC_BASE_URL را روی https://api.qcode.cc/api و ANTHROPIC_AUTH_TOKEN را روی کلید شما که با cr_ شروع می‌شود قرار دهید؛ بدون اسلش انتهایی.
نشانی Codex
Base URL را روی https://api.qcode.cc/openai قرار دهید، نه /openai/v1، و wire_api = "responses" را در config.toml تولیدشده نگه دارید.
یک کلیک برای جابه‌جایی
Claude Code و Codex هر کدام در هر لحظه دقیقاً یک پیکربندی فعال دارند؛ روی «فعال‌سازی» در کارت دیگر کلیک کنید تا CC Switch آن مجموعه را دوباره در فایل پیکربندی بنویسد.
جدیدترین انتشار پایدار (بر اساس اطلاعات تا 2026-10-13)
در 2026-10-13 (UTC) منتشر شد؛ خط 4.0 با v4.0.4 (2026-10-07) پایدار شد، در حالی که v4.0.0 (2026-10-04) تا v4.0.3 (2026-10-06) در GitHub به‌عنوان پیش‌نمایش علامت‌گذاری شده‌اند.
CC Switch در واقع چه کاری انجام می‌دهد
بر اساس اطلاعات تا 2026-10-13، CC Switch یک اپلیکیشن دسکتاپ متن‌باز (با مجوز MIT) و چندسکویی برای Windows، macOS و Linux است که پیکربندی‌های API ابزارهای خط فرمان مانند Claude Code و Codex را به‌صورت کارت مدیریت می‌کند: یک کلیک روی «فعال‌سازی» مجموعه دیگری را جایگزین می‌کند. مستندات QCode آن را به‌عنوان یک جابه‌جاکننده پروفایل پیکربندی توصیف می‌کند. خودش یک نقطه پایانی استنتاج نیست؛ فقط هر پیکربندی را در فایل پیکربندی استاندارد ابزار می‌نویسد (~/.claude/settings.json برای Claude Code، ~/.codex/config.toml برای Codex)، هنگام فعال‌سازی یک کارت آن را بازنویسی می‌کند و هنگام جابه‌جایی دوباره آن را برمی‌گرداند. بنابراین Claude Code و Codex هر کدام در هر لحظه فقط یک پیکربندی در حال اعمال دارند و دو مجموعه هرگز با هم اعمال نمی‌شوند. README رسمی می‌گوید این ابزار جابه‌جایی یک‌کلیکی ارائه می‌دهد و دیگر نیازی به ویرایش دستی فایل‌های JSON، TOML یا YAML نیست؛ فهرست ابزارهای پشتیبانی‌شده بین نسخه‌ها تغییر می‌کند، بنابراین README رسمی را بررسی کنید.
انتشارهای اخیر CC Switch (بر اساس اطلاعات تا 2026-10-13)
تا 2026-10-13، جدیدترین انتشار پایدار در GitHub Releases نسخه v4.0.11 است که در 2026-10-13 (UTC) منتشر شده است. یادداشت‌های انتشار آن می‌گویند این انتشار قابلیت حذف نصب را اضافه می‌کند: ابزارهای نصب‌شده را می‌توان از صفحه Apps حذف نصب کرد، اما فقط نصب‌هایی که منبعشان قابل تأیید است، و داده‌های پیکربندی و نشست نگه داشته می‌شوند. انتشار پیش از آن، v4.0.10 که در 2026-10-12 منتشر شد، بر لینک‌های واردکردن یک‌کلیکی (پیوندهای عمیق ccswitch://) تمرکز دارد: اگر روی یک لینک کلیک شود در حالی که CC Switch در حال اجرا نیست، دیگر آن لینک از دست نمی‌رود، لینک‌ها می‌توانند قالب API را اعلام کنند، و پنجره تأیید به شما امکان می‌دهد انتخاب کنید که آیا درست پس از واردکردن تغییر دهید؛ راهنماهای صاحبان سایت به زبان‌های چینی، انگلیسی و ژاپنی و یک تولیدکننده لینک آنلاین همراه با آن منتشر شدند. آغاز این خط، v4.0.0 در 2026-10-04، به‌عنوان پیش‌نمایش علامت‌گذاری شد، مانند v4.0.1 و v4.0.2 در 2026-10-05 و v4.0.3 در 2026-10-06؛ v4.0.4 (2026-10-07) به‌عنوان پایدار منتشر شده است، و همچنین v4.0.10 و v4.0.11. یادداشت‌های v4.0 می‌گویند حالت Aggregation جدید مدل‌های چند ارائه‌دهنده را در یک انتخاب‌گر مدل Claude Code یا Codex قرار می‌دهد تا بتوانید درست در داخل کلاینت تغییر دهید، که این حالت به‌صورت اختیاری فعال می‌شود و در حال حاضر از Claude Code و Codex پشتیبانی می‌کند، و که هر درخواست را بر اساس مدلی که انتخاب می‌کنید ارسال می‌کند، بدون ارائه تعویض خودکار در صورت خطا. هسته نوشتن پیکربندی بازسازی شد، بنابراین تغییر فقط فیلدهای کلیدی را جایگزین می‌کند نه اینکه کل فایل را بازنویسی کند، و بقیه موارد نگه داشته می‌شوند. نسخه قبلی v3.20.4 که در 2026-09-22 منتشر شد، یک باگ را برطرف کرد که در آن ویرایش یا تغییر از یک پیکربندی Codex، کلید API ذخیره‌شده را پاک می‌کرد. مستند CC Switch در QCode در 2026-10-08 به‌روزرسانی شد و بیان می‌کند که با مستندات رسمی v3.20.3 (2026-09-11) راستی‌آزمایی شده است، آخرین بررسی در 2026-09-18 انجام شده، بنابراین ممکن است برچسب‌های رابط کاربری بین نسخه‌ها متفاوت باشند.
گاه‌شمار انتشار و مستندات
CC Switch v3.20.3 منتشر می‌شود؛ مستند CC Switch در QCode با مستندات رسمی این نسخه راستی‌آزمایی شده است. بر اساس مستند QCode، از این انتشار، ویرایشگر Claude یک کلید تغییر سریع Disable Artifact Tool دریافت می‌کند.
v3.20.4 منتشر می‌شود و یک باگ را برطرف می‌کند که در آن ویرایش یا تغییر از یک پیکربندی Codex، کلید API ذخیره‌شده را پاک می‌کرد؛ تا زمانی که v4.0.4 در 2026-10-07 نسخه 4.0 را پایدار کرد، این نسخه جدیدترین انتشار پایدار در GitHub بود.
پیش‌نمایش v4.0.0 با حالت Aggregation جدید منتشر می‌شود و هنگام تغییر، فقط فیلدهای کلیدی را جایگزین می‌کند نه اینکه کل فایل را بازنویسی کند؛ v4.0.4 (2026-10-07) پایدار است و تا 2026-10-13 این خط به v4.0.11 رسیده بود؛ v4.0.10 پیش از آن (2026-10-12) بر لینک‌های واردکردن یک‌کلیکی ccswitch:// تمرکز داشت و v4.0.11 حذف نصب ابزارهای نصب‌شده را اضافه می‌کند.
تأییدشده در برابر مستندنشده یا متناقض
تأییدشده (عیناً در مستندات)
هر مورد از موارد زیر را می‌توان واژه‌به‌واژه در مستندات QCode، README رسمی CC Switch، راهنمای کاربری آن یا یادداشت‌های انتشار GitHub بررسی کرد: پیکربندی Claude Code از ANTHROPIC_BASE_URL = https://api.qcode.cc/api و ANTHROPIC_AUTH_TOKEN = کلیدی که با cr_ شروع می‌شود استفاده می‌کند، و فعال‌کردن آن هر دو را در ~/.claude/settings.json می‌نویسد؛ Base URL در Codex برابر https://api.qcode.cc/openai است، و CC Switch فایل‌های ~/.codex/config.toml و ~/.codex/auth.json را با wire_api = "responses" تولید می‌کند؛ کلید تغییر وضعیت در پنل Codex برای تبدیل پراکسی محلی، که برای سرویس‌هایی در نظر گرفته شده است که فقط Chat Completions را پشتیبانی می‌کنند، برای QCode خاموش می‌ماند؛ در هر زمان فقط یک پیکربندی فعال است؛ پیکربندی‌های Claude و Codex می‌توانند یک کلید را مشترکاً استفاده کنند؛ CC Switch برای هر پیکربندی یک کلید جداگانه ذخیره می‌کند؛ بررسی اتصال روی کارت، کلید را اعتبارسنجی نمی‌کند؛ تا 2026-10-13، جدیدترین انتشار پایدار در GitHub نسخه v4.0.11 است که در 2026-10-13 منتشر شده است (نسخه قبلی v4.0.10 در 2026-10-12)، v4.0.0 تا v4.0.3 به‌عنوان پیش‌نمایش علامت‌گذاری شده‌اند و از v4.0.4 (2026-10-07) به بعد پایدار است؛ یادداشت‌های v4.0 می‌گویند Aggregation به‌صورت اختیاری فعال می‌شود و مدل‌های چند ارائه‌دهنده را در یک فهرست مدل قرار می‌دهد، و یادداشت‌های v4.0.10 می‌گویند لینک واردکردن ccswitch:// حتی وقتی برنامه در حال اجرا نیست از دست نمی‌رود.
مستندنشده یا متناقض
این صفحه درباره سه نکته نتیجه‌گیری نمی‌کند. نخست، اینکه Claude Code پس از یک تغییر نیاز به راه‌اندازی مجدد دارد یا نه: README رسمی می‌گوید Claude Code از تغییر بدون نیاز به راه‌اندازی مجدد پشتیبانی می‌کند، و پرسش‌های متداول در راهنمای کاربر رسمی می‌گوید راه‌اندازی مجدد معمولاً لازم نیست و تنها اضافه می‌کند که اگر تغییر اعمال نشد باید ترمینال را ببندید و دوباره باز کنید یا IDE را راه‌اندازی مجدد کنید؛ issue #3057 که در مستندات QCode ذکر شده، نشستی در حال اجرا را ثبت کرده که همچنان از پیکربندی قدیمی استفاده می‌کرده است. روی نسخه خودتان آزمایش کنید و اگر درخواست‌ها همچنان به آدرس قدیمی می‌روند، نشست را دوباره باز کنید. دوم، اینکه فعال کردن یک پیکربندی ویرایش‌های دستی شما روی settings.json را پاک می‌کند یا نه: مستندات QCode گزارش‌هایی را ثبت کرده که برخی نسخه‌ها کل فایل را بازنویسی می‌کنند و enabledPlugins و hooks را حذف می‌کنند، و توصیه می‌کند پیش از آن پشتیبان بگیرید؛ یادداشت‌های v4.0 و پرسش‌های متداول راهنمای کاربر می‌گویند تغییر فقط فیلدهای آدرس، اعتبارنامه‌ها، مدل و پروتکل را جایگزین می‌کند، در حالی که پلاگین‌ها، hooks، مجوزها، MCP و متغیرهای محیطی، توضیحات و قالب‌بندی خودتان همه همان‌طور که هستند حفظ می‌شوند، و 4.0 از v4.0.4 (2026-10-07) پایدار بوده است، اما این صفحه رفتار واقعی آن نسخه را آزمایش نکرده است. سوم، اسلش پایانی در Base URL: نقاط پایانی QCode به آن نیاز ندارند، و اینکه خود CC Switch چگونه با آن برخورد می‌کند، بر اساس مستندات QCode، در مستندات رسمی پوشش داده نشده است.
CC Switch یا ویرایش دستی فایل‌های پیکربندی
CC Switch در برابر ویرایش دستی
هر دو همان فایل‌ها را تغییر می‌دهند: CC Switch مقادیر ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN را در ~/.claude/settings.json می‌نویسد و base_url و کلیدهای مرتبط را در ~/.codex/config.toml؛ خودش یک نقطه پایانی استنتاج نیست. اگر اغلب بین چند پیکربندی جابه‌جا می‌شوید، برای مثال بین asia.qcode.cc و api.qcode.cc در شبکه سرزمین اصلی چین، یا برای مقایسه بین ورود رسمی و QCode، CC Switch در زمان صرفه‌جویی می‌کند. اگر فقط از یک پیکربندی استفاده می‌کنید، یا روی سروری بدون دسکتاپ کار می‌کنید، ویرایش دستی مستقیم‌تر است: CC Switch فقط به‌صورت اپلیکیشن دسکتاپ عرضه می‌شود که به رابط گرافیکی نیاز دارد، و برای ماشین‌های بدون دسکتاپ README رسمی CC Switch CLI را که توسط جامعه نگهداری می‌شود توصیه می‌کند.
Claude Code در برابر Codex
در CC Switch آن‌ها دو صفحه با دو پیکربندی هستند: Claude به ~/.claude/ و Codex به ~/.codex/ می‌رود، بدون اینکه با یکدیگر تداخل کنند، بنابراین کافی است claude و codex را در ترمینال‌های جداگانه اجرا کنید. تفاوت در پروتکل و آدرس است: Claude Code از پروتکل Anthropic با https://api.qcode.cc/api استفاده می‌کند، و Codex از پروتکل OpenAI Responses با https://api.qcode.cc/openai. مستندات QCode بیان می‌کند که مدل‌های Claude فقط از طریق نقطه پایانی Anthropic کار می‌کنند و Codex باید از Responses استفاده کند؛ هر دو پیکربندی می‌توانند همان کلید cr_ را بپذیرند.
شش گام: نصب، پیکربندی، جابه‌جایی
① نصب: بسته‌ای را از GitHub Releases مربوط به CC Switch دانلود کنید. برای Windows 10 و نسخه‌های بعدی، .msi یا .zip قابل حمل را بردارید؛ برای macOS 12 و نسخه‌های بعدی، .dmg را بردارید یا brew install --cask cc-switch را اجرا کنید؛ برای Linux، .deb، .rpm یا .AppImage را بردارید (به‌طور رسمی glibc 2.35+ و WebKitGTK 4.1 لازم است)، و Arch از paru -S cc-switch-bin استفاده می‌کند. ② راه‌اندازی Claude Code: در جابه‌گر بالای صفحه Claude را انتخاب کنید، روی + در بالا سمت راست کلیک کنید، Custom را به‌عنوان پیش‌تنظیم انتخاب کنید، و در JSON پیکربندی، ANTHROPIC_BASE_URL را روی https://api.qcode.cc/api و ANTHROPIC_AUTH_TOKEN را روی کلید cr_ خود تنظیم کنید؛ نام را خودتان انتخاب می‌کنید و مثال مستندات از QCode.cc استفاده می‌کند. ③ ذخیره کنید، نشانگر را روی کارت ببرید و روی Enable کلیک کنید؛ CC Switch هر دو مقدار را در ~/.claude/settings.json می‌نویسد. برای بررسی، claude را در ترمینال اجرا کنید. ④ راه‌اندازی Codex: به Codex بروید، روی + کلیک کنید و Custom را انتخاب کنید، Base URL را روی https://api.qcode.cc/openai، کلید API را روی همان کلید cr_ و مدل پیش‌فرض را روی gpt-6-sol یا gpt-5.6-terra تنظیم کنید؛ نام را خودتان انتخاب می‌کنید و مثال مستندات از qcode با حروف کوچک استفاده می‌کند (که به‌عنوان کلید TOML مناسب است) و در config.toml به‌صورت model_provider = "qcode" ظاهر می‌شود. کلید تغییر وضعیت پنل برای تبدیل پروکسی محلی را خاموش بگذارید؛ این گزینه برای سرویس‌هایی است که فقط از Chat Completions پشتیبانی می‌کنند. ⑤ ذخیره کنید، روی Enable کلیک کنید و برای بررسی codex را اجرا کنید؛ config.toml باید شامل base_url = "https://api.qcode.cc/openai" و wire_api = "responses" باشد. ⑥ برای جابه‌جایی در آینده، روی Enable در کارت دیگری کلیک کنید یا روی نام پیکربندی در سینی سیستم کلیک کنید. ابتدا ~/.claude/settings.json (برای Codex، ~/.codex/config.toml) را باز کنید تا مطمئن شوید آدرس تغییر کرده است؛ برای Codex ترمینال را دوباره راه‌اندازی کنید، و اگر Claude Code هنوز از آدرس قدیمی استفاده می‌کند، نشست را ببندید و نشست جدیدی باز کنید. اگر نسخه دومی برای asia.qcode.cc ذخیره می‌کنید، پسوندی مانند (asia) به نام آن اضافه کنید تا بتوانید آن‌ها را در سینی سیستم از هم تشخیص دهید. دو مورد دیگر نیز پس از 4.0 تغییر کرده است. مورد اول حالت Aggregation است: از v4.0 به‌صورت اختیاری فعال می‌شود، README می‌گوید Claude Code 2.1.243 یا جدیدتر لازم است، و هیچ failover ارائه نمی‌دهد؛ وقتی چند ارائه‌دهنده اضافه می‌کنید، مدل‌های آن‌ها همگی در انتخاب‌گر مدل Claude Code یا Codex ظاهر می‌شوند و هر درخواست به ارائه‌دهنده مدلی می‌رود که انتخاب می‌کنید. برای نحوه استفاده از آن، صفحه جداگانه CC Switch 4.0 Aggregation mode در همین سایت را ببینید. مورد دوم لینک‌های درون‌ریزی یک‌کلیکی است: یک لینک ccswitch:// در وب‌سایت خود ارائه‌دهنده، پیکربندی را برای شما راه‌اندازی می‌کند، و از v4.0.10 (2026-10-12)، حتی اگر CC Switch در حال اجرا نباشد، لینک از دست نمی‌رود، و پنجره تأیید به شما اجازه می‌دهد انتخاب کنید که بلافاصله پس از درون‌ریزی جابه‌جا شوید یا نه.
درباره QCode
در QCode، پیکربندی‌های Claude Code و Codex می‌توانند از همان کلید cr_ (که در کنسول ایجاد شده است) استفاده کنند: کلید در میان پروتکل‌ها کار می‌کند و مسیر درخواست تعیین می‌کند کدام پروتکل استفاده شود. پیکربندی Claude Code از https://api.qcode.cc/api با مدل‌هایی مانند claude-sonnet-5، claude-sonnet-5-5 یا claude-opus-5 استفاده می‌کند و همچنین می‌توانید مدل‌ها را با /model در داخل Claude Code تغییر دهید؛ پیکربندی Codex از https://api.qcode.cc/openai با gpt-6-sol یا gpt-5.6-terra استفاده می‌کند. سه دامنه دسترسی امکانات یکسانی ارائه می‌دهند و کلید یکسانی را می‌پذیرند: us.qcode.cc به آمریکای شمالی و اروپا سرویس می‌دهد، و برای شبکه‌های چین سرزمین اصلی، مستندات asia.qcode.cc را با مسیرهای بدون تغییر توصیه می‌کنند، بنابراین می‌توانید برای هر دامنه یک پیکربندی CC Switch نگه دارید. استفاده مشترک از یک کلید در دو پیکربندی به دوبار شارژ شدن منجر نمی‌شود؛ مصرف بر اساس توکن محاسبه می‌شود و نرخ هر مدل در /models است. هر درخواست را می‌توانید با وارد کردن کلید خود در probe.qcode.cc بررسی کنید.
پرسش‌های متداول
در CC Switch جابه‌جایی انجام شد، اما Claude Code آن را اعمال نکرد. حالا چه باید کرد؟
ابتدا فایل را بررسی کنید، سپس نشست را دوباره باز کنید. فایل ~/.claude/settings.json را باز کنید و تأیید کنید که ANTHROPIC_BASE_URL اکنون پیکربندی‌ای را نشان می‌دهد که همین حالا فعال کرده‌اید؛ اگر فایل تغییر کرده اما نشست تغییر نکرده است، claude در حال اجرا را ببندید و آن را در ترمینال جدید دوباره اجرا کنید. Issue #3057 که در مستندات QCode به آن استناد شده، دقیقاً همین را ثبت می‌کند: Claude Code هنگام شروع فرایند، بلوک env در settings.json را به متغیرهای محیطی می‌خواند و نشست در حال اجرا آن را دوباره نمی‌خواند. درباره اینکه اصلاً به راه‌اندازی مجدد نیاز است یا نه، هر دو منبع رسمی اکنون می‌گویند معمولاً نه: README رسمی می‌گوید Claude Code از تعویض داغ بدون راه‌اندازی مجدد پشتیبانی می‌کند، و پرسش‌های متداول راهنمای کاربر می‌گوید راه‌اندازی مجدد معمولاً لازم نیست و می‌افزاید اگر اعمال نشد باید ترمینال را ببندید و دوباره باز کنید یا IDE را دوباره راه‌اندازی کنید؛ برای Codex، هر دو می‌گویند ترمینال را دوباره راه‌اندازی کنید. جابه‌جایی از سینی سیستم همان فایل را می‌نویسد و claude در حال اجرا را برای شما پایان نمی‌دهد. اگر از Aggregation استفاده می‌کنید، یک لایه دیگر هم هست: README رسمی و پرسش‌های متداول راهنمای کاربر می‌گویند تغییرات مدل‌های تجمیع‌شده Claude Code فوراً اعمال می‌شوند، در حالی که Codex هر زمان وارد Aggregation شوید یا از آن خارج شوید یا فهرست مدل‌های تجمیع‌شده را تغییر دهید به راه‌اندازی مجدد کامل نیاز دارد. Aggregation در صفحه جداگانه «حالت Aggregation در CC Switch 4.0» در همین سایت توضیح داده شده است.
چگونه منشأ خطای 401 Unauthorized را پیدا کنم؟
معمولاً یک پیکربندی کلید اشتباه دارد. مطمئن شوید که کلید با cr_ شروع می‌شود و فاصله‌ای در ابتدا یا انتها ندارد، سپس در کنسول بررسی کنید که هنوز معتبر است. اگر Claude Code خطای 401 برمی‌گرداند در حالی که Codex کار می‌کند (یا برعکس)، مورد معیوب همان پیکربندی است: CC Switch برای هر پیکربندی یک کلید جداگانه ذخیره می‌کند، بنابراین هنگام تغییر کلیدها هر یک را به‌روزرسانی کنید. همچنین توجه داشته باشید که بررسی اتصال روی یک کارت فقط بررسی می‌کند که آیا آدرس قابل دسترسی است یا نه؛ راهنمای کاربر رسمی می‌گوید کلید را اعتبارسنجی نمی‌کند، بنابراین یک بررسی موفق ثابت نمی‌کند که کلید درست است.
Codex بعد از اجرا مدام می‌چرخد. چه چیزی را باید بررسی کنم؟
ابتدا ~/.codex/config.toml را بررسی کنید. base_url باید به /openai ختم شود، نه /openai/v1، و wire_api = "responses" باید باقی بماند. مستندات QCode می‌گوید شایع‌ترین علت، نبودن model_provider در سطح بالا است، یا وجود یکی که با نام جدول [model_providers.xxx] مطابقت ندارد؛ در این صورت Codex به نقطه پایانی داخلی openai خود بازمی‌گردد. پس از رفع آن، ترمینال را دوباره باز کنید و دوباره codex را اجرا کنید.
آیا می‌توان از Claude Code و Codex هم‌زمان استفاده کرد؟
بله. CC Switch پیکربندی Claude را در ~/.claude/ و پیکربندی Codex را در ~/.codex/ می‌نویسد؛ آن‌ها با هم تداخل ندارند، بنابراین کافی است claude و codex را در ترمینال‌های جداگانه اجرا کنید. هر دو می‌توانند از همان کلید cr_ استفاده کنند: Claude Code روی https://api.qcode.cc/api و Codex روی https://api.qcode.cc/openai. مستندات QCode می‌گویند اشتراک‌گذاری یک کلید به این روش باعث شارژ مضاعف نمی‌شود، صرفاً به این دلیل که پیکربندی دوم ایجاد کرده‌اید.
settings.json را دستی ویرایش کردم. آیا فعال کردن پیکربندی دیگر تغییرات من را پاک می‌کند؟
طبق منابع رسمی برای نسخه فعلی خیر — این صفحه آن را آزمایش نکرده است، بنابراین تهیه نسخه پشتیبان پیش از فعال‌سازی، اقدام ایمن است. مستندات QCode بیان می‌کند که وقتی یک پیکربندی را فعال می‌کنید، CC Switch فیلدهای مطابق در ~/.claude/settings.json را با مقادیر آن پیکربندی بازنویسی می‌کند، که پیش از آن تهیه نسخه پشتیبان را توصیه می‌کند، و اینکه گزارش شده برخی نسخه‌ها کل فایل را بازنویسی می‌کردند و enabledPlugins و hooks را حذف می‌کردند؛ یادداشت‌های انتشار v4.0 و پرسش‌های متداول راهنمای کاربر می‌گویند جابه‌جایی اکنون فقط فیلدهای کلید را جایگزین می‌کند، در حالی که plugins، hooks، permissions، MCP و متغیرهای محیطی که خودتان اضافه کرده‌اید، کامنت‌ها و قالب‌بندی همگی همان‌طور که هستند حفظ می‌شوند، و 4.0 از v4.0.4 (2026-10-07) پایدار بوده است. اگر چیزی از دست رفت، آن را از ~/.cc-switch/backups/ (مستندات رسمی می‌گویند 10 مورد آخر نگه داشته می‌شوند) یا از یک خروجی با نام cc-switch-export-{timestamp}.sql بازیابی کنید. همچنین، CC Switch در اولین اجرا، تنظیمات موجود Claude Code و Codex شما را به‌عنوان پیکربندی‌ای با نام default وارد می‌کند.
چگونه به ورود رسمی Anthropic برگردم؟
پیکربندی رسمی داخلی را در فهرست انتخاب کنید (Claude Official برای Claude Code، OpenAI Official برای Codex؛ اگر آن را حذف کرده‌اید، از پیش‌تنظیم‌ها دوباره اضافه کنید)، روی «Enable» کلیک کنید، CLI را دوباره راه‌اندازی کنید و فرایند ورود خود ابزار را طی کنید: /login در Claude Code، codex login برای Codex. پس از آن می‌توانید بین ورود رسمی و پیکربندی سفارشی QCode خود رفت‌وبرگشت کنید. مستندات QCode نسبت به ساخت دستی پیکربندی ترکیبی با بلوک env خالی که همچنان یک کلید cr_ را نگه می‌دارد هشدار می‌دهد.
منابع
راه‌اندازی، نشانی‌ها و عیب‌یابی: صفحه مستندات QCode درباره CC Switch (به‌روزرسانی 2026-10-08؛ در آن آمده که با مستندات رسمی CC Switch v3.20.3 (2026-09-11) راستی‌آزمایی شده است و آخرین بررسی آن در 2026-09-18 بوده است) و صفحه مربوط به نقاط پایانی و قالب‌های API (اینکه کدام پروتکل از کدام نقطه پایانی استفاده می‌کند، سه دامنه دسترسی و قاعده اسلش انتهایی)، هر دو در 2026-10-13 خزش شده‌اند. مراحل نصب خود CC Switch، الزامات سیستم، رفتار تعویض، بررسی اتصال و ورود رسمی: README در مخزن GitHub مربوط به CC Switch (مجوز MIT) و صفحه پرسش‌های متداول راهنمای کاربری رسمی، که در همان روز خزش شده‌اند. نسخه‌ها و تاریخ‌ها: GitHub Releases API و یادداشت‌های انتشار CC Switch (v3.20.4، v4.0.0 تا v4.0.4، v4.0.10 و v4.0.11، همراه با تاریخ‌های انتشار و برچسب‌های preview یا stable)، که در همان روز خزش شده‌اند.
اتصال CC Switch به QCode
یک کلید cr_: Claude Code روی /api، Codex روی /openai، با یک کلیک روی Enable تعویض کنید. صورت‌حساب بر اساس توکن محاسبه می‌شود؛ نرخ هر مدل را در /models ببینید.
مطالب مرتبط
راه‌اندازی نقطه پایانی سفارشی Claude Code
دو متغیر محیطی، قالب settings.json و apiKeyHelper.
راهنمای راه‌اندازی API شخص ثالث در Codex CLI
نحوه تنظیم model_provider، base_url و env_key در config.toml.
حالت تجمیع CC Switch 4.0 و وارد کردن با یک کلیک
حالت مستقیم، مسیریابی و تجمیع به سه تب تقسیم شده‌اند؛ تجمیع چند ارائه‌دهنده را در یک فهرست مدل قرار می‌دهد؛ لینک‌های ccswitch:// پس از بسته‌شدن برنامه نیز باقی می‌مانند؛ هیچ ساخت خط فرمانی در README وجود ندارد.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
مراحل و نقل‌قول‌های این صفحه در 2026-10-13 بررسی شده‌اند؛ صفحات رسمی، یعنی مستندات QCode، README رسمی CC Switch و یادداشت‌های انتشار GitHub، اولویت دارند. برچسب‌های رابط کاربری CC Switch و رفتار تعویض آن بین نسخه‌ها تغییر می‌کنند، بنابراین بر اساس نسخه‌ای که دارید عمل کنید؛ در دسترس بودن مدل‌ها همان چیزی است که /models نشان می‌دهد.