# QCode للمستخدمين خارج البر الرئيسي للصين

كل ما في QCode.cc يعمل بالطريقة نفسها بالنسبة إليك، مع **ثلاثة** أمور تُحدَّد بشكل مختلف: العملة التي تشحن الرصيد بها، ونطاق الوصول الذي توجّه أداتك إليه، ولغة الوثائق التي تقرأ بها. تستعرض هذه الصفحة الأمور الثلاثة وتُحيل إلى الصفحات التفصيلية.

## 1. إنشاء حساب

استخدم **Sign Up** في الزاوية العلوية اليمنى من [qcode.cc](https://qcode.cc) وسجّل باستخدام عنوان بريدك الإلكتروني. ستنتقل إلى لوحة التحكم التي عنوانها الفرعي *«إدارة مفاتيح API وشحن الرصيد والاستخدام»* — راجع [دليل لوحة التحكم](/docs/reference/dashboard-guide).

## 2. شحن الرصيد بالدولار الأمريكي

تحتوي صفحة شحن الرصيد على تبويب عملة لكل رصيد: *«أرصدة 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**. وعند النجاح تقول الصفحة *«تم تفعيل الاشتراك — تم إنشاء مفتاح API الخاص بك وهو جاهز للاستخدام»*. تبدأ المفاتيح بـ `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)، استجابة عبر الإنترنت»*، وتُفحص الرسائل خارج ساعات العمل *«على فترات متقطعة، وقد تتأخر الردود»*. ويتيح زر **تواصل معنا** في الزاوية السفلية اليمنى من لوحة التحكم الوصول إلى Telegram والبريد الإلكتروني؛ ويعمل البريد [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).
- **الأسعار** لكل token، ومتزامنة مع [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)