# Qwen Code وQwen 3.7-max: إعداد Token Plan

> تثبيت Qwen Code على Node.js 22، وربط Token Plan الدولي، والتعرّف على ثلاثة أخطاء تؤدي إلى ظهور أخطاء 401: عنوان API والمفتاح وتعيين المقعد.

Source: https://ailoot.ai/blog/ar/qwen-code-token-plan-setup/
Canonical: https://ailoot.ai/blog/ar/qwen-code-token-plan-setup/
Language: ar
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-207
Revision: sha256-6669658ed3be8e82dd123617b5cc84cab65debeec2fbc07a3e5f6e6fc66a426b


الوثائق المرجعية لـ Ailoot: [ailoot.ai/docs/](https://ailoot.ai/docs/).



**تحديث 03.10.2026:** طرأت ثلاثة تغييرات منذ النشر. أوقفت Alibaba المشتريات الجديدة من Coding Plan: عاد مستوى Lite في مارس، ونفد Pro. انتقل Token Plan من حصة أسبوعية إلى حصة شهرية. وصدر نموذج أحدث، وهو Qwen3.8-max. كما صححت خطأً في وصف مفتاح Token Plan؛ فلهذا الأمر أهمية تحديدًا عند ظهور الخطأ 401، وسأشرحه أدناه.

## ما Qwen Code، ولماذا ليس مجرد نسخة مقلدة أخرى؟

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

أهم النقاط

Qwen Code هو وكيل ذكاء اصطناعي مفتوح المصدر يعمل في الطرفية من Alibaba، ويعمل مثل Claude Code: يُشغَّل في طرفية VS Code، ويقرأ مشروعك، ويكتب التعليمات البرمجية، وينفّذ الأوامر. والفرق الأساسي هو إتاحة الوصول إلى نحو اثني عشر نموذجًا باشتراك واحد، بما في ذلك Qwen 3.7 وDeepSeek V4 وKimi K2.

</div>

عندما سمعت عن Qwen Code للمرة الأولى، ظننت أنه «نسخة أخرى من Claude Code ستتعطل عند الطلب الثاني». كنت مخطئًا. لم تنسخ Alibaba الواجهة، بل أنشأت وكيل CLI خاصًا بها من الصفر، مع توافق كامل مع OpenAI API. وهذا يعني أنه يمكنك تشغيل نماذج Qwen، وكذلك DeepSeek وGLM وKimi، وحتى Claude عبر Anthropic API.

إليك ما يمكنه فعله فعليًا:

- يقرأ بنية المشروع ويفهم سياقه (مثل Claude Code مع `CLAUDE.md`)
- يشغّل أوامر shell، ويحرّر الملفات، وينشئ عمليات commit
- يدعم Skills وSubAgents
- يعمل في VS Code عبر الطرفية المدمجة أو إحدى الإضافات
- يبدّل بين النماذج بأمر `/model` واحد

هناك جانب سلبي واحد، لكنه مهم جدًا: **أُغلق المستوى المجاني في 15 أبريل 2026**. سابقًا، كان Qwen OAuth يتيح 100 طلب مجاني يوميًا، أما الآن فلم تعد متاحة سوى الخيارات المدفوعة. ومع ذلك، تظل تكلفة Qwen Code المدفوع أقل بكثير من اشتراك Claude Pro. إذا كنت تختار بين الأدوات الآن، فقد تناولت جميع الخيارات في دليل [«بماذا نبرمج في 2026: 8 أدوات ذكاء اصطناعي»](https://ailoot.ai/blog/ar/ai-coding-tools/).

## كم تبلغ التكلفة، وأي خطة ينبغي أن تختار؟

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

أهم النقاط

تقدم Alibaba ثلاثة خيارات للدفع: الدفع لكل رمز، واشتراك Coding Plan، واشتراك Token Plan. وللبرمجة اليومية بأسلوب vibe coding، يقدم Token Plan أفضل قيمة: مبلغ شهري ثابت، وأكثر من 10 نماذج، ولا حاجة إلى حساب الرموز.

</div>

الالتباس بشأن الخطط هو أكبر مشكلة عند إعداد Qwen Code. تستخدم Alibaba أسماء مختلفة في أجزاء مختلفة من وحدة التحكم، وحتى إضافة VS Code تعرض الخيارات الخاطئة. إليك طريقة عملها فعليًا (تم التحقق منها بالرجوع إلى وثائق Alibaba Cloud، التي حُدّثت في 28.09.2026).

| الخطة | ماهيتها | لمن تناسب | التكلفة التقريبية |
|----|----|----|----|
| **الدفع حسب الاستخدام** | تدفع مقابل كل مليون رمز على حدة | الاستخدام العرضي أو التجربة | \$0.30-1.20 لكل 1M رمز |
| **Coding Plan** | اشتراك للأفراد بحصة شهرية (أُوقفت الحصة الأسبوعية في 22.09.2026) | غير متاحة حاليًا للمشتركين الجدد: أُغلقت مشتريات مستوى Lite في 20.03.2026 ونفد Pro | غير متاحة حاليًا للحسابات الجديدة |
| **Token Plan Team Edition, Standard Seat** | 25,000 Credits لكل مقعد شهريًا، وأكثر من 10 نماذج | البرمجة اليومية بأسلوب vibe coding مع التبديل بين النماذج | \$20 لكل مقعد شهريًا ضمن العرض (السعر العادي: \$30) |

وفقًا للتجربة التي وصفها الكاتب، وقع الاختيار على **Token Plan** لأن اشتراكًا واحدًا يمنحك الوصول إلى Qwen 3.7-max (والأحدث منه Qwen3.8-max)، وDeepSeek V4 Pro، وGLM-5. وتستهلك جميع النماذج من مجموعة Credits نفسها. بدّل بينها باستخدام أمر `/model`، فلا تحتاج إلى شراء مفتاح منفصل لكل مزود.

**مهم:** إن Coding Plan وToken Plan **منتجان مختلفان** ولهما عنوانا API مختلفان. يبدأ مفتاح Coding Plan بالبادئة `sk-sp-`. أما مفتاح Token Plan فلا يحتوي على أي بادئة، وفقًا لوصف وثائق Qwen Code الرسمية. إذا خلطت بين العنوان أو المفتاح الخاص بأحد المنتجين والآخر، فستتلقى خطأ 401. وبما أن الشراء الجديد من Coding Plan متوقف، فإن Token Plan هو حاليًا الخيار العملي الوحيد لمعظم القراء.

## كيف تثبّت Qwen Code؟

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

أهم النقاط

لديك خياران: عبر npm (`npm install -g @qwen-code/qwen-code@latest`) أو Homebrew (`brew install qwen-code`). تحتاج إلى Node.js 22 أو أحدث. بعد التثبيت، شغّل `qwen` في الطرفية.

</div>

تحقق من إصدار Node.js قبل التثبيت:

```bash
node --version
```

تحتاج إلى الإصدار **22 أو أحدث**. إذا كان إصدارك أقدم، فحدّثه من [nodejs.org](https://nodejs.org/en/download) أو باستخدام `nvm`:

```bash
nvm install 22
nvm use 22
```

بعد ذلك، ثبّت Qwen Code بأمر واحد:

```bash
npm install -g @qwen-code/qwen-code@latest
```

أو استخدم Homebrew على macOS:

```bash
brew install qwen-code
```

تحقق من التثبيت:

```bash
qwen --version
```

إذا ظهر رقم الإصدار، فأنت جاهز. شغّل Qwen Code بالأمر `qwen` في الطرفية. وفي VS Code، افتح الطرفية المدمجة (<bdi>Ctrl+</bdi>`) واكتب `qwen\`.

توجد أيضًا **إضافة لـ VS Code** باسم `Qwen Code Companion` من QwenLM في السوق. تضيف شريطًا جانبيًا للدردشة، مثل GitHub Copilot. أستخدم هذه الإضافة؛ فهي أسهل من الطرفية وحدها.

## كيف تنشئ حسابًا وتشتري Token Plan؟

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

أهم النقاط

سجّل في وحدة تحكم Alibaba Cloud الدولية (modelstudio.console.alibabacloud.com)، وأضف بطاقة يقبلها المزود، ثم اشترك في Token Plan. تستغرق العملية كلها 10 دقائق.

</div>

خطوة بخطوة:

1. انتقل إلى [modelstudio.console.alibabacloud.com](https://modelstudio.console.alibabacloud.com/)
2. انقر على **Free Sign Up** في أعلى اليمين
3. أدخل بريدك الإلكتروني (يعمل Gmail) وأكّد الرمز الذي وصلك في صندوق الوارد
4. أضف رقم هاتفك
5. أضف بطاقة يقبلها المزود. ستخصم Alibaba مبلغ \$1 للتحقق منها، ثم ترده خلال 1–3 أيام.
6. ابحث عن قسم **ModelStudio** في وحدة التحكم، ثم علامة تبويب **Token Plan**
7. اختر مستوى **Standard** (الحد الأدنى للبدء)
8. أكّد الدفع

بعد الشراء، ستنتقل إلى صفحة **My Subscriptions**. وهناك سترى ما يلي:

- **Standard Seat: 0/1** — يعني ذلك أنك اشتريت مقعدًا، لكنك لم تعيّنه لحسابك بعد
- انقر على **Assign**، واختر حسابك، ثم أكّد
- ينبغي أن تتغير القيمة إلى **1/1**

لن يعمل مفتاح API ما لم تنفّذ هذه الخطوة. ووفقًا للتجربة التي وصفها الكاتب، استغرقت هذه الخطوة 20 دقيقة.



## أين تجد مفتاح API والعنوان الصحيح؟

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

أهم النقاط

يوجد مفتاح API وعنوان API (Base URL) في صفحة Management Platform. عنوان Token Plan الدولي هو `https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`. لا تخلط بينه وبين عنوان DashScope العادي؛ فلن يعمل مفتاح Token Plan عليه.

</div>

في صفحة **My Subscriptions**، انقر على الزر البنفسجي الكبير **Go to Management Platform**. ستُفتح لوحة منفصلة.

اختر **Overview** من القائمة الجانبية اليسرى. سترى في هذه الصفحة قسمين:

**Plan-specific API Key** — مفتاحك الشخصي، وهو مخفي خلف علامات النجمة. انقر على **أيقونة النسخ** المجاورة له (لا تحدده بالماوس؛ ستُنسخ علامات النجمة). لا تحتوي مفاتيح Token Plan على بادئة. هذا ليس خطأً مطبعيًا في التعليمات؛ فوثائق Qwen Code الرسمية تصفها بهذه الطريقة. إذا رأيت `sk-sp-`، فهذا مفتاح **Coding Plan** من منتج مختلف، وقد نسخت المفتاح الخطأ.

**Plan-specific Base URL** — خياران:

- للأدوات المتوافقة مع OpenAI (Qwen Code): `https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`
- للأدوات المتوافقة مع Anthropic: `https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic`

تذكّر: **لا تعمل مع مفتاح Token Plan إلا هذه العناوين**. العنوان القياسي `dashscope-intl.aliyuncs.com` مخصص للمفاتيح العادية (الدفع حسب الاستخدام)، بينما `coding-intl.dashscope.aliyuncs.com` هو عنوان Coding Plan. وسيؤدي استخدام مفتاح Token Plan مع أي منهما إلى خطأ 401.

## كيف تربطه بـ VS Code؟

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

أهم النقاط

اضبط إضافة VS Code عبر الملف `~/.qwen/settings.json`. تحتاج إلى إدخال المفتاح وعنوان API الصحيح والنموذج. إليك إعدادًا جاهزًا للاستخدام؛ انسخه واستبدل المفتاح بمفتاحك.

</div>

إذا ثبّت **إضافة Qwen Code Companion** من سوق VS Code:

1. افتح لوحة الأوامر (Cmd+Shift+P)
2. اكتب **Qwen Code: Choose Provider**
3. إذا ظهرت قائمة بالخيارات، **فلا تختر Coding Plan** (فهو منتج مختلف). اختر **Standard API Key**
4. ألصق المفتاح من Management Platform؛ فمفاتيح Token Plan ليس لها بادئة ثابتة
5. المنطقة: **Singapore**
6. النموذج: `qwen3.7-max`

إذا ظهر خطأ بعد ذلك، **فاضبطه يدويًا عبر الملف**. تملأ الإضافة العنوان الخطأ أحيانًا.

افتح الملف `~/.qwen/settings.json` أو أنشئه، ثم ألصق ما يلي:

```json
{
  "env": {
    "TOKEN_PLAN_API_KEY": "YOUR-KEY-FROM-MANAGEMENT-PLATFORM"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.7-max",
        "name": "qwen3.7-max",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": { "enable_thinking": true },
          "contextWindowSize": 262144
        }
      },
      {
        "id": "qwen3.6-plus",
        "name": "qwen3.6-plus",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": { "enable_thinking": true },
          "contextWindowSize": 1000000
        }
      },
      {
        "id": "deepseek-v4-pro",
        "name": "deepseek-v4-pro",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": { "enable_thinking": true },
          "contextWindowSize": 1000000
        }
      }
    ]
  },
  "security": {
    "auth": { "selectedType": "openai" }
  },
  "model": { "name": "qwen3.7-max" }
}
```

استبدل `YOUR-KEY-FROM-MANAGEMENT-PLATFORM` بمفتاحك من Management Platform. أعد تشغيل VS Code. انتهى.

## لماذا يظهر خطأ 401، وكيف تصلحه؟

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

أهم النقاط

في 90% من الحالات، يعني خطأ 401 عند إعداد Qwen Code أن عنوان API أو المفتاح غير صحيح. يستخدم Token Plan وCoding Plan والدفع حسب الاستخدام عناوين مختلفة، ولا يمكن التبادل بين مفاتيحها.

</div>

وصف الكاتب الأخطاء التي واجهها أثناء الإعداد. إليك القائمة الكاملة لأسباب أخطاء 401 وكيفية التحقق منها:

| العَرَض | السبب | الحل |
|----|----|----|
| `invalid_api_key` | أُرسل مفتاح Token Plan إلى عنوان DashScope (أو العكس) | تحقّق من Base URL. لـ Token Plan: `token-plan.ap-southeast-1...`؛ ولـ Coding Plan: `coding-intl.dashscope...` |
| `invalid access token` | لم يُعيّن Standard Seat (0/1) | انتقل إلى My Subscriptions وانقر على Assign؛ ينبغي أن تظهر القيمة 1/1 |
| `invalid_api_key` | أنشأت إضافة VS Code مفتاحها الخاص عبر عملية المصادقة بدلًا من استخدام Token Plan | افتح `~/.qwen/settings.json` وتحقّق من مطابقة المفتاح لما تعرضه Management Platform (ولا تخلطه بمفتاح Coding Plan ذي البادئة `sk-sp-`) |
| `invalid_api_key` | نُسخت مسافة أو فاصل سطر مع المفتاح | احذف المفتاح وانسخه مجددًا باستخدام أيقونة النسخ (لا تحدده بالماوس) |
| `model not found` | النموذج غير مشمول في خطتك | تحقّق من قائمة Available Models في صفحة الاشتراك |
| `Insufficient quota` | نفدت Credits | تحقّق من Usage في My Subscriptions. إذا بلغت النسبة 100%، فانتظر إعادة التعيين أو اشترِ Boost Pack |

**تحقق سريع من المفتاح عبر الطرفية:**

```bash
curl -s -o /dev/null -w "%{http_code}" -X POST \
  "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3.7-max","messages":[{"role":"user","content":"hi"}],"max_tokens":5}'
