راهنمای پیکربندی Cherry Studio برای APIهای Claude، GPT و DeepSeek
تا تاریخ 2026-10-07، اتصال Cherry Studio به API Claude به این صورت است: در تنظیمات ← سرویس‌های مدل، یک ارائهدهنده اضافه کنید، نوع Anthropic را انتخاب کنید و فقط نشانی ریشه https://api.qcode.cc/api را وارد کنید، بدون /v1. برای GPT و مدلهای چینی مانند DeepSeek، نوع OpenAI را با https://api.qcode.cc/openai انتخاب کنید و از همان کلید cr_ برای هر دو استفاده کنید. این صفحه گام‌ها، شناسههای مدل و خطاهای رایج را نقطه‌به‌نقطه بررسی میکند، بر پایه مستندات QCode و مستندات رسمی Cherry Studio.
به‌روزرسانی شده 2026-11-14
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدلهای چینی.
- صورت‌حساب به‌ازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- به‌صورت خودخدمت: شارژ حساب و فعالسازی فوری
چهار نکته که پیش از شروع باید بدانید
نوع ارائهدهنده برای Claude
نشانی API را روی https://api.qcode.cc/api تنظیم کنید. مستندات QCode میگوید Claude نمی‌تواند از طریق نوع OpenAI کار کند، و Cherry Agent نیز به یک نقطه پایانی با پروتکل Anthropic نیاز دارد.
نوع GPT و مدلهای چینی
نشانی API را روی https://api.qcode.cc/openai تنظیم کنید؛ Cherry بقیه را به‌صورت خودکار اضافه میکند تا /openai/v1/chat/completions شکل بگیرد.
نحوه وارد کردن نشانی API
فقط نشانی ریشه را وارد کنید، بدون /v1 یا هر مسیری؛ اگر خودتان /v1 را تایپ کنید، به /v1/v1 تبدیل میشود. اگر واقعاً باید مسیر خودکار را غیرفعال کنید، نشانی را با # پایان دهید.
یک کلید برای هر دو نوع
هر دو نوع همان کلید cr_ را می‌گیرند که در کنسول ساخته میشود. Cherry همچنین می‌تواند چندین کلید را روی یک ارائهدهنده بچرخاند، که با کاماهای ساده ASCII از هم جدا میشوند.
نحوه اتصال Cherry Studio به یک API سفارشی
تا تاریخ 2026-10-07، اتصال Claude، GPT یا DeepSeek در Cherry Studio همیشه به معنای افزودن یک ارائهدهنده سفارشی در تنظیمات ← سرویس‌های مدل است: Claude از نوع Anthropic با https://api.qcode.cc/api استفاده میکند، در حالی که GPT و مدلهای چینی از نوع OpenAI با https://api.qcode.cc/openai استفاده می‌کنند. Cherry Studio یک کلاینت دسکتاپ متن‌باز است (نسخه Community Edition تحت مجوز AGPL-3.0 است) برای Windows، Mac و Linux. مستندات رسمی آن بیش از 60 ارائهدهنده داخلی را فهرست میکند، و سرویسی که در فهرست نیست همچنان می‌تواند بهعنوان ارائهدهنده سفارشی اضافه شود، به شرطی که پروتکلی مانند OpenAI-compatible یا Anthropic-compatible ارائه دهد. مستندات QCode اشاره میکند که این نرم‌افزار سیستم حساب کاربری ندارد و کاملاً به‌صورت محلی پیکربندی میشود: نه به حساب کاربری Cherry Studio نیاز دارید و نه به حساب کاربری نزد هیچ ارائهدهنده مدلی.
انتشارهای اخیر Cherry Studio (تا تاریخ 2026-10-07)
تا تاریخ 2026-10-07، جدیدترین انتشار پایدار در GitHub Releases نسخه v2.1.4 است که در 2026-09-30 (UTC) منتشر شده است. در یادداشت‌های انتشار آن آمده است: «افزودن Claude Sonnet 5.5 و Opus 5.5 همراه با کنترل‌های thinking و واجد شرایط بودن برای ابزار وب بومی»، و این نسخه همچنین پشتیبانی از GPT-6.1 Sol را برای OpenAI و OpenAI Codex اضافه میکند. v2.1.3 (2026-09-24) میگوید ارائه‌دهندگان پس از افزودن مدل‌ها به‌صورت خودکار تأیید و فعال میشوند، و v2.1.0 (2026-09-18) DeepSeek V4.1 Flash را اضافه کرد. این‌ها به‌روزرسانی‌هایی برای کاتالوگ مدلهای داخلی Cherry هستند؛ وقتی QCode را متصل می‌کنید، همچنان شناسههای مدل را همان‌گونه که مستندات QCode توضیح میدهد وارد می‌کنید و آن‌ها را با /models بررسی می‌کنید. مستند QCode مربوط به Cherry Studio با مستندات رسمی v2.0.14 راستی‌آزمایی شده است، بنابراین برچسب‌های رابط کاربری ممکن است بین نسخه‌ها متفاوت باشند.
گاه‌شمار انتشار و مستندات
Cherry Studio v2.0.14 منتشر میشود؛ مستند QCode مربوط به Cherry Studio با مستندات رسمی این نسخه راستی‌آزمایی شد. از این انتشار به بعد، خطاها به‌جای پیام‌های عمومی مانند «400 null»، جزئیات واقعی ارائهدهنده را نشان می‌دهند.
مستند QCode مربوط به Cherry Studio به‌روزرسانی شده و آخرین بار راستی‌آزمایی شده است؛ Cherry Studio v2.1.0 همان روز منتشر میشود و DeepSeek V4.1 Flash را به کاتالوگ داخلی اضافه میکند.
Cherry Studio v2.1.4 منتشر میشود (UTC) و Claude Sonnet 5.5 و Opus 5.5 را به کاتالوگ داخلی اضافه میکند؛ تا تاریخ 2026-10-07، این جدیدترین انتشار پایدار در GitHub است.
تأیید‌شده در مقابل مستندنشده
تأیید‌شده (عیناً در مستندات)
هر مورد زیر را میتوانید کلمه‌به‌کلمه در مستندات QCode، مستندات رسمی Cherry Studio یا یادداشت‌های انتشار GitHub بررسی کنید: Claude از نوع Anthropic در https://api.qcode.cc/api استفاده میکند؛ GPT و مدلهای چینی از نوع OpenAI در https://api.qcode.cc/openai استفاده می‌کنند؛ هر دو نوع از همان کلید cr_ استفاده می‌کنند؛ آدرس API فقط URL ریشه است و تنها یک # در انتها الحاق مسیر را غیرفعال میکند؛ Claude در صورت قرار گرفتن زیر نوع OpenAI با model_not_available_on_endpoint رد میشود؛ در QCode نقطه پایانی OpenAI Responses فقط به خانواده GPT سرویس میدهد؛ Cherry Agent به یک نقطه پایانی با پروتکل Anthropic نیاز دارد (این موضوع هم در مستندات QCode و هم در مستندات Cherry ذکر شده است)؛ یک ارائهدهنده باید با کلید فعالسازی خود روشن شود و فقط مدل‌هایی که به فهرست آن اضافه شده‌اند در انتخابگرهای مدل نمایش داده میشوند؛ v2.1.4 در 2026-09-30 منتشر شد.
مستندنشده یا تأییدنشده
این صفحه درباره سه نکته هیچ نتیجه‌ای نمی‌گیرد. نخست، مستند QCode بر اساس v2.0.14 تأیید شده است و خودش هشدار میدهد که صفحه تنظیمات با یکی از برچسب‌های «Model Services» یا «Model Provider» مشخص شده است و برچسب دکمه دریافت فهرست مدل‌ها در برخی نسخه‌ها ممکن است «syncing models» باشد؛ این صفحه رابط v2.1.4 را آزمایش نکرده است، بنابراین بر اساس کلاینت خودتان عمل کنید. دوم، مستند QCode برای Cherry Studio فقط یک پیکربندی برای مدلهای چینی ارائه میدهد: نوع OpenAI؛ سایر ترکیب‌ها در آنجا مستند نشده‌اند و این صفحه هم آن‌ها را توضیح نمی‌دهد. سوم، تولید تصویر و ویرایش تصویر فیلدهای Base URL جداگانه خود را دارند و مستند QCode بیان میکند که رفتار Cherry در آن بخش در آن صفحه تأیید نشده است.
کدام نوع ارائهدهنده را انتخاب کنید
Anthropic در برابر OpenAI
این بستگی به خانواده مدل دارد. Claude فقط از طریق نوع Anthropic کار میکند (https://api.qcode.cc/api)، و نقطه پایانی OpenAI در QCode به‌طور کامل Claude را رد میکند؛ GPT و مدلهای چینی GLM، Kimi، DeepSeek و Qwen از نوع OpenAI استفاده می‌کنند (https://api.qcode.cc/openai). خط جداکننده دیگر Agent است: هم مستندات QCode و هم مستندات Cherry بیان می‌کنند که Cherry Agent به نقطه پایانی با پروتکل Anthropic نیاز دارد، بنابراین اگر Agent را داخل برنامه می‌خواهید، نوع Anthropic را پیکربندی کنید.
OpenAI در برابر OpenAI Responses
هر دو https://api.qcode.cc/openai را بهعنوان آدرس API می‌پذیرند؛ تفاوت در این است که به کدام مدل‌ها دسترسی دارند. مستند QCode بیان میکند که نقطه پایانی Responses فقط به خانواده GPT سرویس میدهد و Claude و مدلهای چینی در آنجا در دسترس نیستند. اگر فقط به GPT نیاز دارید، هر کدام از آن‌ها کار میکند؛ اگر DeepSeek یا مدل چینی دیگری هم می‌خواهید، نوع OpenAI را انتخاب کنید.
شش مرحله برای اتصال Claude (سپس GPT و DeepSeek)
① Settings → Model Services را باز کنید، روی دکمه افزودن ارائهدهنده در زیر فهرست کلیک کنید و در کادر ارائهدهنده سفارشی به ارائهدهنده یک نام بدهید. ② نوع Anthropic را انتخاب کنید، آدرس API را روی https://api.qcode.cc/api تنظیم کنید و کلید cr_ را که در کنسول ساخته‌اید جای‌گذاری کنید. ③ فهرست مدل را واکشی کنید، یا روی + کلیک کنید تا یک شناسه مدل را به‌صورت دستی اضافه کنید، برای مثال claude-sonnet-5؛ فقط مدل‌هایی که به فهرست اضافه شده‌اند در انتخابگرهای مدل نمایش داده میشوند. ④ کلید فعالسازی را در بالا سمت راست ارائهدهنده روشن کنید، سپس از دکمه بررسی استفاده کنید و یک مدل را برای آزمایش اتصال انتخاب کنید. ⑤ برای مدلهای GPT و چینی: نوع OpenAI را انتخاب کنید، آدرس API را روی https://api.qcode.cc/openai تنظیم کنید، از همان کلید cr_ استفاده کنید و شناسههای مدل مانند gpt-6-sol، deepseek-v4.1-flash یا glm-5.3 را اضافه کنید. ⑥ مدل جدید را در هر پنجره چت انتخاب کنید و پیامی بفرستید؛ اگر پاسخی دریافت نشد، ابتدا بررسی کنید که نوع با آدرس مطابقت دارد.
در QCode
در QCode، یک کلید cr_ (که در کنسول ساخته میشود) در میان پروتکل‌ها کار میکند و مسیر درخواست تعیین میکند کدام پروتکل استفاده شود: claude-sonnet-5، claude-sonnet-5-5 و claude-opus-5-5 از طریق نوع Anthropic در https://api.qcode.cc/api هدایت میشوند؛ gpt-6-sol، gpt-5.6-terra، deepseek-v4.1-flash، glm-5.3، kimi-k3 و qwen3.8-max از طریق نوع OpenAI در https://api.qcode.cc/openai هدایت میشوند. سه دامنه دسترسی، امکانات یکسانی ارائه می‌دهند و همان کلید را می‌پذیرند: us.qcode.cc (لس‌آنجلس) به آمریکای شمالی و اروپا سرویس میدهد، و برای شبکه‌های سرزمین اصلی چین، مستندات asia.qcode.cc را پیشنهاد می‌کنند و مسیرها بدون تغییر باقی میمانند. مصرف به‌ازای هر توکن محاسبه میشود؛ برای نرخ هر مدل به /models مراجعه کنید. هر درخواست را میتوانید با وارد کردن کلید خود در probe.qcode.cc بررسی کنید.
پرسشهای متداول
برای Claude در Cherry Studio کدام نوع ارائهدهنده را باید انتخاب کنم؟
نوع Anthropic. آدرس API را روی https://api.qcode.cc/api تنظیم کنید، کلید cr_ خود را وارد کنید، سپس یک شناسه مدل (مانند claude-sonnet-5) اضافه کنید یا فهرست مدل‌ها را دریافت کنید. مستندات QCode اعلام میکند که مدلهای Claude فقط می‌توانند از نقطه پایانی Anthropic استفاده کنند، نه نوع OpenAI. ارائهدهنده Anthropic داخلی Cherry به‌طور پیشفرض https://api.anthropic.com است؛ رویکردی که مستندات QCode ارائه میدهد، افزودن یک ارائهدهنده سفارشی جداگانه است.
model_not_available_on_endpoint به چه معناست؟
یعنی پروتکل اشتباه است، نه کلید. اگر یک مدل Claude را زیر نوع OpenAI قرار دهید، QCode خطایی مانند «Model 'claude-sonnet-5' is not available on this endpoint» برمیگرداند. مستندات میگوید این بررسی پیش از احراز هویت انجام میشود، بنابراین حتی وقتی کلید نامعتبر است نیز ظاهر میشود؛ در مقابل، کلید اشتباه خطای Invalid API key را برمیگرداند. راه‌حل: Claude را به نوع Anthropic در https://api.qcode.cc/api منتقل کنید.
آیا آدرس API باید شامل /v1 یا اسلش انتهایی باشد؟
هیچکدام. فقط آدرس ریشه را وارد کنید و Cherry Studio مسیر مربوط به نوعی را که انتخاب کردهاید اضافه میکند؛ اگر خودتان /v1 را تایپ کنید، به /v1/v1 تبدیل میشود. مستندات نقاط پایانی QCode نیز میگوید بهعنوان یک قاعده کلی برای BASE_URL، اسلش انتهایی اضافه نکنید، چون //v1/messages و خطای 404 تولید میکند. اگر واقعاً به یک آدرس کامل نیاز دارید، آن را با # به پایان برسانید: در این صورت Cherry دیگر چیزی اضافه نمیکند و دقیقاً همان چیزی را که تایپ کردهاید به کار میبرد.
کلید را وارد کردم اما هنوز نمیتوانم گفتگو کنم، یا مدل نمایش داده نمیشود. حالا چه کنم؟
سه چیز را بررسی کنید: اینکه کلید فعالسازی ارائهدهنده در بالا سمت راست روشن است یا نه (اگر نباشد، مدلهایش از فهرست انتخاب خارج میمانند)؛ اینکه مدل به فهرست اضافه شده است یا نه (فقط مدلهای فهرستشده در انتخابگرهای مدل ظاهر میشوند)؛ و اینکه نوع با آدرس مطابقت دارد یا نه. پرسشهای متداول رسمی Cherry همچنین پیشنهاد میکند تأیید کنید که مدل پیشفرض واقعاً یکی از مدلهای موجود زیر آن ارائهدهنده باشد و با دکمه بررسی تست کنید؛ اگر بررسی ناموفق بود، بهدنبال شناسه اشتباه تایپشده در فهرست مدل بگردید. با curl کردن مستقیم https://api.qcode.cc/api قضاوت نکنید: این آدرس یک صفحه معرفی HTML (HTTP 200) برمیگرداند که نه خطاست و نه مدرکی بر کارکردن مسیر. پس از وارد کردن کلید، گزارش درخواستهای شما در probe.qcode.cc است.
آیا Cherry Agent می‌تواند از Claude از طریق QCode استفاده کند؟
بله، آن را با نوع Anthropic تنظیم کنید. مستندات QCode اعلام میکند که Cherry Agent به نقطه پایانی نیاز دارد که از پروتکل Anthropic پشتیبانی کند، بنابراین برای استفاده از Agent درون برنامه، نوع Anthropic را با https://api.qcode.cc/api پیکربندی کنید؛ صفحه رسمی Anthropic در Cherry نیز میگوید Agent به نقطه پایانی با پروتکل Anthropic نیاز دارد. اگر Agent میگوید که API Gateway باید فعال شود، همان‌جا از همان پیام آن را فعال و راه‌اندازی کنید، یا به‌صورت دستی از Settings → API Gateway آن را شروع کنید.
برای GPT و DeepSeek از کدام نوع و کدام شناسههای مدل استفاده کنم؟
نوع OpenAI، با https://api.qcode.cc/openai بهعنوان آدرس API و همان کلید cr_. برای شناسههای مدل میتوانید از gpt-6-sol، gpt-5.6-terra، deepseek-v4.1-flash، glm-5.3، kimi-k3 یا qwen3.8-max استفاده کنید؛ برای اینکه در حال حاضر چه چیزهایی ارائه میشود، /models را بررسی کنید. نوع OpenAI Responses نیز با همان آدرس کار میکند، اما در QCode آن نقطه پایانی فقط خانواده GPT را ارائه میدهد، بنابراین DeepSeek، سایر مدلهای چینی و Claude در آنجا در دسترس نیستند.
منابع
مراحل راه‌اندازی، انواع ارائهدهنده و آدرس‌ها: صفحه مستندات QCode درباره Cherry Studio (به‌روزرسانی 2026-09-18) و صفحه نقاط پایانی و قالب‌های API (به‌روزرسانی 2026-09-25؛ اینکه کدام خانواده‌های مدل از کدام نقطه پایانی استفاده می‌کنند، متن دقیق خطا و سه دامنه دسترسی)، هر دو خزش‌شده در 2026-10-07. رابط و قواعد خود Cherry Studio: مستندات رسمی Cherry Studio در docs.cherryai.com.cn (دامنه قدیمی docs.cherry-ai.com اکنون با 301 به آنجا تغییر مسیر میدهد)، یعنی صفحه‌های ارائه‌دهنده‌های سفارشی، تنظیمات سرویس مدل، Anthropic، مرجع سریع ارائهدهنده و پرسشهای متداول، خزش‌شده در همان روز. نسخه‌ها و پلتفرم‌ها: README و Releases مخزن GitHub مربوط به Cherry Studio (یادداشت‌های انتشار از v2.0.14 تا v2.1.4)، خزش‌شده در همان روز.
اتصال Cherry Studio به QCode
یک کلید cr_: Claude از طریق نوع Anthropic، GPT و مدلهای چینی از طریق نوع OpenAI. صورت‌حساب بر اساس توکن؛ برای نرخ هر مدل /models را ببینید.
مطالب مرتبط
پیکربندی نقطه پایانی سفارشی Claude Code
دو متغیر محیطی، شکل settings.json و apiKeyHelper.
کلید API Claude بدون کارت اعتباری: Console در مقابل QCode
بررسی‌شده در 2026-11-05: مراحل و الزامات رسمی برای ایجاد کلید و خرید اعتبار، اینکه QCode چگونه پس از شارژ حساب و خرید پلن یا بسته یک کلید cr_ به شما میدهد، به‌همراه نحوه استفاده از کلید، انقضا و Base URL.
چگونه تشخیص دهیم یک سرویس رله API هوش مصنوعی ارزش استفاده دارد یا نه
چهار بررسی که خودتان میتوانید انجام دهید.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
مراحل و نقل‌قول‌های این صفحه در 2026-10-07 با مستندات QCode، مستندات رسمی Cherry Studio و یادداشت‌های انتشار GitHub بررسی شده است؛ ممکن است تغییرات بدون اطلاع قبلی رخ دهد. برچسب‌های رابط کاربری بین نسخه‌های کلاینت تغییر می‌کنند، بنابراین بر اساس نسخه‌ای که دارید عمل کنید؛ دسترس‌پذیری مدل همان چیزی است که /models نشان میدهد.