01beginner3 min read دقيقة قراءة
البدء والتثبيت
ثبّت Claude Code، وأضف مفتاح API الخاص بك، وشغّل أول جلسة في أقل من خمس دقائق.
التثبيتالمصادقةالجلسة-الأولىREPL
ثبّت Claude Code، وأضف مفتاح API الخاص بك، وشغّل أول جلسة في أقل من خمس دقائق.
Claude Code هو مساعد الترميز الذكي من Anthropic المصمم للعمل مباشرةً في الطرفية. على عكس إضافات المحررات، يعمل Claude Code في أي shell — سواء كنت تستخدم محررًا نصيًا أو متصلًا عبر SSH أو تشغّل خطوط CI/CD. تتفاعل معه من خلال REPL تحاوري وجملة من أوامر الشرطة المائلة (slash commands) المصممة لمهام التطوير اليومية.
قبل التثبيت، تأكد من توافر ما يلي:
تحقق من الإصدارات:
node --version # يجب أن يكون v18 أو أعلى
npm --version # يجب أن يكون 9 أو أعلىثبّت Claude Code عالميًا عبر npm:
npm install -g @anthropic-ai/claude-codeتحقق من نجاح التثبيت:
claude --versionيجب أن ترى ناتجًا مشابهًا لـ claude-code 1.x.x.
إذا ظهرت لك رسالة خطأ تتعلق بالصلاحيات على macOS أو Linux، لا تستخدم sudo. بدلًا من ذلك، عدّل مسار npm العالمي: npm config set prefix ~/.npm-global ثم أضف ~/.npm-global/bin إلى متغير البيئة PATH.
يقرأ Claude Code مفتاح API من متغيرات البيئة. الأسلوب الأكثر أمانًا هو إضافته إلى ملف إعدادات الـ shell:
# ~/.zshrc أو ~/.bashrc
export ANTHROPIC_API_KEY="sk-ant-..."ثم أعد تحميل الإعدادات:
source ~/.zshrcأو يمكنك إنشاء ملف .env في جذر مشروعك:
ANTHROPIC_API_KEY=sk-ant-...
لا تحتفظ بمفتاح API داخل المستودع أبدًا. أضف .env إلى ملف .gitignore واستخدم متغيرات البيئة في أنظمة CI.
شغّل الـ REPL:
claudeستظهر شاشة الترحيب ثم موجه >. اكتب طلبًا بلغة طبيعية:
> اشرح الغرض من هذا المستودع
سيقرأ Claude الملفات الموجودة في المجلد الحالي ويردّ بملخص وافٍ. هذا كل شيء — لا إعدادات إضافية، ولا إضافات للمحرر.
/helpلرؤية جميع أوامر الشرطة المائلة المتاحة، اكتب:
> /help
مثال على الناتج:
Available commands:
/review مراجعة الملف الحالي بحثًا عن المشاكل
/fix تطبيق الإصلاح المقترح
/explain شرح الكود المحدد
/commit توليد رسالة commit
/test توليد اختبارات وحدة
/bug تشخيص خطأ
/clear مسح سياق المحادثة
/exit الخروج من Claude Code
للخروج من الـ REPL:
> /exit
# أو
Ctrl+Cلديك الآن Claude Code مثبتًا وجاهزًا للعمل. سير العمل الأساسي بسيط: claude يفتح الـ REPL، وأوامر الشرطة المائلة تُشغّل مهامًا محددة، والنص العادي يطرح أسئلة مفتوحة. في الوحدة التالية ستتعلم كل أمر بالتفصيل مع أمثلة حقيقية.