Claude Desktop

Claude Code را داخل برنامهٔ Claude Desktop (تب Code) روی OneProvider و بدون حساب Claude اجرا کنید.

برنامهٔ Claude Desktop با تب Code

چه چیزی کار می‌کند

تب Code (Claude Code با رابط تصویری) و Cowork از طریق حالت درگاه داخلی Claude Desktop روی OneProvider اجرا می‌شوند؛ Anthropic این را third-party inference می‌نامد. حساب Claude یا Anthropic لازم نیست. روی macOS 14+ و Windows 10 (2004) یا جدیدتر، از جمله Windows 11، کار می‌کند.

محدودیت کلاینت

حالت درگاه فقط محلی است: نشست‌ها روی رایانهٔ شما اجرا می‌شوند، بدون نشست ابری، SSH یا Remote Control. Desktop درگاه را از فرم زیر می‌گیرد، نه از ANTHROPIC_BASE_URL یا ~/.claude/settings.json (آن‌ها برای خط فرمان Claude Code هستند). بدون این فرم، Desktop فقط با اشتراک پولی Claude باز می‌شود.

راه‌اندازی

1. نصب Claude Desktop و وارد نشدن

   برنامه را از claude.com/download دانلود کنید (macOS: فایل .dmg، Claude را به Applications بکشید؛ Windows: نصب‌کنندهٔ .msix) و اجرا کنید. در صفحهٔ ورود بمانید: وارد نشوید و حساب Anthropic نسازید.

2. روشن کردن Developer Mode

   macOS: در نوار منو Help → Troubleshooting → Enable Developer Mode (راهنما ← عیب‌یابی ← فعال‌سازی حالت توسعه‌دهنده) را انتخاب کنید. Windows: در گوشهٔ بالا سمت چپ صفحهٔ ورود روی منوی برنامه ☰ بزنید، سپس Help → Troubleshooting → Enable Developer Mode. برنامه دوباره راه‌اندازی می‌شود و منوی Developer ظاهر می‌شود؛ بعد از راه‌اندازی‌های مجدد هم فعال می‌ماند.

3. باز کردن Configure Third-Party Inference

   Developer → Configure Third-Party Inference… (پیکربندی استنتاج شخص ثالث) را انتخاب کنید. در بخش Connection مقدار Inference provider را روی Gateway بگذارید و کارت Gateway credentials را مطابق نمونه پر کنید. base URL دقیقاً همین است، بدون /v1 و بدون مسیر پایانی؛ کلید OneProvider خود را در Gateway API key جایگذاری کنید.

   Inference provider: Gateway
   Gateway base URL: https://api.oneprovider.dev
   Gateway API key: sk-your-key-here
   Credential kind: Static API key
   Gateway auth scheme: Bearer (x-api-key also works)

4. بررسی فهرست مدل‌ها

   اول Models را خالی بگذارید: Desktop از https://api.oneprovider.dev/v1/models می‌پرسد و مدل‌های Claude کاتالوگ را نشان می‌دهد. اگر انتخاب‌گر خالی ماند، بخش Models را باز کنید و شناسهٔ دقیق مدل Claude (<your-compatible-model-id>) را از کاتالوگ مدل‌ها اضافه کنید؛ ورودی اول پیش‌فرض نشست‌های جدید Code است.

5. اعمال، راه‌اندازی مجدد و شروع در حالت درگاه

   روی Apply Changes و سپس Save & Restart بزنید. بعد از اجرای دوباره، صفحهٔ ورود پیشنهاد می‌دهد با پیکربندی ارائه‌دهندهٔ استنتاج شما شروع شود: همان گزینه را انتخاب کنید، نه ورود Anthropic را. تب Code را باز کنید، یک پوشهٔ پروژهٔ محلی انتخاب کنید و پیام بفرستید.

بررسی اتصال

تأیید درخواست در حساب کاربری

در یک نشست جدید Code پیام کوتاهی بفرستید. ظرف یک دقیقه درخواست باید در حساب کاربری زیر «مصرف» با مدل، توکن‌ها و مبلغ کسرشده دیده شود. اگر ناموفق بود:

