البدء مع ‎Claude Code‎ في 2026: من التثبيت إلى أوّل ‎commit‎

ما هو ‎Claude Code‎ فعلاً

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

المعنى العملي لذلك: ‎Claude Code‎ يعطي أفضل ما لديه أمام مشكلات حقيقيّة محصورة النطاق في قواعد شيفرة فعلية. إن طلبت منه أن «يساعدك في مشروعك»، حصلت على تشتّت. أمّا إن طلبت منه «أضِف تحقّقاً من المدخلات لدالة createUser في src/api/users.ts وحدّث الاختبارات المقابلة»، فإنّك تحصل على نتيجة ملموسة.

الخطوة الأولى — التثبيت

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

تأكّد من نجاح التثبيت:

claude --version
# → claude-code 1.x.x

إن واجهت خطأ صلاحيّات على ‎macOS‎ أو ‎Linux‎، فالعلاج المتعارف عليه هو ضبط ملكيّة مجلد ‎npm‎ العالمي بدل تشغيل ‎npm‎ بصلاحيات ‎sudo‎. توثيق ‎Anthropic‎ يغطّي هذا في قسم المتطلّبات. على ‎Windows‎، يكفي تشغيل الطرفيّة بصلاحيات المسؤول لمعالجة معظم مشكلات الصلاحيّات، غير أنّ مسار ‎WSL2‎ يبقى أكثر استقراراً للاستخدام الوكيلي الكثيف.

الخطوة الثانية — التوثيق

claude login

سيفتح ذلك نافذة متصفّح لإتمام ‎OAuth‎. عند انتهاء العمليّة، تُحفَظ بيانات الاعتماد داخل ~/.claude/، ولا تحتاج إلى تكرار هذه الخطوة إلا إذا بدّلت حسابك.

إن كنت تستخدم مفتاح ‎API‎ مباشرةً — كأن تكون داخل بيئة تكامل مستمر، أو على جهاز بلا متصفّح — فاضبط متغيّر البيئة بدلاً من ذلك:

export ANTHROPIC_API_KEY="sk-ant-api03-..."

اشتراك ‎Claude Pro‎ يشمل حصّة توكنات شهرية تكفي للاستخدام الفردي المعتدل. أمّا إن كنت تشغّل ‎Claude Code‎ على قواعد شيفرة كبيرة، أو تكتب كميات اختبارات واسعة، أو تشغّله في حلقات متكرّرة، فسيغلب أن تتجاوز سقف ‎Pro‎ فتحتاج إلى رصيد ‎API‎ تكميلي. تعرض لوحة تحكّم ‎Anthropic‎ استهلاكك في الزمن الحقيقي، فتفقّدها بعد أوّل جلسات لتعاير حجم استخدامك.

الخطوة الثالثة — اكتب ملف ‎CLAUDE.md‎ خاصّتك

ملف ‎CLAUDE.md‎ مختصر لكنّه فعّال يغطّي خمسة محاور:

# Project: [name]

## Stack
- Runtime: Node 20, TypeScript 5.3
- Framework: Next.js 14 (App Router)
- Database: PostgreSQL via Prisma
- Tests: Vitest, run with `npm test`

## Commands
- Dev server: `npm run dev`
- Build: `npm run build`
- Lint: `npm run lint` — fix before committing
- Migrate: `npx prisma migrate dev`

## Rules
- All new API routes go in src/app/api/
- Zod for all input validation — no raw req.body access
- Never touch the /legacy/ directory
- Do not remove console.error calls in error handlers

## Do not
- npm install packages without asking first
- Modify .env files
- Run database migrations without confirmation

قسم «‎Do not‎» هو تحديداً ما يقفز عنه أكثر المطوّرين في تجربتهم الأولى، وهو القسم الذي يقي من الأخطاء المُكلِفة. إن كانت لديك ملفات لا يجوز لـ ‎Claude‎ المساس بها، فاذكرها بالاسم. وإن كانت ثمّة أوامر يجب ألّا يشغّلها استقلاليّاً، فقُل ذلك صراحةً.

