Back to Article List

شغّل Claude Code و Codex على سيرفرك: الدليل المصوّر للتنصيب والتفعيل

تنصيب Claude Code و Codex على سيرفر VPS وإضافة Codex في VS Code | مرام هوست - شغّل Claude Code و Codex على سيرفرك: الدليل المصوّر للتنصيب والتفعيل

صار بإمكانك اليوم أن تصف برنامجاً بالكلام فيُكتب لك. الأداتان الأشهر في هذا المجال — Claude Code من Anthropic وCodex من OpenAI — لا تعملان داخل المتصفح، بل في سطر أوامر على جهاز يشتغل بلينكس. وهنا يبدأ السؤال الذي يصلنا كثيراً: «أين أشغّلها؟».

هذا الدليل يجيب عن السؤال عملياً. سنأخذ سيرفراً حقيقياً، وننصّب عليه الأداتين خطوة بخطوة، ونمرّ على شاشة الاشتراك والتفعيل صورةً بصورة. ثم نعيد العمل نفسه بطريقة ثانية لمن يفضّل الواجهات الرسومية: إضافة Codex داخل VS Code مربوطة بالسيرفر نفسه. وننهي بالجزء الذي يقرّر النتيجة فعلاً: كيف تكتب الطلب — من يكتبه، وممّ يتكوّن، وكيف تقسّمه، وماذا يفعل الوكيل بعد أن تضغط Enter. كل لقطة في هذا المقال مأخوذة من جلسة حقيقية على سيرفر مرام — لا رسوم توضيحية ولا واجهات مُعاد رسمها.

لمن هذا المقال؟ لمن لا يعرف البرمجة أصلاً، ولمن يعرفها ويريد بيئة عمل جاهزة. لا يُفترض فيك سوى أنك تستطيع نسخ أمر ولصقه.

لماذا على سيرفر، لا على حاسبتك؟

يمكنك فعلاً تنصيب الأداتين على حاسبتك الشخصية. لكن أربعة أسباب تجعل السيرفر الخيار الأفضل عندما يكون هدفك برنامجاً يعمل لا تجربة عابرة:

  • البرنامج يُبنى في البيئة نفسها التي سيعمل فيها. عندما يكتب لك الوكيل برنامجاً على لينكس ويشغّله على لينكس، تختفي الطبقة الأكثر إرهاقاً للمبتدئ: «اشتغل عندي ولم يشتغل على السيرفر».
  • العمل لا يتوقف بإغلاق حاسبتك. الجلسة تبقى قائمة على السيرفر، وتعود إليها من أي جهاز — حتى من الهاتف.
  • لا يعتمد على مواصفات جهازك. تصفح، وتثبيت الحزم، وتشغيل قاعدة البيانات، كلها تجري على موارد السيرفر.
  • الاتصال بخوادم الأدوات أسرع وأثبت. سيرفراتنا في بريطانيا على ربط دولي مباشر؛ قِسنا زمن الوصول إلى خوادم الأداتين من داخل الجهاز التجريبي فكان حوالي 50 ملّي ثانية لكليهما، كما سترى في الصورة الثالثة.

الخطوة صفر: ماذا تحتاج قبل أن تبدأ؟

ما تحتاجهالتفاصيل
سيرفر VPS بنظام لينكسأوبنتو 24.04 مناسب تماماً. الحد الأدنى العملي: نواتان و4 غيغابايت ذاكرة. المريح: 4 أنوية و8 غيغابايت.
اشتراك في إحدى الأداتينClaude Pro أو ChatGPT Plus يكفي للبداية — التفاصيل والأسعار في قسم مستقل أدناه.
برنامج طرفيةويندوز 10 و11 فيهما ssh جاهز داخل PowerShell. على الماك ولينكس استعمل Terminal.
وسيلة دفع دوليةالاشتراكان يُدفعان ببطاقة دولية. هذه أكثر نقطة يتعثّر فيها القارئ في العراق — تكلّمنا عنها بصراحة في آخر المقال.

الجهاز الذي بنينا عليه هذا الدليل هو باقة S-VPS 4: أربعة أنوية، و8 غيغابايت ذاكرة، و250 غيغابايت تخزين SSD.

