Trae + JoinGonka Gateway — نماذج شبكة Gonka في AI-IDE

Trae — AI-IDE مع وكلاء، ووضع SOLO المستقل، ومجموعة من النماذج المدمجة التي يتم خصم تكلفتها من الحد الشهري للخطة. منذ أغسطس 2026، يُطلق على بيئة سطح المكتب في الوثائق اسم TraeCode — إذا واجهت هذا الاسم في الواجهة أو المساعدة، فهو نفس الـ IDE.

بالإضافة إلى النماذج المدمجة، يمكن لـ Trae العمل مع نماذج خاصة: في نافذة Add Model يوجد خيار Custom Model، حيث يتم تحديد تنسيق API، وعنوان الطلب، ومعرف النموذج، والمفتاح. هناك تنسيقان — OpenAI Chat Completions وAnthropic Messages، — وJoinGonka Gateway يدعم كليهما بمفتاح واحد. بهذه الطريقة يحصل وكلاء Trae على نماذج شبكة Gonka اللامركزية مع الدفع بالتوكنز بناءً على أسعار الشبكة الحية. بعد التسجيل وتأكيد العنوان، سيصل إلى الحساب 3M توكن مجانية — كافية لاختبار الربط على مشروعك.

تم إدراج أسماء عناصر القائمة والحقول أدناه وفقاً للوثائق الرسمية لـ Trae للواجهة الإنجليزية؛ في الواجهة المحلية، ستتم ترجمة التسميات، وسيكون ترتيب الخطوات كما هو.

ما ستحتاجه: بناء Trae، الإصدار والمفتاح

البناء والإصدار. لدى Trae فرعان: دولي (الوثائق على docs.trae.ai) وصيني (docs.trae.cn). خيار Custom Model موجود في كليهما ويعمل بنفس الطريقة؛ الاختلاف يكمن في النماذج المدمجة ومجموعة الإعدادات المسبقة في الإضافات. يتم دعم عنوان الطلب المخصص للنموذج الخاص منذ الإصدار 3.5.51 بتاريخ 14 أبريل 2026 — إذا كان إصدارك قديماً، قم بالتحديث. الإصدار الدولي غير متاح في جميع البلدان: قبل التثبيت، تحقق من قائمة البلدان والمناطق المدعومة.

النظام. macOS 12 فأحدث، Windows 10 أو 11 (x64)، Linux في حزم .deb و.rpm. عند التشغيل الأول، سيقترح Trae اختيار السمة واللغة، واستيراد الإعدادات من VS Code أو Cursor، وتسجيل الدخول إلى الحساب.

مفتاح JoinGonka. سجل في البوابة، وافتح قسم "API-keys" في المكتب الشخصي واضغط على "Create key". يبدأ المفتاح بـ jg- ويظهر مرة واحدة — احفظه فوراً. من المريح إنشاء مفتاح منفصل لـ Trae: في قسم "Usage" سيظهر استهلاكه كسطر منفصل.

خطة Trae. يجب اختيار النموذج الخاص يدوياً من قائمة النماذج، وفي جدول خطط Trae، تحتوي الخطة المجانية في سطر اختيار النموذج على وضع Auto فقط — وفي هذا الوضع لا تُستخدم النماذج الخاصة. لا تنص الوثائق صراحةً على ما إذا كان هذا القيد ينطبق على النماذج المضافة بمفتاح خاص. القاعدة العملية بسيطة: إذا كان يمكن إيقاف تشغيل Auto Mode في قائمة النماذج في خطتك، فكل شيء جاهز؛ إذا لم يكن كذلك — فستحتاج إلى خطة مدفوعة.

الاتصال: Settings → Models → Add Model → Custom Model

