Claude Desktop با API شخص ثالث: راهاندازی Gateway در حالت 3P، محدودیت‌ها و پرسش‌های متداول
تا تاریخ 2026-10-07، Claude Desktop میتواند از API شخص ثالث استفاده کند، اما فقط از یک نوع: Gateway که Anthropic Messages API را پیادهسازی میکند. مستندات رسمی آن را راهی برای استفاده از مدلهای Claude معرفی میکنند و کشف مدل فقط مدلهای Claude را نشان میدهد. نقطه ورود، حالت توسعه‌دهنده است: Help → Troubleshooting → Enable Developer Mode، سپس Developer → Configure Third-Party Inference، جایی که ارائهدهنده استنتاج را روی Gateway تنظیم می‌کنید و Base URL و کلید را وارد می‌کنید. اپلیکیشن دسکتاپ، ANTHROPIC_BASE_URL یا settings.json مربوط به Claude Code CLI را نمیخواند و GPT قابل اتصال نیست. این صفحه مراحل، تفاوت آن با Claude Code و پرسش‌های متداول را بر پایه مستندات رسمی Anthropic و مستندات QCode شرح میدهد.
به‌روزرسانی شده 2026-11-13
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدلهای چینی.
- صورتحساب بهازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- به‌صورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکته که پیش از شروع باید بدانید
ارائهدهنده استنتاجی که باید انتخاب کنید
در بخش Connection پنجره Configure Third-Party Inference، ارائهدهنده استنتاج را روی Gateway تنظیم کنید، سپس Gateway base URL، کلید API مربوط به Gateway و طرح احراز هویت را وارد کنید. طبق مستندات رسمی، پنجره مقادیر را همان‌طور که تایپ می‌کنید اعتبارسنجی میکند و میتواند اتصال را در برابر نقطه پایانی شما آزمایش کند.
Gateway باید چه چیزی را پیادهسازی کند
الزام رسمی، Anthropic Messages API است: POST /v1/messages همراه با streaming و tool use الزامی است. GET /v1/models اختیاری است؛ اگر Gateway آن را پیادهسازی کند، مدلها برای شما کشف می‌شوند و اگر نه، آن‌ها را در inferenceModels فهرست می‌کنید.
کدام مدلها را میتوانید انتخاب کنید
صفحه رسمی Gateway درباره استفاده از مدلهای Claude روی یک Gateway است و کشف مدل فقط مدل‌هایی را نشان میدهد که شناسه آن‌ها به‌عنوان Claude قابل تشخیص است. مستندات QCode بیان میکند که مدلهای GPT نمیتوانند از نقطه پایانی Anthropic استفاده کنند، بنابراین GPT در اپلیکیشن دسکتاپ کار نمیکند.
دسکتاپ و CLI هرکدام پیکربندی خود را می‌خوانند
اپلیکیشن دسکتاپ تنظیمات Gateway خود را از پیکربندی استنتاج شخص ثالث مخصوص خود میخواند، نه از ANTHROPIC_BASE_URL یا settings.json. Claude Code CLI برعکس است: از طریق متغیرهای محیطی یا یک فایل تنظیمات به Gateway دسترسی پیدا میکند.
حالت 3P در Claude Desktop چیست
تا تاریخ 2026-10-07، اتصال Claude Desktop به یک API شخص ثالث از طریق حالت استقرار انجام می‌شود که Anthropic آن را Claude Desktop on 3P مینامد: همه استنتاج مدل به ارائه‌دهنده‌ای فرستاده می‌شود که شما پیکربندی می‌کنید، که میتواند Google Cloud's Agent Platform، Amazon Bedrock، Microsoft Foundry، یک Gateway سازگار که شما اداره می‌کنید، یا خود Anthropic API باشد. جدول معماری رسمی تفاوت‌ها را مشخص میکند: Claude Desktop استاندارد استنتاج را به Anthropic API میفرستد، در حالی که حالت 3P از نقطه پایانی پیکربندی‌شده شما استفاده میکند؛ اپلیکیشن وب داخل برنامه بسته‌بندی شده است نه اینکه از claude.ai بارگذاری شود؛ هویت کاربر فقط دستگاه محلی است (مگر اینکه از کنسول مدیریت claude.ai مدیریت شود)؛ گفتگوها روی دیسک محلی ذخیره می‌شوند. Anthropic می‌گوید حالت 3P قابلیتهای Chat، Cowork و Code را حفظ میکند و استنتاج و صورتحساب توسط ارائه‌دهنده‌ای که انتخاب می‌کنید انجام می‌شود (اینکه Cowork از طریق QCode کار میکند یا نه، در این صفحه تأیید نشده است). این حالت برای سازمان‌هایی طراحی شده است که الزامات امنیتی، مقرراتی یا قراردادی آن‌ها مانع از ارسال داده از طریق محصولات خود Anthropic می‌شود؛ یک دستگاه واحد را نیز می‌توان مستقیماً در برنامه پیکربندی کرد، مسیری که مستندات آن را برای ارزیابی، پایلوت‌ها یا سازمان‌های بدون MDM توصیف میکند.
تغییرات اخیر در مستندات رسمی (تا تاریخ 2026-10-07)
تا تاریخ 2026-10-07، جدیدترین انتشار در تغییرات پیکربندی Claude Desktop on 3P، نسخه v2.26454.0 (2026-10-06) است. دو نکته مستقیماً برای کاربران Gateway اهمیت دارد. نخست، صفحه رسمی Gateway می‌گوید در نسخه‌های پیش از v2.19675.0 (2026-10-01)، یک نشست برای هر مدل، پنجره زمینه 200K توکنی را روی مدخل مدل استاندارد فرض میکند؛ نسخه‌های جدیدتر برای مدل‌هایی که به‌عنوان دارای پنجره بومی 1M شناخته می‌شوند 1M و برای هر شناسه مدل دیگر 200K را فرض میکنند. دوم، طرح احراز هویت Gateway اکنون فقط دو مقدار می‌گیرد: bearer و x-api-key، با bearer به‌عنوان مقدار پیش‌فرض. مستندات همچنین از Gatewayها می‌خواهد که کش prompt را حفظ کنند: هر Gateway که cache_control را حذف میکند یا system prompt یا فهرست ابزار را از یک درخواست به درخواست بعدی تغییر میدهد، باعث می‌شود هر نوبت کل گفتگو را با هزینه کامل توکن ورودی دوباره پردازش کند. صفحه راهاندازی Claude Desktop در QCode آخرین بار در 2026-09-25 به‌روزرسانی شده است.
خط زمانی
Claude Desktop v1.3036.0 تنظیم طرح احراز هویت Gateway را اضافه میکند، بنابراین اعتبارنامه Gateway را می‌توان به‌صورت هدر Authorization: Bearer یا هدر x-api-key ارسال کرد.
صفحه راهاندازی QCode Claude Desktop به‌روزرسانی شده است؛ در آن گفته می‌شود که این صفحه بر پایه مستندات رسمی دروازه استنتاج شخص ثالث است و نسخه کنونی ادعای اینکه اتصال QCode به شما امکان میدهد از Cowork بدون Pro استفاده کنید را پس گرفته است.
مراحل و نقل‌قول‌های این صفحه در این تاریخ با صفحات رسمی بررسی شدند؛ تا آن روز، جدیدترین انتشار در تاریخچه تغییرات رسمی پیکربندی v2.26454.0 (2026-10-06) است.
تأییدشده در برابر تأییدنشده
تأییدشده (واژه‌به‌واژه در مستندات رسمی)
همه موارد زیر را می‌توان واژه‌به‌واژه در مستندات رسمی Anthropic یا مستندات QCode بررسی کرد: نقطه ورود Help → Troubleshooting → Enable Developer Mode است، سپس Developer → Configure Third-Party Inference؛ دروازه باید Anthropic Messages API را پیادهسازی کند، به‌طوری که POST /v1/messages از استریمینگ و استفاده از ابزار پشتیبانی کند، در حالی که GET /v1/models اختیاری است؛ کشف مدل فقط مدلهای Claude را نشان میدهد؛ طرح احراز هویت به‌طور پیش‌فرض Bearer است و می‌توان آن را به x-api-key تغییر داد؛ برنامه دسکتاپ ANTHROPIC_BASE_URL یا settings.json را نمیخواند؛ در زمانی که پیکربندی دروازه فعال است، Remote Control در دسترس نیست؛ حالت 3P برنامه موبایل ندارد، دسترسی وب claude.ai ندارد، حالت صدا ندارد، اشتراکگذاری بین کاربران ندارد و هیچ نشستی در ابر Anthropic ندارد؛ 3P مصرف مبتنی بر توکن است و مجوز seat ندارد؛ در QCode، مدلهای Claude فقط می‌توانند از نقطه پایانی Anthropic در https://api.qcode.cc/api استفاده کنند.
تأییدنشده یا منابع با هم اختلاف دارند
این صفحه درباره سه موضوع نتیجه‌گیری نمیکند. نخست، Cowork: Anthropic می‌گوید حالت 3P قابلیتهای Chat، Cowork و Code را حفظ میکند، اما مستندات QCode ادعای اینکه اتصال QCode به شما امکان میدهد از Cowork بدون Pro استفاده کنید را پس گرفته‌اند و از خوانندگان می‌خواهند Cowork را به‌عنوان مورد استفاده QCode به حساب نیاورند، بنابراین این صفحه وعده نمی‌دهد که Cowork از طریق QCode کار میکند. دوم، مدلهای غیر Claude: مستندات رسمی میگویند کشف مدل فقط مدلهای Claude را نشان میدهد، و مستندات دروازه Claude Code میگویند Anthropic از اتصال Claude Code به مدلهای غیر Claude از طریق هیچ دروازه‌ای پشتیبانی نمیکند، بنابراین این صفحه هیچ راه‌اندازی‌ای برای مدلهای دیگر در برنامه دسکتاپ ارائه نمی‌دهد. سوم، جست‌وجوی وب، که تأیید نشده است: پانویس در جدول ویژگی‌های رسمی می‌گوید دروازه‌هایی که ابزارهای سرور Anthropic را فوروارد نمی‌کنند ابتدا به یک ارائهدهنده جست‌وجوی وب پیکربندی‌شده نیاز دارند؛ مستندات QCode توضیح نمی‌دهند که جست‌وجوی وب در برنامه دسکتاپ چگونه رفتار میکند، و این صفحه تأیید نکرده است که آیا از طریق QCode کار میکند یا نه.
تفاوت آن با Claude Code Desktop و Claude Code CLI
در برابر Claude Code Desktop
آن‌ها دو برنامه جداگانه نیستند. مستندات رسمی میگویند برنامه Claude Desktop سه تب دارد: Chat برای گفتگوها، Cowork برای Dispatch و کارهای عاملی طولانی‌تر، و Code برای توسعه نرم‌افزار؛ Claude Code Desktop همان تب Code است. در حالت 3P، Code همان موتور Claude Code را که CLI مستقل اجرا میکند اجرا میکند، پیکربندی استنتاج شخص ثالث برنامه دسکتاپ را به‌طور خودکار به ارث می‌برد و از همان ارائهدهنده، نقطه پایانی و اعتبارنامه‌های نشست‌های Cowork استفاده میکند. بنابراین پس از راهاندازی دروازه در برنامه دسکتاپ، تب Code نیز از آن استفاده میکند، بدون نیاز به پیکربندی اضافی.
در برابر Claude Code CLI
پیکربندی در جای دیگری قرار دارد. CLI از طریق ANTHROPIC_BASE_URL به‌همراه یک متغیر اعتبارنامه به دروازه دسترسی پیدا میکند (مستندات QCode از ANTHROPIC_AUTH_TOKEN استفاده میکنند)؛ برنامه دسکتاپ هیچ‌کدام را نمیخواند. مستندات رسمی میگویند تا زمانی که یک اعتبارنامه دروازه فعال است، درخواست‌ها آن را به‌جای ورود اشتراک claude.ai همراه دارند و محدودیت‌های مصرف اشتراک اعمال نمی‌شوند؛ تنظیم فقط ANTHROPIC_BASE_URL بدون اعتبارنامه جایگزین اشتراک نمی‌شود. کدام را به کار ببرید: مستندات برای مدیریت نشست‌های موازی در یک پنجره، چیدن پنل‌ها کنار هم یا بررسی بصری تغییرات، برنامه دسکتاپ را پیشنهاد میکنند و برای اسکریپت‌نویسی، خودکارسازی یا گردش کار ترمینال، CLI را. برنامه دسکتاپ فقط تعاملی است و خروجی به سبک --print ندارد.
شش مرحله برای اتصال یک دروازه در برنامه دسکتاپ
① Claude Desktop را از claude.com/download نصب کنید و آن را بدون ورود یا ساخت حساب کاربری Anthropic اجرا کنید. ② از نوار منوی macOS (در Windows، منوی برنامه ☰ در گوشه بالا-چپ صفحه ورود)، Help → Troubleshooting → Enable Developer Mode را انتخاب کنید؛ برنامه با منوی Developer دوباره راهاندازی می‌شود. ③ Developer → Configure Third-Party Inference… را انتخاب کنید و در بخش Connection، Inference provider را روی Gateway قرار دهید. ④ آدرس gateway را به‌عنوان Gateway base URL و کلیدی را که gateway شما صادر کرده به‌عنوان Gateway API key وارد کنید؛ Credential kind را روی مقدار پیش‌فرض Static API key و Gateway auth scheme را روی مقدار پیش‌فرض Bearer نگه دارید و فقط اگر gateway شما به x-api-key نیاز دارد، به آن تغییر دهید. ⑤ Models: اگر gateway، GET /v1/models را پیادهسازی میکند، مدلها برای شما کشف می‌شوند؛ اگر نه، هر شناسه کامل مدلی را که gateway شما می‌پذیرد در inferenceModels زیر Models فهرست کنید، و اولین ورودی مدل پیش‌فرض می‌شود. ⑥ Apply Changes را کلیک کنید، سپس Save & Restart؛ پس از راهاندازی مجدد، صفحه ورود گزینه‌ای برای شروع با این پیکربندی ارائه میدهد. برای بازگشت به Claude Desktop استاندارد، گزینه ورود Anthropic را در همان صفحه انتخاب کنید.
در QCode
بر اساس مستندات QCode، مرحله ④ را این‌گونه پر کنید: Gateway base URL برابر است با https://api.qcode.cc/api (بدون /v1 و بدون اسلش انتهایی؛ برای شبکه‌های سرزمین اصلی چین، مستندات https://asia.qcode.cc/api را توصیه میکند)، Gateway API key یک کلید cr_ است که در کنسول ساخته می‌شود، و auth scheme روی پیش‌فرض bearer می‌ماند. در QCode، مدلهای Claude فقط می‌توانند از نقطه پایانی Anthropic استفاده کنند؛ بنابراین در برنامه دسکتاپ مدلهای Claude مانند claude-sonnet-5-5، claude-opus-5-5 یا claude-sonnet-5 را انتخاب کنید. مدلهای GPT نمیتوانند از نقطه پایانی Anthropic استفاده کنند؛ برای GPT از کلاینتی استفاده کنید که از پروتکل OpenAI پشتیبانی میکند. همان کلید با Claude Code CLI هم کار میکند: ANTHROPIC_BASE_URL را روی https://api.qcode.cc/api و ANTHROPIC_AUTH_TOKEN را روی کلید cr_ خود تنظیم کنید. هزینه بهازای هر توکن محاسبه می‌شود؛ برای قیمت هر مدل، /models را ببینید. هر درخواست را میتوانید با وارد کردن کلید خود در probe.qcode.cc بررسی کنید.
پرسش‌های متداول
آیا Claude Desktop میتواند از API شخص ثالث یا سفارشی استفاده کند؟
بله، اما فقط یک gateway که Anthropic Messages API را پیادهسازی میکند؛ مستندات رسمی آن را راهی برای استفاده از مدلهای Claude معرفی میکند و کشف مدل فقط مدلهای Claude را نشان میدهد. از تاریخ 2026-10-07، Anthropic این را Claude Desktop on 3P مینامد: در حالت developer، Configure Third-Party Inference را باز کنید، inference provider را روی Gateway تنظیم کنید و یک base URL و کلید وارد کنید. Gateway باید از POST /v1/messages با streaming و tool use پشتیبانی کند. Claude Desktop استاندارد، خارج از حالت 3P، استنتاج را به Anthropic API میفرستد.
آیا میتوانید از GPT در Claude Desktop استفاده کنید؟
خیر. مستندات رسمی الزام میکنند که gateway، Anthropic Messages API را پیادهسازی کند، و کشف مدل فقط مدلهای Claude را نشان میدهد؛ مستندات QCode بیان میکند که مدلهای GPT نمیتوانند از نقطه پایانی Anthropic استفاده کنند. برای GPT روی دسکتاپ، مستندات QCode توصیه میکند کلاینتی انتخاب کنید که از پروتکل OpenAI پشتیبانی میکند.
ANTHROPIC_BASE_URL را در settings.json تنظیم کردم. چرا برنامه دسکتاپ از آن استفاده نمیکند؟
زیرا برنامه دسکتاپ آن را نمیخواند. مستندات رسمی gateway در Claude Code میگویند برنامه دسکتاپ تنظیمات gateway خود را از پیکربندی third-party inference خودش میخواند، نه از ANTHROPIC_BASE_URL یا settings.json؛ آن دو فقط روی Claude Code CLI اثر میگذارند. برای ارسال برنامه دسکتاپ (شامل تب Code آن) از طریق gateway، آن را در Developer → Configure Third-Party Inference پیکربندی کنید. اگر آن پنجره فقطخواندنی باشد، یک مدیر پیکربندیای توزیع کرده است و آن پیکربندی اولویت دارد.
آیا با وجود gateway شخص ثالث همچنان به حساب کاربری Claude یا اشتراک Pro نیاز دارید؟
شما وارد نمیشوید. مراحل رسمی تکماشینی میگویند وارد نشوید و حساب کاربری Anthropic نسازید؛ پس از پیکربندی، صفحه ورود امکان رد کردن احراز هویت Anthropic و شروع با پیکربندی ارائهدهنده شما را ارائه میدهد. مستندات 3P را مصرف مبتنی بر توکن میداند که ارائهدهنده شما آن را صورتحساب میکند، بدون لایسنس بهازای هر کاربر، و استفاده شما از خود برنامه دسکتاپ همچنان تابع شرایط خدمات تجاری Anthropic است. در عوض، قابلیتهای کمتری وجود دارد: در جدول قابلیتهای رسمی، حالت 3P برنامه موبایل ندارد، دسترسی وب به claude.ai ندارد، حالت صدا ندارد، اشتراکگذاری بین کاربران ندارد و نشستی در فضای ابری Anthropic ندارد. برای بازگشت، در صفحه ورود گزینه ورود با Anthropic را انتخاب کنید.
انتخابکننده مدل خالی است یا پیام «Gateway was unreachable» را میبینید. اکنون چه باید بکنید؟
ابتدا آدرس را بررسی کنید، سپس فهرست مدلها را. بر اساس مستندات رسمی، خطای «Gateway was unreachable» یعنی برنامه در زمان راهاندازی نتوانسته به Base URL تنظیمشده دسترسی پیدا کند؛ بنابراین URL و مسیر شبکه را بررسی کنید. برای انتخابگر خالی، مستندات میگویند پاسخ GET /v1/models در Gateway و فهرست inferenceModels خود را بررسی کنید: وقتی /v1/models در دسترس نباشد یا خطا برگرداند، انتخابگر به inferenceModels بازمیگردد و اگر آن فهرست خالی باشد، انتخابگر هم خالی است. مستندات QCode اضافه میکند که Base URL نباید با اسلش تمام شود و کلید باید با cr_ شروع شود و فاصله در ابتدا یا انتها نداشته باشد؛ اگر انتخابگر هنوز خالی است، خودتان شناسههای کامل مانند claude-sonnet-5-5 را در inferenceModels فهرست کنید.
آیا میتوانید برنامه دسکتاپ و Claude Code CLI را همزمان و با یک کلید QCode اجرا کنید؟
بله. مستندات رسمی میگویند برنامه دسکتاپ همان موتور زیربنایی CLI را اجرا میکند و میتوانید هر دو را همزمان روی یک ماشین، حتی روی یک پروژه، اجرا کنید. مستندات QCode میگویند هر کدام پیکربندی خودش را میخواند؛ برنامه دسکتاپ پیکربندی خودش و CLI فایل ~/.claude/settings.json را، در حالی که هر دو یک کلید API QCode را بدون تداخل به اشتراک میگذارند. یک نکته: فرمان /desktop که یک نشست CLI را به برنامه دسکتاپ منتقل میکند به ورود با اشتراک Claude نیاز دارد و مستندات میگویند با احراز هویت کلید API در دسترس نیست.
منابع
حالت 3P و راهاندازی Gateway: مستندات رسمی Anthropic برای Claude Desktop on 3P در claude.com/docs (صفحه‌های مرور کلی، مقایسه قابلیت‌ها، نصب و راهاندازی، پیکربندی درون‌برنامه‌ای، LLM gateway، مدلها و سطوح effort، Chat، Code، حقوقی و انطباق، به‌همراه تغییرات پیکربندی)، بازبینی‌شده در 2026-10-07. رابطه برنامه دسکتاپ با CLI: مستندات رسمی Claude Code در code.claude.com (صفحه برنامه دسکتاپ، صفحه اتصال به LLM gateway و صفحه other-LLM-gateways)، بازبینی‌شده در همان روز. آدرس‌ها، کلیدها و قواعد نقطه پایانی QCode: صفحه راهاندازی Claude Desktop در مستندات QCode (به‌روزرسانی‌شده در 2026-09-25)، صفحه نقاط پایانی و قالب‌های API، صفحه متغیرهای محیطی و صفحه اشتراک‌ها و کلید QCode، بازبینی‌شده در همان روز.
اتصال Claude Desktop به QCode
ارائهدهنده استنتاج را روی Gateway تنظیم کنید، از https://api.qcode.cc/api به‌عنوان آدرس و یک کلید QCode که با cr_ شروع می‌شود استفاده کنید و یک مدل Claude انتخاب کنید. صورتحساب بهازای توکن محاسبه می‌شود؛ قیمت هر مدل را در /models ببینید.
مطالب مرتبط
بازطراحی Claude Code Desktop در 2026
بازطراحی 2026-04-14: نوار کناری Mission Control، نشست‌های موازی و یک ترمینال یکپارچه.
هدایت Claude Code به یک نقطه پایانی سفارشی
برای سمت CLI: نحوه تنظیم ANTHROPIC_BASE_URL و AUTH_TOKEN.
قابلیتهای پنهان Claude: 20 کاربرد و بررسی کلید API (2026-11-03)
اینکه هر یک از 20 قابلیت Claude کجا فعال می‌شود، کدام پلن‌ها آن را دریافت میکنند و آیا یک کلید API (شامل QCode) کار میکند — بررسی‌شده در 2026-11-03 بر اساس صفحه‌های رسمی و جدول QCode، همراه با اصلاح چهار تصور غلط رایج.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
مراحل و نقل‌قول‌های این صفحه در 2026-10-07 بر اساس مستندات رسمی Anthropic و مستندات QCode بررسی شده‌اند؛ تغییرات ارائهدهنده ممکن است بدون اطلاع رخ دهد. نام منوها و دکمه‌ها در برنامه دسکتاپ بین نسخه‌ها تغییر میکند، بنابراین نسخه‌ای را که دارید مبنا قرار دهید؛ دسترس‌پذیری مدل همان چیزی است که /models نشان میدهد.