صفحة باقات VPS في مرام هوست تعرض أربع باقات S-VPS بمواصفاتها وأسعارها الشهرية
الصورة 1 — باقات S-VPS كما تظهر في صفحة الطلب. اخترنا الرابعة لأن وكيل الذكاء الاصطناعي يفتح ملفات كثيرة ويبني ويشغّل في الوقت نفسه

كيف تطلب السيرفر؟ خمس دقائق

لا تحتاج معرفة تقنية لطلب السيرفر — الخطوات أقرب إلى شراء اشتراك إنترنت منها إلى أي شيء تقني:

  1. افتح صفحة باقات VPS واختر الباقة المناسبة (الجدول أدناه يساعدك).
  2. في صفحة الإعداد اختر نظام التشغيل — اختر Ubuntu-24، فهو ما تعمل عليه الأدوات بأقل مشاكل.
  3. اختر دورة الفوترة: شهري، أو سنوي بخصم يقارب السُّبع.
  4. أضف إلى السلة، وادفع بالدينار العراقي عبر زين كاش أو بطاقة فيزا وماستركارد.
  5. خلال دقائق تصلك رسالة فيها عنوان الجهاز واسم المستخدم وكلمة المرور — ومنفذ الدخول 2026.
صفحة إعداد الطلب في مرام هوست تعرض مواصفات باقة S-VPS 4 وخيار دورة الفوترة الشهرية والسنوية واختيار نظام التشغيل وعدد النسخ الاحتياطية
صفحة إعداد الطلب — وفيها الخياران الوحيدان اللذان يهمّانك فعلاً: نظام التشغيل ودورة الفوترة. الباقي مضبوط مسبقاً

أي باقة تختار؟

الباقةالمواردالشهريهل تصلح للعمل مع الوكيل؟
S-VPS 2نواة · 2 غيغابايت8 دولاراتلا للبناء. تصلح لاستضافة البرنامج بعد أن يكتمل ويخفّ.
S-VPS 3نواتان · 4 غيغابايت17 دولاراًالحد الأدنى العملي. يعمل، مع بطء محسوس في المهام الطويلة.
S-VPS 44 أنوية · 8 غيغابايت29 دولاراًالمريح — وهو ما بنينا عليه كل مقالات هذه السلسلة.

لماذا لا تكفي أرخص باقة؟ لأن الوكيل لا يكتب سطراً وينتظر: يقرأ عشرات الملفات، ويشغّل التنصيب، ويرفع الخادم، ويختبر — في اللحظة نفسها. بنواة واحدة وغيغابايت واحد ستختنق الجلسة قبل أن تُنهي الطلب الثالث، وستظن أن الأداة ضعيفة بينما المشكلة في الجهاز.

الخطوة 1: ادخل إلى سيرفرك

بعد إتمام الطلب تصلك رسالة فيها عنوان الجهاز واسم المستخدم وكلمة المرور. افتح PowerShell على ويندوز واكتب (استبدل العنوان بعنوانك):

ssh -p 2026 [email protected]

انتبه إلى المنفذ. أجهزة مرام تستمع على المنفذ 2026 لا على 22 — هذا تشديد أمني مقصود. إن نسيت -p 2026 ستحصل على «Connection timed out» وتظن أن الجهاز معطّل وهو يعمل.

نافذة طرفية تُظهر أول اتصال SSH بالسيرفر ورسالة الترحيب الخاصة بأوبنتو مع معلومات النظام
الصورة 2 — أول دخول. الرسالة التي تظهر لك هي رسالة أوبنتو القياسية، وفيها لمحة سريعة عن حالة الجهاز

تأكّد أنك في المكان الصحيح بثلاثة أوامر: نسخة النظام، وعدد الأنوية والذاكرة، والمساحة. وأضفنا أمرين رابعاً وخامساً يقيسان زمن الوصول إلى خوادم الأداتين — وهما اللذان يهمّاننا هنا:

طرفية تعرض نسخة أوبنتو وعدد الأنوية والذاكرة والمساحة وزمن الوصول إلى خوادم Anthropic وOpenAI
الصورة 3 — الجهاز: أوبنتو 24.04.4، أربعة أنوية، 7.6 غيغابايت ذاكرة متاحة، 242 غيغابايت مساحة. والسطران الأخيران يقيسان الوصول إلى خوادم الأداتين: نحو 50 ملّي ثانية لكليهما