افتح Settings ← Models — لوحة التحكم بالنماذج.
اضغط على Add Model. في النافذة التي تظهر، اختر Custom Model بدلاً من مزوّد من القائمة الجاهزة.
املأ الحقول بالقيم من الجدول. هناك عمودان — لكل من تنسيقي API؛ اختر أحدهما.
اضغط على Add Model. سيقوم Trae بإجراء استدعاء تجريبي لـ API والتحقق من المفتاح: عند النجاح سيظهر النموذج في القائمة، وعند الفشل ستعرض النافذة رسالة خطأ وسجل استجابة المزوّد.

الحقل	تنسيق OpenAI	تنسيق Anthropic
API Format	`OpenAI Chat Completions`	`Anthropic Messages`
Custom Request URL، مفتاح Full URL مُطفأ	`https://gate.joingonka.ai/v1`	`https://gate.joingonka.ai`
Custom Request URL، مفتاح Full URL مُشغّل	`https://gate.joingonka.ai/v1/chat/completions`	`https://gate.joingonka.ai/v1/messages`

بقية الحقول لا تعتمد على التنسيق:

الحقل	القيمة	الشرح
Model ID	`deepseek-ai/DeepSeek-V4-Flash-0731`	المعرّف الدقيق للنموذج كما تعيده البوابة
Display Name	`DeepSeek V4 Flash (Gonka)`	الاسم في قائمة النماذج؛ بدونه سيعرض Trae الـ Model ID
API Key	`jg-your-key`	مفتاح واحد يكفي للتنسيقين معاً

أي تنسيق تختار. ابدأ بـ OpenAI Chat Completions: فهو المسار الأساسي للبوابة، ومعظم الأدوات تعمل به. أما Anthropic Messages فيفيدك إن كنت معتاداً على هذا التنسيق في أدوات أخرى أو أردت مقارنة سلوك الوكيل على بروتوكولين — فالمفتاح والرصيد مشتركان بينهما.

كيف يعمل Full URL. يحدّد المفتاح من يضيف المسار. عند إطفائه — تمنح العنوان الأساسي، ويضيف Trae المسار حسب التنسيق المختار: /chat/completions إلى العنوان الذي يحتوي على /v1 لتنسيق OpenAI، و/v1/messages إلى الجذر لتنسيق Anthropic. وعند تشغيله — يُستخدم العنوان كما هو، ويجب أن يكون المسار كاملاً داخله. الخطأ الأكثر شيوعاً هو خلط الوضعين: إدخال المسار الكامل والمفتاح مُطفأ، أو إدخال العنوان الأساسي والمفتاح مُشغّل.

سجل واحد — نموذج واحد. كرّر الخطوات لبقية نماذج الشبكة لتنتقل بينها دون العودة إلى الإعدادات: deepseek-ai/DeepSeek-V4-Flash-0731 وMiniMaxAI/MiniMax-M2.7 وzai-org/GLM-5.3-Flash. القائمة الحالية تعيدها GET https://gate.joingonka.ai/v1/models. يمكنك لاحقاً تعديل النموذج المُضاف، أو تعطيله (سيبقى في اللوحة لكنه يختفي من القائمة في الدردشة)، أو حذفه.

إعدادات إضافية واختيار النموذج

تحت الحقول الأساسية توجد قائمة قابلة للطي Advanced Settings. يمكنك تركها كما هي — سيقوم Trae بوضع القيم الافتراضية — ولكن هناك إعدادان يستحقان التعيين بوعي: سلسلة النموذج ونافذة السياق.

