جهّز وكيلك الأول

من التثبيت الأول إلى وكيل ذكاء اصطناعي يعمل. الجزءان اللذان يفوتان معظم المبتدئين موجودان في الأعلى: علاقة AgentsRoom بأدوات CLI للذكاء الاصطناعي، وطريقة تسجيل الدخول.

كيف يعمل AgentsRoom (اقرأ هذا أولاً)

AgentsRoom هو قمرة القيادة، وأدوات CLI للذكاء الاصطناعي (Claude وCodex وGitHub Copilot CLI وCursor و15 أداة CLI أخرى للوكلاء) هي المحركات. تسجّل الدخول إلى هذه المحركات مرة واحدة عبر الأمر الخاص بكل منها، ثم يقودها AgentsRoom بصريًا. لا يخزّن AgentsRoom رموزك (tokens) ولا مفاتيح API ولا كلمة مرور ChatGPT ولا يطّلع عليها أبدًا: تبقى داخل التخزين الآمن الخاص بكل CLI على جهازك.

لا يوجد زر "تسجيل الدخول إلى ChatGPT" أو "تسجيل الدخول إلى Anthropic" داخل AgentsRoom حسب التصميم. يتم تسجيل الدخول في CLI الذي تقوم بتثبيته في الخطوة 0 أدناه.

قبل أن تبدأ

✓Windows 10 أو أحدث، أو macOS 14 أو أحدث (Sonoma)، أو توزيعة Linux حديثة بنظام 64 بت
✓
أداة CLI واحدة على الأقل للبرمجة بالذكاء الاصطناعي مثبّتة (Claude أو Codex أو GitHub Copilot CLI أو Cursor أو أي من أدوات CLI الوكلاء الـ 15 الأخرى التي يدعمها AgentsRoom)
مثال: curl -fsSL https://claude.ai/install.sh | bash
✓اشتراك نشط أو مفتاح API لدى المزوّد الذي اخترته

الخطوة 0: ثبّت محرك AI الخاص بك وسجّل الدخول إليه

اختر مزوّدًا واحدًا للبدء (يمكنك إضافة المزيد لاحقًا). لكل مزوّد: ثبّت الـ CLI، وشغّله مرة واحدة لتسجيل الدخول، وتحقق من أنه يعمل. ثم انتقل إلى الخطوة 1.

اضغط على المزود لتوسيع خطواته.

Claude (Anthropic)الموصى به للمستعملين لأول مرة

يعمل مع

Claude Pro، Claude Max، أو مفتاح API من Anthropic.

1. التثبيت

curl -fsSL https://claude.ai/install.sh | bash

2. تسجيل الدخول

شغّل claude مرة واحدة في أي طرفية. تُفتح نافذة متصفح لتسجيل الدخول بحسابك لدى Anthropic.

3. التحقق

قم بتشغيل أمر التثبيت أعلاه، ثم قم بتشغيل اسم CLI وحده في الطرفية الخاصة بك (على سبيل المثال، اكتب "claude" واضغط على إدخال). يجب أن ترى مطالبة ترحيب. اكتب "hello" واضغط على إدخال: إذا حصلت على إجابة، فأنت جاهز لاستخدامه داخل AgentsRoom.

Codex (OpenAI / ChatGPT)استخدم حساب ChatGPT الخاص بك

يعمل مع

اشتراك ChatGPT Plus أو Pro أو Team أو Enterprise، أو مفتاح API من OpenAI.

1. التثبيت

curl -fsSL https://chatgpt.com/codex/install.sh | sh

2. تسجيل الدخول

شغّل codex مرة واحدة في أي طرفية. ستُفتح نافذة في المتصفح. سجّل الدخول بحساب ChatGPT، وهو الحساب نفسه الذي تستخدمه على chatgpt.com.

3. التحقق

Antigravity (Google)مستوى مجاني متاح

يعمل مع

حساب Google (تسجيل الدخول عبر المتصفّح). يتوفّر مستوى مجاني سخي.

1. التثبيت

curl -fsSL https://antigravity.google/cli/install.sh | bash

2. تسجيل الدخول

شغّل الأمر antigravity مرة واحدة في أي طرفية. ستُفتح نافذة متصفّح لتسجيل الدخول إلى Google.

3. التحقق

OpenCodeاستخدم مزوّدك الخاص

يعمل مع

أي مزوّد تضبطه: Anthropic وOpenAI وOpenRouter وغيرها.