لمعالجة أعمق لبنية ‎CLAUDE.md‎، راجع مقالنا عن كتابة ‎CLAUDE.md‎ يعمل فعلاً. أمّا حزمة ‎Septim Starter‎ بسعر ‎$9‎، فتشمل قالباً مجرَّباً لخمسة أنواع شائعة من المشاريع — ‎Next.js‎، و‎Python Flask‎، و‎Rails‎، و‎Go‎، و‎Node‎ النقي — كي لا تنطلق من ملف فارغ.

الخطوة الرابعة — أعطِ الأداة مهمّة حقيقية

cd ~/projects/my-app
claude

عند المُحَث، أعطِ الأداة مهمّة محدّدة بما يكفي ليكون لها حالة إنجاز واضحة. مهام أولى مناسبة للمبتدئ:

• أضِف محدِّد معدّل لمسار /api/login — خمس محاولات في الدقيقة لكل ‎IP‎، مع ‎429‎ عند التجاوز.
• اكتب اختبارات وحدة لكل دالة في src/lib/date-utils.ts — استهدف تغطية فروع بنسبة 90٪.
• أعِد هيكلة src/components/UserTable.tsx ليستخدم ‎React Query‎ بدل استدعاءات ‎fetch‎ المباشرة.

سيقرأ ‎Claude Code‎ الملفات ذات الصلة، ويقترح تغييرات، ويستأذنك قبل الكتابة على القرص أو تشغيل أوامر. في الإعداد الافتراضي، يستأذنك قبل أي عمليّة كتابة، وهذا هو الوضع المناسب للتعلّم. تستطيع لاحقاً تخفيف هذه الصلاحيّات أو تشديدها داخل ~/.claude/settings.json بعد أن تلمّ بسلوك الأداة.

ماذا يحدث داخل الحلقة الوكيلية

تمرّ المهمّة المعتادة في ‎Claude Code‎ بهذه الدورة:

1. قراءة الملفات المصدرية ذات الصلة لفهم البنية الراهنة.
2. اقتراح خطّة تنفيذ، وتعداد الملفات التي ستلمسها.
3. كتابة التعديلات ملفّاً ملفّاً مع شرح موجز.
4. تشغيل مجموعة الاختبارات إن كانت معدّةً في ‎CLAUDE.md‎، والتعامل مع الإخفاقات تكراراً.
5. الإبلاغ عن الإنجاز، وتعداد كل ملف جرى تغييره.

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

الخطوة الخامسة — افحص تكاليفك

تعرض لوحة ‎Anthropic‎ على ‎console.anthropic.com‎ استهلاكك من التوكنات مفصَّلاً بحسب النموذج والتاريخ. بعد الجلسة الثانية أو الثالثة، تفقّد اللوحة لتفهم وتيرة استهلاكك قبل أن تشرع في تشغيل ‎Claude Code‎ على مهام أطول.

الأنماط الثلاثة التي تدفع التكلفة إلى أعلى من المتوقّع:

• ملفات ضخمة في السياق. إن قرأ ‎Claude Code‎ ملفاً من عشرة آلاف سطر للإجابة عن سؤال يخصّ دالة واحدة، فأنت دفعت ثمن عشرة آلاف سطر من توكنات الإدخال. وجّهه إلى ملفات بعينها بدل أن تطرح أسئلة فضفاضة عن قاعدة الشيفرة كلّها.
• إعادة بناء السياق المتكرّرة. كل رسالة جديدة في الجلسة تعيد إرسال سجلّ المحادثة كاملاً. الجلسات الطويلة تصبح مكلفة. ابدأ جلسات نظيفة للمهام غير المرتبطة بدل أن تجرّ جلسة واحدة طوال اليوم.
• إطلاق الوكلاء الفرعيّين. يستطيع ‎Claude Code‎ إطلاق وكلاء فرعيّين للعمل المتوازي. لكل وكيل فرعي سياقه الخاص، فإذا شغّلت عدّة وكلاء معاً تضاعفت تكلفتك تبعاً لذلك. يغطّي دليل ‎Tokenocalypse‎ الموضوع تفصيلاً — راجع تشريح تكلفة الوكيل الفرعي.

