ارائهدهنده سفارشی ZCode: API مدل اختصاصی شما برای Claude، GPT و مدلهای چینی (نوامبر 2026)
بله. در تاریخ 2026-11-10، صفحه رسمی Connect Models در ZCode میگوید میتوانید ارائهدهنده سفارشی سازگار با پروتکلهای Anthropic / OpenAI اضافه کنید: در نسخه دسکتاپ، در پایین انتخاب‌گر مدل روی مدیریت مدل‌ها کلیک کنید تا تنظیمات -> تنظیمات مدل باز شود، در پایین فهرست ارائه‌دهندگان روی افزودن ارائهدهنده کلیک کنید، نقطه پایانی و کلید API را وارد کنید، سپس با افزودن مدل شناسههای مدل را اضافه کنید. با ZCode CLI 0.17.1 آزمایش شده است و هر سه پروتکل QCode بدون ورود به حساب Z.ai یا BigModel کار میکنند: Base URL مربوط به Anthropic برابر https://api.qcode.cc/api است، OpenAI Chat و Responses هر دو از https://api.qcode.cc/openai/v1 استفاده میکنند، و کلید همان کلید cr_ QCode شماست.
به‌روزرسانی شده 2026-11-14
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدلهای چینی.
- صورتحساب بهازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- به‌صورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکته کلیدی: مستندات رسمی و تست 2026-11-10
همه روی CLI 0.17.1 کار میکنند
تا 2026-11-10، با ZCode CLI 0.17.1 تست شد: anthropic-messages با https://api.qcode.cc/api (claude-haiku-5-5) و openai-chat-completions و openai-responses هر دو با https://api.qcode.cc/openai/v1 (deepseek-v4-flash، gpt-6.1-terra). هر سه بدون ورود به حساب Z.ai یا BigModel پاسخ برگرداندند.
بدون /v1 در URL Anthropic
در کد منبع ZCode، اگر Base URL مربوط به Anthropic به /v1 ختم نشود، /v1 به انتهای آن اضافه میشود و سپس SDK مسیر /messages را اضافه میکند؛ بنابراین https://api.qcode.cc/api درخواست /api/v1/messages را می‌فرستد. OpenAI Chat و Responses مستقیماً /chat/completions یا /responses را اضافه میکنند، پس از https://api.qcode.cc/openai/v1 استفاده میکنند.
دسکتاپ و CLI از فایل‌های پیکربندی متفاوت استفاده میکنند
نسخه دسکتاپ ارائه‌دهندگان را در ~/.zcode/v2/config.json نگه می‌دارد و baseURL زیر options هر ارائهدهنده قرار می‌گیرد. CLI فایل ~/.zcode/v2/provider_config.json را می‌خواند (نه config.json) و از api.type و api.baseUrl استفاده میکند؛ مستندات رسمی CLI اشاره میکند که املای api.baseUrl با options.baseURL قدیمی متفاوت است.
آخرین نسخه تا 2026-11-10
جدیدترین انتشار GitHub نسخه v3.17.2 است: README و changelog تاریخ آن را 2026-11-03 ذکر میکنند و این انتشار در 2026-11-04 (UTC) منتشر شد. مخزن zai-org/ZCode تحت مجوز Apache License 2.0 است و CLI ساخته‌شده از سورس آن نسخه 0.17.1 را گزارش میکند.
ZCode چیست و آیا میتواند از کلید API خودتان استفاده کند؟
بله. تا 2026-11-10، صفحه رسمی Connect Models در ZCode میگوید می‌توان هر سرویس مدلی را که با پروتکلهای Anthropic / OpenAI سازگار است بهعنوان ارائهدهنده سفارشی اضافه کرد، از جمله سرویس‌های عمومی، کانال‌های مدیریت‌شده توسط تیم و سرویس‌های خودمیزبان در شبکه خصوصی. ZCode یک فضای کاری کدنویسی با هوش مصنوعی متن‌باز از Z.ai (Zhipu) است: پرسش‌های متداول رسمی آن را «Agentic Development Environment (ADE)» جدیدی می‌نامد که حول ZCode Agent داخلی شکل گرفته است و README آن را «فضای کاری کدنویسی با هوش مصنوعی با رابط‌های دسکتاپ، مرورگر و ترمینال» توصیف میکند. نسخه دسکتاپ از macOS (Apple Silicon / Intel)، Windows (x64 / ARM64) و Linux (AppImage، DEB، RPM) پشتیبانی میکند؛ نسخه خط فرمان با zcode اجرا میشود، zcode --web رابط وب را اجرا میکند و مستندات مخزن CLI را از سورس می‌سازند. صفحه رسمی سه راه برای دریافت مدل فهرست میکند: ورود با حساب Z.ai یا BigModel و استفاده مستقیم از سهمیه GLM Coding Plan آن؛ تغییر صفحه Z.ai / BigModel به حالت API Key و وارد کردن کلید از آن پلتفرم؛ یا افزودن ارائهدهنده سفارشی که در آن مصرف بر اساس سرویسی که به آن اشاره می‌کنید محاسبه میشود. QCode از راه سوم استفاده میکند.
v3.17.2: آخرین نسخه تا 2026-11-10
تا 2026-11-10، جدیدترین انتشار در GitHub نسخه v3.17.2 است: README و changelog تاریخ آن را 2026-11-03 ذکر میکنند و انتشار GitHub در 2026-11-04 (UTC) منتشر شد. changelog این نسخه میگوید فایل‌های پیکربندی خراب دیگر بازنویسی نمیشوند و این کار از از دست رفتن داده جلوگیری میکند. CLI ساخته‌شده از شاخه main مخزن نسخه 0.17.1 را گزارش میکند که با نسخه دسکتاپ متفاوت است؛ همان CLI، بیلدی است که در تست QCode در 2026-11-10 استفاده شد.
گاه‌شمار
مخزن zai-org/ZCode در GitHub ایجاد میشود.
v3.17.2 منتشر میشود (تاریخ ذکرشده در README و changelog؛ انتشار GitHub در 2026-11-04 به وقت UTC منتشر شد).
مستندات رسمی، README و Releases بررسی شد؛ v3.17.2 همچنان جدیدترین نسخه است. با ZCode CLI 0.17.1 تست شد: پروتکلهای Anthropic، OpenAI Chat و Responses در QCode همگی کار میکنند.
آنچه مستندات ZCode میگوید و آنچه تست و سورس‌کد پاسخ می‌دهد
مستندشده توسط ZCode
① افزودن ارائهدهنده سفارشی در برنامه دسکتاپ: تنظیمات -> تنظیمات مدل را باز کنید، در پایین فهرست ارائه‌دهندگان روی افزودن ارائهدهنده کلیک کنید، نامی برای آن بگذارید، نقطه پایانی و کلید API را وارد کنید، شناسههای مدل را به‌صورت دستی با افزودن مدل اضافه کنید و کلید فعال‌سازی را روشن کنید. ② مثال رسمی DeepSeek: نقطه پایانی Anthropic با https://api.deepseek.com/anthropic و نقطه پایانی OpenAI با https://api.deepseek.com/v1. ③ در فایل دسکتاپ ~/.zcode/v2/config.json، options یک ارائهدهنده فقط تنظیمات اتصال مانند apiKey، baseURL، apiKeyRequired و headers را می‌شناسد؛ سایر کلیدهایی که به‌صورت دستی اضافه میشوند بی‌صدا نادیده گرفته میشوند و هرگز در بدنه درخواست نوشته نمیشوند. ④ مستندات CLI مخزن: ارائه‌دهندگان شخصی در ~/.zcode/v2/provider_config.json قرار دارند، انواع API عبارت‌اند از openai-chat-completions، openai-responses و anthropic-messages، و api.baseUrl با options.baseURL قدیمی به شکل متفاوتی نوشته میشود. ⑤ همان مستندات CLI می‌گویند این فایل کلید را به‌صورت متن ساده نگه می‌دارد؛ بنابراین مجوزهای آن را محدود کنید و آن را در Git قرار ندهید. ⑥ برخی استقرارهای شخص ثالث فقط تا xhigh را می‌پذیرند، بنابراین بالاترین سطح تفکر خطای پارامتر 400 برمی‌گرداند؛ انتخاب high کار میکند. ⑦ همان مدل GLM در نقطه پایانی سازگار با Anthropic تصاویر را حفظ میکند، اما در نقطه پایانی سازگار با OpenAI Chat طوری با آن رفتار میشود که گویی از تصاویر پشتیبانی نمی‌کند. ⑧ پس از راه‌اندازی، کانال را در انتخاب‌گر مدل برگزینید و یک دستور آزمایشی کوتاه بفرستید.
آنچه مستندات بی‌پاسخ می‌گذارند، با آزمون و سورس روشن میشود
تا تاریخ 2026-11-10: ① نحوه اتصال مسیر: مستندات نمی‌گویند؛ در سورس ZCode، Base URL مربوط به Anthropic که /v1 پایانی ندارد، /v1 به آن اضافه میشود و سپس SDK مسیر /messages را اضافه میکند، در حالی که OpenAI Chat و Responses مستقیماً /chat/completions یا /responses را می‌افزایند؛ بنابراین QCode از https://api.qcode.cc/api و https://api.qcode.cc/openai/v1 استفاده میکند. ② آیا باید ابتدا به حساب کاربری Z.ai یا BigModel وارد شوید: با ZCode CLI 0.17.1 آزمون شد، پیکربندی ارائهدهنده شخصی به‌تنهایی کافی است. ③ Responses: صفحه پیکربندی دسکتاپ پروتکلهای Anthropic و OpenAI را فهرست میکند و گزینه Responses اختصاصی ندارد؛ نوع openai-responses در CLI در آزمون کار میکند، باز هم با https://api.qcode.cc/openai/v1. ④ نحوه انتخاب برنامه دسکتاپ وقتی یک ارائهدهنده هم نشانی Anthropic و هم نشانی OpenAI دارد هنوز مستند نشده است؛ بنابراین یک ارائهدهنده بهازای هر پروتکل روشن‌ترین پیکربندی است.
برنامه دسکتاپ در برابر CLI: دو نقطه ورود، دو فایل پیکربندی
برنامه دسکتاپ: افزودن ارائهدهنده در رابط کاربری
بر اساس مستندات رسمی: تنظیمات -> تنظیمات مدل ← افزودن ارائهدهنده. برای نقطه‌های پایانی Anthropic و OpenAI، از همان نشانی‌هایی استفاده کنید که آزمون CLI را پاس کردند (https://api.qcode.cc/api و https://api.qcode.cc/openai/v1)، سپس شناسههای مدل را با افزودن مدل اضافه کنید. پیکربندی در ~/.zcode/v2/config.json ذخیره میشود؛ در آنجا options یک ارائهدهنده، baseURL را نگه می‌دارد.
CLI: نوشتن provider_config.json
CLI فایل ~/.zcode/v2/provider_config.json را می‌خواند، نه config.json برنامه دسکتاپ را. هر ارائهدهنده یک api.type دارد: anthropic-messages با https://api.qcode.cc/api، یا openai-chat-completions / openai-responses با https://api.qcode.cc/openai/v1؛ کلید در access.apiKey و مدل‌ها در personalModelIds قرار می‌گیرند. تا تاریخ 2026-11-10، با ZCode CLI 0.17.1 آزمون شد، هر سه کار میکنند.
نحوه اتصال ZCode به QCode: مراحل دسکتاپ و CLI
دسکتاپ: ① ZCode را از zcode.z.ai نصب کنید (در macOS فایل ZCode.app را به پوشه Applications بکشید، در Windows نصب‌کننده را اجرا کنید، در Linux از AppImage، DEB یا RPM استفاده کنید). ② روی نام مدل در کادر گفتگو کلیک کنید، سپس روی مدیریت مدل‌ها در پایین فهرست کلیک کنید تا تنظیمات -> تنظیمات مدل باز شود. ③ روی افزودن ارائهدهنده در پایین فهرست ارائه‌دهندگان کلیک کنید، نام آن را QCode Claude بگذارید، نقطه پایانی Anthropic را روی https://api.qcode.cc/api تنظیم کنید، کلید cr_ خود را وارد کنید، مدل‌هایی مانند claude-sonnet-5-5 را با افزودن مدل اضافه کنید و کلید فعال‌سازی را روشن کنید. ④ ارائهدهنده دومی با نام QCode OpenAI اضافه کنید، با نقطه پایانی OpenAI با https://api.qcode.cc/openai/v1 و مدل‌هایی مانند gpt-6.1-sol و deepseek-v4-flash. ⑤ یک مدل را در انتخاب‌گر مدل انتخاب کنید و یک دستور آزمایشی کوتاه بفرستید. CLI: در ~/.zcode/v2/provider_config.json، یک ارائهدهنده زیر providerRules اضافه کنید، کلید cr_ خود را در access.apiKey بگذارید، api.type را روی anthropic-messages و api.baseUrl را روی https://api.qcode.cc/api تنظیم کنید (یا openai-chat-completions / openai-responses با https://api.qcode.cc/openai/v1)، شناسههای مدل را در personalModelIds فهرست کنید و defaultModelSelection را روی آن تنظیم کنید. این فایل کلید را به‌صورت متن ساده نگه می‌دارد؛ بنابراین مجوزهای آن را محدود کنید و آن را در Git قرار ندهید.
اجرای ZCode با کلید API QCode
در تاریخ 2026-11-10، یک کلید API QCode هم نقاط پایانی سازگار با Anthropic و هم سازگار با OpenAI را در اختیار شما قرار می‌دهد: مدلهای Claude روی نقطه پایانی Anthropic در https://api.qcode.cc/api، مدلهای GPT روی نقطه پایانی OpenAI در https://api.qcode.cc/openai/v1 (همان نشانی برای Chat و Responses)، و خانوادههای GLM، Kimi، DeepSeek و Qwen روی نقطه پایانی Anthropic یا روی OpenAI Chat. مصرف بهازای هر توکن و با نرخ‌های هر مدل در /models صورتحساب میشود؛ شناسههای رایج مدل عبارت‌اند از claude-sonnet-5-5، claude-opus-5-5، gpt-6.1-sol، deepseek-v4-pro، glm-5.3، kimi-k3 و qwen3.8-max. سه مرحله: ① ثبت‌نام کنید و حساب را شارژ کنید (Alipay و سایر روش‌های پرداخت اصلی پشتیبانی میشوند)؛ ② یک پلن شخصی یا یک بسته پرداخت بهازای مصرف بخرید و کلید API خود را که با cr_ شروع میشود کپی کنید؛ ③ ارائه‌دهندگان را همان‌طور که در بالا گفته شد در ZCode اضافه کنید؛ مقاله مستندات QCode در https://docs.qcode.cc/en/docs/ide/zcode همین فرایند راه‌اندازی را گام‌به‌گام توضیح می‌دهد. برای یک پلن ماهانه آماده نیستید؟ بسته‌های پرداخت بهازای مصرف (/pay-as-you-go) از $4 شروع میشوند و برای یک سهمیه یک‌باره هستند که آن را در بازه 7 روز مصرف می‌کنید؛ اگر از قبل پلن شخصی دارید، هنگام نیاز به سهمیه بیشتر یک بسته تقویتی اضافه کنید.
پرسش‌های متداول
آیا ZCode میتواند از کلید API خودم استفاده کند؟
بله. صفحه رسمی Connect Models در ZCode میگوید ZCode میتواند هر سرویس مدل سازگار با پروتکلهای Anthropic / OpenAI را بهعنوان ارائهدهنده سفارشی اضافه کند: روی Add Provider کلیک کنید، نقطه پایانی و کلید API را وارد کنید، سپس شناسههای مدل را دستی با Add Model اضافه کنید. در تاریخ 2026-11-10، در آزمایش با ZCode CLI 0.17.1، هر سه پروتکل QCode مستقیماً کار میکنند: Base URL مربوط به Anthropic برابر https://api.qcode.cc/api است، OpenAI Chat و Responses از https://api.qcode.cc/openai/v1 استفاده میکنند و کلید همان کلید QCode شماست که با cr_ شروع میشود؛ مصرف بهازای هر توکن و با نرخ هر مدل در /models صورتحساب میشود.
مدل سفارشی در ZCode کجا تنظیم میشود؟
دسکتاپ: روی نام مدل در کادر چت کلیک کنید، روی Manage Models در پایین انتخاب‌گر مدل کلیک کنید تا Settings -> Model Settings باز شود، سپس روی Add Provider در پایین فهرست ارائه‌دهنده‌ها کلیک کنید؛ در اولین اجرا و بدون مدل قابل استفاده، گزینه Use API Key در صفحه خوش‌آمدگویی نیز به تنظیمات مدل می‌رسد. CLI: فایل ~/.zcode/v2/provider_config.json را ویرایش کنید، نه فایل ~/.zcode/v2/config.json مربوط به دسکتاپ را، و نشانی را در api.baseUrl قرار دهید، نه در options.baseURL. مستندات رسمی CLI نیز می‌گویند ZCODE_BASE_URL به نقطه پایانی سرویس خود محصول مربوط است، بنابراین نشانی API مدل در آن قرار نمی‌گیرد.
آیا ZCode میتواند از Claude استفاده کند؟
ارائهدهنده سفارشی ZCode از پروتکل Anthropic پشتیبانی میکند، بنابراین میتوانید Base URL مربوط به Anthropic در QCode را وارد کنید، https://api.qcode.cc/api، و مدلهای Claude را فراخوانی کنید؛ در تاریخ 2026-11-10، claude-haiku-5-5 در آزمایشی با ZCode CLI 0.17.1 مستقیماً پاسخ داد و claude-sonnet-5-5 و claude-opus-5-5 نیز در /models هستند. مدلهای Claude فقط روی همان نشانی ارائه میشوند؛ مدلهای GPT از Base URL مربوط به OpenAI https://api.qcode.cc/openai/v1 استفاده میکنند.
آیا Base URL در ZCode به /v1 نیاز دارد؟
برای Anthropic نه، برای OpenAI بله. کد منبع ZCode به Base URL مربوط به Anthropic که از قبل به آن ختم نمی‌شود، /v1 را اضافه میکند و سپس SDK مسیر /messages را اضافه میکند؛ بنابراین https://api.qcode.cc/api را وارد کنید (بر اساس کد منبع، https://api.qcode.cc/api/v1 به همان /api/v1/messages می‌رسد). OpenAI Chat و Responses مستقیماً /chat/completions یا /responses را اضافه میکنند؛ بنابراین https://api.qcode.cc/openai/v1 را وارد کنید. در تاریخ 2026-11-10، هر سه در آزمونی با ZCode CLI 0.17.1 موفق شدند؛ اسلش انتهایی را ننویسید.
آیا ZCode از Responses یا Gemini پشتیبانی میکند؟
CLI از Responses پشتیبانی میکند: api.type را روی openai-responses و api.baseUrl را روی https://api.qcode.cc/openai/v1 تنظیم کنید؛ در تاریخ 2026-11-10، این مورد در آزمایشی با ZCode CLI 0.17.1 (gpt-6.1-terra) کار کرد. صفحه پیکربندی دسکتاپ پروتکلهای Anthropic و OpenAI را بدون ورودی جداگانهای برای Responses فهرست میکند؛ برای مدلهای GPT در برنامه دسکتاپ، نقطه پایانی OpenAI https://api.qcode.cc/openai/v1 را وارد کنید. انواع API در مستندات ZCode هیچ نوع Gemini را شامل نمیشوند؛ در QCode میتوانید از Claude، GPT و خانوادههای GLM، Kimi، DeepSeek و Qwen استفاده کنید؛ شناسههای مدل در /models قرار دارند.
ZCode در کار با QCode خطای 400 یا 404 برمی‌گرداند؛ اکنون چه باید کرد؟
خطا را تطبیق دهید. model_not_available_on_endpoint: یک مدل Claude به ارائه‌دهنده‌ای با آدرس OpenAI اضافه شده است؛ مدلهای claude-… را در ارائه‌دهنده‌ای قرار دهید که آدرسش https://api.qcode.cc/api است. خطای پارامتر 400 در بالاترین سطح thinking: مستندات می‌گویند برخی استقرارهای شخص ثالث فقط تا xhigh را می‌پذیرند، بنابراین high را انتخاب کنید. خطای 404: یک علت رایج، اسلش انتهایی است که مسیر را به //v1/messages تبدیل میکند؛ /api و /openai/v1 را دقیقاً مانند بالا وارد کنید. حذف تصاویر: در مثال رسمی، همان مدل GLM تصاویر را در نقطه پایانی سازگار با Anthropic حفظ میکند، اما در نقطه پایانی سازگار با OpenAI Chat بهعنوان مدل بدون پشتیبانی از تصویر در نظر گرفته میشود؛ برای یک مدل سفارشی، قابلیت تصویر آن را در پیکربندی مدل اعلام کنید.
منابع
ZCode: صفحات Connect Models، نصب و پرسش‌های متداول و تغییرات در zcode.z.ai، صفحه ZCode در docs.bigmodel.cn، و README، LICENSE، راهنمای استفاده از CLI و سند پیکربندی، تابع normalizeAnthropicBaseURL در کد منبع، داده‌های مخزن و Releases مربوط به zai-org/ZCode در GitHub، که همه در 2026-11-10 خوانده شدند. آزمون: 2026-11-10، ZCode CLI 0.17.1 ساخته‌شده از سورس مخزن. QCode: qcode.cc/models، qcode.cc/pricing، qcode.cc/pay-as-you-go و صفحه Endpoints & API Paths در docs.qcode.cc، بازیابی‌شده در 2026-11-10.
ZCode را با کلید خودتان اجرا کنید
یک کلید API QCode را در یک ارائهدهنده سفارشی ZCode قرار دهید: نقطه پایانی Anthropic برای Claude، نقطه پایانی OpenAI برای GPT، و برای مدلهای چینی هر یک از این دو؛ صورتحساب بر اساس توکن و با نرخ‌های هر مدل در /models محاسبه میشود.
مطالب مرتبط
بسته‌های پرداخت بهازای مصرف
بسته‌های سهمیه یک‌باره به مدت 7 روز معتبر، بدون اشتراک؛ بسته‌های اضافی به همان کلید اضافه میشوند.
Claude Code با مدلهای چینی: راهنمای راه‌اندازی
یک کلید cr_ برای DeepSeek، GLM، Kimi و Qwen در Claude Code: همان آدرس، با /model تغییر دهید.
راهنمای راه‌اندازی مدل سفارشی Trae
نحوه تکمیل مدل سفارشی Trae: قالب API، URL درخواست، شناسه مدل و کلید API، به‌همراه محدودیت حالت Auto و خطاهای رایج.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
مطالب این صفحه در 2026-11-10 با مستندات ZCode، مخزن و کد منبع بررسی شد و آدرس‌های QCode با ZCode CLI 0.17.1 آزمایش شدند؛ صفحات رسمی ملاک هستند. نام‌ها و گزینه‌های منو تابع نسخه‌ای است که نصب می‌کنید و دسترس‌پذیری مدلهای QCode تابع /models است.