ثبّت Grok Build على macOS أو Linux أو Windows في دقيقتين

قبل التثبيت

Grok Build تطبيق طرفية من SpaceXSI (سابقًا xAI). تتوفر ملفات تنفيذية جاهزة لـ macOS وLinux وWindows. تحتاج إلى:

• طرفية: Terminal أو iTerm على macOS، أو أي shell على Linux، أو PowerShell أو Git Bash على Windows.
• متصفح ويب لتسجيل الدخول الأول، أو مفتاح API إذا كنت تعدّه على خادم.
• حساب. Grok Build متاح للتجربة مجانًا، وتضيف خطة Plus في X Subscription ($8 شهريًا) والفئات الأعلى مزيدًا من الاستخدام.

أوامر التثبيت

1. macOS أو Linux أو Git Bash: شغّل curl -fsSL https://x.ai/cli/install.sh | bash
2. Windows PowerShell: شغّل irm https://x.ai/cli/install.ps1 | iex
3. تحقق من نجاح التثبيت: شغّل grok --version. إذا ظهر رقم إصدار، فقد نجح التثبيت.

يأتي كلا الأمرين من صفحة Grok Build الرسمية ومستودع GitHub. ويضع المثبّت البرنامج في ~/.grok/bin، وفقًا لدليل إعداد من جهة خارجية.

يمكن للمطورين أيضًا البناء من المصدر. ويتطلب ذلك سلسلة أدوات Rust (مثبّتة ومثبّتة الإصدار عبر rustup)، وDotSlash (cargo install dotslash)، وprotoc. وmacOS وLinux هما بيئتا البناء المدعومتان. أما بناءات Windows فهي «بأفضل جهد»، لذا ينبغي لمستخدمي Windows استخدام الملف التنفيذي الجاهز.

التشغيل الأول وتسجيل الدخول

1. افتح طرفية في مجلد مشروعك، لا في مجلدك الرئيسي.
2. شغّل grok.
3. تُفتح نافذة متصفح لتسجيل الدخول، عادةً على grok.com.
4. بعد تسجيل الدخول، تبدأ واجهة الطرفية. وتُخزَّن بيانات الاعتماد في ~/.grok/auth.json.

لماذا يهم مجلد المشروع: في يوليو 2026، كان تشغيل Grok Build قد يرفع المجلد الحالي بالكامل إلى التخزين السحابي للشركة. عطّلت SpaceXSI ذلك في اليوم نفسه وتقول إن Build يمكن الآن تشغيله محليًا بالكامل. ولا يزال البدء في مجلد المشروع العادة الأكثر أمانًا، لأن الوكيل يستطيع قراءة الملفات وتعديلها حيث يعمل.

افتراضيًا، يستخدم Grok Build وضع الخطة: يقترح خطة ولا يجري أي تعديلات حتى توافق عليها.

التحديث والتحقق من إعدادك

• grok update يحدّث Grok Build إلى أحدث إصدار.
• grok doctor يتحقق من إعداد الطرفية ويبلّغ عن المشكلات.
• grok --version يعرض الإصدار المثبّت.

حدّث كثيرًا. تطرح SpaceXSI الميزات بسرعة، وتصل النماذج الجديدة مثل Grok 4.7 إلى Grok Build في يوم إصدارها.

استخدام مفتاح API في CI

لا يعمل تسجيل الدخول عبر المتصفح على خوادم البناء. ولـ CI، اضبط متغير البيئة XAI_API_KEY بدلًا من ذلك، واستخدم الوضع دون واجهة للنصوص البرمجية وخطوط المعالجة.

1. أنشئ حسابًا على console.x.ai.
2. اشحن رصيدًا. واجهة API مدفوعة مسبقًا، وتُرفض الطلبات عند نفاد الرصيد.
3. أنشئ مفتاحًا من صفحة API Keys.
4. خزّنه كسرّ في نظام CI لديك واكشفه باسم XAI_API_KEY.

يُحتسب الاستخدام عبر مفتاح API بأسعار API، لا من رصيد اشتراكك. ويكلّف نموذج grok-build-0.1 مبلغ $1 لكل مليون رمز إدخال و$2 لكل مليون رمز إخراج.

ملف الإعداد والأذونات

يحتفظ Grok Build بإعداداته في ~/.grok/config.toml. وهناك تُضبط خوادم MCP، للاتصال بأدوات مثل Linear أو Sentry أو Postgres.

توضع أعراف كل مشروع في ملف AGENTS.md في كل مجلد. ويدرج دليل من جهة خارجية أوضاع الأذونات هذه: default وacceptEdits وauto وdontAsk وbypassPermissions وplan. ومن الخيارات المفيدة --worktree و--no-plan و--no-subagents. تجنّب bypassPermissions ما لم تشغّل Build في بيئة معزولة.

المشكلات الشائعة

• «grok: command not found»: افتح طرفية جديدة ليعيد shell تحميل المسار، وتحقق من أن ~/.grok/bin موجود في PATH.
• العرض يبدو معطوبًا: شغّل grok doctor للتحقق من دعم الطرفية.
• نافذة تسجيل الدخول لا تُفتح: على جهاز بعيد، استخدم XAI_API_KEY بدلًا من ذلك.
• مفتاح API مرفوض: تحقق من أن حسابك في console لديه رصيد مشحون.
• Grok 4.7 Fast غير موجود: Fast ليس جزءًا من الفئة المجانية.
• نفد الاستخدام: تتشارك الخطط المدفوعة رصيدًا أسبوعيًا واحدًا مع دردشة Grok وCursor. والاستخدام المكثف في مكان واحد يترك أقل للبقية.

أسئلة يطرحها الناس