Git و GitHub

تجهيز · الحساب

اعمل حساب على github.com

الحساب مجاني وبتعمله من المتصفح. اسم المستخدم بيطلع برابط كل مستودعاتك، فاختار اسم بسيط وواضح.

1. افتح github.com/signupأو اختار Continue with Google إذا بتحب تسجّل بحساب Google.
2. اتبع الخطوات بالصفحةكلمة السر هاي لموقع GitHub بس، وما بتنكتب لـClaude أبداً.
3. اختار اسم مستخدمإذا الاسم محجوز، زيد عليه رقم أو شرطة، زي sara-2.
4. أكّد إيميلكGitHub بيطلب منك تأكيد الإيميل قبل ما يصير الحساب جاهز.
5. فعّل التحقق بخطوتينمن إعدادات الحساب بعد ما تخلص. هيك حسابك بيضل محمي حتى لو انكشفت كلمة السر.

عملت حساب جديد على GitHub.
اشرحلي خطوة خطوة كيف أفعّل التحقق بخطوتين (two-factor authentication) من إعدادات الحساب، وشو الطرق اللي بقدر أستخدمها.
ما تطلب مني كلمة السر، وما تفتح أي موقع باسمي.

تجهيز · المستودع

اعمل مستودع خاص

المستودع هو المكان اللي رح ينحفظ فيه مشروعك على GitHub. خلّيه خاص وفاضي تماماً، لأنه الملفات جاهزة على جهازك.

1. اضغط + فوق على اليمينوبعدها اختار New repository.
2. اكتب اسم المستودعحروف إنجليزية وأرقام بدون مسافات، زي recipes-app. البرومبت تحت بيساعدك تختار.
3. اختار Privateهيك ما بيشوفه إلا انت واللي بتعطيهم صلاحية.
4. ما تضيف ولا إشياترك README و.gitignore وlicense فاضيين، لأنهم بيعملوا تعارض مع مشروعك.
5. اضغط Create repositoryانسخ رابط المستودع اللي بينتهي بـ.git، لأنك رح تحطه ببرومبت الربط.

بدي أعمل مستودع على GitHub لهالمشروع، واسم المستخدم تبعي هو USERNAME.
1. اقترحلي اسم قصير للمستودع من اسم مجلد المشروع: حروف إنجليزية صغيرة وأرقام وشرطات بس.
2. أعطيني رابط المستودع الكامل اللي رح يطلع بعد ما أعمله.
ما تعمل المستودع بنفسك، بس اقترح.

تجهيز · الأسرار

مكان الأسرار

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

• ANTHROPIC_API_KEY=sk-ant-xxxxملف .env: القيمة الحقيقية، وبيضل على جهازك بس.
• ANTHROPIC_API_KEY=ملف .env.example: الاسم بدون القيمة، وبينرفع على GitHub.

رتّبلي الأسرار بهالمشروع:
1. دوّر على أي مفتاح API أو كلمة سر مكتوبة جوّا الكود، واحكيلي وين بدون ما تطبعها.
2. انقلها لملف .env، وخلّي الكود يقرا منه.
3. اعمل ملف .env.example فيه نفس الأسماء بدون القيم.
4. تأكّد إنه .env موجود بـ.gitignore، وإنه .env.example مش مستثنى.
اعرضلي كل تعديل قبل ما تعمله.

تجهيز · جهاز جديد

رجّع ملف .env

الـpull والـclone ما بيجيبوا ملف .env، لأنه أصلاً مش على GitHub. احفظ القيم بمدير كلمات سر، وعبّيها بنفسك على كل جهاز.

نسخت المشروع على جهاز جديد، وملف .env مش موجود.
1. اعمل ملف .env من .env.example.
2. احكيلي شو الأسماء اللي لازم أعبّي قيمها.
3. ما تطلب مني القيم بالمحادثة: بعبّيهم بنفسي جوّا الملف.
4. بعد ما أخلّص، شغّل المشروع وتأكّد إنه بيقرا الملف.

تجهيز · Claude Code

اربط GitHub بـClaude Code

Claude Code بيوصل لـGitHub من خلال أداتين على جهازك: git وgh. بس تسجّل دخول بنفس حسابك مرة وحدة، بيصير يقدر يرفع ويسحب باسمك.

