> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teamsoclo.site/llms.txt
> Use this file to discover all available pages before exploring further.

# البدء

> شراء الكود، استبداله بمفتاح، تثبيت Node.js، اختيار أداة

<Steps>
  <Step title="اشترِ كود CDK">
    تبدو الأكواد بالشكل `TSL-XXXX-XXXX-XXXX` وتُباع حسب الباقة:

    | الباقة | النموذج | يُباع بـ |
    | - | - | - |
    | **GPT** | `gpt-5.6-sol` | رصيد (10M, 20M, 50M, 100M, 200M, 500M, 1B) |
    | **GPT Astra** | `gpt-astra` | رموز (5M, 10M, 20M, 50M, 100M, 200M, 500M, 1B) |
    | **Claude** | `claude-opus-5`, `claude-fable-5-1`, `claude-sonnet-5`, `claude-haiku-4-5`… | رصيد (10M, 20M, 50M, 100M, 200M, 300M, 500M, 1B) |

    لكل باقة **فترة صلاحية تبدأ من لحظة الاستبدال** (مطبوعة على المنتج، مثلاً يوم واحد، يومان، 5 أيام). عند انتهاء الصلاحية أو استنفاد الحصة يتوقف المفتاح؛ الرصيد غير المستخدم لا ينتقل إلى مفتاح جديد.

    الإعلانات والدعم: [t.me/teamsoclo](https://t.me/teamsoclo).
  </Step>

  <Step title="استبدل الكود للحصول على مفتاح API">
    افتح **[redeem.teamsoclo.site](https://redeem.teamsoclo.site)**، الصق الكود، واستبدله. ستحصل على مفتاح `sk-...` وتعليمات خاصة بباقتك.

    <Warning>
      انسخ المفتاح بزر **Copy** وليس بتحديد النص. المفاتيح طويلة ومن السهل فقدان حرف من أي طرف؛ هذا يظهر لاحقاً كـ `401 Unauthorized` لا كـ "نسخت بشكل خاطئ".
    </Warning>

    فقدتَ المفتاح؟ استبدل الكود ذاته مجدداً وستعرض الصفحة المفتاح نفسه. الرصيد المتبقي وتاريخ الانتهاء: [gpt.teamsoclo.site/check](https://gpt.teamsoclo.site/check).
  </Step>

  <Step title="ثبِّت Node.js (لـ Codex CLI فقط)">
    يُثبَّت Codex CLI عبر `npm`، لذا تحتاج **Node.js 18 أو أحدث**. تحقق:

    ```bash theme={null}
    node --version
    ```

    إن لم يكن مثبتاً، ثبِّته لنظامك:

    <Tabs>
      <Tab title="macOS">
        ```bash theme={null}
        brew install node
        ```

        أو حمِّل المثبِّت من [nodejs.org](https://nodejs.org).
      </Tab>

      <Tab title="Linux">
        ```bash theme={null}
        curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
        nvm install --lts
        ```

        يتجنب nvm أخطاء صلاحيات `EACCES` مع الحزم العامة.
      </Tab>

      <Tab title="Windows">
        ```powershell theme={null}
        winget install OpenJS.NodeJS.LTS
        ```

        أو حمِّل المثبِّت من [nodejs.org](https://nodejs.org).
      </Tab>
    </Tabs>

    Cursor وCline وChatbox لا يحتاجان Node.js.
  </Step>

  <Step title="اختر أداة وأعِدَّها">
    <CardGroup cols={2}>
      <Card title="Codex" icon="terminal" href="/ar/setup/codex">
        CLI + إضافة VS Code + تطبيق، أمر واحد للثلاثة
      </Card>

      <Card title="Claude Code" icon="sparkles" href="/ar/setup/claude-code">
        CLI + إضافة، أمر واحد، يتطلب مفتاح باقة Claude
      </Card>

      <Card title="Cursor" icon="mouse-pointer-2" href="/ar/setup/cursor">
        تجاوز Base URL في Settings → Models
      </Card>

      <Card title="Cline / Roo Code" icon="bot" href="/ar/setup/cline">
        مزود OpenAI Compatible
      </Card>

      <Card title="Chatbox" icon="message-square" href="/ar/setup/chatbox">
        ويب وسطح المكتب
      </Card>
    </CardGroup>
  </Step>
</Steps>

## كيف تُحسب الحصة

تُحسب المفاتيح على **الرموز المستخدمة فعلياً** (الإدخال + الإخراج)، تماماً كما يعيده `usage` في كل طلب. لا رسوم خفية، لا رموز مُضافة.

* باقة **GPT**: 10M رصيد = 10M رمز `gpt-5.6-sol`.
* باقة **GPT Astra**: 10M = 10M رمز `gpt-astra`. مفتاح Astra يستدعي `gpt-astra` فقط؛ مفتاح GPT يستدعي `gpt-5.6-sol` فقط.
* باقة **Claude**: يُحسب الرصيد لكل نموذج، Opus 5 تقريباً 1 رصيد/رمز، Fable تقريباً 2، Sonnet/Haiku أرخص. مفتاح Claude يستدعي نماذج `claude-*` فقط.

<Tip>
  أفضل طريقة للتوفير: **ابدأ محادثة جديدة عند تغيير الموضوع**. كل رسالة تُعيد إرسال التاريخ كاملاً؛ الرسالة 51 في محادثة طويلة تكلّف أضعاف الرسالة الأولى. في Cursor وCline، وجِّه الوكيل إلى الملفات المحددة بدلاً من مسح المستودع.
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.