```

إذا أعاد `200`، فالمفتاح يعمل والمشكلة في إعدادات الإضافة. وإذا أعاد `401`، فالمفتاح أو العنوان غير صحيح.

## ما النماذج المتاحة، وأيها ينبغي أن تختار؟

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

أهم النقاط

يوفر Token Plan أكثر من 10 نماذج من 5 مزودين؛ وأُضيف النموذج الرائد الجديد Qwen3.8-max في أغسطس 2026. النموذج الأساسي للعمل اليومي في vibe coding هو qwen3.6-plus، إذ يوازن بين السعر والجودة. للمهام المعقدة، استخدم qwen3.7-max أو الأحدث qwen3.8-max. وللتعديلات السريعة، استخدم qwen3.6-flash.

</div>

إليك النماذج المفيدة فعلًا في vibe coding:

| النموذج | متى تستخدمه | استهلاك Credits |
|----|----|----|
| **qwen3.8-max** | النموذج الرائد الجديد من Alibaba (صدر في أغسطس 2026)، أعلى جودة للمهام المعقدة | مرتفع — تنفد Credits أسرع من 3.7-max |
| **qwen3.7-max** | هندسة معمارية معقدة، وإعادة هيكلة مشروع كبير، والإنشاء من الصفر | مرتفع — تنفد الحصة خلال أسبوع مع البرمجة اليومية |
| **qwen3.6-plus** | نموذج العمل اليومي الأساسي: التعديلات، والتحسينات، والمراجعات، والشروحات | متوسط — يكفي لشهر عند العمل 2–4 ساعات يوميًا |
| **qwen3.6-flash** | التعديلات السريعة، والأسئلة البسيطة، والتنسيق | منخفض |
| **deepseek-v4-pro** | بديل لـ Qwen: قد يكون أفضل أحيانًا في المهام الخوارزمية والرياضيات | متوسط |
| **kimi-k2.6** | السياق الطويل: قراءة قواعد برمجية كبيرة وتحليل الوثائق | متوسط |

بدّل بين النماذج باستخدام أمر `/model` مباشرة في جلسة Qwen Code؛ فلا حاجة إلى تغيير الإعدادات أو إعادة التشغيل.

**أنصح بالبدء بـ `qwen3.6-plus`.** إذا شعرت بعد أسبوع أن الحصة تنفد بسرعة كبيرة، فانتقل إلى `qwen3.6-flash` للأعمال الاعتيادية، واحتفظ بـ `qwen3.7-max` للمهام المعقدة فقط.

## Qwen Code أم Claude Code: أيهما ينبغي أن تستخدم؟

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

أهم النقاط

ينتج Claude Code تعليمات برمجية أفضل ويفهم السياق على نحو أفضل. أما Qwen Code فيكلف أقل ويمنحك الوصول إلى نماذج متعددة عبر اشتراك واحد. والجمع المثالي هو استخدام Claude Code للعمل الأساسي وQwen Code للمهام المتوازية والتجارب.

</div>

تصف المراجعة شهرًا من عمل الكاتب باستخدام الأداتين. إليك مقارنة تستند إلى تلك التجربة:

| المعيار | Claude Code | Qwen Code |
|----|----|----|
| جودة التعليمات البرمجية | أفضل — أصدرت Anthropic منذ ذلك الحين نماذج أحدث (Opus 5.5، 22.09.2026)، ولم تتقلص الفجوة | جيدة، لكن حتى النموذج الرائد الجديد Qwen3.8-max يتأخر عن أفضل نماذج Anthropic في الاختبارات المستقلة |
| فهم المشروع | `CLAUDE.md` + قراءة متعمقة لشجرة المشروع = يعمل مثل شخص | آليات مشابهة، لكنها أقل صقلًا |
| السعر | Claude Pro بسعر \$20 شهريًا (Max بسعر \$100-200 شهريًا للبرمجة المكثفة) | Token Plan Standard بسعر يبدأ من \$20 شهريًا، ويشمل أكثر من 10 نماذج |
| اختيار النماذج | Claude فقط (Opus/Sonnet/Haiku) | Qwen + DeepSeek + GLM + Kimi + MiniMax |
| مفتوح المصدر | لا (مغلق المصدر) | نعم (ترخيص MIT) |

| إضافة VS Code | أصلية ومستقرة | متاحة، لكنها غير مصقولة — وتواجه أحيانًا مشكلات في المفاتيح |

**متى يكون Qwen Code أفضل قيمة:**

- عندما تحتاج إلى عدة نماذج (DeepSeek للرياضيات وKimi للسياق الطويل)
- عندما تجرّب أساليب مختلفة للمهمة نفسها
- عندما تكون ميزانيتك محدودة، لكنك تبرمج يوميًا
- عندما تريد أداة مفتوحة المصدر يمكنك تخصيصها

**متى يكون Claude Code لا غنى عنه:**

- في مشروع حرج تكون فيه جودة التعليمات البرمجية مساوية للمال
- عند العمل على مشروع قديم كبير (يحافظ Opus على السياق بشكل أفضل) — تناولت على نحو منفصل [كيفية عدم استنفاد حدود Claude Code](https://ailoot.ai/blog/ar/claude-code-token-limits-saving/)
- عندما تحتاج إلى إضافة VS Code مستقرة دون إعداد يدوي

الجمع في التجربة التي وصفها الكاتب: **Claude Code للمشروع الأساسي**، و**Qwen Code للتجارب والمهام المتوازية**، إذ يمكنك تجربة فكرة بسرعة على نموذج أقل تكلفة. وللمقارنة التفصيلية مع أدوات أخرى، راجع [Cursor vs Claude Code](https://ailoot.ai/blog/ar/cursor-vs-claude-code/) و[Codex vs Claude Code](https://ailoot.ai/blog/ar/codex-vs-claude-code-choice/).

## ثلاثة أخطاء يقع فيها الجميع

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

أهم النقاط

Token Plan وCoding Plan منتجان مختلفان ولهما عنوانان مختلفان. تُدخل إضافة VS Code المفتاح الخطأ. ويجب تعيين المقعد يدويًا. تستهلك هذه الأخطاء الثلاثة من 30 دقيقة إلى عدة ساعات — وقد واجهتها كلها وسجلت حلولها.

</div>

### الخطأ 1: Token Plan ≠ Coding Plan

تستخدم Alibaba أسماء مختلفة لهذه المنتجات في أجزاء مختلفة من وحدة التحكم. خيار “Coding Plan” في إضافة VS Code **ليس Token Plan**. تذكّر: اعتبارًا من 20.03.2026، أُغلقت مشتريات Coding Plan Lite الجديدة ونفد Pro؛ وإذا لم تكن مشتركًا به بالفعل، فلن يتاح لك إلا Token Plan. ولكل منهما عنوان API مختلف:

- **Token Plan**: `https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`
- **Coding Plan**: `https://coding-intl.dashscope.aliyuncs.com/v1`

