# QCode برای کاربران خارج از سرزمین اصلی چین

همه‌چیز در QCode.cc برای شما یکسان کار می‌کند، اما **سه** مورد متفاوت تصمیم‌گیری می‌شود: اینکه حساب را با کدام ارز شارژ می‌کنید، ابزارتان را به کدام دامنه دسترسی متصل می‌کنید، و مستندات را به کدام زبان می‌خوانید. این صفحه هر سه را بررسی می‌کند و به صفحات جزئیات پیوند می‌دهد.

## 1. ساخت حساب کاربری

از **Sign Up** در گوشه بالا-راست [qcode.cc](https://qcode.cc) استفاده کنید و با نشانی ایمیل خود ثبت‌نام کنید. به کنسول وارد می‌شوید که زیرعنوان آن «Manage your API keys, top-up and usage» است — به [راهنمای داشبورد](/docs/reference/dashboard-guide) مراجعه کنید.

## 2. شارژ حساب با USD

صفحه شارژ حساب برای هر موجودی یک تب ارزی دارد: «موجودی‌های CNY و USD جدا هستند. مبلغ شارژ به موجودی ارز متناظر افزوده می‌شود.» خارج از سرزمین اصلی چین معمولاً از تب **USD** استفاده می‌کنید که صفحه در حال حاضر این گزینه‌ها را ارائه می‌دهد:

- **کارت اعتباری / کارت نقدی** — «بدون کارمزد»، در پنجره جدید باز می‌شود.
- **Apple Pay / Google Pay** — گزینه کیف پول در همان صفحه پرداخت بین‌المللی.
- **ارز دیجیتال** — «0% کارمزد پلتفرم · ~1d تسویه دستی»: انتقال درون‌زنجیره‌ای که به‌صورت دستی تأیید می‌شود، پس برای کمی انتظار برنامه‌ریزی کنید.

محدودیت‌های درج‌شده در تب USD: «حداقل $5» / «حداکثر $2,000». روش‌های پرداخت روسی (SBP، کارت بانکی روسی) فقط در رابط روسی نمایش داده می‌شوند و موجودی **USD** را افزایش می‌دهند در حالی که شما به روبل پرداخت می‌کنید. مقایسه کامل، شامل Alipay و WeChat Pay برای CNY، در [مرور روش‌های پرداخت](/docs/reference/payment-methods) آمده است؛ جزئیات ارز دیجیتال در [راهنمای پرداخت با ارز دیجیتال](/docs/reference/crypto-payment) است.

## 3. انتخاب پلن و کپی کلید

پلن‌ها از کنسول و با موجودی شما خریداری می‌شوند — **Buy a Plan** صفحه اشتراک را با تب‌های **Recommended Plans** و **Custom Configuration** باز می‌کند. در صورت موفقیت، صفحه نمایش می‌دهد: «Subscription Activated — Your API Key is created and ready to use». کلیدها با `cr_` شروع می‌شوند (به [پرسش‌های متداول](/docs/reference/faq) مراجعه کنید) و یک کلید برای هر سه پروتکل کار می‌کند.

برای استفاده فردی دو گزینه وجود دارد: پلن شخصی و بسته‌های پرداخت به‌ازای مصرف؛ به [نحوه انتخاب پلن](/docs/getting-started/choose-a-plan) مراجعه کنید. هر کدام را که بخرید، کلید به همان شیوه استفاده می‌شود.
## 4. دامنه دسترسی مناسب را انتخاب کنید

هر سه دامنه یک حساب کاربری و یک کلید یکسان دارند؛ تنها تفاوتشان در مسیریابی است
([نقاط پایانی و مسیرهای API](/docs/getting-started/endpoints-and-api-paths) مرجع این موضوع است):

| دامنه | کاربران هدف | زمان استفاده |
|---|---|---|
| `api.qcode.cc` | جهانی (مبتنی بر تأخیر Route 53) | پیش‌فرض بیرون از سرزمین اصلی چین — نزدیک‌ترین گره را انتخاب می‌کند |
| `us.qcode.cc` | آمریکای شمالی / اروپا (پشتیبان) | اگر نشانی جهانی برای شما درست کار نکرد |
| `asia.qcode.cc` | آسیا (پشتیبان) | اگر در آسیا هستید و نشانی جهانی درست کار نمی‌کند |

در کنسول، بلوک **نشانی دسترسی API**، `https://api.qcode.cc` را در هر رابط غیرچینی به‌عنوان
توصیه‌شده برجسته می‌کند و دو مورد دیگر را به‌صورت ردیف‌های **پشتیبان** فهرست می‌کند. آن را
به‌ازای هر ابزار وارد کنید، با پایان یافتن در پیشوند پروتکل و **بدون اسلش انتهایی**:

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"
claude
```

`/api` شاخه Anthropic است (Claude Code)، `/openai` شاخه Codex و `/gemini` شاخه Google
— جدول کامل هر ابزار در
[متغیرهای محیطی](/docs/getting-started/environment) آمده است.

## 5. نصب ابزارها

بلوک **راه‌اندازی یک‌کلیکی (توصیه‌شده)** در کنسول، زبان رابط را برای شما ثبت می‌کند: در یک
رابط غیرچینی، فرمانی که نشان می‌دهد شامل `--lang en` است، در حالی که رابط چینی فرمان را
بدون هیچ پرچم زبانی چاپ می‌کند. شکل ساده آن چنین است:

```bash
curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --lang en
curl -fsSL https://qcode.cc/install/codex.sh | bash -s -- --lang en
```

اسکریپت با یک آزمون تأخیر سریع‌ترین نقطه پایانی را انتخاب می‌کند، کلید `cr_` شما را می‌پرسد
(ورودی نمایش داده نمی‌شود)، در صورت نیاز Node.js و CLI را نصب می‌کند و یک درخواست آزمایشی
می‌فرستد. در Windows از شکل `irm … | iex` استفاده می‌شود. جزئیات و بازگردانی: [اسکریپت راه‌اندازی یک‌کلیکی](/docs/getting-started/one-click-install)،
سپس [شروع سریع](/docs/getting-started/quick-start) یا
[شروع سریع Codex](/docs/getting-started/codex-quick-start).

برای اجرای ابزارها روی ماشینی که همیشه روشن می‌ماند، [سرورهای ابری: انتخاب، خرید و استفاده](/docs/getting-started/cloud-servers) را ببینید.

## 6. مستندات را به زبان خودتان بخوانید

سایت مستندات یک منوی زبان در سربرگ خود دارد — دکمه **🌐** کنار جعبه جستجو، زبان‌هایی را که
مستندات در آن‌ها منتشر شده‌اند فهرست می‌کند. با انتخاب یک زبان، انتخاب شما ذخیره می‌شود (یک
کوکی که با خود qcode.cc مشترک است) و صفحه زیر نشانی آن زبان دوباره بارگذاری می‌شود. هر صفحه
همچنین به‌صورت مستقیم برای هر زبان قابل آدرس‌دهی است، که لینک‌ها را قابل اشتراک می‌کند:

```text
https://docs.qcode.cc/docs/<category>/<slug>            no prefix: your browser language decides, Chinese is the fallback
https://docs.qcode.cc/en/docs/<category>/<slug>         English
https://docs.qcode.cc/<lang>/docs/<category>/<slug>     any other published language
```

اگر صفحه‌ای که نیاز دارید هنوز به زبان شما موجود نیست، نسخه انگلیسی را بخوانید و همان دنباله
URL را نگه دارید. برای اینکه **ابزارها** به جای انگلیسی به زبان شما پاسخ دهند،
[تنظیمات زبان](/docs/usage/language-settings) را ببینید.
## 7. پشتیبانی در مناطق زمانی مختلف

پشتیبانی در ساعات کاری UTC+8 به‌صورت آنلاین در دسترس است — *«روزهای هفته 10:00 - 21:00 (UTC+8) پاسخ آنلاین»*، و پیام‌های خارج از ساعات کاری *«به‌صورت متناوب بررسی می‌شوند؛ ممکن است پاسخ‌ها با تأخیر باشد»*. دکمه **تماس با ما** در گوشه پایین‌راست کنسول، تلگرام و ایمیل را در دسترس قرار می‌دهد؛ ایمیل [hi@qcode.cc](mailto:hi@qcode.cc) در هر ساعتی کار می‌کند و کانال ارتقاها و پرداخت‌های متوقف‌شده است. اندازه‌گیری‌های زنده نقاط پایانی به‌صورت عمومی در [probe.qcode.cc](https://probe.qcode.cc) در دسترس است.

## نکات مهم

- **اشتراک Claude / ChatGPT شما استفاده نمی‌شود و مصرف نمی‌شود.** QCode روی پلن‌های خودش اجرا می‌شود — [اشتراک‌ها در برابر کلیدهای API در برابر کلیدهای QCode](/docs/reference/subscription-vs-api-key) را ببینید.
- **بازپرداخت:** سهمیه فروخته‌شده غیرقابل بازپرداخت است، به‌جز استثناهای محدود فهرست‌شده در [پرسش‌های متداول](/docs/reference/faq)؛ ارزش استفاده‌نشده از یک ارتقا به موجودی شما برگشت داده می‌شود. سهمیه باقی‌مانده یک بسته پرداخت به‌ازای مصرف پس از انقضا باطل می‌شود و بازپرداخت نمی‌شود.
- **خرید سازمانی:** شرکتی خارج از چین که به قرارداد و انتقال بانکی سازمانی نیاز دارد، از [راهنمای پلن تیمی](/docs/reference/enterprise-guide) استفاده می‌کند.
- **قیمت‌ها** به‌ازای هر توکن هستند و با [qcode.cc/models](https://qcode.cc/models) همگام‌سازی می‌شوند: [شرح صورت‌حساب](/docs/reference/billing).

## صفحات مرتبط

- [راهنمای داشبورد](/docs/reference/dashboard-guide)
- [سرورهای ابری: انتخاب، خرید و استفاده](/docs/getting-started/cloud-servers) — انتخاب یک خط و سفارش سرور برای عامل‌هایی با اجرای طولانی‌مدت
- [مرور روش‌های پرداخت](/docs/reference/payment-methods)
- [راهنمای پرداخت با رمزارز](/docs/reference/crypto-payment)
- [نقاط پایانی و مسیرهای API](/docs/getting-started/endpoints-and-api-paths)
- [متغیرهای محیطی](/docs/getting-started/environment)
- [اسکریپت راه‌اندازی یک‌کلیکی](/docs/getting-started/one-click-install)
- [معرفی Claude Code](/docs/getting-started/introduction)
- [تنظیمات زبان](/docs/usage/language-settings)
- [راهنمای عیب‌یابی](/docs/reference/troubleshooting)