الإعداد	ماذا تختار	لماذا
Model Series	`Default`	تغير إعدادات السلاسل المسبقة المطالبات (prompts)، والمعاملات الفائقة (hyperparameters)، ونافذة السياق وفقاً لـ API الموردين أنفسهم. على سبيل المثال، يرفع إعداد Deepseek-4 الحدود إلى 616,000 رمز للمدخلات و384,000 للمخرجات — وهو أكثر مما يقدمه النموذج في شبكة Gonka
Context Window (Token)	المدخلات والمخرجات — حسب جدول النماذج أدناه	سيقوم Trae بملء الحقول الفارغة بالقيم الافتراضية الخاصة به؛ للقيم المحددة يدوياً الأولوية ولن تسمح للوكيل بتجاوز سياق النموذج
Image Input Support	مغلق	نماذج الشبكة نصية. مع إغلاق الإعداد، سيحذر Trae نفسه من أن النموذج لا يقبل الصور
Thinking Mode	`Follow model default`	يتم إدارة التفكير بواسطة النموذج نفسه؛ في GLM-5.3 Flash، يكون مفعلاً افتراضياً
Tool Call Rounds, Hyperparameters	تركها فارغة	القيم الافتراضية مناسبة؛ يمكن ضبط Temperature و Top P و Top K لاحقاً إذا لزم الأمر

سعر نماذج الشبكة متساوٍ، لذا فإن الاختيار يعتمد على السلوك. تدعم جميع النماذج في الجدول استدعاء الأدوات الأصلي (native tool calling)، الذي يقوم عليه عمل وكلاء Trae.

النموذج	Model ID	Context Window: المدخلات / المخرجات	متى تستخدمه في Trae
DeepSeek V4 Flash	`deepseek-ai/DeepSeek-V4-Flash-0731`	380000 / 32768	النموذج الرئيسي للوكيل: المستودعات الكبيرة، الجلسات الطويلة، إنشاء ملفات ضخمة — أكبر سقف استجابة في الشبكة
MiniMax M2.7	`MiniMaxAI/MiniMax-M2.7`	200000 / 8192	التعديلات السريعة، الأسئلة حول الكود، شرح جزء من الكود — دورة قصيرة "سؤال - جواب"
GLM-5.3 Flash	`zai-org/GLM-5.3-Flash`	390000 / 8192	نموذج التفكير: يفكر قبل الرد. التصميم، تصحيح الأخطاء المعقد، تحليل بنية برمجية خارجية؛ يذهب جزء من حدود المخرجات إلى التفكير

تم شرح كيفية عمل ميزانية التفكير ولماذا لا ينبغي تقليل حد المخرجات لنماذج التفكير في مراجعة GLM-5.3 Flash؛ ومقارنة النماذج في مهام التطوير — في المقالة حول أفضل نماذج الكود.

التحقق والتشخيص

نماذجك الخاصة موجودة في القائمة العامة: اضغط على اسم النموذج الحالي في الزاوية اليمنى السفلية من حقل إدخال الدردشة واختر النموذج الذي أضفته. يوجد هناك أيضًا مفتاح Auto Mode — يجب إيقاف تشغيله: في وضع Auto، يختار Trae النموذج من النماذج المدمجة ولا يستخدم النماذج التي أضفتها أنت.

امنح الوكيل مهمة تتطلب أداة، على سبيل المثال: "اقرأ package.json وقم بإدراج نصوص البناء البرمجية". يجب أن يفتح الوكيل الملف ويجيب بشكل موضوعي — وهذا يعني أن حلقة "طلب — استدعاء أداة — استجابة" عبر البوابة (gateway) قد تم إنشاؤها. ثم افتح لوحة تحكم البوابة، قسم "الاستخدام" (Usage): في كتلة "حسب المفاتيح" (By keys)، ستظهر الطلبات ووقت آخر وصول لمفتاح Trae، وفي كتلة "حسب النماذج" (By models) سيظهر النموذج المختار.

إذا ساءت الأمور، انظر إلى نص الخطأ. Trae لا يخفي رد نموذجك الخاص: إنه يعرض خطأ المزود كما هو، مع رمز الخطأ الداخلي 4028.