إذا اشتريت Token Plan لكنك أعددت الإضافة على أنها Coding Plan، فستتلقى خطأ 401، والعكس صحيح.

### الخطأ 2: تنشئ إضافة VS Code مفتاحًا خاصًا بها

عند إعداد الإضافة عبر واجهتها الرسومية (Cmd+Shift+P - Qwen Code: Choose Provider)، تنشئ الإضافة أحيانًا **مفتاحًا خاصًا بها** عبر Alibaba Auth API. ويكون لهذا المفتاح تنسيق مختلف، كما أنه غير مرتبط باشتراك Token Plan.

الحل: بعد إعدادها عبر الواجهة الرسومية، افتح `~/.qwen/settings.json` وتأكد من أن المفتاح الموجود في `env` يطابق ما تعرضه **Management Platform** (Overview - Plan-specific API Key). وإذا لم يتطابق، فاستبدله يدويًا.

### الخطأ 3: لم يُعيّن Standard Seat

بعد شراء Token Plan، سترى `Standard Seat: 0/1` في صفحة My Subscriptions. يعني ذلك أن المقعد قد اشتُري، لكنه **غير مرتبط بحسابك**. ولن يعمل مفتاح API حتى تنقر على **Assign**.

وفقًا لتجربة الكاتب، استغرق تصحيح خطأ 401 مدة 20 دقيقة قبل ملاحظة هذا السطر.