رمز 404 و421 في الصورة ليسا خطأً — بل دليل نجاح. الخادم ردّ فعلاً، وهذا كل ما نريد إثباته في هذه المرحلة.

الخطوة 2: نصّب Node.js ثم الأداتين

كلتا الأداتين تُوزَّعان عبر npm، ولذلك نبدأ بتنصيب Node.js بنسخته الحديثة:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v && npm -v

ثم — وهذه خطوة صغيرة توفّر عليك متاعب كثيرة — اجعل حزم npm العامة تُنصَّب داخل مجلد المستخدم بدل مجلدات النظام، حتى لا تحتاج sudo في كل تحديث:

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

والآن الأداتان، بأمرين:

npm install -g @anthropic-ai/claude-code
npm install -g @openai/codex
طرفية تعرض تنصيب Node.js ثم تنصيب Claude Code وCodex ونتيجة فحص الإصدارات
الصورة 4 — التنصيب كله استغرق ثوانيَ معدودة. النتيجة: Claude Code 2.1.283 وcodex-cli 0.158.0

لاحظ حجم العملية: حزمتان فقط لكل أداة، وثلاث ثوانٍ وستّ ثوانٍ. لا يوجد ما يمكن أن «ينكسر» هنا.

الخطوة 3: الاشتراك — من أين تحصل عليه وبكم؟

هذه هي النقطة التي يتوقف عندها أكثر الناس، فلنكن دقيقين فيها. الأداتان مجانيتان في التنصيب، لكنهما تحتاجان حساباً مدفوعاً لتعملا. وأمامك مساران:

المسار الأول: اشتراك شهري (الأنسب للأغلبية)

تشترك في الخدمة نفسها التي تستعملها من المتصفح، والأداة في الطرفية تستهلك من الحصة ذاتها. لا فاتورة منفصلة ولا مفاجآت في آخر الشهر.

الخطةالسعر الشهريملاحظات
Claude Pro20 دولاراً‏17 دولاراً إذا دفعت سنوياً. يشمل Claude Code بالحصة نفسها.
Claude Maxمن 100 دولارحصة أكبر بكثير، بمستويين. للعمل اليومي المكثّف.
ChatGPT Go8 دولاراتأرخص مدخل، والحصة محدودة.
ChatGPT Plus20 دولاراًيشمل Codex. المقابل المباشر لـClaude Pro.
ChatGPT Proمن 100 دولاربمستويين أيضاً، حصص أعلى بكثير.

الأسعار كما هي معلنة على الموقعين الرسميين عند كتابة هذا المقال في أيلول 2026 — راجعها قبل الشراء.

المسار الثاني: مفتاح API بالدفع حسب الاستهلاك

بدل الاشتراك الشهري، تشحن رصيداً وتدفع مقابل ما تستهلكه فعلاً. مناسب إن كان استعمالك متقطعاً، ومكلف إن كان يومياً. للمقارنة، هذه أسعار نماذج Claude لكل مليون token:

النموذجالمدخلات (لكل مليون)المخرجات (لكل مليون)
Claude Opus 55 دولارات25 دولاراً
Claude Sonnet 5دولاران10 دولارات
Claude Haiku 4.5دولار واحد5 دولارات

نصيحتنا: ابدأ باشتراك شهري واحد بـ20 دولاراً. لا تشترك في الاثنين معاً في الشهر الأول، ولا تبدأ بمفتاح API — الاشتراك يعطيك سقفاً معروفاً، والمفتاح يعطيك فاتورة مفتوحة قبل أن تعرف عاداتك في الاستعمال.

التفعيل على السيرفر: Claude Code

شغّل الأمر claude في أي مجلد. سيسألك أول مرة عن شكل الألوان، ثم يعرض عليك طرق الدخول الثلاث:

شاشة Claude Code تعرض ثلاث طرق لتسجيل الدخول: حساب باشتراك، حساب كونسول بالدفع حسب الاستهلاك، أو منصة طرف ثالث
الصورة 5 — الخيار الأول هو الاشتراك الشهري، والثاني هو مفتاح API. اختر الأول إن كنت تتبع نصيحتنا أعلاه

بعد اختيارك يحاول البرنامج فتح المتصفح. لن ينجح طبعاً — أنت داخل سيرفر بلا واجهة رسومية — فيعرض لك بدلاً من ذلك رابطاً تفتحه في متصفح حاسبتك:

شاشة Claude Code تعرض رابط تسجيل الدخول وحقلاً للصق الكود
الصورة 6 — انسخ الرابط إلى متصفحك، وافق على الطلب، ثم انسخ الكود الذي يظهر لك والصقه في السطر الأخير. هذه هي كل عملية التفعيل

التفعيل على السيرفر: Codex

شغّل codex فتظهر لك ثلاثة خيارات مشابهة:

شاشة Codex تعرض ثلاثة خيارات لتسجيل الدخول: عبر ChatGPT، أو بكود جهاز، أو بمفتاح API
الصورة 7 — الخيار الأول يفترض وجود متصفح على الجهاز نفسه؛ وعلى سيرفر بعيد اختر الثاني

هذه أهم معلومة في المقال كله لمستخدمي Codex: الخيار الأول (Sign in with ChatGPT) يفتح خادماً محلياً على السيرفر وينتظر متصفحاً لن يأتي. الخيار الثاني (Sign in with Device Code) يعطيك كوداً قصيراً تُدخله من أي جهاز آخر — وهو الطريقة الصحيحة للسيرفرات.

شاشة Codex تعرض رابط تفعيل الجهاز وكوداً من ثمانية أحرف صالحاً لخمس عشرة دقيقة
الصورة 8 — افتح الرابط من هاتفك أو حاسبتك، أدخل الكود، وتكتمل الجلسة على السيرفر تلقائياً. الكود صالح خمس عشرة دقيقة فقط

الطريقة الثانية: إضافة ChatGPT / Codex داخل VS Code

كل ما سبق كان في سطر الأوامر. وإن كنت تفضّل واجهة رسومية — وأغلب المبتدئين يفضّلونها — فهناك طريق ثانٍ يعطيك النتيجة نفسها: تعمل من محرّر VS Code على حاسبتك، بينما المشروع والأوامر تجري على سيرفرك.

1) ثبّت الإضافة

افتح VS Code، ثم لوحة الإضافات (Extensions)، وابحث عن Codex. الإضافة الصحيحة ناشرها OpenAI ومعرّفها openai.chatgpt — انتبه، فهناك إضافات مقلّدة بأسماء مشابهة.

صفحة إضافة Codex من OpenAI داخل VS Code تعرض اسم الناشر ومعرّف الإضافة وعدد التنزيلات ووصف الإضافة
الصورة 9 — صفحة الإضافة داخل VS Code. لاحظ المعرّف openai.chatgpt وعلامة التوثيق بجانب اسم الناشر، والسطر الذي يقول إنها مشمولة بخطط Plus وPro وBusiness

ويمكنك تثبيتها بأمر واحد بدل البحث، إن كان code مضافاً إلى مسار النظام:

code --install-extension openai.chatgpt

2) لوحة الوكيل تظهر في جانب المحرّر

بعد التثبيت تجد لوحة جديدة فيها حقل «Describe what to build». هنا تكتب ما تريد بالعربية أو الإنجليزية، وتختار من الأسفل ما إذا كان التنفيذ محلياً (Local)، ومستوى الصلاحيات الذي تمنحه للوكيل (Approvals).

لوحة Codex داخل VS Code بعد التثبيت وفيها حقل وصف ما تريد بناءه وخيارات التنفيذ والصلاحيات
الصورة 10 — لوحة الوكيل بعد التثبيت مباشرة. عند أول استعمال ستطلب منك تسجيل الدخول بحساب ChatGPT نفسه

مستوى الصلاحيات هو أهم إعداد هنا. الوكيل يستطيع تعديل الملفات وتشغيل الأوامر. ابدأ بالوضع الافتراضي الذي يسألك قبل كل عملية حسّاسة، ولا ترفع الصلاحيات إلى «نفّذ بلا سؤال» إلا بعد أن تفهم ما يفعله — وعلى مشروع لا يضرّك فقدانه.

3) اربط المحرّر بسيرفرك — وهنا يكتمل المعنى

حتى الآن الإضافة تعمل على حاسبتك. الخطوة التي تجعلها تعمل على سيرفرك هي إضافة Remote - SSH من مايكروسوفت. ثبّتها بالأمر:

code --install-extension ms-vscode-remote.remote-ssh