المهمّة البرمجيّة الواحدة المحصورة النطاق تكلّف عادةً بين ‎$0.05‎ و‎$0.40‎ من رصيد ‎API‎ بحسب حجم الملفات وتعقيدها. أمّا الجلسة التي تطلب فيها من ‎Claude Code‎ أن يفهم قاعدة شيفرتك كاملةً قبل أن يفعل أي شيء، فقد تكلّفك عدّة دولارات. ملف ‎CLAUDE.md‎ الذي كتبته في الخطوة الثالثة يقلّص هذا النمط الثاني تقليصاً ملموساً، إذ يحلّ السياق الجاهز محلّ التوكنات المُنفَقة على الاستكشاف.

أخطاء شائعة في الجلسة الأولى

أن تطلب من ‎Claude Code‎: «انظر إلى مشروعي وقُل لي ما المشكلة»

هذا يحرق نافذة السياق في رحلة استكشافية مفتوحة. النتيجة مراجعة شيفرة عامّة قد تكشف مشكلات حقيقية، لكن بثمن توكنات باهظ. استخدم ‎Septim Drills‎ بسعر ‎$29‎ لتمرينات مراجعة شيفرة منظّمة، أو وجّه ‎Claude Code‎ إلى ملف بعينه بسؤال محدّد.

ألّا تقرأ الخطّة قبل الموافقة عليها

يقترح ‎Claude Code‎ خطّة قبل التنفيذ. اقرأها. في المهام المعقّدة، تحوي الخطّة أحياناً خطوات لن تجيزها — كإسقاط جدول، أو إزالة طبقة تخزين مؤقت، أو لمس ملف استثنيته صراحةً. اكتشاف ذلك على مستوى الخطّة بلا تكلفة. أمّا اكتشافه بعد إتمام الكتابة، فهو ‎git revert‎.

تشغيلها بلا تحكّم في الإصدارات

‎Claude Code‎ يكتب على القرص. لا تشغّله إلا في مستودعات شجرة عملها نظيفة، حتى تستطيع تشغيل git diff على كل تغيير وgit checkout . على ما لا يعجبك. إن لم تكن تستخدم ‎git‎ بعد، فهيّئ مستودعاً قبل أن تبدأ جلستك الأولى.

تجاهُل ملف ‎CLAUDE.md‎

دون ‎CLAUDE.md‎، يستنبط ‎Claude Code‎ سياق المشروع عبر استكشاف الملفات. هذا الاستنباط يستهلك توكنات، وكثيراً ما يكون خاطئاً في تقدير الأعراف، والأوامر المحظورة، ومحرّك الاختبارات. الدقائق العشرون التي تنفقها في الخطوة الثالثة على ‎CLAUDE.md‎ ستوفّر عليك أضعافها خلال أسبوعك الأوّل من الاستخدام.

إلى أين بعد ذلك

متى أنجزت بضع مهام بنجاح، فالخطوة التالية الطبيعيّة هي توسيع ‎Claude Code‎ بخوادم ‎MCP‎، وهي تكاملات تمنحه وصولاً إلى أدوات خارجية كقاعدة بياناتك أو ‎GitHub‎ أو المتصفّح. راجع دليل خوادم ‎MCP‎ لجولة عمليّة.

إن كنت تشغّل ‎Claude Code‎ داخل فريق وتريد إعداد مراجعة آليّة لطلبات السحب، فإنّ دليل إعداد مراجعة طلبات السحب يغطّي ضبط ‎GitHub Action‎ من البداية إلى النهاية.

أمّا لإدارة التكلفة على نطاق أوسع — حين تتجاوز مرحلة المبتدئ وتستخدم ‎Claude Code‎ يوميّاً — فراجع دليل مراقبة التكلفة ومقال إدارة الذاكرة والسياق.