MiniMax Code: وكيل MiniMax بمفتاحك الخاص عبر Gonka

للوكيل ثلاث نقاط دخول، وجميعها تعمل مع مزوّد BYOK بالطريقة ذاتها:

يثبّت المثبّت الرسمي أحدث إصدار في ~/.minimax-code، ويجلب عند الحاجة إصدار Node.js المناسب، ولا يتطلب صلاحيات المسؤول:

# macOS / Linux / WSL
curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

# Windows (PowerShell)
irm https://filecdn.minimax.chat/public/install.ps1 | iex

إذا كان Node.js مثبّتاً لديك بالفعل (22.19 وأحدث ضمن السلسلة 22، و24.2 وأحدث ضمن السلسلة 24، وكذلك 25 و26)، فيكفي npm:

npm install -g @minimax-ai/code@latest --registry=https://registry.npmjs.org/ --ignore-scripts=false --include=optional --allow-scripts=@minimax-ai/code,better-sqlite3

هذا الأمر الطويل ليس عبثاً: يحتاج الوكيل إلى بناء SQLite الأصلي، لذا يجب أن تبقى التبعيات الاختيارية وسكربتات التثبيت مفعّلة. بعد التثبيت، افتح الطرفية من جديد وتحقق من الأمر: mcode --version.

داخل TUI ستحتاج إلى Shift+Tab (وضع التخطيط)، وAlt+M (التبديل بين أوضاع الأذونات — Ask وAuto وFull access)، و@ للإشارة إلى ملف، و/help لعرض قائمة الأوامر. ويستأنف العمل المتوقف الأمر mcode --continue، بينما ينشئ mcode init . ملف AGENTS.md في المشروع يتضمن قواعد للوكيل.

أما بيانات المستخدم — config.yaml والجلسات وحالة تسجيل الدخول — فتُحفظ منفصلة عن البرنامج في المجلد ~/.minimax (وللملف الشخصي المُسمّى: ~/.minimax-<profile>)؛ ويحدد المتغير MINIMAX_DATA_DIR موقعاً آخر.

مفتاح JoinGonka. سجّل في gate.joingonka.ai/register: بعد تأكيد العنوان ستُضاف إلى حسابك 3M من الرموز المجانية. يُنشأ المفتاح ذو البادئة jg- في لوحة التحكم ضمن قسم «مفاتيح API»؛ ومن المفيد تخصيص مفتاح منفصل للوكيل — إذ ستظهر حركة مروره في سطر مستقل.

أغلق mcode إذا كان قيد التشغيل، ثم نفّذ:

npx @joingonka/setup --tool minimax-code --model minimax

سيسأل المثبّت عن المفتاح، ويحفظ نسخة من config.yaml السابق، ويكتب فيه كتلته فقط، وينتهي بطلب حيّ إلى البوابة: يُتحقق من المفتاح والعنوان والطراز فورًا، لا عند أول مهمة. في ~/.minimax/config.yaml سيظهر مزوّد joingonka ضمن فرع custom_provider — وهناك تحديدًا يحتفظ mcode بنقاط النهاية الخارجية:

custom_provider:
  joingonka:
    name: JoinGonka
    kind: custom
    enabled: true
    api: openai-completions
    options:
      apiKey: jg-your-key
      baseURL: https://gate.joingonka.ai/v1
      authMode: api-key
    models:
      MiniMaxAI/MiniMax-M2.7:
        name: MiniMax M2.7 (Gonka)
        limit:
          context: 200000
          output: 8192
      deepseek-ai/DeepSeek-V4-Flash-0731:
        name: DeepSeek V4 Flash (Gonka)
        reasoning: true
        limit:
          context: 380000
          output: 32768
      zai-org/GLM-5.3-Flash:
        name: GLM 5.3 Flash (Gonka)
        reasoning: true
        limit:
          context: 390000
          output: 8192
defaultModel: custom_provider:joingonka/MiniMaxAI/MiniMax-M2.7

ما يستحق معرفته عن هذه الكتلة:

• صيغة API مكتوبة بوضوح. بدون حقل api يعتبر mcode المزوّد متوافقًا مع Anthropic؛ ويختار المثبّت openai-completions — المسار القياسي للبوابة.
• لكل طراز حدوده الخاصة. يمنح mcode للطراز غير المعروف نافذة 200,000 وردًّا بـ 16,384 رمزًا؛ والقيم الفعلية للشبكة مختلفة، لذا تم تحديد limit لكل السجلات الثلاث.
• المفتاح موضوع في الملف كنص صريح، والملف نفسه يحصل على صلاحيات 600. وهكذا يخزّن mcode المفاتيح أيضًا: علمه --api-key-env يقرأ المتغير ويكتب القيمة في الإعداد لا مرجعًا إليها.
• الطراز الافتراضي. العلم --model minimax يضبط MiniMax M2.7. وبدون العلم يختار المثبّت DeepSeek V4 Flash لوكلاء البرمجة — فنافذتها وسقف ردّها أكبر — بينما --model glm يعطي GLM-5.3 Flash. وإذا كان الإعداد يختار بالفعل طرازًا لمزوّد آخر، فإن إعادة التشغيل بدون --model لن تمسّه.
• الملفات الشخصية. لملف شخصي مسمّى، شغّل المثبّت مع متغير بيئة، مثل MINIMAX_DATA_DIR=~/.minimax-work.

طلب إغلاق mcode أثناء التثبيت ليس شكليًا: فالوكيل يعيد كتابة config.yaml بالكامل عند حفظه الخاص وقد يمحو تعديلًا جرى من خلفه.

النتيجة نفسها يحققها أمر الوكيل الرسمي. يُمرَّر المفتاح عبر متغير بيئة — فليس له مكان في الوسائط ولا في سجل الصدفة:

# read the key without echo
read -s JOINGONKA_API_KEY
export JOINGONKA_API_KEY

mcode provider add --name JoinGonka \
  --base-url https://gate.joingonka.ai/v1 \
  --api-format openai-completions \
  --model MiniMaxAI/MiniMax-M2.7 \
  --api-key-env JOINGONKA_API_KEY \
  --context-limit 200000 --output-limit 8192 --use

العلم --use يتحقق أولًا من أول طراز مدرج بطلب حيّ، ثم يحفظ المزوّد ويجعل الطراز افتراضيًا؛ وعند الفشل لا يُحفظ شيء. وتنتهي الجولة الناجحة بالسطر Provider added and selected: JoinGonka. ومن الاسم يستنتج mcode مفتاح المزوّد — joingonka — لذا فإن المثبّت الذي يعمل لاحقًا سيحدّث نفس السجل لا أن ينشئ ثانيًا.

العلمان --context-limit و--output-limit يسريان على جميع الطرازات المدرجة في الأمر، بينما حدود طرازات الشبكة مختلفة. لذلك من المناسب بالأمر إنشاء طراز واحد، وكتابة البقية في الملف. أغلق mcode ودمج هذه القطعة مع كتلة المزوّد الموجودة في ~/.minimax/config.yaml:

custom_provider:
  joingonka:
    models:
      MiniMaxAI/MiniMax-M2.7:
        limit: { context: 200000, output: 8192 }
      deepseek-ai/DeepSeek-V4-Flash-0731:
        limit: { context: 380000, output: 32768 }
      zai-org/GLM-5.3-Flash:
        limit: { context: 390000, output: 8192 }

الطريقة الثالثة تفاعلية: داخل TUI يفتح الأمر /model اختيار الطراز مع بند + Add 3rd-party provider…، بينما يدير /provider الاتصالات المحفوظة. ويُعدَّل العنوان على شاشة الطراز بـ Ctrl+E؛ والتحقق الفاشل لا يحفظ شيئًا، وتبقى المسودة للتعديل.

أي صيغة API تختار. البوابة تقبل الثلاث، والفرق فقط في العنوان الأساسي:

في جولتنا اجتازت الصيغ الثلاث اختبار الاتصال.

ثلاثة أوامر تُثبت أن الربط ما زال يعمل. الأول يسرد المزوّدين — النشط مُعلَّم بنجمة، والمفتاح مُقنَّع:

mcode provider list
* custom_provider:joingonka   active   jg-a****9f3c

الثاني يُجري طلبًا فعليًا، وعند النجاح يرد بـ Provider available: custom_provider:joingonka؛ وتتحقق العَلمَة --model من طراز محدّد بعينه:

mcode provider test custom_provider:joingonka

الثالث يختبر الأمر الأهم — التعامل مع الملفات. ضع في المجلد ملفًا صغيرًا يحتوي على خطأ واضح واطلب منه العثور عليه:

mcode exec "Read calc.py and tell me in one sentence whether it has a bug."

ينبغي أن يستدعي الوكيل أداة القراءة بنفسه وأن يجيب في صلب الموضوع. في تجربتنا عملت الطرازات الثلاثة في الشبكة بهذه الطريقة؛ ولتحديد طراز آخر لتشغيل واحد استخدم عَلمَة بالصيغة --model custom_provider:joingonka/<model-id>. ومع العَلمَة --output-format json يظهر في الرد حقل usage يحوي عدد رموز الإدخال والإخراج — ومن المفيد مطابقته مع لوحة تحكّم البوابة: ففي قسم «الاستخدام» تظهر الطلبات بالساعات والأيام، مع تفصيل حسب الطرازات وحسب المفاتيح.

