راه‌اندازی مدل سفارشی WorkBuddy با QCode

چگونه QCode.cc را به‌عنوان مدل سفارشی WorkBuddy اضافه کنید: نقاط ورود چین و جهانی، مسیرهای models.json، URL نقطه پایانی، خطای 4100، و شناسه‌های مدل GPT و مدل‌های چینی.

به کلید API نیاز دارید؟ ثبت‌نام ←·نقاط پایانی و Base URL ←

آخرین بررسی: 2026-11-10 · 📄 بر اساس مستندات رسمی (سایت چین workbuddy.cn: آخرین مورد تغییرات 5.11.0، 2026-11-03، در حال عرضه تدریجی؛ سایت بین‌المللی workbuddy.ai: آخرین مورد تغییرات 5.9.4)

در یک نگاه¶

WorkBuddy (سایت بین‌المللی: workbuddy.ai) عامل هوش مصنوعی دسکتاپ از تیم CodeBuddy در Tencent Cloud برای خروجی‌های اداری (یادداشت‌ها، صفحه‌گسترده‌ها، ارائه‌ها، کد سبک) است، نه جایگزین مستقیم Claude Code. llms.txt رسمی آن می‌گوید زیربنای مشترکی با محصول کدنویسی CodeBuddy دارد؛ برای CodeBuddy به مدل‌های سفارشی CodeBuddy مراجعه کنید. برای اتصال WorkBuddy به QCode.cc، تنظیمات → مدل‌ها را باز کنید، یک مدل سفارشی با نقطه پایانی https://api.qcode.cc/openai/v1/chat/completions، کلید cr_ و یک شناسه مدل فعال مانند gpt-6.1-sol اضافه کنید، سپس مدل را انتخاب کنید و ping را بفرستید. مدل‌های سفارشی WorkBuddy از OpenAI Chat Completions استفاده می‌کنند که QCode روی آن GPT و مدل‌های چینی را ارائه می‌دهد؛ مدل‌های Claude روی نقطه پایانی Anthropic ارائه می‌شوند که کلاینت‌هایی مانند Claude Code از آن استفاده می‌کنند.

این صفحه یک کار را پوشش می‌دهد: افزودن QCode.cc به‌عنوان مدل سفارشی WorkBuddy، تا همان کلید cr_ بتواند مدل‌های موجود ما GPT / GLM / Kimi / DeepSeek / Qwen را از WorkBuddy فراخوانی کند.

