CodeBuddy models.json: مدلهای سفارشی و url درست (نوامبر 2026)
بله. بر اساس 2026-11-10، راهنمای پیکربندی رسمی models.json در CodeBuddy میگوید مدلهای سفارشی در مسیر سطح کاربر ~/.codebuddy/models.json قرار می‌گیرند (سطح پروژه: .codebuddy/models.json در ریشه پروژه)؛ در حال حاضر فقط از قالب رابط OpenAI پشتیبانی میکند، و CLI میتواند api را نیز روی openai-responses تنظیم کند. با CodeBuddy Code 2.182.0 آزمون شد؛ QCode بدون ورود با حساب Tencent کار میکند: یک ورودی Chat مسیر کامل https://api.qcode.cc/openai/v1/chat/completions را بهعنوان url می‌گیرد، یک ورودی Responses مقدار https://api.qcode.cc/openai/v1 را می‌گیرد، و متغیر محیطی CODEBUDDY_BASE_URL مقدار https://api.qcode.cc/openai/v1 را می‌گیرد. هر سه موفق میشوند.
به‌روزرسانی شده 2026-11-14
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدلهای چینی.
- صورت‌حساب به‌ازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- بهصورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکته: مستندات رسمی و آزمون تاریخ 2026-11-10
روی CLI 2.182.0 موفق است
بر اساس 2026-11-10، با CodeBuddy Code 2.182.0 آزمون شد: بدون ورود با حساب Tencent، ورودیهای Chat و Responses در models.json و متغیر CODEBUDDY_BASE_URL همگی به QCode می‌رسند. از یک کلید QCode که با cr_ شروع می‌شود استفاده کنید؛ مصرف به‌ازای هر توکن صورت‌حساب می‌شود و نرخ‌های هر مدل در /models آمده است.
url در Chat به /chat/completions ختم می‌شود
عبارت رسمی: «فیلد url باید مسیر کامل رابط باشد و معمولاً به /chat/completions ختم شود»، و https://api.openai.com/v1 بهعنوان نمونه نادرست ذکر شده است. بنابراین یک ورودی Chat در QCode از https://api.qcode.cc/openai/v1/chat/completions استفاده میکند؛ توقف در /v1 مسیر درخواست را ناقص می‌گذارد.
با تنظیم api، url فقط Base URL است.
مستندات CLI: وقتی api روی openai-responses تنظیم شود، درخواستها به {url}/responses میروند؛ url مقدار Base URL را می‌گیرد و /responses در انتها اختیاری است. برای QCode از https://api.qcode.cc/openai/v1 با شناسه GPT مانند gpt-6.1-terra استفاده کنید. جدول فیلدهای IDE فیلد api را ندارد، بنابراین ورودیهای Responses مخصوص CLI هستند.
همان فایل در IDE؛ apiKey خود کلید است
مستندات IDE از همان مسیرهای فایل و فیلدهای Chat استفاده میکند و apiKey را «مقدار واقعی کلید، نه نام متغیر محیطی» توصیف میکند؛ در CLI، apiKey و url ارجاع‌های ${VAR_NAME} را می‌پذیرند. اگر IDE و CLI یک ~/.codebuddy/models.json مشترک دارند، در هر ورودی، کلید cr_ خود را مستقیماً بنویسید؛ CLI نیز آن را می‌پذیرد.
آیا CodeBuddy میتواند از کلید API خودتان استفاده کند؟
بله. بر اساس 2026-11-10، راهنمای پیکربندی رسمی models.json در CodeBuddy میگوید مدلهای سفارشی در models.json قرار می‌گیرند: ~/.codebuddy/models.json در سطح کاربر برای همه پروژه‌ها اعمال می‌شود و .codebuddy/models.json در ریشه پروژه اولویت دارد. در حال حاضر فقط از API با قالب رابط OpenAI پشتیبانی میکند، و CLI نیز api را با مقدار openai-responses می‌پذیرد. CodeBuddy ابزار کدنویسی با هوش مصنوعی Tencent Cloud است؛ معرفی محصول Tencent Cloud میگوید سه شکل دارد: افزونه، IDE و CLI. افزونه در VS Code یا IDEهای JetBrains نصب می‌شود، CodeBuddy IDE یک IDE مستقل است و CodeBuddy Code ابزار خط فرمان است (فرمان codebuddy). مسیر models.json در مستندات codebuddy.cn و codebuddy.ai یکسان است. این پروتکل در QCode، GPT و خانواده‌های چینی (DeepSeek، GLM، Kimi، Qwen) را اجرا میکند؛ اگر به Claude نیاز دارید، از ابزاری با نقطه پایانی Anthropic استفاده کنید، مانند Claude Code، ZCode یا Qoder، با همان کلید. WorkBuddy، محصول اداری همان تیم، نیز از OpenAI Chat Completions استفاده میکند اما models.json را در مسیر دیگری نگه میدارد؛ /workbuddy-guide را ببینید.
بر اساس 2026-11-10: از CLI v2.180.0، مدلهای سفارشی هیچ هدر هویت پلتفرم ارسال نمی‌کنند
تاریخچه نسخه‌های CLI بینالمللی، v2.180.0 را 2026-11-04 و v2.182.0 را 2026-11-09 ثبت میکند. یادداشت‌های انتشار v2.180.0 می‌گویند مدلهای سفارشی دیگر هدرهای درخواست هویت پلتفرم را حمل نمی‌کنند: وقتی یک مدل سفارشی مستقیماً به یک نقطه پایانی شخص ثالث متصل می‌شود، اطلاعات هویت دیگر به سرویسی که پیکربندی کرده‌اید ارسال نمی‌شود. جدیدترین ورودی در تاریخچه نسخه‌های IDE سرزمین اصلی 4.12.4 (2026-11-06) است و مسیر مستند models.json تغییری نکرده است. تا تاریخ 2026-11-10، با CodeBuddy Code 2.182.0 آزمون شد: مدلهای سفارشی بدون ورود با حساب Tencent از طریق OpenAI Chat و Responses به QCode می‌رسند.
خط زمانی
تاریخچه نسخه‌های CLI بینالمللی، v2.180.0 را فهرست میکند؛ یادداشت‌های انتشار آن می‌گویند مدلهای سفارشی دیگر هدرهای درخواست هویت پلتفرم را حمل نمی‌کنند.
تاریخچه نسخه‌های CLI بینالمللی، v2.182.0 را فهرست میکند؛ همان نسخه‌ای که در آزمون این صفحه استفاده شده است.
با CodeBuddy Code 2.182.0 آزمون شد: مسیر کامل Chat، Responses در /openai/v1 و CODEBUDDY_BASE_URL همگی به QCode می‌رسند، بدون ورود با حساب Tencent در هیچ مرحله‌ای.
آنچه مستندات بیان میکنند و آنچه آزمون 2026-11-10 تکمیل میکند
آنچه مستندات CodeBuddy بیان میکنند
① مکان‌های فایل: ~/.codebuddy/models.json در سطح کاربر برای هر پروژه اعمال می‌شود؛ سطح پروژه، فایل .codebuddy/models.json در ریشه پروژه است و اولویت بالاتری دارد. پیکربندی‌ها به ترتیب سطح پروژه، سطح کاربر و پیش‌فرض‌های داخلی ادغام میشوند: مدخلی با همان id بازنویسی می‌شود، مدخلی با id متفاوت افزوده می‌شود، و availableModels در سطح پروژه، سطح کاربر را کاملاً بازنویسی میکند و ادغامی انجام نمی‌شود. ② در حال حاضر فقط از API با قالب رابط OpenAI پشتیبانی میکند؛ url مربوط به Chat باید مسیر کامل رابط باشد و معمولاً به /chat/completions ختم می‌شود. ③ فیلدها: id (الزامی)، name، vendor، apiKey، url، maxInputTokens، maxOutputTokens، supportsToolCall، supportsImages و supportsReasoning؛ CLI موارد api، temperature (0-2) و relatedModels را اضافه میکند. ④ وقتی api روی openai-responses تنظیم شود، مدل از OpenAI Responses API استفاده میکند و درخواستها به {url}/responses میروند؛ فقط apiای که به‌صراحت در مدخل مدل نوشته شود، پروتکل را تغییر می‌دهد. ⑤ در CLI، apiKey و url مقدار ${VAR_NAME} را می‌پذیرند که هنگام شروع CLI حل می‌شود؛ اگر متغیر وجود نداشته باشد، جای‌نگهدار اصلی حفظ می‌شود و فراخوانی API شکست می‌خورد. ⑥ مجوزهای models.json را روی 600 تنظیم کنید و فایل پیکربندی‌ای را که کلید واقعی دارد در کنترل نسخه کامیت نکنید. ⑦ فایل‌های پیکربندی با debounce یک‌ثانیه‌ای بهصورت hot-reload بارگذاری مجدد میشوند؛ مدل‌هایی که از طریق models.json اضافه میشوند به‌طور خودکار برچسب custom می‌گیرند. ⑧ متغیرهای محیطی CLI: CODEBUDDY_API_KEY همیشه در حالت غیرتعاملی (-p) استفاده می‌شود؛ CODEBUDDY_BASE_URL آدرس نقطه پایانی API را بازنویسی میکند، معمولاً همراه با CODEBUDDY_API_KEY؛ CODEBUDDY_MODEL مدل عامل پیشفرض را بازنویسی میکند.
آنچه مستندات باز می‌گذارند و آزمون 2026-11-10 آن را تکمیل میکند
تا تاریخ 2026-11-10، با CodeBuddy Code 2.182.0 آزموده شده است: ① CODEBUDDY_BASE_URL یک Base URL از نوع Chat در OpenAI است و CLI مسیر /chat/completions را به آن می‌افزاید، پس آن را روی https://api.qcode.cc/openai/v1 تنظیم کنید و یک id مدل GPT یا چینی را با --model بفرستید؛ این مسیر به models.json نیازی ندارد. ② نه models.json و نه CODEBUDDY_BASE_URL، هیچ‌کدام ابتدا به ورود با حساب کاربری Tencent نیاز ندارند. ③ یک url از نوع Responses با مقدار https://api.qcode.cc/openai نیز کار میکند؛ مراحل بالا و مستندات راه‌اندازی QCode از https://api.qcode.cc/openai/v1 استفاده میکنند، همان مقداری که برای CODEBUDDY_BASE_URL به کار می‌رود. ④ مراحل IDE مطابق مستندات رسمی IDE است.
IDE و CLI: یک models.json، دو تفاوت
CodeBuddy IDE (بر اساس مستندات رسمی)
همان ~/.codebuddy/models.json و فایل سطح پروژه را می‌خواند. url یک مدخل Chat، مسیر کامل https://api.qcode.cc/openai/v1/chat/completions است؛ apiKey خود کلید cr_ شماست (مستندات IDE: مقدار واقعی کلید، نه نام متغیر محیطی)؛ جدول فیلدها api ندارد. در منوی کشویی مدل، مدخل‌های custom برچسب custom دارند.
CodeBuddy Code CLI (آزموده‌شده روی 2.182.0)
مدخل‌های Chat از همان مسیر کامل استفاده میکنند؛ مدخلی با api: openai-responses فقط https://api.qcode.cc/openai/v1 را بهعنوان url می‌پذیرد، همراه با یک id مدل GPT؛ apiKey میتواند ${QCODE_API_KEY} باشد. همچنین می‌توانید از models.json صرف‌نظر کنید و فقط CODEBUDDY_BASE_URL=https://api.qcode.cc/openai/v1 و CODEBUDDY_API_KEY را تنظیم کنید.
چگونه CodeBuddy را به QCode متصل کنید
① CLI را نصب کنید (اگر فقط از IDE استفاده می‌کنید، این مرحله را رد کنید؛ IDE را از codebuddy.cn یا codebuddy.ai دانلود می‌کنید): پیش‌نیاز رسمی Node.js 18.20 یا بالاتر است؛ دستور npm install -g @tencent-ai/codebuddy-code را اجرا کنید، سپس با codebuddy --version بررسی کنید (آزمون این صفحه از 2.182.0 استفاده کرد). ② فایل ~/.codebuddy/models.json را ایجاد کنید و یک مدخل Chat به آرایه models اضافه کنید: id برابر deepseek-v4-flash، name بهصورت دلخواه، vendor برابر QCode، url برابر https://api.qcode.cc/openai/v1/chat/completions، apiKey برابر ${QCODE_API_KEY} (CLI) یا خود کلید cr_ شما (IDE)، supportsToolCall برابر true، و maxInputTokens و maxOutputTokens روی مقادیری تنظیم شوند که مدل انتخاب‌شده پشتیبانی میکند. ③ برای Responses (CLI)، یک مدخل دوم اضافه کنید: id برابر gpt-6.1-terra، api برابر openai-responses، url برابر https://api.qcode.cc/openai/v1، و سایر فیلدها مانند بالا. ④ CLI: دستور export QCODE_API_KEY=cr_xxx را اجرا کنید، سپس codebuddy -p را با یک prompt کوتاه و --model تنظیم‌شده روی id مدخل اجرا کنید؛ یک پاسخ عادی یعنی کار میکند. IDE: منوی کشویی مدل را باز کنید، مدخل دارای برچسب custom را انتخاب کنید و یک پیام بفرستید. ⑤ همان‌طور که مستندات توصیه میکنند، مجوزهای فایل را روی 600 تنظیم کنید و فایلی را که کلید واقعی دارد کامیت نکنید. در سرزمین اصلی چین می‌توانید api.qcode.cc را با asia.qcode.cc جایگزین کنید؛ مسیر بدون تغییر می‌ماند.
اجرای CodeBuddy با کلید API QCode
از 2026-11-10، یک کلید API QCode هم نقاط پایانی سازگار با Anthropic و هم نقاط پایانی سازگار با OpenAI را ارائه میکند. مدلهای سفارشی CodeBuddy از نقطه پایانی OpenAI استفاده میکنند: مقدار url در یک ورودی Chat همان مسیر کامل https://api.qcode.cc/openai/v1/chat/completions است، در حالی که ورودیهای Responses و CODEBUDDY_BASE_URL از https://api.qcode.cc/openai/v1 استفاده میکنند. در QCode این پروتکل مدلهای GPT و خانواده‌های چینی را اجرا میکند؛ شناسه‌های رایج عبارت‌اند از gpt-6.1-sol، gpt-6.1-terra، deepseek-v4-flash، deepseek-v4-pro، glm-5.3، kimi-k3 و qwen3.8-max. مدلهای Claude روی نقطه پایانی Anthropic یعنی https://api.qcode.cc/api اجرا میشوند و همان کلید در ابزارهایی مانند Claude Code، ZCode یا Qoder کار میکند. مصرف به‌ازای هر توکن محاسبه می‌شود و نرخ هر مدل در /models آمده است. سه مرحله: ① ثبت‌نام کنید و حساب خود را شارژ کنید (Alipay و سایر روش‌های پرداخت اصلی پشتیبانی میشوند)؛ ② یک پلن شخصی یا بسته پرداخت به‌ازای مصرف بخرید و کلید API خود را که با cr_ شروع می‌شود کپی کنید؛ ③ فایل models.json را همان‌طور که در بالا آمد بنویسید؛ مستندات QCode در https://docs.qcode.cc/en/docs/ide/codebuddy شامل JSON کامل و دستورهای تست است. هنوز برای پلن ماهانه آماده نیستید؟ بسته‌های پرداخت به‌ازای مصرف (/pay-as-you-go) از $4 شروع میشوند و یک سهمیه یک‌باره در اختیار شما می‌گذارند که ظرف 7 روز مصرف می‌کنید؛ اگر از قبل پلن شخصی دارید، هر زمان به سهمیه بیشتری نیاز داشتید یک بسته تقویتی اضافه کنید.
پرسش‌های متداول
مدل سفارشی را در CodeBuddy کجا پیکربندی می‌کنید؟
در models.json. فایل ~/.codebuddy/models.json در سطح کاربر برای همه پروژه‌ها اعمال می‌شود، .codebuddy/models.json در ریشه پروژه اولویت دارد، و IDE و CLI همان مسیرها را می‌خوانند. تا تاریخ 2026-11-10، همه فیلدها در راهنمای رسمی پیکربندی models.json فهرست شدهاند؛ فایل با وقفه 1 ثانیه‌ای بهصورت خودکار دوباره بارگذاری می‌شود، بنابراین پس از ذخیره نیازی به راه‌اندازی مجدد نیست.
آیا url در models.json به /chat/completions نیاز دارد؟
برای ورودیهای Chat، بله. متن رسمی: «فیلد url باید مسیر کامل رابط باشد و معمولاً با /chat/completions پایان مییابد»، و https://api.openai.com/v1 بهعنوان نمونه نادرست فهرست شده است، بنابراین QCode از https://api.qcode.cc/openai/v1/chat/completions استفاده میکند. ورودیای با api: openai-responses برعکس کار میکند: url همان پایه است (https://api.qcode.cc/openai/v1)، درخواستها به {url}/responses میروند و /responses در انتها اختیاری است. اگر خطای 404 دریافت کردید، ابتدا بررسی کنید که url مربوط به Chat به /chat/completions میرسد.
آیا برای کارکرد مدل سفارشی CodeBuddy باید وارد شوید؟
خیر. تا تاریخ 2026-11-10، با CodeBuddy Code 2.182.0 آزمایش شده است، هم models.json و هم CODEBUDDY_BASE_URL به QCode می‌رسند و بدون ورود با حساب Tencent پاسخ برمی‌گردانند. راه‌اندازی IDE از مستندات رسمی IDE پیروی میکند. یادداشت‌های انتشار v2.180.0 نیز می‌گویند مدلهای سفارشی دیگر سرآیندهای درخواست هویت پلتفرم را حمل نمی‌کنند.
آیا CodeBuddy میتواند از Claude یا GPT استفاده کند؟
بله، GPT و مدلهای چینی. مدلهای سفارشی CodeBuddy از واسط OpenAI استفاده میکنند، و در QCode این پروتکل GPT بههمراه DeepSeek، GLM، Kimi و Qwen را اجرا میکند: ورودیهای Chat میتوانند از gpt-6.1-sol، deepseek-v4-flash، glm-5.3، kimi-k3 یا qwen3.8-max استفاده کنند، و ورودیهای Responses در CLI میتوانند از gpt-6.1-terra استفاده کنند. مدلهای Claude روی نقطه پایانی Anthropic مربوط به QCode یعنی https://api.qcode.cc/api اجرا میشوند؛ وقتی به Claude نیاز دارید، از ابزاری که از آن پشتیبانی میکند مانند Claude Code، ZCode یا Qoder با همان کلید استفاده کنید.
CODEBUDDY_BASE_URL را چگونه تنظیم می‌کنید؟
آن را روی https://api.qcode.cc/openai/v1 تنظیم کنید، CODEBUDDY_API_KEY را روی کلید QCode خودتان که با cr_ شروع می‌شود تنظیم کنید، و یک شناسه مدل GPT یا چینی را با --model بفرستید. تا تاریخ 2026-11-10، با CodeBuddy Code 2.182.0 آزمایش شده است، این متغیر یک پایه Chat در OpenAI است و CLI مسیر /chat/completions را به آن می‌افزاید، بنابراین این مسیر به models.json نیازی ندارد؛ با https://api.qcode.cc/api درخواست به /api/chat/completions می‌رود و QCode پاسخ HTTP 400 می‌دهد. یادداشت‌های رسمی: CODEBUDDY_BASE_URL آدرس نقطه پایانی API را بازنویسی میکند، معمولاً همراه با CODEBUDDY_API_KEY؛ CODEBUDDY_MODEL مدل پیشفرض عامل را بازنویسی میکند.
آیا models.json در CodeBuddy با WorkBuddy یکسان است؟
مسیرها متفاوتاند. متن رسمی WorkBuddy میگوید که یک زیربنای مشترک با CodeBuddy، محصول کدنویسی، دارد. اپ نسخه سرزمین اصلی پیکربندی خود را بهصورت محلی در workbuddy/models.json نگه میدارد و میگوید مدلهای سفارشیای که از قبل در ~/.codebuddy/models.json تنظیم شدهاند پس از ارتقای رابط کاربری همچنان کار میکنند؛ فایل پیشفرض بینالمللی ~/.workbuddy-ai/models.json است. مدلهای سفارشی WorkBuddy نیز از OpenAI Chat Completions استفاده میکنند، بنابراین url دستنویس همان مسیر کامل https://api.qcode.cc/openai/v1/chat/completions است؛ منوها و مراحل در /workbuddy-guide قرار دارند.
منابع
CodeBuddy: راهنمای پیکربندی models.json در codebuddy.cn و codebuddy.ai (IDE و CLI)، صفحات متغیرهای محیطی و نصب CLI، یادداشت‌های انتشار CLI v2.180.0 و تاریخچه نسخه بینالمللی، تاریخچه نسخه IDE سرزمین اصلی، و مرور کلی محصول CodeBuddy در Tencent Cloud؛ WorkBuddy: صفحات پیکربندی مدل در workbuddy.cn و workbuddy.ai و workbuddy.cn/llms.txt. همه در 2026-11-10 بررسی شدهاند. QCode: مستندات Endpoints & API Paths، مستندات راه‌اندازی CodeBuddy و شناسه‌های فعال در qcode.cc/models. آزمون CLI: CodeBuddy Code 2.182.0، 2026-11-10.
اجرای CodeBuddy با کلید خودتان
یک کلید API QCode را در models.json مربوط به CodeBuddy قرار دهید: OpenAI Chat برای GPT و مدلهای چینی، CLI Responses برای GPT؛ صورت‌حساب به‌ازای هر توکن، با نرخ هر مدل در /models.
مطالب مرتبط
بسته‌های پرداخت به‌ازای مصرف
بسته‌های سهمیه یک‌باره به مدت 7 روز معتبر، بدون اشتراک؛ بسته‌های اضافی به همان کلید افزوده میشوند
راهنمای Tencent WorkBuddy
مرور کلی چندعاملی Office، زاویه راه‌اندازی API سفارشی، و مرز ابزار کدنویسی
ارائه‌دهنده سفارشی ZCode: چگونه از API مدل خودتان استفاده کنید (2026-11)
استفاده از کلید API خودتان در ZCode: Add Provider در دسکتاپ و provider_config.json در CLI، اینکه آیا هر Base URL به /v1 نیاز دارد، و نتایج آزمون CLI 0.17.1.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
در 2026-11-10 با مستندات رسمی CodeBuddy بررسی شد؛ راه‌اندازی QCode با CodeBuddy Code CLI 2.182.0 آزموده شد و مراحل IDE از مستندات رسمی IDE پیروی میکنند. QCode.cc وابسته به Tencent یا CodeBuddy نیست. رابط کاربری و فیلدها تابع نسخه‌ای هستند که نصب می‌کنید و شناسه‌های مدل مطابق /models هستند.