1. التثبيت

curl -fsSL https://opencode.ai/v2/install | bash

2. تسجيل الدخول

شغّل opencode ثم استخدم الأمر /connect لإضافة مفتاح مزوّد أو اشتراك OpenCode Go.

3. التحقق

Grok Build (xAI)سياق 256K

يعمل مع

حساب xAI (تسجيل الدخول عبر المتصفح) أو مفتاح Grok API لاستخدام headless.

1. التثبيت

curl -fsSL https://x.ai/cli/install.sh | bash

2. تسجيل الدخول

شغّل grok مرة واحدة في أي طرفية. تفتح نافذة متصفح لتسجيل الدخول إلى xAI. للاستخدام headless، عيّن متغير البيئة GROK_CODE_XAI_API_KEY بدلاً من ذلك.

3. التحقق

Cursorمحرّرك، داخل الطرفية

يعمل مع

حساب Cursor. خطتك الحالية تشمل الـ CLI؛ أما المستوى المجاني فيصل إلى مجموعة أصغر من النماذج.

1. التثبيت

curl https://cursor.com/install -fsS | bash

2. تسجيل الدخول

شغّل cursor-agent login لتسجيل الدخول عبر متصفّحك. توجد الإعدادات في ~/.cursor.

3. التحقق

oh-my-piأكثر من 60 واجهة خلفية

يعمل مع

ما تدفع مقابله بالفعل: يسجّل الدخول إلى Anthropic و OpenAI و Google و xAI و Z.ai و DeepSeek وغيرها، أو يقبل مفتاح API بسيطًا.

1. التثبيت

curl -fsSL https://omp.sh/install | sh

2. تسجيل الدخول

شغّل omp مرة واحدة، ثم استخدم /login لربط مزوّد. توجد الإعدادات في ~/.omp.

3. التحقق

Kimi (Moonshot AI)سياق حتى 1M

يعمل مع

حساب Kimi (تسجيل الدخول عبر المتصفح) أو مفتاح API من منصة Moonshot AI المفتوحة.

1. التثبيت

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

2. تسجيل الدخول

شغّل kimi مرة واحدة في أي طرفية، ثم اكتب /login لتسجيل الدخول بحساب Kimi. توجد الإعدادات في ~/.kimi-code.

3. التحقق

Freebuffبلا مفتاح

يعمل مع

لا شيء. الخدمة مجانية وممولة بإعلانات نصية تظهر بين الأدوار.

1. التثبيت

npm install -g freebuff

2. تسجيل الدخول

شغّل freebuff داخل مشروعك. يوجد أمر freebuff login إن أردت ربط حساب Codebuff.

3. التحقق

Pi (Earendil)بسيط وقابل للتوسيع

يعمل مع

ما تدفع مقابله بالفعل: يسجّل Pi الدخول إلى Anthropic و OpenAI و Google و GitHub Copilot ومزوّدين آخرين كثيرين، أو يقبل مفتاح API بسيطًا.

1. التثبيت

curl -fsSL https://pi.dev/install.sh | sh

2. تسجيل الدخول

شغّل pi مرة واحدة، ثم استخدم /login لربط مزوّد. توجد الإعدادات في ~/.pi/agent.

3. التحقق

Devinخطة واحدة، نماذج متعددة

يعمل مع

خطة Devin أو Windsurf، بما في ذلك المستوى المجاني. الاشتراك نفسه يشمل نماذج Claude و GPT و Gemini ونماذج SWE من Cognition.

1. التثبيت

curl -fsSL https://cli.devin.ai/install.sh | bash

2. تسجيل الدخول

شغّل devin auth login لتسجيل الدخول عبر متصفّحك. توجد الإعدادات في ~/.config/devin.

3. التحقق

Command Codeاختر من نماذج مفتوحة وأخرى مملوكة

يعمل مع

حساب Command Code أو مفتاح API عبر COMMAND_CODE_API_KEY. يعتمد الوصول إلى النماذج وحدود الاستخدام على حسابك لدى المزوّد.

1. التثبيت

npm install -g command-code@latest

2. تسجيل الدخول

نفّذ command-code login لتسجيل الدخول، أو اضبط COMMAND_CODE_API_KEY في بيئتك. ثم شغّل command-code داخل مشروعك.

3. التحقق

Mistral Vibeنماذج أوروبية

يعمل مع

حساب Mistral (Pro أو Team) أو مفتاح Mistral API.