ما تراه	ماذا يعني ذلك	ماذا تفعل
`401`, `Invalid API key` — في نافذة Add Model أو في الدردشة	البوابة لم تتعرف على المفتاح	تأكد من أن المفتاح يبدأ بـ `jg-`، ومُدخل بدون مسافات، وفعال في قسم "مفاتيح API"
`404`, `Invalid URL (POST …)`	يوجد جزء إضافي في المسار؛ تعرض البوابة في نص الخطأ المكان الذي وصل إليه الطلب	طابق العنوان مع الجدول: المسار الكامل مسموح به فقط عند تفعيل Full URL، ويُكتب العنوان الأساسي لتنسيق Anthropic بدون `/v1`
`405 Not Allowed`, `301` أو HTML بدلاً من الاستجابة	الطلب ذهب خارج نطاق API: بالنسبة لتنسيق OpenAI، العنوان الأساسي يفتقد `/v1` أو عند تفعيل Full URL تم تحديد العنوان الأساسي فقط	اجعل العنوان مطابقاً لأحد خيارات الجدول: الأساسي عند إيقاف Full URL، والمسار الكامل عند التفعيل
الرمز 984, `Incorrect model name`	معرف النموذج (Model ID) لا يتطابق مع المعرف على البوابة	انسخ المعرف من جدول النماذج حرفياً
الرمز 4028 ونص يحتوي على `429`	النموذج محمّل بشكل زائد: في ساعات الذروة قد تُستهلك سعة نموذج معين في الشبكة بالكامل	أعد المحاولة بعد بضع ثوانٍ أو انتقل إلى نموذج آخر؛ حالة الشبكة مرئية على صفحة الحالة
الرمز 4054, `Model Request failed`	الطلب إلى نموذجك الخاص لم يصل أو انقطع	تحقق عبر صفحة الحالة مما إذا كانت البوابة متاحة، وطابق إعدادات تسجيل النموذج عبر Edit: التنسيق، العنوان، المعرف
الرمز 7000: النموذج لا يقبل الصور	تم إرفاق صورة بالرسالة، بينما نماذج الشبكة نصية	أزل الصورة أو استخدم نموذجاً مدمجاً يدعم الرؤية لهذه المهمة
تم اختيار نموذجك الخاص ولكن يرد نموذج آخر	وضع Auto Mode مفعل	قم بإيقاف تشغيله من قائمة النماذج

كم تكلف هذه الخدمة

يستهلك الوكيل في IDE التوكنات أسرع من الدردشة: كل طلب يتضمن تعليمات النظام، ووصف الأدوات، والملفات المفتوحة، وتاريخ الخطوات. لذلك، يحدد سعر التوكن ما إذا كان بإمكانك تشغيل الوكيل لكل تفصيل صغير أو عليك التوفير.

من خلال JoinGonka Gateway، تكلف التوكنات $0.0069 للمليون عند الإدخال و $0.021 للمليون عند الإخراج — السعر موحد لجميع نماذج الشبكة ويتم استخلاصه في هذه الصفحة من مصدر حي. ترتيب المبالغ بناءً على الأسعار في سبتمبر 2026:

السيناريو	الاستهلاك	عبر Gateway
مهمة لمرة واحدة: قراءة ملفات وإجراء تعديل	عشرات الآلاف من التوكنات	جزء من السنت
يوم عمل نشط مع الوكيل	3-7M توكن	بضعة سنتات
شهر من التطوير اليومي	~150M توكن	حوالي دولار أو دولارين

المقارنة مع Trae نفسه توضيحية، لأن النماذج المفتوحة موجودة أيضاً ضمن النماذج المدمجة، وينشر Trae قائمة أسعارهم للمليون توكن. تبلغ تكلفة DeepSeek-V4-Flash و MiniMax-M2.7 هناك $0.30 عند الإدخال و $1.20 عند الإخراج، بينما GLM-5.3 Flash غير موجودة في القائمة المدمجة للنسخة الدولية على الإطلاق. عبر البوابة، الفرق في نفس النماذج هو تقريباً ×43 عند الإدخال و ×58 عند الإخراج.

