Claude Desktop
برنامهٔ دسکتاپ Claude را بهجای ورود با حساب Anthropic، به درگاه آشا وصل کنید؛ با جابهجایی خودکار بین پروایدرها، کنترل هزینهٔ تیم و مصرف شفاف.
Claude Desktop برنامهٔ دسکتاپ Anthropic است. با پیکربندی «درگاه» (Gateway) در نسخههای جدید، بدون نیاز به حساب Anthropic مستقیماً به API آشا متصل میشود و همهٔ درخواستها از درگاه عبور میکنند.
توصیهٔ سازگاری: استفاده از Claude Desktop از طریق درگاه فقط با خانوادهٔ پروایدرهای Anthropic تضمین میشود. برای حداکثر سازگاری، توصیه میکنیم هنگام استفاده از Claude Desktop، پروایدرهای Anthropic را در اولویت بالای انتخاب پروایدر قرار دهید.
چرا باید کلود دسکتاپ را به آشا وصل کنیم؟
آشا یک لایهٔ پایداری و مدیریت بین Claude Desktop و API ارائهدهندگان اضافه میکند و چند مزیت کلیدی برای شما و سازمانتان فراهم میکند.
جابهجایی خودکار پروایدر برای دسترسپذیری بالا
API ارائهدهندگان هر از گاهی با قطعی یا محدودیت نرخ روبهرو میشود. وقتی Claude Desktop را از طریق آشا مسیردهی کنید، درخواستها بهصورت خودکار بین چند پروایدر Anthropic جابهجا میشوند؛ اگر یکی در دسترس نباشد یا محدودیت داشته باشد، آشا درخواست را به پروایدر دیگری هدایت میکند و نشستهای شما بیوقفه ادامه مییابد.
کنترل بودجهٔ سازمانی
برای تیمها و سازمانها، آشا مدیریت بودجهٔ متمرکز فراهم میکند: سقف هزینه تعیین کنید، اعتبار را بین اعضای تیم تقسیم کنید و از پرش هزینهٔ ناگهانی جلوگیری کنید؛ همه در کیف پول به تومان. این قابلیت وقتی چند عضو تیم بهصورت همزمان از Claude Desktop استفاده میکنند بسیار ارزشمند است.
دید و تحلیل مصرف
آشا دید کاملی از نحوهٔ استفاده از Claude Desktop در تیم شما میدهد: الگوی مصرف را دنبال کنید، هزینهها را لحظهای ببینید و متوجه شوید کدام پروژه یا کدام عضو تیم بیشترین منابع را مصرف میکند. همهٔ این دادهها در داشبورد فعالیت آشا در دسترس است.
نحوهٔ کار
آشا نقطهٔ پایانی سازگار با Anthropic Messages API ارائه میدهد:
- حالت درگاه (Gateway Mode): وقتی Claude Desktop را با پشتیبان درگاه و آدرس API آشا پیکربندی میکنید، برنامه مستقیماً با پروتکل بومی Anthropic با آشا صحبت میکند؛ هیچ پروکسی محلی لازم نیست.
- پوست Anthropic: پوست Anthropicِ آشا دقیقاً مانند API خود Anthropic رفتار میکند؛ نگاشت مدلها را انجام میدهد و قابلیتهای پیشرفته مثل بلوکهای «تفکر» و استفادهٔ بومی از ابزارها را منتقل میکند.
- صورتحساب: هزینه از اعتبار کیف پول آشا کسر میشود و مصرف (شامل توکنهای استدلال) در داشبورد آشا نمایش داده میشود.
پیشنیازها
- نصب شدهٔ Claude Desktop: آخرین نسخه را از سایت Anthropic دانلود کنید.
- کلید API آشا: یک کلید API از داشبورد آشا بسازید.
مراحل پیکربندی
گام ۱ — فعالسازی حالت توسعه
Claude Desktop را اجرا کنید — نیازی به ورود نیست. از منوی Help گزینهٔ Troubleshooting را باز کنید و روی Enable Developer Mode کلیک کنید. این کار یک منوی Developer را به نوار منو اضافه میکند.
گام ۲ — باز کردن پنل استنتاج طرف سوم
از نوار منو روی Developer › Configure Third-Party Inference… کلیک کنید.
گام ۳ — وارد کردن اعتبارنامهٔ درگاه
اتصال را روی Gateway بگذارید و اعتبارنامهٔ آشا را وارد کنید:
| فیلد | مقدار |
|---|---|
| Gateway base URL | https://app.asha-ai.ir |
| Gateway API key | کلید API آشا (مثل sk-asha-…) |
| Gateway auth scheme | bearer |
| Credential kind | Static API key |
فیلد Credential kind مشخص میکند درگاه از کدام منبع اعتبارنامه استفاده کند؛ آن را روی Static API key بگذارید تا Claude Desktop همیشه با همان کلید API آشا که وارد کردهاید احراز هویت کند و به منبع دیگری برنگردد.
در برخی نسخههای جدیدتر Claude Desktop فیلدهای اختیاری Sign-in session lifetime و Gateway SSO IdP (OIDC) (Client ID، Issuer URL، Authorization URL) هم به این پنل اضافه شده. آشا درگاه را با یک کلید API ثابت احراز هویت میکند، نه با جریان ورود OIDC؛ بنابراین فیلدهای OIDC را خالی بگذارید و مانند بالا با کلید API آشا احراز هویت کنید. گزینهٔ OIDC فقط برای درگاههایی است که خودشان (یا پشتسرشان) یک سرور مجوزدهی OAuth دارند.
برای ذخیرهٔ تنظیمات روی Apply Changes کلیک کنید (در نسخههای قدیمیتر با عنوان Apply locally نمایش داده میشود).
گام ۴ — راهاندازی دوباره و اجرا
Claude Desktop را کاملاً ببندید و دوباره باز کنید. در صفحهٔ شروع، Continue with Gateway را انتخاب کنید (با برچسب «Local configuration»). به هیچ حساب Anthropic نیازی نیست.
گام ۵ — انتخاب مدل
انتخابگر مدل حالا مدلهای موجود از طریق اتصال آشا را نمایش میدهد.
Claude Code
Claude Code عامل کدنویسی خطفرمانی جداگانهٔ Anthropic است که با آشا هم کار میکند. اگر گردش کار مبتنی بر ترمینال را ترجیح میدهید، راهنمای اتصال Claude Code به آشا را ببینید — شامل تنظیم متغیرهای محیطی، پیکربندی مدل، حالت سریع و یکپارچهسازی GitHub Action.
رفع اشکال
- خطاهای اتصال: مطمئن شوید Gateway base URL دقیقاً
https://app.asha-ai.irاست و کلید API معتبر است. همچنین طرح احراز هویت بایدbearerباشد. - ظاهر نشدن مدلها: مطمئن شوید در کیف پول آشا اعتبار کافی دارید؛ موجودی را از داشبورد آشا بررسی کنید.
- ظاهر نشدن «Continue with Gateway»: مطمئن شوید تنظیمات را بهصورت محلی اعمال کرده و Claude Desktop را کاملاً بسته و دوباره باز کردهاید (خروج کامل، نه فقط بستن پنجره).
- خطای «Access to this website is blocked by your network egress settings» هنگام WebFetch: Claude Desktop ترافیک ابزارها را بهصورت پیشفرض در sandbox نگه میدارد که ممکن است ابزار WebFetch را از رسیدن به سایتهایی که مجاز نکردهاید مسدود کند. این موضوع هم برای Cowork و هم برای Claude Code صدق میکند. از مسیر Developer › Configure Third-Party Inference… به تب Workspace restrictions بروید و میزبانهای لازم را به Allowed egress hosts اضافه کنید.
-
خطاهای TLS هنگام استفاده از Claude Code داخل Claude Desktop: Claude Code در
یک sandbox اجرا میشود که ایزولاسیون شبکهاش ممکن است اتصال TLS به درگاه را بشکند. برای رفع
آن، موارد زیر را به یک فایل تنظیمات Claude اضافه کنید و سپس Claude Desktop را راهاندازی دوباره
کنید:
فایلی را انتخاب کنید که با دامنهٔ موردنظرتان همخوانی داشته باشد؛JSON settings.json
{ "sandbox": { "enableWeakerNetworkIsolation": true } }~/.claude/settings.jsonبرای همهٔ پروژهها اعمال میشود، در حالی که.claude/settings.jsonیا.claude/settings.local.jsonداخل پروژه، آن را به همان پروژه محدود میکند. در هر حال این گزینه ایزولاسیون شبکهٔ sandbox را برای همهٔ ترافیک شبکهٔ آغازشده توسط عامل شل میکند، نه فقط اتصالات TLS درگاه؛ بنابراین محدودترین دامنهای را انتخاب کنید که مشکل شما را رفع میکند و پس از رفع مشکل، آن را حذف کنید. - حریم خصوصی: آشا پرامپتهای شما را ثبت نمیکند مگر اینکه صریحاً ثبت پرامپت را در تنظیمات حساب خود فعال کرده باشید. برای جزئیات، سیاست حریم خصوصی آشا را ببینید.