بدي أربط GitHub بـClaude Code.
1. افحص إذا git وgh منزّلين. إذا لا، احكيلي كيف أنزّلهم واستنى موافقتي.
2. افحص إذا أنا مسجّل دخول (gh auth status).
3. إذا مش مسجّل، احكيلي أشغّل gh auth login بنفسي بتبويب Terminal منفصل.
4. بعدها تأكّد إنه git بيقدر يرفع باسمي، وإذا لزم شغّل gh auth setup-git بعد موافقتي.
ما تطلب مني كلمة سر أو توكن.

تجهيز · المشروع

اربط مشروعك بالمستودع

Claude بيربط مجلد مشروعك بالمستودع اللي عملته على الموقع. قبل الربط، بيتأكد إنه الأسرار مستثناة بملف .gitignore.

عملت مستودع خاص وفاضي على GitHub، وهاد رابطه:
https://github.com/USERNAME/my-app.git
1. إذا Git مش مفعّل هون، اقترح تفعيله واستنى موافقتي.
2. اعمل ملف .gitignore بيستثني الأسرار (.env)، المكتبات، وملفات النظام.
3. دوّر على مفاتيح أو كلمات سر بالملفات، واحكيلي وين بدون ما تطبعها.
4. اربط المشروع بهالرابط (git remote add origin)، بس ما ترفع إشي.
اعرضلي كل أمر قبل ما تشغّله.

رفع · أول مرة

ارفع مشروعك أول مرة

الـcommit بيحفظ نسخة على جهازك، والـpush بيبعتها لـGitHub. Claude بيسألك قبل الرفع، وانت بتوافق.

ارفع المشروع على GitHub لأول مرة:
1. اعرضلي الملفات اللي رح تنحفظ، وتأكّد إنه ما في أسرار.
2. اعمل أول commit واقترح رسالة قصيرة.
3. اسألني قبل الرفع، وبعد موافقتي اعمل git push -u origin main.
4. ما تستخدم --force أبداً.

رفع · كل مرة

ارفع تعديلاتك

استخدمه كل ما تخلص شغل مهم. التعديل اللي ما انرفع بيضل على جهازك بس.

ارفع تعديلاتي على GitHub:
1. احكيلي شو تغيّر، وتأكّد إنه ما في أسرار.
2. اعمل commit برسالة بتوصف التعديل.
3. اسألني قبل ما تعمل push.
4. إذا GitHub رفض الرفع، ما تستخدم --force: اسحب أول واشرحلي.

سحب · آخر نسخة

اسحب آخر نسخة

الـpull بيجيب أي تعديل صار على GitHub، من جهاز تاني أو من موقع GitHub نفسه. وعلى جهاز جديد، نفس البرومبت بينسخ المشروع كامل.

بدي أجيب آخر نسخة من GitHub لهالجهاز:
https://github.com/USERNAME/my-app.git
- إذا المشروع مش موجود هون، انسخه بـgit clone، نزّل مكتباته، واحكيلي شو لازم أرجّع بنفسي (زي .env).
- إذا موجود، افحص أول إذا عندي تعديلات مش محفوظة، وما تخسرها.
- اسحب بطريقة merge (git pull --no-rebase).
- احكيلي شو تغيّر، وإذا صار تعارض وقّف واشرحلي.

مشاكل · خطأ

الصق الخطأ

إذا طلعلك خطأ، الصقه كامل وخلّي Claude يشرحه. ما توافق على أي حل بيحذف ملفات أو بيرفع بالقوة.

• ! [rejected] main -> main (fetch first)في تعديلات على GitHub مش عندك. اسحب أول، وبعدها ارفع.
• Your local changes to the following files would be overwritten by mergeعندك تعديلات مش محفوظة. اعمل commit أول، وبعدها اسحب.
• CONFLICT (content): Merge conflict in app.txtنفس السطر تعدّل بمكانين. خلّي Claude يوريك النسختين، وانت بتختار شو يضل.
• بيطلب Username وPassword وبيفشلGitHub ما بيقبل كلمة سر الحساب هون. ارجع لبرومبت الربط وسجّل دخول من جديد.

طلعلي هالخطأ:
[الصق الخطأ هون]

اشرحلي شو معناه، واقترح أأمن حل.
اعرضلي الأوامر قبل ما تشغّلها، وما تحذف ولا تعمل push --force بدون إذني.