## كيف تتحقق من أن كل شيء يعمل؟

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

أهم النقاط

خطوتان: تحقّق أولًا من المفتاح باستخدام curl في الطرفية (ينبغي أن يعيد 200)، ثم اكتب أي prompt في Qwen Code. إذا عمل curl لكن لم تعمل الإضافة، فالمشكلة في إعدادات الملف `~/.qwen/settings.json`.

</div>

**الخطوة 1. تحقّق من المفتاح عبر الطرفية:**

```bash
curl -X POST \
  "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3.6-plus","messages":[{"role":"user","content":"Hello"}]}'
```

إذا احتوى الرد على نص من النموذج، فهذا يعني أن المفتاح والعنوان يعملان.

**الخطوة 2. تحقّق عبر Qwen Code:**

افتح VS Code، ثم الطرفية المدمجة، واكتب `qwen`. إذا بدأ التشغيل، فاكتب شيئًا:

```
ما هذا المشروع في هذا المجلد؟
```

سيقرأ Qwen Code البنية ويرد عليك. إذا فعل ذلك، فقد اكتمل الإعداد.

**الخطوة 3. تحقّق من استخدام Credits:**

بعد مرور خمس دقائق على طلباتك الأولى، انتقل إلى Management Platform—Overview—Usage Consumption. ينبغي أن تكون النسبة غير صفرية. إذا كانت 0% بعد أكثر من 10 طلبات، فأنت تستخدم العنوان الخطأ (فالطلبات تخرج من نطاق الاشتراك وتتجه إلى الدفع حسب الاستخدام أو لا تصل إلى أي مكان).

