دانلود CC Switch: آخرین نسخه v4.0.28 و راهاندازی
CC Switch v4.0.28 (2026-11-08): ccswitch.io تنها وبسایت رسمی است. از GitHub Releases دانلود کنید، سپس QCode.cc را به Claude Code یا Codex CLI اضافه کنید.
به کلید API نیاز دارید؟ ثبتنام ←نقاط پایانی و Base URL ←
در این صفحه
- نگاه کلی
- چرا از CC Switch استفاده کنیم
- پیشنیازها
- وبسایت، دانلود و نصب بر اساس سیستمعامل
- خط فرمان (CLI): نسخه رسمی وجود ندارد، اما یک CC Switch CLI ساختهشده توسط جامعه موجود است
- پیکربندی ارائهدهنده Claude (برای Claude Code)
- پیکربندی ارائهدهنده Codex (برای Codex CLI)
- اپ دسکتاپ Codex
- جابهجایی بین چند ارائهدهنده/حساب کاربری
- موارد استفاده
- ویژگیهای پیشرفته Claude Code (که همچنان از طریق QCode کار میکنند)
- درباره Gemini / Antigravity
- انتخاب نقطه پایانی برای شبکه شما
- یک کلید برای Claude و Codex
- پس از اتصال: تغییر، همزیستی، بازیابی
- نکات کاربردی
- پرسشهای متداول
- دکمه «Enable» پس از ذخیره قابل کلیک نیست
- هر درخواست Claude Code در 2.1.265–2.1.267 با خطای 400 مواجه میشود (طرحواره Artifact)
- خطای 401 Unauthorized
- جابهجایی ارائهدهندهها اثری نداشت
- Codex هنگام راهاندازی بیپایان میچرخد
- آیا میتوان همزمان از Claude و Codex استفاده کرد؟
- settings.json را دستی ویرایش کردهام — آیا فعالسازی باعث از دست رفتن آن میشود؟
- چگونه میتوان به ورود رسمی Anthropic بازگشت؟
- حالت تجمیع در v4.0 و درونریزی با ccswitch:// در v4.0.10 (2026-10)
- گامهای بعدی
آخرین بازبینی: 2026-11-09 · 📄 بر پایه مستندات رسمی (CC Switch v4.0.28، منتشرشده در 2026-11-08؛ بخشهای دانلود، CLI و فهرست کلاینت با README، Releases و CHANGELOG در 2026-11-09 مطابقت داده شد)
نگاه کلی¶
| مورد | جزئیات |
|---|---|
| مدلهای قابل استفاده | به خود CLI مدیریتشده بستگی دارد: Claude Code (Claude ✅)، Codex (GPT ✅)، OpenCode / OpenClaw / Hermes Agent — CC Switch یک نقطه پایانی استنتاج نیست؛ فقط فایلهای پیکربندی هر CLI را مینویسد |
| پروتکل و Base URL | برای هر هدف مدیریتشده: نقطه پایانی Claude https://api.qcode.cc/api · نقطه پایانی Codex https://api.qcode.cc/openai |
| محل پیکربندی | درون برنامه؛ در ~/.claude/settings.json، ~/.codex/config.toml و غیره نوشته میشود |
| مستندات رسمی | وبسایت · مخزن GitHub · راهنمای کاربر |
CC Switch یک برنامه دسکتاپ چندسکویی (Windows / macOS / Linux) است که پیکربندیهای ارائهدهندگان API را برای Claude Code، Claude Desktop، Codex، Gemini CLI، Grok Build، OpenCode، OpenClaw، Hermes، Pi، MiniMax Code، Kimi Code و Oh My Pi از یک رابط کاربری مدیریت میکند، بهعلاوه Antigravity CLI (agy) از نسخه v4.0.18 (فهرست برگرفته از README رسمی که در 2026-10-26 بررسی شده است؛ سه افزوده در ادامه پوشش داده میشوند). این راهنما نشان میدهد چگونه QCode.cc را بهعنوان ارائهدهنده سفارشی در CC Switch اضافه کنید، چگونه با یک کلیک بین چند ارائهدهنده/حساب کاربری جابهجا شوید، و موارد استفاده رایج و عیبیابی را پوشش میدهد.
چرا از CC Switch استفاده کنیم¶
- بدون ویرایش دستی پیکربندی: فرمهای بصری جایگزین
settings.json/config.tomlمیشوند - جابهجایی ارائهدهنده با یک کلیک: فوراً بین qcode.cc، Anthropic رسمی و پراکسیهای محلی جابهجا شوید
- اکوسیستم Claude + Codex: پیکربندیهای Claude Code و Codex CLI را در یک برنامه واحد مدیریت کنید
- مدیریت چند حساب کاربری / چند پلن: چند پیکربندی برای همان ارائهدهنده (مثلاً یک کلید کاری و یک کلید شخصی) ذخیره کنید و هر زمان خواستید جابهجا شوید
- میانبرهای سینی سیستم: بدون باز کردن پنجره اصلی، از منوی سینی ارائهدهنده را عوض کنید
CC Switch در اصل یک «جابهجاکننده پروفایل پیکربندی» است: هر ارائهدهنده یک پروفایل است، و جابهجایی فقط فیلدهای اصلی را در فایل پیکربندی CLI هدف (نقطه پایانی، کلید، نام مدل، پروتکل و غیره) جایگزین میکند و بقیه چیزها سر جای خود میمانند (README رسمی). در هر لحظه فقط یک ارائهدهنده فعال است، که به شما کمک میکند از فرض فعال بودن همزمان چند ارائهدهنده پرهیز کنید.
پیشنیازها¶
- Claude Code CLI یا Codex CLI نصب شده باشد
- یک کلید API QCode.cc (با
cr_شروع میشود) که از داشبورد در دسترس است - همین کلید در چندین نقطه پایانی پروتکل (Anthropic، OpenAI و غیره) کار میکند — به نقاط پایانی و قالبهای API مراجعه کنید
وبسایت، دانلود و نصب بر اساس سیستمعامل¶
تا تاریخ 2026-11-09، README رسمی CC Switch میگوید: «تنها وبسایت رسمی: ccswitch.io». کد منبع و نصبکنندهها در مخزن GitHub و در صفحه انتشارها آن قرار دارند؛ آخرین نسخه v4.0.28 است (منتشرشده در 2026-11-08، بر اساس صفحه انتشار و CHANGELOG). بازبینی 2026-10-26 این صفحه نسخه v4.0.20 را بررسی کرد (منتشرشده در 2026-10-24)؛ بازبینی 2026-10-15 نسخه v4.0.12 را بررسی کرد (منتشرشده در 2026-10-14). فقط از این دو مکان دانلود کنید.
نیازمندیهای سیستم (README رسمی):
- Windows: Windows 10 و بالاتر
- macOS: macOS 12 (Monterey) و بالاتر
- Linux: x86_64 یا ARM64 با glibc 2.35+ و WebKitGTK 4.1، مثلاً Ubuntu 22.04+، Debian 12+، Fedora جدید؛ RHEL / Rocky / Alma 8–9 هنوز پشتیبانی نمیشوند
در نام فایلهای زیر، {version} آخرین نسخه در صفحه انتشارها است (برای مثال 4.0.28):
| سیستمعامل | دانلود و نصب |
|---|---|
| Windows | نصبکننده CC-Switch-v{version}-Windows.msi، یا نسخه قابلحمل CC-Switch-v{version}-Windows-Portable.zip؛ در Windows روی ARM از CC-Switch-v{version}-Windows-arm64.msi یا CC-Switch-v{version}-Windows-arm64-Portable.zip استفاده کنید |
| macOS | Homebrew توصیه میشود: brew install --cask cc-switch (بهروزرسانی با brew upgrade --cask cc-switch)؛ یا CC-Switch-v{version}-macOS.dmg را (توصیهشده) یا .zip را بهصورت دستی دانلود کنید. این یک نسخه یونیورسال است که بهصورت بومی روی Apple Silicon و Intel اجرا میشود؛ README میگوید کد آن امضا شده و توسط Apple نوتریزه (notarization) شده است، بنابراین میتوانید مستقیماً آن را نصب و باز کنید |
| Linux | .deb (Debian / Ubuntu)، .rpm (Fedora و سایر توزیعهایی که WebKitGTK 4.1 را همراه دارند)، .AppImage (هر توزیعی که نیازمندیهای بالا را برآورده کند)، هرکدام در x86_64 و arm64، با نامی مانند CC-Switch-v{version}-Linux-x86_64.deb |
| Arch Linux | paru -S cc-switch-bin |
Flatpak بخشی از انتشارهای رسمی نیست؛ README میگوید میتوانید خودتان آن را از .deb بسازید (به flatpak/README.md در مخزن مراجعه کنید). پس از نصب، در ادامه با «پیکربندی ارائهدهنده Claude» در پایین پیش بروید.
هشدار منابع رسمی و کلاینتهای افزودهشده در v4.0.18–v4.0.20 (2026-10-26)¶
یادداشتهای انتشار رسمی هشداری درباره جعل دارند که عیناً نقل میشود: «هر وبسایت یا کلاینت CC Switch که از شما پرداخت، شارژ حساب یا اطلاعات ورود بخواهد، جعلی است.» میافزایند که اگر فریب داده شدهاید و پرداخت کردهاید، باید تراکنش را متوقف کنید و آن را از طریق GitHub Issues گزارش دهید. فقط از ccswitch.io و GitHub Releases دانلود کنید.
سه کلاینت در انتشارهای 4.0.18–4.0.20 به فهرست مدیریتشده پیوستند (تاریخها از CHANGELOG):
- v4.0.18 (2026-10-21) — Antigravity CLI. یادداشتها آن را «یازدهمین برنامهای که CC Switch مدیریت میکند» مینامند و میگویند: «ارائهدهنده Antigravity فقط زمانی اثر میکند که agy در ترمینالی از CC Switch اجرا شود.» Antigravity CLI به سرویسی سازگار با Gemini API نیاز دارد. QCode در حال حاضر سری Gemini را ارائه نمیدهد.
- v4.0.19 (2026-10-23) — Kimi Code، «دوازدهمین برنامهای که CC Switch مدیریت میکند». پیکربندی آن در
~/.kimi-code/config.tomlیا در پوشهای است که باKIMI_CODE_HOMEتعیین میشود، وقتی که آن تنظیم شده باشد (یادداشتهای انتشار). - v4.0.20 (2026-10-24) — Oh My Pi، «سیزدهمین برنامهای که CC Switch مدیریت میکند». پیکربندی آن در
~/.omp/agentیا در~/.omp/profiles/<name>/agentاست، وقتی از پروفایل نامدار استفاده میکنید (یادداشتهای انتشار).
آنچه v4.0.21 (2026-10-26) در این پیکربندی تغییر میدهد¶
v4.0.21 در بخش حسابها امکان جابهجایی میان چند حساب کاربری اشتراک رسمی Claude را اضافه میکند؛ این موضوع به کارتهای رسمی Claude مربوط است، در حالی که ارائهدهنده QCode همچنان یک ارائهدهنده سفارشی با Base URL و کلید مخصوص خودش است. دو تغییر به فیلدهای این صفحه مربوط میشوند: در فرم ارائهدهنده Codex، هر ردیف از فهرست مدلها اکنون یک دستگیره کشیدن دارد، و همین ترتیب، ترتیب منوی /model در Codex است؛ وقتی ردیف اول نماینده مدل پیشفرض است، مدلی که به ردیف اول کشیده میشود پیشفرض جدید میشود (issue #8870)؛ و باز کردن ترمینال از منوی ⋯ به روی کارت منتقل شده و بهصورت دکمه نمادین در سمت چپ ویرایش قرار گرفته است. این انتشار همچنین مشکل رفتن درخواستهای Codex به آدرسی متفاوت از طریق مسیریابی را برطرف میکند.
خط فرمان (CLI): نسخه رسمی وجود ندارد، اما یک CC Switch CLI ساختهشده توسط جامعه موجود است¶
تا تاریخ 2026-10-26، خود CC Switch هیچ نسخه رسمی خط فرمان ندارد. پرسشهای متداول رسمی بیان میکند که CC Switch فقط بهصورت یک اپلیکیشن دسکتاپ منتشر میشود که به رابط گرافیکی نیاز دارد. برای سرورها، نشستهای SSH یا ماشینهای بدون دسکتاپ، README رسمی، CC Switch CLI را که توسط جامعه نگهداری میشود توصیه میکند — یک انشعاب (fork) خط فرمان از CC Switch که بهطور جداگانه توسط نویسندهای دیگر منتشر شده و محصول رسمی CC Switch نیست. این صفحه آن را ویژگیبهویژگی تست نکرده است؛ پیش از تکیه بر آن، README آن را بخوانید.
نصب (از README همان پروژه؛ آخرین نسخه در 2026-10-15 برابر v5.11.1 است):
# macOS / Linux: Homebrew
brew install cc-switch-cli
# or the install script (installs to ~/.local/bin; read the script first)
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash
در Windows، فایل cc-switch-cli-windows-x64.zip را از صفحه Releases آن دانلود کنید، آن را از حالت فشرده خارج کنید و cc-switch.exe را در دایرکتوریای در PATH خود قرار دهید.
استفاده پایه:
cc-switch # full-screen terminal UI (TUI)
cc-switch provider list # list providers
cc-switch provider add # add a provider (field values: see the Claude / Codex sections below)
cc-switch provider switch <id> # switch provider
cc-switch use <id> # shortcut for the line above
cc-switch --app codex provider list # --app picks the tool; the default is claude
cc-switch start claude <id> # launch Claude with this provider for this run only, without changing the global one
--app مقادیر claude (پیشفرض)، codex و همچنین opencode، hermes، openclaw، pi و غیره را میپذیرد. بهطور پیشفرض، این CLI دایرکتوری داده ~/.cc-switch را با اپلیکیشن دسکتاپ به اشتراک میگذارد؛ نسخه دیتابیسی که پشتیبانی میکند گاهی از اپلیکیشن دسکتاپ عقب میماند — اگر پیام «database version is too new» را دیدید، CLI را ارتقا دهید یا منتظر بمانید تا همسطح شود.
اگر ترجیح میدهید هیچکدام را نصب نکنید، ویرایش دستی فایلهای پیکربندی هم کار میکند: برای Claude Code، آموزش Claude Code و برای Codex، آموزش Codex را ببینید؛ مقادیر Base URL و کلید همان مقادیر این صفحه هستند.
پیکربندی ارائهدهنده Claude (برای Claude Code)¶
CC Switch را اجرا کنید → در نوار کناری Claude Code را انتخاب کنید → روی «+» (افزودن ارائهدهنده) در بالا سمت راست کلیک کنید → در زبانه ارائهدهندگان مخصوص برنامه، از فهرست کشویی پیشتنظیمها سفارشی را انتخاب کنید → JSON پیکربندی را در پنل ویرایش کنید (عبارتپردازی رابط کاربری بین نسخهها تغییر میکند؛ بر اساس آنچه نسخه شما نشان میدهد پیش بروید):
| فیلد | مقدار |
|---|---|
| نام ارائهدهنده | QCode.cc |
| ANTHROPIC_BASE_URL | https://api.qcode.cc/api |
| ANTHROPIC_AUTH_TOKEN | کلید API QCode.cc شما (با cr_ شروع میشود) |
چرا
asia.qcode.cc؟ این نقطه پایانی آسیا در QCode.cc است و برای کاربران در سرزمین اصلی چین مناسب است؛ اگر دسترسی به آن دشوار بود، بهجای آن ازapi.qcode.ccاستفاده کنید. همان کلید در هر سه دامنه کار میکند:api/asia/us.
پس از ذخیره، روی فعالسازی در کارت کلیک کنید (دکمههای عملیات کارت هنگام نگهداشتن نشانگر نمایان میشوند) تا آن را به ارائهدهنده فعلی Claude تبدیل کنید. CC Switch بهطور خودکار ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN را در ~/.claude/settings.json مینویسد. برای بررسی اتصال، claude را در ترمینال اجرا کنید.
انتخاب مدل پیشفرض¶
QCode.cc مجموعه کاملی از مدلهای پرچمدار تا سبک ارائه میدهد. در Claude Code با /model جابهجا شوید، یا مستقیماً در پیکربندی مشخص کنید:
| مدل | مناسب برای |
|---|---|
claude-sonnet-5 |
پیشفرض روزانه، رده متعادل فعلی |
claude-opus-5-5 |
پرچمدار فعلی؛ استدلال دشوار و بازآراییهای بزرگ |
claude-opus-5 |
پرچمدار نسل قبل، هنوز در دسترس |
claude-sonnet-4-6 |
Sonnet نسل قبل، هنوز عرضه میشود |
claude-opus-4-8 |
پرچمدار نسل قبل، هنوز عرضه میشود |
claude-haiku-5-5 |
پرسش و پاسخ سریع، کارهای کوچک دستهای |
نرخها و اندازههای پنجره زمینه را بهصورت زنده در qcode.cc/models بخوانید — این صفحه عمداً دیگر اعداد را کپی نمیکند. مجموعه کامل (مدلهای GPT و خانواده چین) در همان صفحه است. از نسخه v3.20.3، ویرایشگر ارائهدهنده Claude یک پنل نگاشت مدل بهازای هر نقش (Sonnet / Opus / Fable / Haiku / زیرعامل) نیز دارد با دکمه اعمال یککلیکی به همه نقشها.
پیکربندی ارائهدهنده Codex (برای Codex CLI)¶
در نوار کناری Codex را انتخاب کنید → «+» افزودن ارائهدهنده → سفارشی → بهصورت زیر پر کنید:
⚠️ ویرایشگر ارائهدهنده Codex یک گزینه تغییر وضعیت «Needs Local Routing» دارد که برای ارائهدهندگانی است که فقط با Chat Completions کار میکنند. آن را برای QCode خاموش بگذارید — QCode پروتکل Responses را بهصورت بومی ارائه میدهد، و فعالسازی آن مستلزم بالا ماندن یک پروکسی محلی است.
| فیلد | مقدار |
|---|---|
| نام ارائهدهنده | qcode (حروف کوچک توصیه میشود، بهعنوان کلید TOML استفاده میشود) |
| Base URL | https://api.qcode.cc/openai |
| کلید API | کلید API QCode.cc شما |
| مدل پیشفرض | gpt-6.1-sol (توصیهشده) یا gpt-5.6-terra (برای برنامهنویسی) |
CC Switch معادل ~/.codex/config.toml و ~/.codex/auth.json را تولید میکند:
model_provider = "qcode"
model = "gpt-6.1-sol"
model_reasoning_effort = "high"
[model_providers.qcode]
name = "qcode"
base_url = "https://api.qcode.cc/openai"
wire_api = "responses"
requires_openai_auth = true
ذخیره کنید، روی فعالسازی کلیک کنید، سپس برای بررسی اتصال codex را اجرا کنید. گزینههای مدل GPT: gpt-6.1-sol / gpt-6-sol / gpt-5.6-terra (نرخها و زمینه: qcode.cc/models). نسخه Codex CLI را از codex --version روی دستگاه خود بخوانید؛ به یک عدد تاریخی در این صفحه اعتماد نکنید.
اپ دسکتاپ Codex¶
خلاصه: اپ دسکتاپ Codex همان ~/.codex/config.toml را میخواند که CC Switch مینویسد؛ بنابراین پس از آنکه QCode مطابق توضیحات بالا بهعنوان یک ارائهدهنده Codex تنظیم شد، اپ دسکتاپ و نسخه خط فرمان از پیکربندی یکسانی استفاده میکنند. (این صفحه ورود/احراز هویت را در اپ دسکتاپ آزمایش نکرده است.) مبنا:
- مستندات رسمی OpenAI (استفاده از اعتبارنامه API/ارائهدهنده از طریق دروازه) بیان میکند که اپ macOS همان
~/.codex/config.tomlرا میخواند و باید پس از ذخیره تنظیمات ارائهدهنده، اپ را دوباره راهاندازی کنید؛ در Windows فایل%USERPROFILE%\.codex\config.tomlاست و اپ نیز باید دوباره راهاندازی شود. - README رسمی CC Switch از شما میخواهد اپ دسکتاپ Codex را کاملاً ببندید و دوباره باز کنید (⌘Q در macOS؛ بستن پنجره کافی نیست) — این جمله در بخش حالت Aggregation آن درباره بازخوانی فهرست مدلها آمده است؛ وقتی ارائهدهندهای معمولی را تغییر میدهید، بستن کامل و باز کردن دوباره هم عادت معقولی است.
برای آنکه اپ دسکتاپ از QCode استفاده کند:
- در زبانه Codex در CC Switch، ارائهدهنده QCode را مانند بخش قبل اضافه کنید و فعالسازی کنید (Base URL
https://api.qcode.cc/openai،wire_api = "responses"). - اپ دسکتاپ Codex را کاملاً ببندید، سپس دوباره باز کنید.
- در اپ بررسی کنید که مدل انتخابشده یکی از مدلهای GPT باشد که QCode ارائه میکند (برای نمونه
gpt-6.1-sol). مستندات OpenAI پیشنهاد میکند مدل انتخابشده و پیکربندی را در اپ دسکتاپ بررسی کنید.
دو یادآوری:
- مستندات OpenAI هشدار میدهد که متغیری که در ترمینال تنظیم میشود ممکن است برای اپی که از دسکتاپ اجرا میشود در دسترس نباشد. اگر از CC Switch استفاده نمیکنید و بهجای آن
config.tomlرا دستی مینویسید و کلید را از طریق یک متغیر محیطی ارسال میکنید، مطمئن شوید فرایند اپ میتواند آن متغیر را ببیند. - تا تاریخ 2026-10-15، مستندات OpenAI اپ دسکتاپ را «اپ دسکتاپ ChatGPT» مینامد، جایی که ChatGPT یا Codex را انتخاب میکنید؛ نسخههای macOS و Windows از chatgpt.com/download میآیند و Linux راهنمای نصب رسمی خودش را دارد. اینکه ورود با حساب کاربری ChatGPT چگونه در اپ دسکتاپ با یک ارائهدهنده سفارشی همزیستی میکند در آن صفحات رسمی پوشش داده نشده است؛ بنابراین این صفحه ادعایی درباره آن مطرح نمیکند.
جابهجایی بین چند ارائهدهنده/حساب کاربری¶
ارزش اصلی CC Switch در جابهجایی است. یک چیدمان رایج:
- در زبانه Claude، چند ارائهدهنده ذخیره کنید، مثلاً
QCode.cc(اصلی)،QCode.cc (asia)(نود سرزمین اصلی)،Anthropic Official(برای مقایسه). - برای جابهجایی، روی فعالسازی در کارت ارائهدهنده هدف کلیک کنید — CC Switch مقدارهای متناظر
ANTHROPIC_BASE_URL/ANTHROPIC_AUTH_TOKENرا در~/.claude/settings.jsonبازنویسی میکند. - پیکربندی جدید را فعال کنید: README رسمی میگوید Claude Code در حال حاضر دادههای ارائهدهنده را بهصورت زنده جابهجا میکند؛ پرسشهای متداول رسمی و مشکل #3057 حالت دیگر را مستند میکنند —
settings.jsonروی دیسک از قبل جدید است، اما نشست در حال اجرا هنوز از ارائهدهنده قدیمی استفاده میکند. اگر نشست فعلی هنوز روی نود قدیمی است، پیش از اجرای دوبارهclaude، آن را ببندید و یک ترمینال جدید باز کنید. Codex و سایر CLIها: همیشه ترمینال را دوباره باز کنید (پرسشهای متداول). - Codex هم به همین شکل کار میکند: جابهجایی مورد فعال در زبانه Codex فایل
~/.codex/config.tomlرا بازنویسی میکند.
میانبر سینی سیستم: CC Switch در سینی سیستم باقی میماند؛ از v3.13.0 منوی کلیک راست به زیرمنوهای جداگانه برای هر اپ گروهبندی شده است (Claude / Codex / Gemini)، عنوان هر زیرمنو ارائهدهنده فعال فعلی و خلاصه مصرف است — برای جابهجایی روی نام یک ارائهدهنده کلیک کنید. جابهجایی از سینی همان فایلهای زندهای را مینویسد که فعالسازی در پنجره اصلی مینویسد؛ دامها در بخش «پس از اتصال» در ادامه آمده است.
نمونه چند حساب کاربری / چند پلن¶
دو پیکربندی برای همان حساب کاربری QCode.cc ذخیره کنید، هر یک با یک کلید API متفاوت:
| نام ارائهدهنده | Base URL | کلید API | هدف |
|---|---|---|---|
QCode.cc (work) |
https://api.qcode.cc/api |
کلید کاری | تیم / حساب کاربری قابل صورتحساب |
QCode.cc (personal) |
https://api.qcode.cc/api |
کلید شخصی | پروژههای شخصی |
با جابهجایی ارائهدهنده فعال، بهصورت یکپارچه بین دو سهمیه جابهجا میشوید بدون اینکه صورتحسابها با هم مخلوط شوند.
موارد استفاده¶
- شبکه ناپایدار در چین: از
asia.qcode.ccبهعنوان اصلی استفاده کنید و هنگام نوسان، با یک کلیک بهapi.qcode.ccجهانی تغییر دهید. - مقایسه ارائهدهندگان: همان وظیفه را از طریق QCode.cc و Anthropic رسمی اجرا کنید تا پاسخها و هزینه را مقایسه کنید.
- تفکیک تیمی / شخصی: از کلیدهای مختلف برای تفکیک مصرف کاری و شخصی استفاده کنید تا حسابداری آسان شود.
- Claude + Codex با هم: هر دو Claude Code و Codex CLI را در یک برنامه مدیریت کنید که بهترتیب به نقاط پایانی پروتکل Anthropic و پروتکل OpenAI متصل هستند.
ویژگیهای پیشرفته Claude Code (که همچنان از طریق QCode کار میکنند)¶
CC Switch فقط ارائهدهندگان را تغییر میدهد؛ قابلیتهای خود Claude Code تحت تأثیر قرار نمیگیرند. پس از اتصال به QCode، ویژگیهای زیر طبق معمول کار میکنند (روی هر مدلی که Claude Code با آن پیکربندی شده است اجرا میشوند):
ورودی بینایی: درک نیازمندیها از اسکرینشات / نمودار¶
Claude Code میتواند تصاویر را به مدلهای دارای قابلیت بینایی بدهد: چسباندن (Ctrl+V)، کشیدن و رها کردن، یا ارجاع به مسیر یک فایل تصویر در prompt شما. کاربردهای رایج:
- ساخت رابط کاربری از روی ماکت / اسکرینشات
- اشکالزدایی از روی اسکرینشات خطا
- خواندن نمودارهای معماری و نمودارها
مدلهای دارای قابلیت بینایی در QCode شامل claude-opus-5 / claude-sonnet-5، بهعلاوه claude-opus-4-8 / claude-sonnet-4-6 که همچنان عرضه میشوند، و خانواده GPT (مانند gpt-6.1-sol، gpt-5.6-terra) هستند. نشانگرهای زنده قابلیتها: qcode.cc/models.
توجه: این ورودی تصویر (درک) است، نه تولید تصویر. برای تولید تصویر توسط یک مدل، از مدل
gpt-image-2استفاده کنید — به تولید تصویر با gpt-image-2 مراجعه کنید.
گردشکارهای پویا (هماهنگی زیرعاملهای پسزمینه)¶
کلیدواژه ultracode را در prompt خود قرار دهید (یا بهسادگی بخواهید «یک گردشکار اجرا شود») تا گردشکارهای پویای Claude Code فعال شوند: این گردشکار دهها تا صدها زیرعامل پسزمینه را بهصورت موازی هماهنگ میکند و برای بازبینی در سطح کل پایگاه کد، مهاجرت و پژوهش ایدهآل است. عاملها در پسزمینه به اجرا ادامه میدهند تا شما به کار خود ادامه دهید؛ اجراها را با فرمان /workflows مشاهده کنید. این قابلیت روی هر مدلی اجرا میشود که Claude Code با آن پیکربندی شده است — بنابراین زمانی کار میکند که Claude Code روی QCode تنظیم شده باشد. مطالعه بیشتر: زیرعاملها.
حالت بدون رابط / خروجی خودکارسازی¶
در اسکریپتها و CI، یکبار با -p اجرا کنید و یک قالب خروجی مشخص کنید:
# Structured JSON (incl. result / total_cost_usd / usage / session_id), parse with jq
claude -p "Summarize test coverage in this repo" --output-format json | jq '.result'
# Newline-delimited streaming JSON events, good for real-time pipes
claude -p "Review src/ for security risks" --output-format stream-json
استفاده بیشتر از خط لوله و CI در خودکارسازی و CI/CD.
درباره Gemini / Antigravity¶
فهرست CC Switch شامل Gemini CLI است، اما QCode در حال حاضر مدلهای Gemini را ارائه نمیدهد، بنابراین چیزی برای پیکربندی QCode زیر Gemini در CC Switch وجود ندارد. بهجای آن از مدلهای Claude، GPT یا خانواده چین استفاده کنید؛ مدلهایی که میتوانید فراخوانی کنید در qcode.cc/models فهرست شدهاند.
برای زمینه: Google Gemini CLI را بازنشسته کرده است (پایان پشتیبانی (EOL) در 2026-06-18 برای پلنهای Pro/رایگان؛ کلیدهای پرداختی سازمانی تحت تأثیر نیستند)، و Google Antigravity CLI جانشین آن شده است (از 2026-05-19 در دسترس است). CC Switch همچنان Gemini CLI را بهعنوان یک برنامه درجهیک با همان ورودی Claude / Codex نگه میدارد؛ این موضوع فقط به حساب کاربری Google خودتان یا منابع دیگر مربوط است و هیچ ارتباطی با QCode ندارد.
انتخاب نقطه پایانی برای شبکه شما¶
سه نقطه پایانی از یک کلید استفاده میکنند. نقطهای را انتخاب کنید که با شبکه شما سازگار است؛ اگر دسترسی به یکی کند بود، Base URL را به دیگری تغییر دهید.
| نقطه پایانی | Claude Base URL | Codex Base URL |
|---|---|---|
| بینالمللی | https://api.qcode.cc/api |
https://api.qcode.cc/openai |
| آسیا (توصیهشده برای CN) | https://asia.qcode.cc/api |
https://asia.qcode.cc/openai |
| آمریکای شمالی / اروپا | https://us.qcode.cc/api |
https://us.qcode.cc/openai |
خودبررسی: درخواست مستقیم به مسیر یک Base URL کد
401برمیگرداند — این انتظار میرود؛ یعنی مسیر درست است و فقط احراز هویت وجود ندارد.
یک کلید برای Claude و Codex¶
ارائهدهندههای Claude و Codex در CC Switch میتوانند از همان کلید API QCode.cc استفاده کنند. QCode بهازای هر توکن صورتحساب میشود؛ نرخهای هر مدل در qcode.cc/models فهرست شدهاند (قواعد در صورتحساب). افزودن دو ارائهدهنده باعث دوبار صورتحساب شدن نمیشود. اگر ارائهدهندههایی با کلیدهای متفاوت ساخته باشید، هر کلید بهطور مستقل صورتحساب میشود.
پس از اتصال: تغییر، همزیستی، بازیابی¶
این بخش همان ترافیک پس از راهاندازی است که جستوجوهای «CC Switch» واقعاً به همراه میآورند. نحوه پر کردن فرم در بالا آمده است؛ این بخش آنچه پس از اجرا رخ میدهد را توضیح میدهد.
چند پلن / چند کلید¶
یک ارائهدهنده = یک BASE_URL + کلید + (برای Codex) مدل. میتوانید چند ردیف برای همان حساب کاربری QCode نگه دارید، برای مثال:
| نام ارائهدهنده | نقش |
|---|---|
QCode.cc |
دامنه جهانی، اصلی |
QCode.cc (asia) |
گره آسیا، زمانی که مسیر سرزمین اصلی دچار نوسان میشود |
QCode.cc (work) / QCode.cc (personal) |
دو کلید cr_ متفاوت، صورتحسابهای جداگانه |
فقط یک ارائهدهنده در هر زمان فعال است — CC Switch دو پیکربندی را همزمان در ~/.claude/settings.json نمینویسد. برای مقایسه Anthropic رسمی و QCode، روی فعالسازی بهطور متناوب کلیک کنید. انتظار نداشته باشید هر دو همزمان فعال باشند.
CLI ارائهدهنده جدید را برنداشت¶
به این ترتیب بررسی کنید؛ ابتدا کلید را مقصر ندانید:
- فایل
~/.claude/settings.jsonرا باز کنید (یا برای Codex،~/.codex/config.tomlرا) و تأیید کنیدANTHROPIC_BASE_URL/base_urlهمان ردیفی است که همین حالا فعال کردهاید. - فایل تغییر کرد، نشست تغییر نکرد: این رفتار در مشکل #3057 آمده است — Claude Code بلوک
envرا ازsettings.jsonدر شروع فرایند کپی میکند. یک نشست در حال اجرا آن را دوباره نمیخواند.claude/codexفعلی را ببندید و یک ترمینال جدید باز کنید. - README رسمی میگوید Claude Code اکنون تغییر داغ انجام میدهد. اگر نسخه ساخت شما این کار را میکند، میتوانید از راهاندازی مجدد صرفنظر کنید؛ اگر هنوز به گره قدیمی برخورد میکند، نشست را دوباره باز کنید.
همزیستی با ورود رسمی Anthropic / ChatGPT¶
README / پرسشهای متداول رسمی:
- در فهرست به ارائهدهنده رسمی از پیش تعبیهشده بروید (Claude Official / OpenAI Official؛ اگر آن را حذف کردهاید، از پیشتنظیمها دوباره اضافه کنید)
- روی فعالسازی کلیک کنید
- CLI مربوطه را دوباره باز کنید و خروج / ورود (یا OAuth) خودش را اجرا کنید
- پس از آن میتوانید بین ورود رسمی و ارائهدهنده سفارشی
QCode.ccجابهجا شوید
OAuth رسمی و ANTHROPIC_AUTH_TOKEN مربوط به QCode را در settings.json دستی ادغام نکنید — هنگام فعالسازی، CC Switch فیلدهایی را که مالک آنهاست بازنویسی میکند. جابهجایی بین چند حساب کاربری رسمی Codex طبق README انجام میشود: Codex میتواند بین ارائهدهندههای رسمی مختلف جابهجا شود.
دامهای تغییر از سینی¶
- نبود آیکون: macOS — تنظیمات نوار منو؛ Windows — سرریز نوار وظیفه؛ Linux ممکن است به
libappindicatorنیاز داشته باشد (پرسشهای متداول رسمی) - حالت سبکوزن (منوی سینی): پنجره اصلی نابود میشود (پنهان نمیشود) و فقط سینی باقی میماند؛ پیش از v4.0.21 این حالت پایدار نمیماند، بنابراین شروع عادی به حالت معمولی برمیگشت، و از v4.0.21 (2026-10-26) پس از راهاندازی مجدد دوام میآورد (یادداشتهای انتشار)؛ نخستین پیوند عمیق
ccswitch://پنجره را دوباره میسازد و کمی کندتر است (پرسشهای متداول رسمی، از v3.13.0) - کلیک روی سینی، بدون تغییر CLI: سینی همان فایلهای زندهای را مینویسد که فعالسازی مینویسد. این کار
claudeدر حال اجرا را نمیکشد. نشست را مانند بالا دوباره باز کنید - پسوندهایی مانند
(asia)/(work)منوی سینی را خوانا نگه میدارند
پیکربندی بازنویسی شد — چگونه آن را بازیابی کنیم¶
هنگام فعالسازی / تحویل گرفتن، CC Switch فیلدهای ارائهدهنده را در فایلهای زنده CLI مینویسد. چند مشکل (#2992، #4274؛ بهعلاوه #1656، یک درخواست ویژگی برای رفتار نوشتن ادغامی) بازنویسی کامل فایل را گزارش میکنند که کلیدهایی را حذف کرده است که CC Switch مالک آنها نیست (enabledPlugins، hooks، statusLine، permissions، …). فایلهای افزونه اغلب روی دیسک باقی میمانند؛ فقط دیگر بارگذاری نمیشوند چون enabledPlugins رفته است.
مسیرهای بازیابی که میتوانید بررسی کنید (README رسمی / راهنمای کاربر، نه یک افسانه شخص ثالث):
- پشتیبانهای برنامه:
~/.cc-switch/backups/(چرخشی؛ متن رسمی: 10 مورد آخر) - خروجیای که خودتان گرفتهاید: خروجی تنظیمات نامی مانند
cc-switch-export-{timestamp}.sqlدارد؛ درونریزی، پایگاهداده فعلی را بازنویسی میکند — پیش از درونریزی دوباره خروجی بگیرید - دیگر «Common Config Snippet» وجود ندارد: از v4.0 این ویژگی حذف شده است (README رسمی: دکمههای آن حذف شدهاند). جابهجایی فقط فیلدهای کلیدی — نقطه پایانی، کلید، نام مدل، پروتکل — را جایگزین میکند و بقیه را رها میکند؛ تنظیماتی که پیش از ارتقا در یک snippet بودند، هنگام جابهجایی از قبل در فایل پیکربندی نوشته شده بودند، بنابراین باقی میمانند. پیش از آنکه CC Switch برای نخستین بار فایل پیکربندی یک ابزار را بازنویسی کند، از نسخه اصلی در
~/.cc-switch/backups/live-first-write/پشتیبان میگیرد - ویرایشهای دستی Claude: از v4.0، جابهجایی عموماً آنها را پاک نمیکند؛ در نسخه قدیمیتر، اگر فقط
~/.claude/settings.jsonرا ویرایش کردهاید، آن را از پشتیبان خودتان / Time Machine / تاریخچه محلی ویرایشگر بازیابی کنید
پایگاهداده خود CC Switch در ~/.cc-switch/cc-switch.db است؛ رابط کاربری دستگاه در ~/.cc-switch/settings.json قرار دارد. حذف مورد دوم فقط رابط کاربری را بازنشانی میکند؛ Claude hooks را بازیابی نمیکند.
نکات کاربردی¶
- نامگذاری با پسوندها: پسوندهایی مانند
(asia)/(work)را به نام ارائهدهندهها اضافه کنید تا جابهجایی از سینی در یک نگاه بدون ابهام باشد. - فایل را بررسی کنید، سپس نشست جدیدی باز کنید: به
~/.claude/settings.json/~/.codex/config.tomlاعتماد کنید؛ فرایند در حال اجرا بهصورت خودکار بارگذاری مجدد نمیشود (پرسشهای متداول / #3057). - بدون اسلش انتهایی: QCode نیازمند Base URL بدون
/انتهایی است (در غیر این صورت SDKها مسیرهای خراب به سبک//v1/...میسازند). - کلیدها را جدا نگه دارید: CC Switch کلیدها را برای هر ارائهدهنده بهصورت مستقل ذخیره میکند؛ هنگام تعویض کلیدها بهروزرسانی هر یک را فراموش نکنید.
- از پیکربندی خود نسخه پشتیبان بگیرید: از نسخه v4.0 به بعد، جابهجایی فقط فیلدهای کلیدی را جایگزین میکند و عموماً مواردی را که افزودهاید دستنخورده میگذارد؛ در نسخههای قدیمیتر باز هم ابتدا نسخه پشتیبان بگیرید.
پرسشهای متداول¶
دکمه «Enable» پس از ذخیره قابل کلیک نیست¶
بررسی کنید به ترتیب: ① فیلد نقطه پایانی خالی نباشد؛ ② JSON / TOML داخل پنل از نظر نحوی معتبر باشد (ویرایشهای دستی بیشتر از همه آن را خراب میکنند)؛ ③ حذف / انتهایی از Base URL را امتحان کنید (نقاط پایانی QCode نباید اسلش انتهایی داشته باشند. نحوه برخورد خود CC Switch با اسلشهای انتهایی توسط CC Switch مستند نشده است؛ این ترتیب بر اساس تجربه ماست).
هر درخواست Claude Code در 2.1.265–2.1.267 با خطای 400 مواجه میشود (طرحواره Artifact)¶
Claude Code 2.1.265–2.1.267 طرحواره ابزار Artifact را منتشر کرد که دروازههای سختگیر آن را بیچونوچرا رد میکنند (400، Invalid schema for function 'Artifact'). از CC Switch 3.20.3 (2026-09-11) به بعد ویرایشگر ارائهدهنده Claude یک کلید تغییر سریع «Disable Artifact Tool» دارد که env.CLAUDE_CODE_DISABLE_ARTIFACT="1" را مینویسد. اصلاح رسمی Claude Code ارتقا به ≥2.1.268 است؛ عیبیابی را ببینید. ما هر تعامل سمت QCode را بازتولید نکردهایم — اگر با آن مواجه شدید، تیکتی همراه با شناسه درخواست باز کنید.
خطای 401 Unauthorized¶
- تأیید کنید که کلید API با
cr_شروع میشود و فاصله ابتدایی یا انتهایی ندارد - بررسی کنید که کلید در qcode.cc/dashboard معتبر است
- اگر Claude خطای 401 برمیگرداند اما Codex کار میکند (یا برعکس)، کلید در یکی از ارائهدهندهها نادرست وارد شده است — CC Switch کلیدها را برای هر ارائهدهنده بهصورت مستقل ذخیره میکند
جابهجایی ارائهدهندهها اثری نداشت¶
ابتدا بررسی کنید که فایل فعال از قبل ارائهدهنده جدید را نشان میدهد. اگر فایل تغییر کرده است، نشست فعلی claude / codex را ببندید و نشست جدیدی باز کنید (پرسشهای متداول رسمی؛ #3057). فقط روی سینی کلیک نکنید و در پنجره قدیمی به تایپ ادامه ندهید.
Codex هنگام راهاندازی بیپایان میچرخد¶
بررسی کنید که base_url از قرارداد نقطه پایانی QCode پیروی میکند و به /openai ختم میشود (نه /openai/v1). wire_api = "responses" باید حفظ شود. رایجترین اشتباه: model_provider سطح بالا وجود ندارد یا با نام جدول [model_providers.xxx] مطابقت نمیکند — سپس Codex بیصدا به نقطه پایانی داخلی openai بازمیگردد (گزارش رسمی #7263 نشانه را مستند میکند).
آیا میتوان همزمان از Claude و Codex استفاده کرد؟¶
بله. CC Switch پیکربندی Claude را در ~/.claude/ و پیکربندی Codex را در ~/.codex/ مینویسد. این دو پیکربندی کاملاً مستقل هستند. در صورت نیاز، claude و codex را در ترمینالهای جداگانه اجرا کنید.
settings.json را دستی ویرایش کردهام — آیا فعالسازی باعث از دست رفتن آن میشود؟¶
عموماً از نسخه v4.0 به بعد خیر: جابهجایی فقط فیلدهای کلیدی (نقطه پایانی، کلید، نام مدل، پروتکل و غیره) را جایگزین میکند؛ افزونهها، hooks، مجوزها و متغیرهای محیطی که افزودهاید باقی میمانند (پرسشهای متداول رسمی README). نسخههای پیش از v4.0 گزارشهایی از جایگزینی کل فایل داشتند که enabledPlugins / hooks را حذف میکرد (#2992، #4274)؛ در نسخه قدیمیتر ابتدا نسخه پشتیبان بگیرید و در صورت از دست رفتن چیزی، از ~/.cc-switch/backups/ (شامل live-first-write/) یا یک فایل .sql صادرشده بازیابی کنید.
چگونه میتوان به ورود رسمی Anthropic بازگشت؟¶
به ارائهدهنده رسمی داخلی جابهجا شوید (Claude Official / OpenAI Official؛ اگر حذف شده است، آن را از پیشتنظیمها دوباره اضافه کنید) → فعالسازی → CLI را دوباره باز کنید → خروج / ورود رسمی را اجرا کنید. پیکربندی ترکیبی «env خالی اما نگهداشتن کلید cr_» را دستی نسازید.
حالت تجمیع در v4.0 و درونریزی با ccswitch:// در v4.0.10 (2026-10)¶
CC Switch نسخه v4.0.0 را در 2026-10-04 و نسخه v4.0.10 را در 2026-10-12 منتشر کرد (تاریخها از دو صفحه انتشار گرفته شدهاند: v4.0.0 و v4.0.10). هر خطی که در ادامه نقل میشود عیناً از فایلهای انگلیسی یادداشتهای انتشار در مخزن است: docs/release-notes/v4.0.0-en.md و docs/release-notes/v4.0.10-en.md؛ دو صفحه انتشار بالا فقط برای تاریخها استفاده شدهاند و نسخه چینی را دارند. هیچچیز در این بخش توسط ما آزمایش نشده است و هیچ لینک ورودی اجرا نشد.
حالت تجمیع (v4.0.0)¶
حالت تجمیع جدید مدلهای چند ارائهدهنده را در یک انتخابگر مدل Claude Code یا Codex قرار میدهد، بنابراین میتوانید درست داخل کلاینت بین آنها جابهجا شوید
چند ارائهدهنده اضافه کنید و مدلهایشان همگی با هم در انتخابگر مدل Claude Code یا Codex نمایش داده میشوند
هر مدلی را که انتخاب کنید، درخواست مستقیماً به همان ارائهدهنده میرود، بدون اینکه هرگز از کلاینت خارج شود.
بنابراین میتوان چند سرویس مدل اضافه کرد، مدلهایشان با هم در یک انتخابگر مدل ظاهر میشوند، و درخواست به هر ارائهدهندهای که مالک مدلی است که شما انتخاب کردهاید میرود، بدون اینکه از کلاینت خارج شود. همان یادداشتها بیان میکنند که این قابلیت اختیاری است، در حال حاضر از Claude Code و Codex پشتیبانی میکند، برای هر مدل انتخابشده ارسال میکند و هیچ جابهجایی خودکار در صورت خرابی ارائه نمیدهد:
تجمیع اختیاری است و در حال حاضر از Claude Code و Codex پشتیبانی میکند. هر درخواست را بر اساس مدلی که انتخاب میکنید مسیریابی میکند و جابهجایی خودکار در صورت خرابی ارائه نمیدهد.
در رابط کاربری، یادداشتها سه زبانه در بالای هر صفحه برنامه را توصیف میکنند — مستقیم / مسیریابی / تجمیع — و تأکید میکنند که فشردن یک زبانه فقط آنچه را که به آن نگاه میکنید تغییر میدهد؛ اقدامات کارت شامل افزودن و حذف است، بهعلاوه انتخاب یک ارائهدهنده بهعنوان پیشفرض برای درخواستهایی که مدل تجمیعشده را نام نمیبرند:
هر صفحه برنامه سه زبانه در بالا دارد: مستقیم / مسیریابی / تجمیع. کلیک روی یک زبانه فقط آنچه را که به آن نگاه میکنید تغییر میدهد و هرگز به پیکربندی شما دست نمیزند
روی «Add» یا «Remove» در یک کارت ارائهدهنده کلیک کنید، سپس یک ارائهدهنده را بهعنوان پیشفرض انتخاب کنید تا درخواستهایی را مدیریت کند که مدل تجمیعشده را نام نمیبرند
دو نکته برای استفاده با پرداخت بهازای توکن اهمیت دارد. نخست، یادداشتها هشدار میدهند که تغییر در میانه نشست ممکن است، اما هر مدل جدید باید کش prompt خود را دوباره بسازد، بنابراین اولین نوبت پس از تغییر بهطور محسوسی گرانتر است (عین متن: میتوانید در میانه یک نشست به مدل دیگری تغییر دهید. توجه کنید که پس از هر تغییر، مدل جدید باید کش prompt خود را دوباره بسازد، بنابراین اولین نوبت پس از تغییر بهطور محسوسی گرانتر است). در QCode، نرخهای هر مدل در https://qcode.cc/models فهرست شدهاند. دوم، فهرست مدل تغییرکرده یک اعلان راهاندازی مجدد ایجاد میکند، و کاربران Codex CLI میتوانند سرویس پسزمینه را از همان نوار با یک کلیک راهاندازی مجدد کنند:
هنگامی که فهرست مدل تغییر میکند، از شما خواسته میشود کلاینت را راهاندازی مجدد کنید، و کاربران Codex CLI میتوانند سرویس پسزمینه را از نوار با یک کلیک راهاندازی مجدد کنند
v4.0.0 همچنین نحوه نوشتن تنظیمات را تغییر داد، که اگر فایلها را دستی ویرایش میکنید اهمیت دارد:
اکنون جابهجایی بین ارائهدهندگان فقط فیلدهای کلیدی را جایگزین میکند بهجای بازنویسی کل فایل
درونریزی با پیوند عمیق ccswitch:// (v4.0.10)¶
یادداشتهای v4.0.10 خود را ششمین انتشار رفع اشکال برای شاخه 4.0 مینامند که بر لینکهای درونریزی یککلیکی متمرکز است:
ششمین انتشار رفع اشکال برای 4.0 پایدار
این انتشار بر لینکهای درونریزی یککلیکی (پیوندهای عمیق
ccswitch://) تمرکز دارد
رفتاری که اصلاح میشد، کلیک روی یک پیوند عمیق در حالی بود که برنامه باز نبود؛ این مورد در یادداشتها مورد به مورد ذکر شده است:
در Windows و Linux، کلیک روی یک لینک درونریزی یککلیکی وقتی CC Switch باز نبود، برنامه را اجرا میکرد، اما پنجره تأیید درونریزی ظاهر نمیشد
در حالت سبک، پیوند نیز هنگام بازسازی پنجره از دست میرفت
در macOS همان پیوند پنجره تأیید را دو بار باز میکرد
اکنون لینکها ابتدا ذخیره میشوند و تنها پس از نمایش پنجره تأیید بهعنوان پردازششده حساب میشوند، بنابراین اگر چیزی در میانه کار وقفه ایجاد کند از دست نمیروند، و یک لینک قدیمیتر که بعداً برسد، لینک جدیدتر را بازنویسی نمیکند.
پنجره تأیید اکنون همچنین گزینهای درباره جابهجایی بلافاصله پس از درونریزی ارائه میدهد. یادداشتها بیان میکنند که این جابهجایی بهطور پیشفرض خاموش است و روشنکردن آن هشداری نشان میدهد مبنی بر اینکه درخواستهای کلاینت به آدرس داخل لینک فرستاده میشوند (عین متن: پنجره تأیید به شما اجازه میدهد انتخاب کنید آیا بلافاصله پس از درونریزی جابهجا شوید یا نه، و بهطور پیشفرض خاموش است؛ وقتی روشن باشد، پنجره هشدار میدهد که درخواستهای کلاینت به آدرس داخل لینک فرستاده میشوند).
درباره قالبهای API، یادداشتها بیان میکنند:
قالبهای غیربومی برای Claude Code، Codex و Grok Build نیاز دارند که مسیریابی محلی روشن باشد؛ ترکیبهایی که یک برنامه پشتیبانی نمیکند هنگام تجزیه لینک رد میشوند
برای شما این یعنی: وقتی آدرسی از QCode را از طریق یک پیوند عمیق به Claude Code یا Codex وارد میکنید، ابتدا به قالب API که لینک اعلام میکند نگاه کنید (anthropic / openai_chat / openai_responses / gemini_native) — مسیریابی محلی فقط زمانی باید از قبل روشن باشد که آن قالب برای برنامه موردنظر بومی نباشد (برای نمونه openai_chat در Claude Code)؛ ترکیبهایی که برنامه پشتیبانی نمیکند در زمان تجزیه رد میشوند. اینکه از کدام آدرس در سمت QCode استفاده کنید نسبت به جدول نقاط پایانی بالا و نقاط پایانی و مسیرهای API بدون تغییر است: https://api.qcode.cc/api برای Claude، https://api.qcode.cc/openai/v1 برای GPT و مدلهای چینی، و Claude هرگز از آدرس سازگار با OpenAI عبور نمیکند. همین انتشار همچنین راهنماهای صاحبان سایت را به زبانهای چینی، انگلیسی و ژاپنی بههمراه یک تولیدکننده لینک آنلاین منتشر کرد (عین متن: راهنماهای صاحبان سایت به زبانهای چینی، انگلیسی و ژاپنی و یک تولیدکننده لینک آنلاین نیز منتشر شدهاند)؛ این صفحه خروجی آنها را بازتولید نمیکند.
گامهای بعدی¶
- راهاندازی magpie — اجرای Claude Code / Codex از طریق یک دروازه محلی
- یکپارچهسازی WorkBuddy — همان کلید بهعنوان مدل سفارشی Tencent WorkBuddy
- آموزش Claude Code — تسلط بر جریان کاری اصلی Claude Code
- آموزش Codex — تعمیق با Codex CLI
- یکپارچهسازی VS Code — استفاده مستقیم از Claude Code در ویرایشگر
- عاملهای فرعی — هماهنگسازی عاملهای پسزمینه با جریانهای کاری پویا
- خودکارسازی و CI/CD — حالت بدون رابط (headless) و یکپارچهسازی اسکریپت
- صورتحساب — درک پلنها و سهمیه
هنوز کلید API QCode.cc ندارید؟ به qcode.cc/pricing بروید تا یک پلن انتخاب کنید — یک کلید هم Claude Code و هم Codex CLI را درون CC Switch به کار میاندازد.
با QCode شروع کنید
یک کلید API برای Claude Code، Codex و بیشتر — بر اساس توکن، قیمت هر مدل در qcode.cc/models