Claude Desktop فقط محدود به تنظیمات پیش‌فرض نیست. در نسخه‌های جدید این برنامه می‌توانید از طریق قابلیت Third-Party Inference یک API Gateway سفارشی را به کلاینت Claude متصل کنید.

این قابلیت به شما اجازه می‌دهد از یک Custom API یا سرویس‌هایی مانند Sinox API مستقیماً در Claude Desktop استفاده کنید.

در این آموزش، مرحله‌به‌مرحله نحوه فعال‌سازی Developer Mode، تنظیم Third-Party Inference و اتصال API سفارشی به Claude Desktop را بررسی می‌کنیم.

این مراحل در نسخه‌های Windows و macOS تا حد زیادی یکسان هستند.

پیش‌نیازهای اتصال Custom API به Claude Desktop

قبل از شروع به دو مورد نیاز دارید:

• Gateway Base URL
• API Key معتبر

اگر از Sinox API استفاده می‌کنید، API Key خود را از پنل کاربری دریافت کنید.

نکته مهم این است که برای اتصال Claude باید از آدرس API سازگار با Anthropic استفاده کنیم که در ادامه دقیق‌تر توضیح می‌دهیم.

مرحله ۱: ورود به بخش Troubleshooting

ابتدا برنامه Claude Desktop را اجرا کنید.

از منوی برنامه وارد بخش:

Help → Troubleshooting

شوید.

در این قسمت تعدادی از تنظیمات فنی و توسعه‌دهندگان Claude Desktop در دسترس قرار می‌گیرد.

مرحله ۲: فعال کردن Developer Mode

در صفحه Troubleshooting گزینه:

Developer Mode

را پیدا کرده و فعال کنید.

Developer Mode دسترسی به تنظیمات پیشرفته Claude Desktop را فراهم می‌کند و برای تنظیم Third-Party Inference به آن نیاز داریم.

اگر پس از فعال کردن Developer Mode گزینه‌های جدید نمایش داده نشدند، Claude Desktop را به‌طور کامل ببندید و دوباره اجرا کنید.

مرحله ۳: ورود به Configure Third-Party Inference

پس از فعال کردن Developer Mode، وارد بخش:

Configure Third-Party Inference

شوید.

از طریق این قسمت می‌توانید یک API Gateway شخص ثالث را برای Claude تعریف کنید.

در این صفحه تنظیمات مربوط به روش احراز هویت، Gateway Base URL و API Key را مشاهده خواهید کرد.

مرحله ۴: انتخاب Static API Key

در قسمت:

Credential Kind

گزینه:

Static API Key

را انتخاب کنید.

با انتخاب این گزینه، Claude برای اتصال به Gateway از API Key ثابتی که شما وارد می‌کنید استفاده خواهد کرد.

مرحله ۵: وارد کردن Gateway Base URL

در قسمت:

Gateway Base URL

باید آدرس API Gateway موردنظر خود را وارد کنید.

اگر از Sinox API استفاده می‌کنید، برای اتصال Claude Desktop آدرس زیر را وارد کنید:

https://sinoxapi.com

نکته مهم درباره /v1

هنگام اتصال Claude Desktop یا Claude Code به Sinox API، برای مدل‌ها و Endpointهای سازگار با Anthropic، نیازی نیست /v1 را به انتهای Base URL اضافه کنید.

بنابراین آدرس صحیح برای این حالت:

https://sinoxapi.com

است، نه:

https://sinoxapi.com/v1

دلیل این موضوع این است که کلاینت یا کتابخانه سازگار با Anthropic مسیر موردنیاز مانند:

/v1/messages

را خودش به Base URL اضافه می‌کند.

مرحله ۶: وارد کردن Gateway API Key

حالا وارد قسمت:

Gateway API Key

شوید.

API Key سرویس موردنظر خود را در این قسمت قرار دهید.

اگر از Sinox API استفاده می‌کنید، همان API Key که از پنل Sinox دریافت کرده‌اید را وارد کنید.

API Key اطلاعات محرمانه محسوب می‌شود. آن را در اختیار دیگران قرار ندهید و اگر قصد تهیه اسکرین‌شات یا ویدیوی آموزشی دارید، حتماً API Key واقعی خود را مخفی کنید.

تنظیم نهایی Sinox API در Claude Desktop

اگر قصد اتصال Claude Desktop به Sinox API را دارید، تنظیمات نهایی به شکل زیر خواهد بود:

Credential Kind:
Static API Key

Gateway Base URL:
https://sinoxapi.com

Gateway API Key:
API Key حساب Sinox شما

پس از وارد کردن اطلاعات، تنظیمات را ذخیره کنید.

Claude Desktop اکنون می‌تواند درخواست‌های مربوط به مدل‌های سازگار را از طریق Gateway تعریف‌شده ارسال کند.

آیا این روش روی macOS هم قابل استفاده است؟

بله. تنظیمات مربوط به Third-Party Inference در نسخه‌های دسکتاپ Claude برای Windows و macOS مشابه است.

در macOS نیز ابتدا وارد بخش Troubleshooting شوید، Developer Mode را فعال کنید و سپس از قسمت Configure Third-Party Inference اطلاعات Gateway خود را وارد کنید.

البته Claude Desktop به‌طور مرتب به‌روزرسانی می‌شود و ممکن است در نسخه‌های آینده نام یا محل برخی از این گزینه‌ها تغییر کند.

اگر Configure Third-Party Inference نمایش داده نمی‌شود چه کنیم؟

اگر این گزینه را مشاهده نمی‌کنید، ابتدا مطمئن شوید از نسخه به‌روز Claude Desktop استفاده می‌کنید.

سپس وارد:

Help → Troubleshooting

شوید و بررسی کنید که Developer Mode فعال باشد.

در صورت فعال بودن Developer Mode، یک‌بار Claude Desktop را کاملاً ببندید و مجدداً اجرا کنید.

همچنین ممکن است با انتشار نسخه‌های جدید Claude، Anthropic محل یا نحوه دسترسی به بعضی از قابلیت‌های Developer را تغییر دهد.

جمع‌بندی

قابلیت Third-Party Inference در Claude Desktop راه ساده‌ای برای اتصال یک API Gateway سفارشی به کلاینت Claude فراهم می‌کند.

برای انجام تنظیمات ابتدا مسیر:

Help → Troubleshooting → Developer Mode

را دنبال کنید.

سپس وارد:

Configure Third-Party Inference

شوید و Credential Kind را روی Static API Key قرار دهید.

اگر از Sinox API استفاده می‌کنید، تنظیمات اصلی شما به این صورت خواهد بود:

Gateway Base URL: https://sinoxapi.com
Gateway API Key: API Key حساب Sinox

و فراموش نکنید که در اتصال Claude Desktop و Claude Code به API سازگار با Anthropic، نباید /v1 را به Base URL اضافه کنید.

در مقابل، برای ابزارها و کتابخانه‌هایی که از API سازگار با OpenAI استفاده می‌کنند، Base URL سینوکس به صورت https://sinoxapi.com/v1 خواهد بود.