کلود دسکتاپ (Claude Desktop) نسخهٔ دسکتاپی دستیار Anthropic است که با رابط کاربری
گرافیکی کار میکند. روش متداول، لاگین با حساب Anthropic است؛ اما کلود دسکتاپ از
نسخههای اخیر، امکان اتصال به یک درگاه (Gateway) شخص ثالث را هم دارد. در این راهنما
یاد میگیرید کلود دسکتاپ را طوری به آشا وصل کنید که همهٔ گفتوگوها از API آشا، با
کلید خودتان و بهصورت روشن و قابل ردیابی رد شوند.
چرا کلود دسکتاپ را به آشا وصل کنیم؟
وقتی کلود دسکتاپ مستقیماً به یک ارائهدهنده وصل است، قطعی یا محدودیت ترافیک آن
ارائهدهنده به معنی توقف کار شماست. اتصال از طریق درگاه سه مزیت اصلی دارد:
- پایداری با جابهجایی خودکار (Failover): اگر یک ارائهدهنده قطع یا پرترافیک باشد، آشا درخواست را به ارائهدهندهٔ دیگری هدایت میکند و گفتوگوی شما قطع نمیشود.
- کنترل هزینهٔ تیم: سقف هزینه تعیین کنید، اعتبار را بین اعضای تیم تقسیم کنید و از پرش هزینهٔ ناگهانی جلوگیری کنید؛ همه در کیف پول به تومان خودتان.
- شفافیت مصرف: گزارش لحظهای از اینکه کدام مدل، توسط کدام عضو تیم و با چه هزینهای مصرف شده؛ همه قابل مشاهده در داشبورد فعالیت آشا.
یادتان باشد: آشا با API سازگار با Anthropic کار میکند؛ کلود دسکتاپ بهصورت بومی
با آن صحبت میکند و به هیچ پروکسی محلی نیازی نیست.
پیشنیازها
- کلود دسکتاپ نصبشده: آخرین نسخه را از وبسایت Anthropic دانلود کنید.
- کلید API آشا: از پنل کاربری آشا یک کلید بسازید (قالب
sk-asha-...). کلید فقط یکبار کامل نمایش داده میشود؛ آن را امن نگه دارید.
گام ۱ — فعالسازی حالت توسعهدهنده
کلود دسکتاپ را اجرا کنید — نیازی به ورود ندارید. از منوی
Help به بخش Troubleshooting بروید و
Enable Developer Mode را بزنید. این کار منوی Developer را به نوار
منو اضافه میکند.
گام ۲ — باز کردن پنل اتصال شخص ثالث
از منوی Developer، گزینهٔ Configure Third-Party Inference… را انتخاب کنید.
گام ۳ — وارد کردن اطلاعات اتصال Gateway
نوع اتصال را روی Gateway بگذارید و اطلاعات کلید خود را وارد کنید.
آدرس پایهٔ درگاه آشا و کلید API خود را دقیقاً همانطور که در پنل میبینید بنویسید:
مقدار
https://app.asha-ai.ir/v1/
sk-asha-…
bearer
در نسخههای جدیدتر، فیلدهای اختیاری Sign-in session lifetime و
Gateway SSO IdP (OIDC) هم به این پنل اضافه شدهاند. آشا با یک کلید
API استاتیک احراز هویت میشود، نه با جریان ورود OIDC؛ بنابراین فیلدهای OIDC را
خالی بگذارید و فقط با کلید خود احراز هویت کنید. گزینهٔ OIDC فقط برای درگاههایی
است که خودشان (یا پشت یک سرویس دیگر) یک سرور مجوز OAuth دارند.
در پایان روی Apply locally بزنید تا تنظیمات ذخیره شود.
گام ۴ — راهاندازی مجدد
کلود دسکتاپ را کاملاً ببندید (نه فقط پنجره) و دوباره اجرا کنید. در صفحهٔ شروع،
گزینهٔ Continue with Gateway (با عنوان «Local configuration») را
انتخاب کنید. هیچ حساب Anthropic لازم نیست.
گام ۵ — انتخاب مدل
انتخابگر مدل اکنون مدلهایی را که از طریق اتصال آشا در دسترساند نشان میدهد؛ از
همانجا مدل مناسب کارتان را برگزینید. برای مقایسهٔ قیمتها، به صفحهٔ
مدلهای آشا سر بزنید.
همچنین بخوانید: اگر از خط فرمان و ابزارهای Agent استفاده
میکنید، راهنمای اتصال کلود کد (Claude Code) به آشا
را ببینید — متغیرهای محیطی، پیکربندی مدل و یکپارچهسازی GitHub Action.
رفع اشکال متداول
خطای اتصال
مطمئن شوید آدرس Gateway base URL دقیقاً https://app.asha-ai.ir/v1/ است، کلید
API معتبر است و auth scheme روی bearer است.
مدلها نمایش داده نمیشوند
مطمئن شوید کیف پول شما موجودی کافی دارد. ماندهٔ حساب را در پنل کاربری آشا چک کنید
و در صورت نیاز شارژ کنید.
گزینهٔ «Continue with Gateway» دیده نمیشود
مطمئن شوید تنظیمات را با Apply locally ذخیره کردهاید و کلود
دسکتاپ را کاملاً بسته و دوباره باز کردهاید — بستن فقط پنجره کافی نیست.
خطای «دسترسی به این وبسایت مسدود شده» در WebFetch
برخی محیطهای sandbox ترافیک ابزارها را بهطور پیشفرض محدود میکنند و همین میتواند
ابزار WebFetch را از دسترسی به سایتهایی که در لیست سفید قرار نگرفتهاند بازدارد؛
بقیهٔ کلود دسکتاپ تحت تأثیر قرار نمیگیرد. از Developer → Configure Third-Party
Inference…، تب Sandbox & workspace را باز کنید و هاستهای موردنیاز را به
Allowed egress hosts اضافه کنید.
حریم خصوصی
آشا پرامپتهای شما را در سرویسهای هوش مصنوعی ثبت نمیکند مگر اینکه صریحاً ثبت
پرامپت را در تنظیمات حساب فعال کنید. جزئیات در سیاست حریم خصوصی در دسترس است.
جمعبندی
با این پنج گام، کلود دسکتاپ شما به آشا وصل شد: پایداری بهتر، کنترل هزینه برای تیم
و صورتحساب شفاف به تومان؛ همه با یک کلید. برای مشاهدهٔ راهنماها و خبرهای بیشتر، به
بلاگ آشا سر بزنید.
