جهز عميلك الأول

مِنْ a تركيب جديد إلى a عامل آي. والجزءان اللذان يفتقدهما المبتدئان هما في القمة: كيف تتصل شركة AgentsRoom بشركة AI CLIs، وكيفية التوقيع عليها.

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

AgentsRoom هو قمرة القيادة. والمحركات هي: AI CLI (Claude Code, Codex, OpenCode, Antigravity, Aider, Grok Build, Mistral Vibe, Kimi Code). تَوقّعُ في إلى المحركاتِ مرّة عبر أمرِهم الخاصِ، ثمّ AgentsRoom يَقُودُهم بصرياً. AgentsRoom لا تخزن أو ترى رموزك، API keys أو ChatGPT كلمة السر: أولئك الذين يبقون داخل كل CLI الخاصة التخزين الآمن على جهازك.

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

قبل أن تبدأ

✓Windows 10 أو أحدث، أو macOS 14 أو أحدث (Sonoma)، أو توزيعة Linux حديثة بنظام 64 بت
✓
مركبة واحدة على الأقل من طراز AI تدوين CLI (Claude, Codex, OpenCode, OpenCode, Antigravity CLI or Aider or Grok Build or Mistral Vibe or Kimi Code)
npm install -g @anthropic-ai/claude-code
✓اشتراك نشط أو API key لمقدمكم المختار

الخطوة صفر: تركيب وتوقيع في محرك AI الخاص بك

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

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

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

يعمل مع

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

1. Install

npm install -g @anthropic-ai/claude-code

2- التوقيع

تشغيل كلود مرة في أي محطة طرفية. نافذة بروزر تفتح للتوقيع مع حسابك Anthropic.

3 - التحقق

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

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

يعمل مع

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

1. Install

npm install -g @openai/codex

2- التوقيع

تشغيل الشفرة مرة في أي محطة طرفية. نافذة مصففة مفتوحة وقّعْ في مَع حسابِكَ ChatGPT، نفس واحد تَستعملُ على الدردش آب.com.

3 - التحقق

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

يعمل مع

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

1. Install

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

2- التوقيع

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

3 - التحقق

OpenCodeأحضروا مزودكم الخاص

يعمل مع

أيّ مُقدّم تُصادره: Anthropic, OpenAI, OpenRouter, and more.

1. Install

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

2- التوقيع

أديروا سجلاً للوقود المفتوح وأتبعوا العجلات لإضافة مفتاح للمزود.

3 - التحقق

Aiderمستخدمو الطاقة

يعمل مع

أي مقدم عن طريق API key (Anthropic, OpenAI, DeepSeek and more).

1. Install

python -m pip install -U --upgrade-strategy only-if-needed aider-chat

2- التوقيع

لا يوجد أمر بالتسجيل ضعي جهازك (API key) كمتغير بيئي في ملفك، على سبيل المثال:.

3 - التحقق

Grok Build (xAI)سياق 256K

يعمل مع

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

1. Install

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

2- التوقيع

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

3 - التحقق

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

يعمل مع

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

1. Install

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

2- التوقيع

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

3 - التحقق

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

يعمل مع

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

1. Install

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

2- التوقيع

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

3 - التحقق

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

يعمل مع

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

1. Install

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

2- التوقيع

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

3 - التحقق

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

يعمل مع

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

1. Install

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

2- التوقيع

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

3 - التحقق

Freebuffبلا مفتاح

يعمل مع

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

1. Install

npm install -g freebuff

2- التوقيع

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

3 - التحقق

عالقة في هذه الخطوة؟ انظر قسم الاضطرابات في أسفل هذه الصفحة.

تحميل وتركيب AgentsRoom

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

Tip: AgentsRoom سيتم إخطارك عندما يكون هناك نسخة جديدة.

إنشاء مشروعك الأول

اضغط الزر + في الجانب. إختار أي ملف على آلتك هذا هو المكان الذي يعمل فيه وكلاء الاستخبارات سمّي مشروعكَ وإحالته إلى منطقة.

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

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

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

Tip: إذا كانت المحطة النهائية تبدو فارغة أو تظهر شاشة لوحات، لم يوقع عليها بعد. فتح محطة عادية، تشغيل كلود أو شفرة (أو قيادة مقدمك) مرة واحدة، إكمال الإشارة، ثم العودة.

شاهدْه يَعْملُ

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

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

اعتاد على تركيبك

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

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

الخدع والخدع

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

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

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

4.(إخطارات (إكس جي LOS66X12

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

الاضطرابات

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

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

الأمر الذي لم يعثر عليه: كلود (أو شفرة، جيميني، إلخ)

لم يتم تثبيت 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 من قذيفة الدخول الخاصة بك، وليس من طرفك التفاعلي. كويت AgentsRoom تماما، فتح محطة طرفية جديدة، والتحقق من CLI، يمكن الاتصال بها من دورة جديدة للقصف )التي تكلود(، ثم إعادة إطلاق AgentsRoom.