⁧صفحهٔ ورود معمولی بدون گزینهٔ ارائه‌دهنده⁩ → ⁧فرم اعمال نشده است: برنامه را کامل ببندید (Cmd+Q در macOS، Task Manager در Windows) و دوباره باز کنید⁩
"Gateway was unreachable" → ⁧base URL را بررسی کنید (دقیقاً https://api.oneprovider.dev) و VPN یا پروکسی را خاموش کنید⁩
401 → ⁧کلید اشتباه، باطل‌شده یا منقضی‌شده است: آن را در حساب کاربری زیر «کلیدها» بررسی کنید⁩
429 insufficient balance → ⁧موجودی حساب کاربری را شارژ کنید، سپس دوباره بفرستید⁩
⁧انتخاب‌گر مدل خالی⁩ → ⁧شناسهٔ مدل را در بخش Models اضافه کنید⁩
"Error 403: Forbidden" → ⁧در مسیر ورود Anthropic هستید: به‌جای آن گزینهٔ ارائه‌دهنده را انتخاب کنید⁩
⁧آنچه Desktop اعمال کرده:⁩ Help → Troubleshooting → Generate Diagnostic Report → Export to file (managed-config.txt, provider-status.txt)
لاگ: ~/Library/Logs/Claude-3p/main.log (macOS) یا %LOCALAPPDATA%\Claude-3p\Logs\main.log (Windows)

مشخصات اتصال

پروتکل

anthropic

Endpoint

https://api.oneprovider.dev

امنیت کلید

کلید فقط در پیکربندی Desktop روی همین رایانه ذخیره می‌شود. از کلید اختصاصی با سقف مصرف استفاده کنید؛ اگر رایانه مشترک است یا کلید فاش شد، آن کلید را در حساب کاربری حذف یا متوقف کنید تا بقیهٔ موجودی شما در امان بماند.

پاسخ‌های سریع

از کدام base URL استفاده کنم؟

Claude Code و SDKهای Anthropic از https://api.oneprovider.dev استفاده می‌کنند. SDKهای OpenAI و کلاینت‌های سازگار با OpenAI از https://api.oneprovider.dev/v1 استفاده می‌کنند. یک کلید پشت هر دو آدرس کار می‌کند؛ فهرست مدل‌ها در صفحهٔ مدل‌ها و نرخ‌ها در صفحهٔ قیمت‌ها است.

چگونه احراز هویت کنم؟

کلید خام sk-… را در x-api-key یا Authorization: Bearer بفرستید: یکی از این دو، نه هر دو. کلید را در یک متغیر محیطی نگه دارید، نه در فایلی که commit می‌شود. اطلاعات بیشتر دربارهٔ احراز هویت .

کلید را از کجا بگیرم؟

حساب کاربری خود را در ربات Telegram به نام @oneprovider_robot یا در app.oneprovider.dev باز کنید، موجودی را شارژ کنید و «صدور کلید» را بزنید. هر کلید می‌تواند سقف مصرف مخصوص خودش را داشته باشد. حساب کاربری و کلیدهای API .

کدهای 401، 404 و 429 یعنی چه؟

401: کلید ارسال نشده، اشتباه تایپ شده یا در هدر نادرست فرستاده شده است؛ کلید را کامل و بدون گیومه و فاصله جای‌گذاری کنید. 404: معمولاً base URL نادرست است، مثلاً /v1 جا افتاده یا دوبار آمده است. 429 با پیام «Insufficient balance»: موجودی حساب کاربری یا سقف مصرف کلید تمام شده است؛ به‌جای تلاش دوباره، شارژ کنید. هر 429 دیگری محدودیت نرخ است؛ تا پایان زمان Retry-After صبر کنید. جزئیات: کدهای خطا و رفع اشکال .

چرا استریم‌ها قطع یا ریست می‌شوند؟

VPN و پروکسی‌های VLESS اغلب SSE را بافر می‌کنند یا مذاکرهٔ HTTP/2 را مختل می‌کنند. OneProvider هیچ محدودیت منطقه‌ای ندارد و استریم‌ها را بافر نمی‌کند؛ پروکسی را خاموش کنید و دوباره امتحان کنید.

اگر این‌ها کافی نبود از کجا بپرسم؟

در Telegram به @Oneproviderhelpbot پیام بدهید یا در حساب کاربری وب «پشتیبانی» را باز کنید و کد وضعیت HTTP و متن دقیق خطا را بفرستید. پشتیبانی چگونه کار می‌کند .