1. التثبيت

command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install --python 3.12 mistral-vibe

2. تسجيل الدخول

شغّل vibe --setup مرة واحدة لتخزين مفتاح Mistral API الخاص بك، ثم شغّل vibe للبدء. توجد الإعدادات في ~/.vibe/config.toml.

3. التحقق

Muse Code (Meta)Muse Spark في الطرفية

يعمل مع

حساب Meta لديه صلاحية استخدام Muse Code، أو مفتاح API عبر META_API_KEY. تحدد Meta شروط الوصول وحدود الاستخدام.

1. التثبيت

curl -fsSL https://dev.meta.ai/install.sh | sh

2. تسجيل الدخول

نفّذ muse login لتسجيل الدخول، أو اضبط META_API_KEY في بيئتك. ثم شغّل muse داخل مشروعك.

3. التحقق

Aiderللمستخدمين المتقدّمين

يعمل مع

أي مزوّد عبر مفتاح API (Anthropic وOpenAI وDeepSeek وغيرها).

1. التثبيت

command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install --python 3.12 aider-chat

2. تسجيل الدخول

لا يوجد أمر لتسجيل الدخول. عيّن مفتاح API كمتغير بيئة في ملف إعدادات الـ shell، على سبيل المثال: export ANTHROPIC_API_KEY=sk-...

3. التحقق

Amp (Sourcegraph)أوضاع لا نماذج

يعمل مع

حساب Amp (تسجيل الدخول عبر المتصفح) أو رمز AMP_API_KEY.

1. التثبيت

curl -fsSL https://ampcode.com/install.sh | bash

2. تسجيل الدخول

شغّل amp login مرة واحدة في أي طرفية لتسجيل الدخول. توجد الإعدادات في ~/.config/amp.

3. التحقق

MiniMax Code (MiniMax)نماذج السلسلة M

يعمل مع

حساب MiniMax (تسجيل الدخول عبر المتصفح) أو مفتاح API من MiniMax.

1. التثبيت

curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

2. تسجيل الدخول

شغّل mcode login --region global (أو mcode login لحساب من البر الرئيسي للصين) في أي طرفية. توجد الإعدادات في ~/.minimax.

3. التحقق

ZCode (عميل مجتمعي)نماذج GLM، وليس من Z.ai

يعمل مع

اشتراك Z.ai أو BigModel، أو مفتاح API. هذا العميل المجتمعي لا تنشره Z.ai ولا تعتمده.

1. التثبيت

npm install -g zcode-app-cli@latest

2. تسجيل الدخول

شغّل zcode مرة واحدة في أي طرفية، ثم اكتب /login لتسجيل الدخول بحساب Z.ai أو BigModel. يتطلب Node.js 22.19 أو أحدث. توجد الإعدادات في ~/.zcode.

3. التحقق

عالق في هذه الخطوة؟ راجع قسم استكشاف الأخطاء وإصلاحها في أسفل هذه الصفحة.

نزّل AgentsRoom وثبّته

نزّل برنامج التثبيت المناسب لنظام التشغيل لديك: ملف .dmg على macOS، أو ملف .exe على Windows، أو AppImage على Linux. افتحه، واتبع خطوات التثبيت، ثم شغّل AgentsRoom.

Tip: يتحقق AgentsRoom تلقائيًا من وجود تحديثات، وستصلك رسالة عند توفر إصدار جديد.

أنشئ مشروعك الأول

اضغط الزر + في الشريط الجانبي. اختر أي مجلد على جهازك: هنا سيعمل وكلاء الذكاء الاصطناعي. سمِّ مشروعك وضعه في منطقة.

Tip: كل مشروع يتوافق مع مجلد حقيقي. يقوم الوكلاء بتشغيل CLI الخاص بالمزود الذي اخترته في ذلك الدليل، تمامًا كما تفعل في الطرفية الخاصة بك.

أضف وكيلك الأول

داخل مشروعك، انقر فوق إضافة وكيل. اختر دورًا (Fullstack هو بداية جيدة)، ثم مزودًا (المحرك الذي قمت بإعداده في الخطوة 0)، ثم نموذجًا (Sonnet موصى به لـ Claude). اختياريًا اكتب مطالبة أولية وانقر فوق إطلاق. تفتح الطرفية وتقوم بتشغيل CLI لك.