ثم أضف سيرفرك إلى ملف إعدادات ssh على حاسبتك — C:\Users\اسمك\.ssh\config على ويندوز أو ~/.ssh/config على ماك ولينكس:

Host maram-vps
    HostName 51.241.185.8
    User maram
    Port 2026

بعدها افتح لوحة الأوامر واختر Remote-SSH: Connect to Host ثم maram-vps. سينزّل VS Code خادمه الصغير على جهازك البعيد أول مرة (نحو 300 ميغابايت، دقيقة أو أقل)، ثم تفتح مجلد مشروعك على السيرفر كأنه على حاسبتك.

نافذة VS Code متصلة بسيرفر مرام عبر SSH تعرض ملفات المشروع على السيرفر ولوحة Codex جاهزة إلى جانبها
الصورة 11 — هذا هو الشكل النهائي: شريط العنوان يقول pos-demo [SSH: maram-vps]، والمستكشف يعرض ملفات المشروع الموجودة فعلاً على السيرفر، والزاوية السفلى اليسرى تؤكّد الاتصال — ولوحة الوكيل جاهزة إلى جانبها

ما الذي تغيّر؟ كل شيء تفعله الآن — فتح الملفات، وتشغيل الطرفية، وتنفيذ أوامر الوكيل — يجري داخل السيرفر، لا على حاسبتك. حاسبتك صارت شاشة ولوحة مفاتيح فقط، وهذا بالضبط ما نريده: تغلق حاسبتك، ويبقى مشروعك حيث هو.

أيّهما تختار: الطرفية أم الإضافة؟

الطرفية (claude / codex)إضافة VS Code
المستوى المناسبمن يريد أخف طريقة وأسرعهامن يريد رؤية الملفات والتعديلات بعينه
رؤية التغييراتنصّية داخل الجلسةمقارنة ملوّنة قبل القبول
يعمل من الهاتفنعم، عبر أي تطبيق SSHلا
يحتاج تنصيباً على السيرفرالأداة نفسها فقطخادم VS Code (نحو 300 ميغابايت)
يكمل العمل بعد إغلاق الجهازنعم مع tmuxينقطع عند إغلاق النافذة

نصيحتنا: ابدأ بالإضافة إن كنت مبتدئاً — الواجهة تشرح نفسها. وتعلّم الطرفية بعد أسبوع، لأنها هي التي تتيح لك ترك مهمة طويلة تعمل وأنت نائم.

كيف تستخدم الأداة وأنت لست مبرمجاً؟

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

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

كيف تجري الجلسة عملياً؟

تدخل إلى سيرفرك، وتنتقل إلى مجلد المشروع، وتكتب اسم الأداة — فتفتح شاشة تكتب فيها طلبك بالعربية. ثم تتكرّر أربع خطوات:

  1. تكتب الطلب وتضغط Enter.
  2. يعرض عليك خطة قبل التنفيذ في المهام غير البديهية — اقرأها. إن رأيت فيها ما لم تطلبه، قل «لا تفعل كذا» قبل أن يبدأ.
  3. يطلب إذنك عند كل عملية حسّاسة: إنشاء ملف، تعديل ملف، تشغيل أمر. هذه لحظتك — الموافقة ليست شكلية.
  4. تفتح الصفحة في متصفحك وتجرّب. ما لم تجرّبه بنفسك لا تعتبره منجزاً، مهما قال لك إنه انتهى.

الأوامر التي تحتاجها فعلاً

الأدوات فيها عشرات الخيارات، لكن ما ستستعمله يومياً لا يتجاوز هذه:

نافذة طرفية تعرض أهم أوامر Claude Code وCodex: بدء جلسة، ومتابعة آخر جلسة، واستعراض الجلسات السابقة، والمراجعة، وفحص التنصيب
هذه كل الأوامر التي تحتاجها في الأسابيع الأولى — والباقي تتعلّمه عند الحاجة إليه

أهمّها --continue وresume: الجلسة تحتفظ بذاكرتها، فتستطيع أن تغلق حاسبتك وتعود غداً وتكمل من حيث توقّفت — والوكيل يتذكّر المشروع كله.

أربع قواعد تغنيك عن تعلّم البرمجة