الطريقة	كيفية الحساب	ما الذي يقيدها
نماذج Trae المدمجة	بالتوكن حسب قائمة أسعار Trae، من الحد الشهري Dollar Usage؛ ما يتجاوز الحد — دفع إضافي On-Demand Usage	حد الباقة وسعرها
نموذج خاص + JoinGonka Gateway	بالتوكن حسب سعر الشبكة، من رصيد البوابة	الرصيد فقط: الاستهلاك مرئي في لوحة التحكم حسب الأيام، المفاتيح، والنماذج

ما يجب مراعاته في العمل

نموذجك الخاص يعمل حيثما توجد قائمة النماذج. هذه هي الدردشة والوكلاء — سواء في وضع IDE أو SOLO (يتم دعم النماذج الخاصة فيه منذ الإصدار 3.3.0). الإكمال التلقائي وتوقع التصحيحات هو آلية منفصلة CUE مع لوحة إعدادات خاصة بها: لا يوجد خيار اختيار نموذج فيها، ويتم تحديد حدودها بواسطة باقة Trae.

الأدوات و MCP. يعمل وكلاء Trae كعملاء MCP، وتظل الخوادم التي قمت بتوصيلها متاحة للوكيل على نموذجه الخاص: تدعم جميع نماذج الشبكة استدعاء الأدوات الأصلي. إذا أبلغ Trae أن مخطط وسيطات الأداة غير متوافق مع النموذج (كود 4027)، فجرب نموذجاً مجاوراً في الشبكة أو خادم MCP آخر.

TraeWork. في تطبيق TraeWork المنفصل، نموذج إضافة نموذجك الخاص هو نفسه، ولكن وفقاً للوثائق، فهو يعمل فقط في TraeWork Desktop وفقط للمهام في البيئة المحلية.

إضافة للمحررات الأخرى. في وثائق إضافة TraeCode لـ VS Code و JetBrains، لا يوجد قسم حول النماذج الخاصة — هذا الدليل يتعلق بـ IDE المكتبي. إذا كنت لا تزال تستخدم VS Code، يتم توصيل نفس البوابة من خلال إضافات الوكلاء، على سبيل المثال Cline.

الخصوصية. إعداد Privacy Mode (Settings → Account) يتحكم فيما يفعله Trae بمحادثاتك ومقتطفات الكود الخاصة بك: مع هذا الوضع، لا تذهب إلى التحليلات والتدريب. من جانب البوابة، لا يتم تخزين المحادثات: لا تبقى المطالبات (Prompts) والردود عليها بعد الإجابة، في لوحة التحكم لا تظهر سوى عدادات الطلبات والرموز (Tokens).

إذا كنت بحاجة للعمل مع الصور — تخطيط، لقطة شاشة لخطأ — قم بتكليف تلك المهمة بالنموذج المدمج الذي يمتلك الرؤية، واترك الكود والأوامر والملفات لنموذج الشبكة: التبديل يستغرق نقرة واحدة في قائمة النماذج.

يتصل Trae بـ JoinGonka Gateway عبر Settings → Models → Add Model → Custom Model: تنسيق OpenAI Chat Completions مع العنوان https://gate.joingonka.ai/v1 أو Anthropic Messages مع العنوان https://gate.joingonka.ai، معرف النموذج والمفتاح jg-. مفتاح Full URL يقرر من يكمل المسار — لا تخلط بين الأوضاع. في الإعدادات الإضافية، اترك السلسلة Default وحدد نافذة السياق وفقاً للنموذج: DeepSeek V4 Flash — 380000 و 32768، MiniMax M2.7 — 200000 و 8192، GLM-5.3 Flash — 390000 و 8192. ولا تنسَ إيقاف Auto Mode: في هذا الوضع لا يستخدم Trae نماذجه الخاصة.

← Warp + JoinGonka Gateway — وكيل طرفية على نقطة النهاية الخاصة بك Cherry Studio + JoinGonka Gateway — عميل ذكاء اصطناعي مكتبي →

تريد معرفة المزيد؟

استكشف الأقسام الأخرى أو ابدأ في كسب GNK الآن.

الحصول على مفتاح ورموز مجانية →