Qoder BYOK: راه‌اندازی مدل سفارشی و Base URL (نوامبر 2026)
در تاریخ 2026-11-10، Qoder میتواند از کلید API خودتان استفاده کند (پلن فردی): در اپ دسکتاپ به تنظیمات > مدل‌ها > افزودن مدل بروید و در بخش سفارشی، OpenAI Compatible یا Anthropic Compatible را انتخاب کنید، سپس Base URL، یک کلید API و یک Model ID وارد کنید؛ در CLI، مدل را با ویزارد در تب سفارشی /model اضافه کنید. بر اساس یادداشت‌های انتشار رسمی، Qoder 0.1.8 (2026-09-05) باعث شد BYOK پلن شخصی یک Base URL سفارشی را بپذیرد. با QCode: Anthropic Compatible را انتخاب کنید و برای Claude آدرس https://api.qcode.cc/api را وارد کنید، یا OpenAI Compatible (Chat Completions API) را انتخاب کنید و برای GPT و مدلهای چینی آدرس https://api.qcode.cc/openai/v1 را با کلید cr_ خودتان وارد کنید.
به‌روزرسانی شده 2026-11-14
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدلهای چینی.
- صورتحساب به‌ازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- به‌صورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکته از منابع رسمی
سازگار با OpenAI و Anthropic
صفحه رسمی دو ارائهدهنده سفارشی را فهرست میکند، OpenAI Compatible و Anthropic Compatible؛ پس از OpenAI Compatible، Chat Completions API یا Responses API را انتخاب می‌کنید.
Base URL سفارشی از 2026-09-05
یادداشت انتشار Qoder 0.1.8: BYOK پلن شخصی اکنون از Base URLهای سفارشی برای هر سرویس مدل سازگار با OpenAI یا Anthropic پشتیبانی میکند. در تاریخ 2026-11-10، آخرین نسخه دسکتاپ 0.5.7 (2026-11-09) است.
نقطه ورود دسکتاپ
تنظیمات، سپس مدل‌ها در ناوبری سمت چپ، سپس افزودن مدل؛ در بخش سفارشی نوع ارائهدهنده را انتخاب کنید، Base URL، کلید API و حداقل یک Model ID را وارد کنید و روی اعتبارسنجی و افزودن مدل کلیک کنید.
از اعتبار Qoder استفاده نمیکند
پرسشهای متداول رسمی: هزینه مدل سفارشی مستقیماً به حساب API ارائهدهنده شما صورتحساب میشود و از اعتبار Qoder استفاده نمیکند؛ Repo Wiki از یک مدل ثابت استفاده میکند و همچنان اعتبار مصرف میکند. تولید تصویر و ویدئو با مدلهای BYOK در دسترس نیست.
آیا Qoder میتواند از کلید API خودتان استفاده کند؟
در تاریخ 2026-11-10، بله. صفحه رسمی مدلهای سفارشی میگوید: «Qoder از دسترسی به منابع مدل ارائه‌دهنده‌های شخص ثالث از طریق کلیدهای API پشتیبانی میکند.» صفحه CLI میگوید «نسخه در دسترس: پلن فردی»، و صفحه قیمتگذاری «Bring Your Own Key (BYOK)» را در ستون رایگان پلنهای فردی فهرست میکند. اپ دسکتاپ، CLI و QoderWork با هم متفاوت‌اند. دسکتاپ: تنظیمات > مدل‌ها > افزودن مدل، سپس یک نقطه پایانی سفارشی با Base URL، کلید API و Model ID. CLI: دستور /model را وارد کنید، به تب سفارشی بروید و «افزودن مدل سفارشی...» را انتخاب کنید تا ویزارد را دنبال کنید. QoderWork: صفحه مدلهای رسمی آن Premium، Advanced و Standard بههمراه Qwen3.7-Max و Qwen3.7-Plus را فهرست میکند و در تاریخ 2026-11-10 هیچ ورودی‌ای برای مدل سفارشی ندارد؛ صفحه دانلود Qoder میگوید QoderWork در 2027-09-05 رسماً فعالیت خود را متوقف میکند، تا آن زمان برای دانلود و استفاده در دسترس میماند، و توصیه میکند از پیش به Qoder Desktop مهاجرت کنید که ابزارهای داخلی وارد کردن داده دارد. سایت جهانی qoder.com و سایت چین Qoder CN از همان مراحل سفارشی استفاده میکنند؛ فقط فهرست ارائه‌دهنده‌های از پیش تنظیم‌شده متفاوت است و فهرست Qoder CN هیچ OpenAI، Google یا OpenRouter ندارد.
2026-09-05: Qoder 0.1.8 Base URLهای سفارشی را به BYOK پلن شخصی اضافه میکند
یادداشت انتشار Qoder 0.1.8 (2026-09-05) با عنوان «Custom Base URLs for BYOK» است و میگوید BYOK پلن شخصی اکنون از Base URLهای سفارشی برای هر سرویس مدل سازگار با OpenAI یا Anthropic پشتیبانی میکند. در سمت CLI، یادداشت انتشار 1.1.50 (2026-09-11) میگوید کاربران نسخه شخصی می‌توانند مدلهای BYOK را با نقاط پایانی URL سفارشی از صفحه سفارشی در /model پیکربندی و مدیریت کنند، و در 2026-09-12 حساب رسمی Qoder در X نوشت که با شروع از v1.1.50، Qoder CLI از یکپارچهسازی مدل سفارشی برای همه کاربران فردی پشتیبانی میکند: شما Base URL، Model ID و کلید API خود را وارد می‌کنید تا متصل شوید. یک یادداشت قبلی CLI 0.2.5 (2026-04-29) از قبل «BYOK Custom URL» را فهرست میکند. تا 2026-11-10، آخرین نسخه دسکتاپ 0.5.7 و CLI نسخه 1.1.86 است که هر دو در 2026-11-09 منتشر شدند.
خط زمانی
Qoder IDE 0.16.0 (IDE محصولی جدا از اپ دسکتاپ است) نسخه Community Edition را عرضه میکند؛ یادداشت انتشار میگوید Community Edition قابلیت BYOK را باز کرده است، با سرویس‌های اصلی MaaS چینی مانند Alibaba Cloud، Kimi، DeepSeek، Z.ai و MiniMax.
Qoder 0.1.8: BYOK پلن شخصی از Base URLهای سفارشی برای هر سرویس مدل سازگار با OpenAI یا Anthropic پشتیبانی میکند.
Qoder CLI 1.1.50: کاربران نسخه شخصی می‌توانند مدلهای BYOK را با نقاط پایانی URL سفارشی از صفحه سفارشی در /model پیکربندی کنند.
آنچه Qoder مستند میکند و آنچه باز می‌گذارد
مستندشده توسط Qoder
① زیر Custom در برنامه دسکتاپ، OpenAI Compatible و Anthropic Compatible وجود دارند؛ پس از OpenAI Compatible، Chat Completions API یا Responses API را انتخاب می‌کنید. ② Base URL، کلید API و حداقل یک Model ID را وارد می‌کنید؛ Add Model ID مدلهای بیشتری برای همان نقطه پایانی اضافه میکند. ③ به بیان رسمی: دقیقاً همان Base URL را که سرویس مدل ارائه میدهد وارد کنید؛ Qoder قالب نمونه https://api.example.com/v1 را نمایش میدهد. ④ Validate and add model اتصال را بررسی میکند و مدل را فقط پس از موفقیت اعتبارسنجی ذخیره میکند. ⑤ هزینه‌ها مستقیماً به حساب API ارائهدهنده شما صورتحساب می‌شوند و از Qoder Credits استفاده نمی‌کنند. ⑥ تولید تصویر و ویدیو با مدلهای BYOK در دسترس نیست. ⑦ صفحه CLI میگوید BYOK را به‌صورت دستی در settings.json پیکربندی نکنید و از ویزارد Custom در /model استفاده کنید. ⑧ اگر افزودن مدل ناموفق بود، بررسی‌های رسمی عبارت‌اند از: اینکه Base URL کامل باشد و پروتکل و نوع API مطابقت داشته باشند، اینکه کلید درست باشد، اینکه Model ID درست باشد، اینکه موجودی کافی باشد و اینکه شبکه عادی باشد. ⑨ صفحه قیمتگذاری «Bring Your Own Key (BYOK)» را در ستون Free پلنهای فردی فهرست میکند.
آنچه صفحات رسمی باز گذاشته‌اند
تا تاریخ 2026-11-10: ① صفحه مدلهای سفارشی دسکتاپ خودش نسخه‌ای را ذکر نمیکند؛ صفحه CLI میگوید «Available edition: Individual plan» و یادداشت انتشار دسکتاپ میگوید «Personal plan BYOK». ② Qoder IDE محصولی جداگانه در همان خانواده است؛ صفحه مدلهای سفارشی آن فقط ارائه‌دهنده‌های از پیش تعیین‌شده را فهرست میکند و میگوید برای کاربران دارای پلنهای Individuals اعمال میشود، در حالی که Base URLهای سفارشی متعلق به برنامه جدید دسکتاپ و CLI هستند. ③ صفحه CLI فیلدهای ویزارد را یک‌به‌یک فهرست نمیکند و میگوید فهرست ارائه‌دهنده‌ها همان چیزی است که ویزارد به‌صورت زنده نشان میدهد؛ عبارت نقطه پایانی URL سفارشی از یادداشت انتشار و پست رسمی X می‌آید. ④ مستندات به‌تفکیک پروتکل نمی‌گویند Qoder کدام مسیر را به Base URL اضافه میکند و فقط یک قالب نمونه ارائه می‌دهند: https://api.example.com/v1؛ نتیجه Validate and add model آزمون عملی است. ⑤ برخی کاربران انجمن گزارش می‌دهند که مدلهای سفارشی پس از پایان دوره آزمایشی ناپدید می‌شوند؛ صفحه قیمتگذاری رسمی BYOK را در ستون Free فهرست میکند و مرحله عیب‌یابی صفحه CLI تأیید این است که BYOK برای حساب کاربری و پلن فعلی در دسترس باشد.
نقاط ورود دسکتاپ و CLI
دسکتاپ: Settings > Models
روی «Add model» کلیک کنید، زیر «Custom» گزینه «OpenAI Compatible» یا «Anthropic Compatible» را انتخاب کنید، Base URL، کلید API و Model ID را وارد کنید، سپس روی «Validate and add model» کلیک کنید. سایت چین Qoder CN از همان مراحل استفاده میکند.
CLI: /model > گزینه Custom
دستور /model را وارد کنید، به تب «Custom» بروید، «Add custom model...» را انتخاب کنید و Enter را بزنید، ویزارد را از «Provider»، «model type» و «model» دنبال کنید و کلید API را وارد کنید؛ پس از اعتبارسنجی به‌صورت خودکار ذخیره میشود و d مدل انتخاب‌شده را حذف میکند.
چگونه از کلید API خودتان در Qoder استفاده کنید و Base URL را تنظیم کنید
① برنامه دسکتاپ را از صفحه دانلود Qoder نصب کنید (macOS 12+، Windows 10+ یا Linux) و وارد شوید؛ برای CLI از curl -fsSL https://qoder.com/install | bash استفاده کنید (Windows PowerShell: irm https://qoder.com/install.ps1 | iex). ② دسکتاپ: Settings > Models در ناوبری سمت چپ > Add model > Provider را باز کنید و زیر Custom، OpenAI Compatible یا Anthropic Compatible را انتخاب کنید؛ برای OpenAI Compatible همچنین Chat Completions API یا Responses API را انتخاب کنید. ③ Base URL، کلید API و Model ID را وارد کنید، نام نمایشی، پنجره زمینه، گزینه‌های بینایی و تفکر را متناسب با مدل تنظیم کنید، روی Validate and add model کلیک کنید و سپس مدل را در چت انتخاب کنید. ④ CLI: /model > Custom > Add custom model...، از ویزارد پیروی کنید و settings.json را به‌صورت دستی ویرایش نکنید. ⑤ دقیقاً همان Base URL را که سرویس مدل شما ارائه میدهد وارد کنید؛ Qoder قالب نمونه https://api.example.com/v1 را نمایش میدهد. مستندات مسیری را که Qoder برای هر پروتکل اضافه میکند فهرست نمی‌کنند، بنابراین اگر اعتبارسنجی ناموفق بود، ابتدا آدرس را با مستندات ارائهدهنده خود بررسی کنید.
اجرای Qoder با کلید API QCode
از تاریخ 2026-11-10، یک کلید QCode هم به نقاط پایانی سازگار با Anthropic و هم به نقاط پایانی سازگار با OpenAI سرویس میدهد و صورتحساب بر پایه توکن و با نرخ هر مدل در /models محاسبه میشود. برای Claude گزینه Anthropic Compatible را انتخاب کنید، https://api.qcode.cc/api را به‌عنوان Base URL و یک Model ID مانند claude-sonnet-5-5 یا claude-opus-5-5 را وارد کنید. برای GPT گزینه OpenAI Compatible با Chat Completions API را انتخاب کنید، https://api.qcode.cc/openai/v1 و یک Model ID مانند gpt-6.1-sol را وارد کنید؛ برای استفاده از Responses API آن را انتخاب کنید و همان https://api.qcode.cc/openai/v1 را وارد کنید (در QCode مسیرهای /openai/responses و /openai/v1/responses معادل هستند)، همراه با یک مدل GPT. GLM، Kimi، DeepSeek و Qwen روی Anthropic Compatible یا روی OpenAI Compatible با Chat Completions API اجرا می‌شوند، برای نمونه deepseek-v4.1-flash، glm-5.3، kimi-k3 و qwen3.8-max؛ شناسه‌های مدل مطابق /models است. از گذاشتن اسلش انتهایی خودداری کنید، روی Validate و add model کلیک کنید و نتیجه اعتبارسنجی Qoder را ملاک قرار دهید؛ اگر Anthropic Compatible اعتبارسنجی نشد، آدرس را به https://api.qcode.cc/api/v1 تغییر دهید و دوباره اعتبارسنجی کنید. سه گام: ① ثبت‌نام و شارژ حساب (Alipay و سایر روش‌های پرداخت اصلی)؛ ② خرید یک پلن شخصی یا یک بسته پرداخت به‌ازای مصرف و کپی کلید API خود که با cr_ شروع میشود؛ ③ وارد کردن آن در Qoder به روش بالا؛ مقاله مستندات QCode در https://docs.qcode.cc/en/docs/ide/qoder همین مراحل راه‌اندازی را توضیح میدهد. هنوز آماده پلن ماهانه نیستید؟ بسته‌های پرداخت به‌ازای مصرف از $4 شروع می‌شوند برای یک سهمیه یک‌باره که ظرف 7 روز مصرف می‌کنید.
پرسشهای متداول
آیا Qoder میتواند از کلید API خودم استفاده کند؟
بله. صفحه رسمی مدلهای سفارشی میگوید Qoder از دسترسی به منابع مدل ارائهدهندگان شخص ثالث از طریق کلیدهای API پشتیبانی میکند؛ مسیر دسکتاپ Settings > Models > Add model و مسیر CLI تب Custom در /model است. صفحه CLI نسخه را Individual plan اعلام میکند. در اپ دسکتاپ، نقاط پایانی سفارشی دو نوع هستند: OpenAI Compatible و Anthropic Compatible. مقادیر QCode در بالا آمده است.
چگونه Base URL را در Qoder تنظیم کنم؟
در Add model، یک نقطه پایانی سفارشی انتخاب کنید و Base URL را وارد کنید؛ صفحه رسمی همان Base URL دقیقی را می‌خواهد که سرویس مدل ارائه میدهد و https://api.example.com/v1 را به‌عنوان قالب نمونه نشان میدهد. برای QCode، گزینه Anthropic Compatible مقدار https://api.qcode.cc/api و گزینه OpenAI Compatible مقدار https://api.qcode.cc/openai/v1 را می‌گیرد، بدون اسلش انتهایی؛ اگر Anthropic Compatible اعتبارسنجی نشد، https://api.qcode.cc/api/v1 را امتحان کنید. اگر اعتبارسنجی شکست خورد، توصیه رسمی این است که ابتدا بررسی کنید Base URL کامل است و پروتکل و نوع API با نقطه پایانی هم‌خوانی دارند، سپس کلید، Model ID، موجودی و شبکه را بررسی کنید.
آیا وقتی کلید خودم را میآورم، Qoder باز هم اعتبار مصرف میکند؟
پرسشهای متداول رسمی پاسخ میدهد: هزینه مدلهای سفارشی مستقیماً از حساب API ارائهدهنده شما کسر میشود و از اعتبار Qoder استفاده نمیکند. استثنا در همان پاسخ آمده است: Repo Wiki از یک مدل ثابت استفاده میکند و اعتبار Qoder مصرف میکند و هنگام تولید یک prompt نمایش میدهد. با کلید QCode، مصرف بر پایه توکن و با نرخ هر مدل در /models محاسبه میشود.
چگونه در Qoder CLI یک مدل سفارشی اضافه کنم؟
در CLI دستور /model را وارد کنید، به تب Custom بروید، Add custom model... را انتخاب کنید و Enter بزنید، سپس ویزارد را از Provider، نوع مدل و مدل دنبال کنید و کلید API و هر اطلاعات دیگری که می‌خواهد را وارد کنید؛ پس از اعتبارسنجی، پیکربندی بهطور خودکار ذخیره میشود و می‌توانید بی‌درنگ به آن سوییچ کنید. صفحه رسمی میگوید BYOK را به‌صورت دستی در settings.json پیکربندی نکنید. اگر تب Custom وجود ندارد، مطمئن شوید که BYOK برای حساب کاربری و پلن شما در دسترس است.
آیا میتوانم در QoderWork مدل سفارشی اضافه کنم؟
از 2026-11-10، صفحه رسمی مدلهای QoderWork فهرست Premium، Advanced و Standard بههمراه Qwen3.7-Max و Qwen3.7-Plus را دارد و هیچ ورودی برای مدل سفارشی ندارد. صفحه دانلود Qoder میگوید QoderWork رسماً در 2027-09-05 فعالیت خود را متوقف میکند، تا آن زمان قابل دانلود و استفاده باقی میماند و حساب کاربری و اعتبار Qoder شما با سایر محصولات Qoder قابل استفاده است؛ توصیه میکند از پیش به Qoder Desktop مهاجرت کنید که ابزارهای درونساخت وارد کردن داده، تاریخچه وظایف، مهارتها و حافظهها را منتقل میکنند. برای آوردن مدل خودتان، آن را همانطور که بالا توضیح داده شد در اپ دسکتاپ Qoder یا CLI اضافه کنید.
آیا میتوانم در پلن Free در Qoder از کلید API خودم استفاده کنم؟
بله. در تاریخ 2026-11-10، صفحه قیمتگذاری Qoder عبارت «Bring Your Own Key (BYOK)» را در ستون Free مربوط به پلنهای فردی فهرست میکند، و در 2026-09-12 حساب رسمی Qoder در X نوشت که از v1.1.50 به بعد، Qoder CLI از یکپارچهسازی مدل سفارشی برای همه کاربران فردی پشتیبانی میکند. اگر زبانه Custom یا گزینه افزودن وجود ندارد، صفحه CLI میگوید تأیید کنید که BYOK برای حساب کاربری و پلن فعلی در دسترس است. بهطور جداگانه، اطلاعیه رسمی (منتشرشده در 2026-09-04) میگوید رده مدل Lite در 2026-09-18 ساعت 14:00 به وقت سنگاپور (UTC+8) از انتخابگر مدل در همه محصولات Qoder حذف شد؛ این تغییر به یک رده مدل مربوط است، و صفحه قیمتگذاری هنوز پلن Lite را فهرست میکند.
منابع
Qoder: صفحه‌های مدلهای سفارشی در docs.qoder.com (چینی، انگلیسی، ژاپنی)، صفحه مدلهای سفارشی CLI، صفحه انتخابگر مدل، صفحه قیمتگذاری، صفحه مدلهای QoderWork و اطلاعیه کنارگذاری رده Lite، صفحه مدلهای سفارشی در docs.qoder.cn، یادداشت‌های انتشار دسکتاپ، CLI و Qoder IDE در changelog.qoder.com، صفحه دانلود qoder.com و پست رسمی Qoder در X مربوط به 2026-09-12، همه در 2026-11-10 خوانده شد. QCode: qcode.cc/models، qcode.cc/pricing، qcode.cc/pay-as-you-go و صفحه Endpoints & API Paths در docs.qcode.cc، بازیابی‌شده در 2026-11-10.
Qoder را با کلید خودتان اجرا کنید
یک کلید API QCode در Qoder: Claude از طریق Anthropic Compatible، GPT و مدلهای چینی از طریق OpenAI Compatible؛ هزینه به‌ازای هر توکن محاسبه میشود. نرخ‌های هر مدل در /models است.
مطالب مرتبط
بسته‌های پرداخت به‌ازای مصرف
بسته‌های سهمیه یک‌باره که به مدت 7 روز معتبرند، بدون اشتراک؛ بسته‌های اضافی به همان کلید اضافه می‌شوند.
کلید API سفارشی Cursor و Base URL
اینکه کلیدها در Settings → Models کجا قرار می‌گیرند، کدام جایگاه میتواند Base URL را تغییر دهد، چرا Tab کلید شما را نادیده می‌گیرد، و راه‌اندازی QCode.
راهنمای راه‌اندازی مدل سفارشی Trae
نحوه پر کردن مشخصات مدل سفارشی Trae: قالب API، URL درخواست، شناسه مدل و کلید API، بههمراه محدودیت حالت Auto و خطاهای رایج.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
مطالب این صفحه در 2026-11-10 با مستندات و یادداشت‌های انتشار رسمی Qoder بررسی شد؛ صفحات رسمی اولویت دارند. Qoder بهطور مکرر نسخه منتشر میکند، بنابراین نام منوها و گزینه‌ها تابع نسخه‌ای است که نصب می‌کنید. در دسترس بودن مدلهای QCode تابع /models است.