التثبيت: VS Code وإضافة مجانية
درس 2 من 12
2التثبيت: VS Code وإضافة مجانية
أول تثبيت لك: المحرر، ثم إضافة، ثم مفتاح API، ومعه أهم درس أمني في المسار كله: أين يُحفظ المفتاح وأين لا.
ماذا تشاهد في الرسم: تثبّت المحرّر، ثم الإضافة، ثم تضع مفتاح API في متغيّر بيئة بعيدًا عن الكود، ثم تتأكّد بسؤال تجريبي.
خارطة هذا الجزء
المفاهيم بالترتيب، اضغط أيًّا منها للقفز إليه:
طريقان إلى نفس الفكرة
الإضافة مثل تطبيق تثبّته على جوالك ليضيف له قدرة جديدة. ومفتاح الواجهة البرمجية مثل بطاقة الدخول إلى مبنى: من يملكها يدخل باسمك ويُحاسب عليك. لهذا لا تلصقها في الكود ولا ترسلها لأحد، بل تحفظها في مكان سري خاص بها.
الإضافة extension حزمة تضيف ميزات لـVS Code من سوق الإضافات. مفتاح API سرّ يصادق طلباتك لدى مزوّد النموذج ويُحتسب عليه الاستهلاك. يُحفظ في متغير بيئة أو ملف .env مدرج في .gitignore أو في مخزن أسرار المحرّر، وتتأكد أن الإضافة تعمل بطلب صغير تعرف جوابه.
المتطلبات قبل البداية
اتصال وصلاحية تثبيت
تحتاج تنزيل برنامج على جهازك. لو كان جهاز عمل بصلاحيات محدودة فقد تحتاج إذن المسؤول.
مساعد المتصفّح من الجزء الأول
هنا يبدأ دوره الحقيقي: كل رسالة خطأ تواجهك، الصقها له واسأل «كيف أصلحها خطوة بخطوة كمبتدئ؟»
حساب Google (اختياري)
لو اخترت Continue.dev أو Cline فستحتاج مفتاحًا مجانيًا من Google AI Studio. ولو اخترت Codeium فلا تحتاج شيئًا.
المفاهيم الأساسية
المهمة الأولى عملية بحتة: محرر يعمل + إضافة ذكاء اصطناعي تعمل. لكن تحتها مفهومان يستحقّان الوقوف.
1ما هي «الإضافة» (extension)؟
الإضافة برنامج صغير يُركّب داخل VS Code فيضيف له قدرة لم تكن موجودة. VS Code نفسه محرر نصوص متقن، وكل ما عداه، دعم لغة، مصحّح، ذكاء اصطناعي، يأتي من الإضافات. ولهذا هو الأشهر: تبنيه أنت على مقاسك.
اللوحة تُفتح بأيقونة المربّعات الأربعة على الجانب أو بـ Ctrl+Shift+X (وCmd على الماك).
2ما هو «مفتاح API»؟
النموذج اللغوي لا يعمل على جهازك، يعمل على خوادم الشركة التي تملكه. فالإضافة في محرّرك تحتاج طريقة لتقول لتلك الخوادم «أنا مسموح لي». مفتاح الـAPI نص سرّي طويل يفعل هذا بالضبط: يُثبت هويتك ويُحسب الاستخدام عليك.
3أي إضافة تختار؟
| الإضافة | مفتاح API | تتميّز بـ | مناسبة إذا |
|---|---|---|---|
Codeium | لا تحتاج | نموذج مجاني مدمج | تريد أقل عدد خطوات بين التثبيت والنتيجة |
Continue.dev | نعم | مفتوحة المصدر وتختار النموذج | تحب تفهم ما يجري وتجرّب نماذج |
Cline | نعم | مبنية حول وضع الوكيل | يهمّك الجزء الرابع (الوكيل) تحديدًا |
والمشروع يذكر Continue.dev كمثال رئيس، لكنه يترك الاختيار لك صراحة. لو كنت تريد أن تنهي المهمة بأسرع طريقة فـCodeium أقلّها احتكاكًا؛ ولو كنت تريد أن تفهم المعمارية فـContinue.dev تُريك النموذج والإعدادات.
4كيف تعرف أنها تعمل؟
المشروع يعطيك اختبارين، وأحدهما يكفي:
- افتح ملفًا وابدأ الكتابة، وانتظر ثانية: هل يظهر نص رمادي باهت؟ هذا هو الإكمال السطري.
- افتح لوحة المحادثة واسأل سؤالًا بسيطًا مثل «Hello, are you there?»: هل جاء رد؟
كيف يعمل؟
شكلان: مسار التثبيت، ثم خريطة أماكن المفتاح.
شكل 3، مسار التثبيت كاملًا، بما فيه حلقة «ما ردّ؟ أعد التشغيل ثم اسأل».
شكل 4، أين يعيش مفتاح الـAPI وأين لا يعيش أبدًا. الخطوط المتقطعة أخطاء حقيقية تحدث يوميًا.
ما المطلوب منك بالضبط
المهمة الأولى، خطوة بخطوة
١. حمّل VS Code من code.visualstudio.com وثبّته. لو تعثّرت، اسأل مساعد المتصفّح: «كيف أثبّت VS Code على نظامي خطوة بخطوة كمبتدئ؟»
٢. افتح لوحة الإضافات بأيقونة المربّعات الأربعة أو Ctrl/Cmd+Shift+X، ثم ابحث عن اسم الإضافة واضغط Install.
٣. إن احتاجت مفتاحًا أنشئ واحدًا مجانيًا من Google AI Studio، والصقه في شاشة إعدادات الإضافة، لا في أي ملف.
(أو اختر Codeium وتخطّ هذه الخطوة تمامًا.)
٤. اختبرها. افتح أي ملف وابدأ الكتابة وانتظر ظهور النص الرمادي، أو افتح المحادثة واسأل «Hello, are you there?».
٥. إن لم يردّ: أعد تشغيل VS Code مرة واحدة أولًا. ثم إن بقي، انسخ نص الخطأ كما هو والصقه لمساعد المتصفّح مع سؤال: «جاني هذا الخطأ وأنا أجهّز إضافة الذكاء الاصطناعي في VS Code. كيف أصلحه خطوة بخطوة؟»
اعتقاد شائع × الحقيقة
| الاعتقاد | الحقيقة |
|---|---|
| «مفتاح الـAPI اسم مستخدم عادي.» | هو كلمة سر. من يملكه يستخدم حسابك وحصّتك. عامله كما تعامل كلمة سر بنكك. |
| «أحفظ المفتاح في ملف config داخل المشروع ليكون منظّمًا.» | هذا بالضبط كيف تتسرّب المفاتيح إلى git. المكان الصحيح: شاشة إعدادات الإضافة، أو متغيّر بيئة خارج المستودع. |
| «إذا ما ردّت الإضافة فهي معطوبة.» | غالبًا تحتاج إعادة تحميل النافذة فقط. المشروع يذكرها، وجرّبها قبل أن تبحث عن حل أعقد. |
| «يجب Continue.dev لأن المشروع ذكرها.» | المشروع ذكرها كمثال وسمح بـCline وCodeium صراحة. والاختيار جزء من الهدف. |
| «المجاني محدود فأحتاج اشتراكًا.» | كل الأدوات في قائمة المشروع مجانية وتكفي كل مهامه. وCursor يذكر صراحة أن خطة Hobby تغطي كل شيء هنا. |
جرّب بنفسك
ثبّتّ Continue.dev وأخذت مفتاحًا من Google AI Studio. أين تضعه؟
المفتاح كلمة سر. وضعه في ملف داخل المشروع يعني أن أول git push يدفعه إلى GitHub. الأماكن الآمنة الوحيدة: شاشة إعدادات الإضافة، أو متغيّر بيئة لا يُرفع. ولو تسرّب فعلًا، ألغِه فورًا من لوحة المفاتيح وأنشئ غيره.
بطاقات مراجعة سريعة
تحقّق من فهمك
1. لماذا يحتاج النموذج مفتاحًا أصلًا؟ أليس البرنامج على جهازي؟
الإضافة على جهازك، لكن النموذج نفسه على خوادم بعيدة. المفتاح هو ما يقول لتلك الخوادم من أنت، وعليه تُحسب الحصّة. (الاستثناء Codeium، الذي يدير هذا داخليًا بلا أن تراه.)
2. لو تسرّب مفتاحك في مستودع عام، ما أول شيء تفعله؟
ألغِه فورًا من لوحة المفاتيح ثم أنشئ غيره. لا يكفي حذفه من الملف ودفع commit جديد، تاريخ git يحتفظ بالنسخة القديمة، والبوتات تمسح GitHub بحثًا عن المفاتيح خلال دقائق.
3. (اكتشف الخطأ) ثبّتّ الإضافة والصقت المفتاح، وما فيه نص رمادي ولا رد. ما ترتيب فحصك؟
(١) أعد تحميل نافذة VS Code. (٢) تأكّد أن الإضافة مفعّلة لا مثبّتة فقط. (٣) تأكّد أن المفتاح نُسخ كاملًا بلا مسافة زائدة. (٤) انسخ أي خطأ ظاهر حرفيًا واسأل مساعد المتصفّح. الترتيب من الأرخص إلى الأغلى، هذه قاعدة تصحيح عامة.
4. هل اختيارك للإضافة قرار نهائي؟
لا، والمشروع نفسه يجعلك تجرّب محرّرًا ثانيًا في الجزء الخامس. تستطيع أن تثبّت أكثر من إضافة وتطفئ ما لا تريد. التكلفة الحقيقية ليست التثبيت بل تشتّت انتباهك بين أدوات كثيرة في وقت واحد.
5. (قرار) على حاسب العمل ليس عندك صلاحية تثبيت. ما خياراتك؟
ثلاثة: اطلب الإذن من المسؤول (الأنظف)، أو استخدم نسخة VS Code المحمولة إن كانت السياسة تسمح، أو اعمل على حاسبك الشخصي للمشروع التعليمي. وما يُنصح به هو ألّا تلتف على سياسة الجهاز، تسريب مفتاح على جهاز عمل مشكلة أكبر بكثير.