GPT و مدل‌های چینی در QCode. مدل‌های سفارشی WorkBuddy از پروتکل OpenAI Chat Completions استفاده می‌کنند، که QCode روی آن GPT و خانواده‌های مدل چینی (DeepSeek / GLM / Kimi / Qwen) را ارائه می‌دهد. مدل‌های Claude روی نقطه پایانی Anthropic در QCode (https://api.qcode.cc/api) ارائه می‌شوند، که مدل‌های سفارشی WorkBuddy از آن استفاده نمی‌کنند؛ یک شناسه claude-… روی نقطه پایانی OpenAI model_not_available_on_endpoint را برمی‌گرداند. برای Claude، از ابزاری استفاده کنید که از نقطه پایانی Anthropic پشتیبانی می‌کند، مانند Claude Code، ZCode یا Qoder. به نقاط پایانی و مسیرهای API مراجعه کنید.

QCode.cc وابسته به Tencent، WorkBuddy یا CodeBuddy نیست. برچسب‌های رابط کاربری از نسخه WorkBuddy که نصب کرده‌اید پیروی می‌کنند؛ معانی فیلدها از پیکربندی رسمی مدل پیروی می‌کنند (چین · بین‌المللی). صفحه بین‌المللی می‌گوید: «یکپارچه‌سازی مدل سفارشی در حال حاضر از API سازگار با OpenAI Chat Completions استفاده می‌کند.»

پیش‌نیازها¶

• WorkBuddy دسکتاپ نصب شده باشد (نسخه چین workbuddy.cn، نسخه بین‌المللی workbuddy.ai؛ مراحل نصب: راهنماهای رسمی Mac / Windows). اپ موبایل ورودی مدل سفارشی ندارد؛ پرسش‌های متداول زیر را ببینید
• یک کلید API QCode.cc (با پیشوند cr_) از داشبورد
• همان کلید روی هر سه پروتکل کار می‌کند. مدل‌های سفارشی WorkBuddy از OpenAI Chat Completions استفاده می‌کنند که به QCode /openai/v1/chat/completions نگاشت می‌شود. قواعد پروتکل و BASE_URL: نقاط پایانی و قالب‌های API

افزودن QCode در رابط کاربری (توصیه‌شده)¶

صفحه‌های رسمی مدل می‌گویند مدل‌های سفارشی از طریق یک رابط کاربری بصری مدیریت می‌شوند (افزودن، ویرایش، حذف)، بدون ویرایش دستی فایل پیکربندی. صفحه چین می‌گوید: اگر سرویس مدل شما در فهرست از پیش تعیین‌شده نیست، Custom را انتخاب کنید و URL، کلید API و نام مدل را دستی وارد کنید. راهنمای WorkBuddy در Tencent Cloud TokenHub نیز از همین مسیر استفاده می‌کند.

1. نسخه چین: WorkBuddy را اجرا کنید → منوی حساب کاربری (پایین چپ) → تنظیمات → مدل. نسخه بین‌المللی: Avatar > System Settings > Models
2. در بخش مدل‌های سفارشی، افزودن مدل را بزنید
3. ارائه‌دهنده: Custom
4. جدول زیر را پر کنید، ذخیره کنید، سپس مدل جدید را در انتخاب‌گر مدل چت انتخاب کنید
5. نسخه بین‌المللی آزمایش اتصال را نیز دارد («بررسی می‌کند آیا API می‌تواند پاسخ دهد»)؛ پیش از اتکا به آن ردیف، آن را اجرا کنید. مستندات یادآوری می‌کند که ذخیره پیکربندی به معنای موفقیت اتصال نیست

می‌توانید چند ردیف سفارشی با همان URL و کلید اضافه کنید و فقط نام مدل را تغییر دهید — مثلاً یکی glm-5.3 و یکی deepseek-v4-pro.

نحوه پر کردن URL (پروتکل سفارشی)¶

رفتار رسمی کلید پروتکل سفارشی (در تنظیمات پیشرفته):

صفحه بین‌المللی سه نکته اضافه می‌کند: وقتی کلید خاموش است، نشانی نرمال‌سازی می‌شود تا مسیر با /chat/completions پایان یابد، و سایر بخش‌های مسیر که ارائه‌دهنده نیاز دارد به‌صورت خودکار برای شما اضافه نمی‌شوند؛ وقتی کلید خاموش است «می‌توانید Base URL شامل /v1 یا URL کامل را وارد کنید»؛ و در بیشتر موارد نیازی نیست کلید را روشن کنید. این کلید فقط نحوه پردازش نشانی‌ها را تغییر می‌دهد و مبدل عمومی پروتکل API نیست.

برای QCode، مسیر کامل https://api.qcode.cc/openai/v1/chat/completions را وارد کنید. این مسیر در هر دو وضعیت کلید درست است: با کلید خاموش، مسیر از قبل با /chat/completions پایان می‌یابد، و با روشن بودن آن، نشانی همان‌طور که تایپ شده ارسال می‌شود. این همچنین همان مقداری است که یک models.json دست‌نویس به‌عنوان url نیاز دارد (پایین را ببینید)، و راهنمای Tencent Cloud TokenHub برای WorkBuddy نیز به همین ترتیب یک URL کامل با پایان /v1/chat/completions وارد می‌کند. برای اپ دسکتاپ WorkBuddy، نتیجه آزمایش اتصال حرف آخر را می‌زند.

• با کلید خاموش، https://api.qcode.cc/openai/v1 نیز کار می‌کند (همان مقدار OPENAI_BASE_URL در متغیرهای محیطی)؛ WorkBuddy مسیر /chat/completions را اضافه می‌کند
• /v1 را نگه دارید: WorkBuddy فقط /chat/completions را اضافه می‌کند، نه سایر بخش‌های مسیر، و مسیر چت QCode برابر /openai/v1/chat/completions است
• QCode از مسیر استاندارد استفاده می‌کند، بنابراین می‌توانید پروتکل سفارشی را خاموش بگذارید؛ با روشن بودن آن، فقط مسیر کامل کار می‌کند
• بدون / انتهایی. اسلش‌های اضافی به //chat/completions تبدیل می‌شوند

سه دامنه دسترسی از نظر عملکرد یکسان‌اند؛ فقط مسیریابی تفاوت دارد. همان کلید روی هر سه کار می‌کند:

محل قرارگیری پیکربندی¶

نسخه چین و نسخه بین‌المللی از مسیرهای متفاوتی استفاده می‌کنند؛ آن‌ها را جداگانه بخوانید (نقل‌شده از دو صفحه رسمی):

صفحه بین‌المللی اضافه می‌کند که اگر دایرکتوری پیکربندی کاربر را تغییر داده‌اید، باید از مسیری استفاده کنید که در صفحه تنظیمات مدل نمایش داده می‌شود، و فایل پیکربندی حاوی کلیدهای API نباید در یک مخزن عمومی بارگذاری شود. صفحه چین فقط workbuddy/models.json را نام می‌برد، نه پوشه‌ای که در آن قرار دارد؛ بر اساس فایل واقعی روی دستگاه خود عمل کنید، یا صرفاً ردیف‌ها را در رابط کاربری مدیریت کنید.

همچنین:

• یادداشت رسمی درباره مصرف اعتبار می‌گوید همه هزینه‌هایی که یک مدل سفارشی ایجاد می‌کند به شخص ثالث پرداخت می‌شود (اینجا QCode.cc، با محاسبه هزینه به‌ازای هر توکن)
• بر اساس تغییرات رسمی، بارگذاری مجدد فوری models.json در 5.1.1 ارائه شد: ویرایش‌ها بدون راه‌اندازی مجدد اعمال می‌شوند

برای تغییرات روزمره از رابط کاربری استفاده کنید. اگر باید models.json را دستی ویرایش کنید، جدول فیلدها و قاعده url در مدل‌های سفارشی CodeBuddy آمده است. مستندات رسمی CodeBuddy می‌گوید: «فیلد url باید مسیر کامل رابط باشد، که معمولاً با /chat/completions پایان می‌یابد» (https://api.openai.com/v1 به‌عنوان نمونه نادرست فهرست شده است)، بنابراین url در QCode برابر https://api.qcode.cc/openai/v1/chat/completions است. CodeBuddy Code CLI که بر همان پایه ساخته شده است، با این مسیر کامل به‌عنوان url در models.json آزمایش شده و متصل می‌شود (CodeBuddy Code 2.182.0، 2026-11-10). WorkBuddy جدول فیلد اختصاصی خود برای آن فایل ندارد، بنابراین ابتدا یک ردیف در رابط کاربری اضافه کنید و فایل محلی را بررسی کنید؛ ساختار را از یک وبلاگ شخص ثالث کپی نکنید.

مدل‌هایی که ابتدا باید اضافه شوند¶

همه شناسه‌های زیر در 2026-11-10 در برابر فهرست زنده در qcode.cc/models بررسی شده‌اند. نرخ‌ها در این صفحه کپی نشده‌اند — qcode.cc/models را زنده در نظر بگیرید (مدیران می‌توانند کارمزد سرویس را تغییر دهند).

هم‌خانواده‌های سبک‌تر glm-5.3-flash، deepseek-v4-flash، deepseek-v4.1-flash، qwen3.8-flash و qwen3.7-plus همگی قابل خرید هستند؛ نسل قبلی glm-5.1 و kimi-k2.6 از رده خارج شده‌اند — وارد کردن آن‌ها شکست می‌خورد. انتخاب مدل را ببینید. نامی را که در qcode.cc/models نیست در نام مدل قرار ندهید.

این مسیر OpenAI Chat Completions است. ANTHROPIC_BASE_URL (https://api.qcode.cc/api) را در فیلد نقطه پایانی قرار ندهید — آن پیشوند برای Claude Code / Anthropic SDK است.

بررسی¶

ابتدا بررسی کنید که مسیر OpenAI در QCode روی شبکه شما قابل دسترسی است (همان بررسی‌ای که در نقاط پایانی و قالب‌های API §4 آمده است):

KEY="cr_your_key"

curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"
# → 400 = path and key both work (empty body is expected)
# → 401 = bad key; 404 = wrong path prefix

در چین سرزمین اصلی، با میزبان asia.qcode.cc تکرار کنید. سپس در WorkBuddy مدل جدید را انتخاب کنید و ping بفرستید. دریافت پاسخ یعنی یکپارچه‌سازی کار می‌کند.

اگر بررسی مسیر موفق شود اما WorkBuddy هنوز خطا بدهد، بخش قبلی را دوباره بررسی کنید: URL باید /v1 را نگه دارد و اسلش پایانی نداشته باشد؛ با روشن بودن پروتکل سفارشی، مسیر کامل است و به /chat/completions ختم می‌شود؛ و شناسه مدل دقیقاً کاراکتربه‌کاراکتر است.

پرسش‌های متداول¶

انتخاب‌گر مدل ردیف جدید را نشان نمی‌دهد¶

از نسخه 5.1.1، گزارش تغییرات رسمی از بارگذاری مجدد خودکار models.json می‌گوید — معمولاً ذخیره کردن کافی است. اگر انتخاب‌گر هنوز آن را نشان نمی‌دهد، WorkBuddy را کاملاً ببندید (آن را در سینی سیستم رها نکنید) و دوباره باز کنید؛ سپس برای دیدن آن ردیف، تنظیمات → مدل را بررسی کنید.

کد خطای 4100 (مدل سفارشی نقطه پایانی یا کلید API ندارد)¶

صفحه رسمی کدهای خطای سایت چین می‌گوید (ترجمه): مدل سفارشی انتخاب‌شده URL نقطه پایانی یا کلید API پیکربندی‌شده ندارد، بنابراین درخواست ارسال نمی‌شود. راه‌حل: در کارت خطا روی «رفتن به پیکربندی» کلیک کنید و URL نقطه پایانی و کلید API مدل را پر کنید. چنین مدلی در انتخاب‌گر مدل به رنگ خاکستری و با یک نشانه هشدار نمایش داده می‌شود و پس از ذخیره کردن، بدون راه‌اندازی مجدد دوباره قابل استفاده می‌شود. صفحه رسمی مدل می‌افزاید که مدل‌هایی که به ماشین محلی اشاره می‌کنند (برای مثال Ollama محلی) به کلید API نیاز ندارند و تحت تأثیر قرار نمی‌گیرند.

نمی‌توانم مدل‌های سفارشی را روی گوشی خود پیدا کنم¶

صفحه رسمی مدل در موبایل می‌گوید (ترجمه): اپلیکیشن موبایل گزینه‌ای برای پیکربندی مدل‌های سفارشی ارائه نمی‌دهد؛ فهرست فقط مدل‌های موجود را نشان می‌دهد. پیکربندی را روی دسکتاپ انجام دهید.

آیا نسخه‌های چین و بین‌المللی به راه‌اندازی جداگانه نیاز دارند؟¶

بر اساس مستندات رسمی، دو نسخه پیکربندی خود را در فایل‌های متفاوتی نگه می‌دارند (چین workbuddy/models.json، بین‌المللی ~/.workbuddy-ai/models.json)، بنابراین نسخه‌ای را که نصب کرده‌اید پیکربندی کنید. URL و کلید QCode در هر دو به یک شکل پر می‌شوند.

HTTP 404¶

1. https://api.qcode.cc/openai/v1/chat/completions را وارد کنید (با پروتکل سفارشی خاموش، https://api.qcode.cc/openai/v1 هم کار می‌کند)
2. با پروتکل سفارشی روشن، فقط مسیر کامل کار می‌کند؛ …/openai/v1 به‌تنهایی همان‌طور که تایپ شده ارسال می‌شود، بدون /chat/completions
3. /v1 را نگه دارید؛ بدون / پایانی
4. از https://api.qcode.cc/api استفاده نکنید (پیشوند Anthropic Messages)

HTTP 401¶

کلید باید با cr_ شروع شود و فاصله نداشته باشد. آن را در qcode.cc/dashboard تأیید کنید. WorkBuddy کلید را به‌صورت محلی ذخیره می‌کند؛ چرخش کلید یعنی ویرایش همین ردیف مدل سفارشی.

پاسخ‌های عجیب یا ناموفق پس از پر کردن نام مدل¶

نام مدل باید یک شناسه زنده روی این نقطه پایانی باشد، مانند gpt-5.6-terra، نه برچسب نمایشی «GPT 5.6 Terra» و نه نام مستعار ارائه‌دهنده دیگر. فهرست زنده: qcode.cc/models یا GET https://api.qcode.cc/openai/v1/models با کلید شما — همان فهرست مجموعه‌ای است که WorkBuddy می‌تواند استفاده کند، و شامل Claude نیست.

آیا WorkBuddy گفتگو را به Tencent آپلود می‌کند؟¶

عبارت رسمی: در مسیر مدل سفارشی، WorkBuddy یک حامل است؛ ورودی را به شخص ثالثی که پیکربندی کرده‌اید هدایت می‌کند و کلید API محلی می‌ماند. صفحه رسمی مدل و توافق‌نامه کاربری Tencent مرجع هستند. درخواست‌هایی که به QCode می‌رسند را می‌توان با همان کلید در probe.qcode.cc بررسی کرد.

آیا WorkBuddy می‌تواند جایگزین Claude Code شود؟¶

خیر. WorkBuddy برای تحویل اداری چندعاملی ساخته شده است؛ Claude Code / Codex برای حلقه‌های کدنویسی درون مخزن ساخته شده‌اند. از هر دو استفاده کنید: خروجی‌های اداری در WorkBuddy، و تغییرات کد در Claude Code که با CC Switch جابه‌جا می‌شود. یک کلید QCode، یک سهمیه — صورت‌حساب را ببینید.

گام‌های بعدی¶

• نقاط پایانی و قالب‌های API — سه پروتکل، سه دامنه، نقشه BASE_URL
• مدل‌های سفارشی CodeBuddy — محصول کدنویسی همان تیم: فیلدهای models.json و راه‌اندازی Responses
• راه‌اندازی CC Switch — جابه‌جایی همان کلید بین Claude Code و Codex
• انتخاب مدل — برای استفاده روزمره کدام سطح را به کار ببرید
• صورت‌حساب — پلن‌ها و سهمیه
• شناسه‌ها و نرخ‌های زنده: qcode.cc/models

هنوز کلید API در QCode.cc ندارید؟ یک پلن در qcode.cc/pricing انتخاب کنید.

سازمانی ←