إذا لم ينجح الفحص، يذكر mcode السبب مباشرة في الرسالة:

السعر موحّد لجميع طرازات الشبكة، لذا يتعلق الاختيار بالسلوك. فيما يلي الحدود وكيف تصرّفت الطرازات في تجربتنا لـ mcode exec على المهمة نفسها (تم التحقق في 21 سبتمبر 2026):

القاعدة العملية بسيطة. للمهام القصيرة والتعديلات السريعة اختر MiniMax M2.7: فهو حاليًا يستحوذ على أكبر سعة في الشبكة. وإذا كان الاستدلال المرئي يعيق — مثلًا حين يحلّل سكربت مخرجات exec — أو كنت بحاجة لقراءة مستودع كبير والحصول على تعديل طويل، فانتقل إلى DeepSeek V4 Flash. أما المنطق المتشعّب فيفكّر فيه GLM-5.3 Flash بشكل أفضل.

التبديل لا يتطلب تعديل الملف: في TUI هو الأمر /model، ولجلسة واحدة mcode -m custom_provider:joingonka/<model-id>، ولتشغيل واحد mcode exec --model بالقيمة نفسها. ويُخزَّن الاختيار الدائم في السطر defaultModel. وتشكيلة الشبكة تتغيّر بمرور الوقت؛ والقائمة الحالية مع الحدود يوفّرها دائمًا GET https://gate.joingonka.ai/v1/models.

أدوات الوكيل تستهلك الرموز (tokens) بشكل مختلف عن الدردشة: مع كل جملة تضيفها، يضيف mcode مطالبة النظام (system prompt) وأوصاف جميع الأدوات، ثم يجري حوارًا متعدد المراحل مع النموذج. في تشغيلنا، مهمة «اقرأ الملف وابحث عن الخطأ» كلفت حوالي 40 ألف رمز، وتقريبًا كلها كانت مدخلات. لذا، السعر لكل رمز هنا هو الفاصل.

عبر JoinGonka Gateway، تكلف الرموز $0.0069 لكل مليون عند الإدخال و $0.021 لكل مليون عند الإخراج — السعر متطابق لجميع نماذج الشبكة ويتم جلبه في هذه الصفحة من مصدر حي. ترتيب الأسعار في سبتمبر 2026: مهمة واحدة — أجزاء من السنت، يوم عمل نشط بـ 3-7 ملايين رمز — بضعة سنتات.

ما يغطيه BYOK. يقوم مزودك الخاص بخدمة الطلبات للنموذج: قراءة وتعديل الكود، الأوامر، الوكلاء الفرعيون، الجلسات. البحث المدمج، أدوات الوسائط mcode-tools والموصلات المدارة هي خدمات من المزود نفسه، وتحتاج لتسجيل الدخول والأرصدة. يتم توصيل أدواتك الخاصة بشكل مستقل عبر خوادم MCP في ملف .mcp.json الخاص بالمشروع.

الأذونات. في TUI يتم التبديل بين أوضاع Ask و Auto و Full access عبر Alt+M أو أمر /permission؛ بالنسبة لـ mcode exec، علم --permission هو المسؤول عن ذلك.

القياس عن بعد (Telemetry). قنوات الإحصائيات والمقاييس والتشخيص في mcode معطلة افتراضيًا ويتم تفعيلها بشكل منفصل؛ المتغيرات MCODE_DISABLE_TELEMETRY و DO_NOT_TRACK تعطلها جميعًا دفعة واحدة. البوابة، من جانبها، لا تخزن محتوى المطالبات والردود — تبقى فقط إجماليات الاستهلاك في الإحصائيات.

إذا كنت بحاجة للعمل مع الصور — لقطة شاشة للواجهة، تصميم — قم بإنشاء مزود ثانٍ بجانبك مع نموذج يدعم الرؤية، مع تحديد العلم --support-image عند الإضافة: نماذج شبكة Gonka نصية، ويمكن أن يكون هناك العديد من المزودين في mcode.

الوكلاء من المختبرات أنفسهم متاحون لجميع عائلات نماذج الشبكة الثلاث: بجانب MiniMax Code يوجد DeepSeek Harness و ZCode من Z.ai، مؤلفي GLM. الثلاثة يتصلون بنفس البوابة بنفس المفتاح.