القاعدةالتطبيق
اطلب مهمة واحدةشاشة واحدة أو ميزة واحدة في كل طلب — لا «ابنِ لي النظام»
جرّب بعد كل خطوةافتح الصفحة واضغط الأزرار. خمس دقائق تجربة توفّر ساعة تصحيح
صف العطل لا الحل«أضغط حفظ فتختفي الفاتورة» أفضل بكثير من «غيّر الدالة الفلانية»
خذ نسخة قبل الطلبات الكبيرةنسخة من مجلد المشروع، أو git init مرة واحدة — فتكون تكلفة أي خطأ صفراً

وإن تعطّل شيء ولم تفهم السبب؟ انسخ رسالة الخطأ كما هي والصقها في الجلسة واكتب: «هذا ما ظهر لي، ما المشكلة وكيف نصلحها؟». الوكيل يقرأ الأخطاء أفضل ممّا يقرأها كثير من المبرمجين — ورسالة الخطأ هي نصف الحل.

البرومبت: المهارة الوحيدة التي عليك إتقانها

وصلت الآن إلى أداة جاهزة تنتظر أن تكلّمها. وهنا تنتقل المسألة كلها من التقنية إلى شيء آخر تماماً: كيف تصف ما تريد. هذا الوصف اسمه «البرومبت» (Prompt)، وهو الفرق الحقيقي بين من يخرج ببرنامج يعمل ومن يخرج بفوضى ملفات لا يفهمها.

من يكتب البرومبت؟ أنت — لا المبرمج

هذه أول مفاجأة للكثيرين. في المشروع التقليدي أنت تشرح للمبرمج، والمبرمج يترجم كلامك إلى كود. مع الوكيل، الترجمة صارت مجانية، وبقي الجزء الذي لا يستطيع أحد أن يؤدّيه عنك: معرفة تفاصيل عملك.

لا أحد يعرف مثلك أن زبونك يشتري بالآجل أحياناً، وأن البيع بالجملة له سعر مختلف، وأن شهر محرّم موسم راكد عندك، وأن الفاتورة يجب أن تُطبع بمقاس معيّن لأن طابعتك كذلك. هذه المعلومات هي المشروع فعلاً — والكود مجرّد قالب يصبّها فيه. لذلك:

صاحب العمل أفضل من يكتب البرومبت، لا الأكثر معرفة بالبرمجة. اكتب بالعربية بلا خجل — الأداتان تفهمانها جيداً — واترك المصطلحات التقنية بالإنجليزية كما هي.

من أي أجزاء يتكوّن الطلب الجيد؟

البرومبت الجيد ليس طويلاً، بل كامل. خمسة أجزاء تكفي، وكل جزء منها يمنع نوعاً معيّناً من الخطأ:

مخطط يوضح الأجزاء الخمسة للبرومبت الجيد: السياق والهدف والقيود ومعيار النجاح وصيغة الإخراج مع مثال لكل جزء
الصورة 12 — الأجزاء الخمسة. أكثر جزء يُنسى هو الرابع، وهو أهمّها كما سترى بعد قليل

ولترى الفرق بعينك، هذا الطلب نفسه مكتوباً بطريقتين — ونتيجة كلٍّ منهما:

مقارنة بين طلب ضعيف وطلب واضح لبناء برنامج مبيعات، وما ينتج عن كل منهما
الصورة 13 — الطلب الضعيف لا يُنتج نتيجة أسوأ فحسب، بل يُنتج نتيجة لا تستطيع تصحيحها لأنك لا تفهم ما بُني

مراحل كتابة الطلب — ولماذا لا تكتبه دفعة واحدة

الخطأ الأشيع عند المبتدئين هو أن يكتب فكرة المشروع كلها في رسالة واحدة طويلة. النتيجة دائماً نفسها: الوكيل ينتج عشرات الملفات مرة واحدة، ولا تعرف أيّها يعمل وأيّها لا. المسار الصحيح تدريجي:

مخطط بست مراحل لكتابة الطلب: من صياغة الفكرة بالعامية إلى التصحيح بلغة النتيجة
الصورة 14 — ستّ مراحل. المرحلة الرابعة هي التي يتجاوزها الجميع، وهي التي تحدّد نجاح المشروع