Tip: إذا بدت الطرفية فارغة أو أظهرت شاشة تسجيل دخول، فهذا يعني أن الـ CLI الخاص بالخطوة 0 لم يسجّل الدخول بعد. افتح طرفية عادية، وشغّل claude أو codex (أو أمر مزوّدك) مرة واحدة، وأكمل تسجيل الدخول، ثم عُد.

شاهده وهو يعمل

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

Tip: يمكنك إطلاق عدة وكلاء في وقت واحد. يحصل كل وكيل على طرفيته الخاصة ويعمل بشكل مستقل.

خصّص إعداداتك

عدّل CLAUDE.md مباشرة من AgentsRoom لمنح الوكلاء سياقاً أفضل. غيّر النماذج، وعدّل الصلاحيات، واضبط الخطافات. أضف مزيداً من الوكلاء بأدوار أو مزوّدين مختلفين.

Tip: Opus للمعمارية، Sonnet للتطوير، Haiku للمهام السريعة مثل الاختبارات.

نصائح وحيل

1.استخدم Opus لقرارات المعمارية، وSonnet للبرمجة اليومية، وHaiku للمهام السريعة

2.جمّع المشاريع حسب المنطقة (العمل، الشخصي، المشاريع الجانبية) لتنظيم أفضل

3.عدّل CLAUDE.md من AgentsRoom لمنح الوكلاء سياقاً أفضل عن المشروع

4.فعّل إشعارات سطح المكتب لتنشغل بأمور أخرى بينما يعمل الوكلاء

5.ابدأ بوكيل واحد لكل مشروع، ثم أضف المزيد عندما تعتاد على ذلك

استكشاف الأخطاء وإصلاحها

طرفية الوكيل تبدو فارغة أو عالقة

في معظم الحالات يكون السبب أن تسجيل الدخول إلى CLI لم يتم. افتح الطرفية لديك (Terminal على macOS، أو PowerShell أو Windows Terminal على Windows، أو محاكي الطرفية لديك على Linux)، ثم نفّذ أمر CLI بمفرده (claude، codex، antigravity، opencode)، وأكمل تسجيل الدخول عبر المتصفح، ثم عُد إلى AgentsRoom وشغّل الوكيل مرة أخرى. لا تملك AgentsRoom شاشة تسجيل دخول خاصة بها: المصادقة تتم داخل CLI.

command not found: claude (أو codex أو antigravity، إلخ)

لم يتم تثبيت CLI، أو أن مسار shell الخاص بك لا يراه. أعد تشغيل أمر التثبيت من الخطوة 0 أعلاه. إذا كنت تستخدم nvm، قم بتثبيت CLI بنفس إصدار Node الذي تستخدمه يوميًا، وإلا فلن يكون الملف الثنائي في PATH عند إطلاق AgentsRoom.

لا أرى زرًا لتسجيل الدخول إلى ChatGPT أو Claude داخل AgentsRoom

حسب التصميم. AgentsRoom هو واجهة مستخدم فوق CLIs ولا يتعامل مع بيانات اعتمادك مباشرة. يتم تسجيل الدخول مرة واحدة داخل CLI (قم بتشغيل claude أو codex في طرفية)، ثم يستخدم AgentsRoom تلك الجلسة. هذا ما يجعل AgentsRoom أكثر أمانًا من الأدوات التي تعترض الرموز الخاصة بك.

الوكيل عالق على "التفكير"

تأكد من أن اشتراكك أو مفتاح API نشط لدى المزود المختار. جرّب تشغيل واجهة سطر الأوامر مباشرة في الطرفية لرؤية رسالة الخطأ الحقيقية: فـ Claude أو OpenAI يقيّدان معدل الطلبات أو ينهيان الجلسات أحياناً دون إشعار.

لا تظهر أي مشاريع في الشريط الجانبي

تأكد من اختيار مجلد صالح عند إنشاء المشروع. يجب أن يكون المجلد موجوداً على القرص. أعد تشغيل AgentsRoom إذا أُضيف مشروع ولم يظهر بعد.

لقد قمت بتثبيت CLI لكن AgentsRoom لا يزال يقول "الأمر غير موجود"

يرث AgentsRoom متغير PATH من صدفة تسجيل الدخول (login shell) لديك، لا من طرفيتك التفاعلية. أغلق AgentsRoom تماماً، وافتح طرفية جديدة، وتأكد أن الـ CLI قابل للاستدعاء من جلسة صدفة جديدة (which claude)، ثم أعد تشغيل AgentsRoom.