## ما الخطوة التالية؟

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaways">

أهم النقاط

أصبح Qwen Code جاهزًا — يمكنك البدء في vibe coding. لكن الأداة نفسها ليست إلا البداية. فالفرق بين «ثبّتُّ CLI» و«أبني منتجًا باستخدام الذكاء الاصطناعي» يكمن في منهجية العمل مع السياق.

</div>

لقد ثبّت Qwen Code وأصبح يعمل. يمكنك فتح أي مشروع والبدء في بنائه عبر الحوار مع الذكاء الاصطناعي.

والسؤال التالي هو: لماذا يعطي prompt نفسه في Qwen Code نتيجة رائعة في مشروع، ونتيجة رديئة في مشروع آخر؟ السبب هو السياق. إذا احتوى المشروع على بنية `business/` تضم الجمهور والمنتجات والأهداف، فسيعمل الذكاء الاصطناعي كشريك. أما إذا كان المجلد فارغًا، فسوف يهلوس.



<div class="section" role="doc-bibliography" aria-label="Sources">

### المصادر

- [Qwen Code على GitHub](https://github.com/QwenLM/qwen-code) — الشيفرة المصدرية والوثائق، تم التحقق منها في 03.10.2026
- [Alibaba Cloud ModelStudio](https://modelstudio.console.alibabacloud.com/) — وحدة التحكم لإدارة الاشتراكات والمفاتيح
- [نظرة عامة على Token Plan](https://www.alibabacloud.com/help/en/model-studio/token-plan-overview) — الخطط الحالية وحالة Coding Plan؛ حدّثتها Alibaba في 28.09.2026، وتم التحقق منها في 03.10.2026
- [وثائق Qwen Code: المصادقة](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) — تنسيقات مفاتيح Token Plan وCoding Plan، تم التحقق منها في 03.10.2026

</div>








تابع استكشاف Ailoot على [ailoot.ai](https://ailoot.ai/).

## أسئلة شائعة

### ما أول ما أفحصه إذا أعاد مفتاح Token Plan الخطأ 401؟

تأكد من أن المفتاح وBase URL يخصان Token Plan، وليس Coding Plan أو DashScope العادي. انسخ المفتاح بزر النسخ في وحدة التحكم، وتحقق من إسناد Standard Seat الذي اشتريته. ثم قارن إعدادات الإضافة المحفوظة بهذا التكوين نفسه.

### هل يثبت نجاح طلب الطرفية أن إضافة VS Code مضبوطة؟

لا؛ فهو يتحقق من المفتاح ونقطة الاتصال والنموذج المستخدمة في ذلك الطلب. اختبر طلبًا داخل Qwen Code بصورة مستقلة، وقارن Base URL والمفتاح المحفوظين فيه بالطلب الناجح. افحص أيضًا الاستهلاك في الاشتراك المقصود.


## Ailoot · الشركة ومحفظة مشاريعها

تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI.

الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.

توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.