وانتبه إلى المرحلة السادسة تحديداً: عندما يخطئ البرنامج، صف العطل ولا تصف الحل. «أضغط زرّ الحفظ فتختفي الفاتورة ولا تظهر في التقرير» تعطي الوكيل ما يحتاجه ليبحث. أما «غيّر الدالة الفلانية» فتحوّلك إلى مبرمج نصف متعلّم يقود مبرمجاً كاملاً — وهذه أسوأ تركيبة ممكنة.

ماذا يحدث فعلاً بعد أن تضغط Enter؟

من المفيد أن تعرف أن الوكيل لا «يكتب نصّاً» فقط. هو يقرأ مشروعك، ويضع خطة، ويعدّل ملفات، ويشغّل أوامر في الطرفية، ويقرأ الأخطاء، ويعيد المحاولة — ثم يتوقف عندك لطلب الإذن:

مخطط يشرح دورة عمل الوكيل: يقرأ ثم يخطط ثم يكتب ثم يشغّل ثم يقرأ الخطأ ثم ينتظر موافقتك
الصورة 15 — هذه الحلقة هي سبب التسمية «وكيل» لا «مساعد». وهي أيضاً سبب أهمية معيار النجاح: بدونه لا يعرف متى يتوقف

البرومبت الدائم: ملف تعليمات المشروع

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

  • CLAUDE.md ‏— يقرؤه Claude Code
  • AGENTS.md ‏— يقرؤه Codex

مثال لمحتوى مناسب لمتجر عراقي:

# قواعد هذا المشروع

- كل المبالغ بالدينار العراقي، بلا كسور.
- التاريخ ميلادي بصيغة يوم/شهر/سنة.
- واجهة الموقع عربية من اليمين إلى اليسار.
- لا تضف أي مكتبة خارجية قبل أن تسألني.
- لا تعدّل ملف قاعدة البيانات مباشرة.

خمسة أسطر كهذه تمنع عشرات الأخطاء المتكرّرة، وهي أعلى مردود لأي دقيقة تقضيها في الكتابة.

عبارات تُبطئك — وبدائلها

بدل أن تقولقللماذا
«حسّن البرنامج»«اجعل صفحة الفواتير تفتح بأقل من ثانية»«التحسين» بلا مقياس يجعله يغيّر أشياء لم تطلبها
«سوّه احترافي»«أضف شعاراً في الأعلى وألواناً بيضاء وعنّابية»الاحترافية ذوق، والذوق يجب أن يُوصف
«ما يشتغل، صلّحه»«أضغط حفظ فتظهر رسالة كذا، وهذا نصّها»رسالة الخطأ نصفُ الحل
«كمّل الباقي»«الآن أضف شاشة تقرير اليوم فقط»«الباقي» غامض، والغموض يُنتج ملفات لا تحتاجها
«غيّر الدالة كذا»«النتيجة الظاهرة خطأ — المفروض كذا»أنت صاحب النتيجة، وهو صاحب الكود

قاعدة الأمان قبل أي طلب كبير: اطلب منه أولاً «اشرح لي خطتك قبل أن تنفّذ»، واقرأ الخطة. ثم خذ نسخة من مشروعك — أو فعّل git في مجلده — قبل أن تأذن له بالتنفيذ. الوكيل يخطئ أحياناً بثقة، وتكلفة التراجع صفر إن كنت قد أخذت نسخة، وباهظة إن لم تفعل.

أخطاء شائعة تُضيّع ساعة على المبتدئ

ما تراهالسبب الحقيقيالحل
Connection timed outنسيت المنفذ 2026أضف -p 2026 إلى أمر ssh
claude: command not foundمجلد npm ليس في المسارأعد فتح الجلسة أو نفّذ source ~/.bashrc
الدخول بالمتصفح لا يكتمل في Codexاخترت الخيار الأول على سيرفر بعيداخرج واختر Device Code
انتهت صلاحية الكودمدّة كود الجهاز خمس عشرة دقيقةأعد تشغيل الأمر ليولّد كوداً جديداً
البرنامج يعمل على السيرفر ولا يفتح من المتصفحجدار الجهاز يسمح بالمنافذ 80 و443 و2026 فقطشغّل تطبيقك خلف المنفذ 80 أو 443، أو اطلب فتح منفذ من الدعم
VS Code يسألك عن نظام الجهاز البعيد في كل اتصاللم يحفظ نوع النظام للمضيفأضف في الإعدادات: "remote.SSH.remotePlatform": {"maram-vps": "linux"}
Disconnected from SSH بعد الاتصال مباشرةمهلة الاتصال قصيرة أثناء تنزيل خادم VS Code أول مرةارفع remote.SSH.connectTimeout إلى 120 وأعد المحاولة

ملاحظة صريحة عن الدفع من العراق

الاشتراكان يُدفعان ببطاقة دولية، وهذه عقبة حقيقية لكثير من القرّاء في العراق. لا نملك حلاً سحرياً لها، لكن نقول بوضوح ما نعرفه: البطاقات الدولية الصادرة من المصارف المحلية تعمل مع بعض الخدمات وتُرفض مع أخرى، والنتيجة تختلف من مصرف إلى آخر ومن شهر إلى آخر. جرّب بطاقتك على خطة شهر واحد قبل أن تلتزم بخطة سنوية، ولا تشترِ من وسيط يطلب منك بيانات حسابك.

أما السيرفر نفسه فتشتريه من مرام بالدينار العراقي عبر بوابات الدفع المحلية — وهذا نصف الطريق مقضيّ.

لماذا يهمّ العتاد أكثر ممّا تظن

ينتهي كثير من المقالات عند «اشترِ أي سيرفر». نحن نختلف مع هذا، ولدينا سبب رقمي.

زمن الشبكة بين العراق وسيرفر خارجي يقع عادةً بين 70 و150 ملّي ثانية. أما زمن توليد الصفحة داخل السيرفر — أي الوقت الذي يقضيه المعالج والقرص في تجهيز الجواب — فيتراوح بين 150 ملّي ثانية وأكثر من ثانيتين حسب العتاد. بعبارة أخرى: المسافة تكلّفك عشرات الملّي ثانية، والعتاد الضعيف يكلّفك آلافاً.

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

لذلك لا تسأل «أين يقع السيرفر؟» وحدها. اسأل أيضاً: ما المعالج؟ وكم نواة وذاكرة؟ وما نوع التخزين؟ واطلب الأرقام من أي مزوّد قبل الشراء — نحن نعرضها في صفحة كل باقة.

السلسلة كاملة: عشرة أنظمة حقيقية

هذا المقال هو الأساس، وعليه تقوم سلسلة بنينا فيها عشرة أنظمة عربية كاملة على سيرفر واحد — كلها تعمل فعلاً، وكل مقال فيها يعطيك نصّ كل طلب جاهزاً للنسخ مع صور النتيجة:

  1. نظام مبيعات ومخزون — المنتجات وشاشة البيع والفاتورة وتقرير الأرباح اليومي
  2. نظام حسابات وفواتير — العملاء والموردون وكشف الحساب وتقرير يفصل «ما ربحتَه» عن «ما قبضتَه»
  3. نظام إدارة عيادة — المرضى والمواعيد والسجل الطبي التراكمي وقائمة من تتصل بهم للمراجعة
  4. نظام إدارة مدرسة — الطلاب والحضور والدرجات والأقساط وتقرير طالب يُطبع لولي الأمر
  5. متجر إلكتروني عراقي — المحافظات وأجور التوصيل والدفع عند الاستلام ونسبة الإلغاء
  6. نظام مطعم وكاشير وتوصيل — منيو بهامش الربح وشاشة مطبخ وطلبات صالة وسفري وتوصيل
  7. نظام مكتب عقارات — العقارات والزبائن ومطابقة تعطي درجة مئوية وحساب العمولات
  8. نظام إدارة عملاء (CRM) — مسار الصفقات والمتابعات المتأخّرة وسجل التواصل وأسباب الخسارة
  9. نظام شركة إنترنت — المشتركون والتحصيل حسب المحصِّل والتذاكر وصحّة الأبراج
  10. نظام حجوزات ومواعيد — صفحة حجز عامة وأجندة يومية وتقرير ساعة الذروة وعدم الحضور

كل مقال منها مستقل، لكنها جميعاً تبدأ من النقطة التي وصلت إليها في هذا الدليل. ابدأ بالأقرب إلى عملك، ولا تقرأها كلها دفعة واحدة.

وإن أردت أن تبدأ الآن: اطّلع على باقات VPS واختر الباقة التي تناسب مشروعك — والتنصيب كله لا يتجاوز الخطوات التي رأيتها أعلاه.

Powered by WHMCompleteSolution