🔝 الدليل الرئيسي: Claude AI: الدليل الشامل 2026
ثبّتت Claude Code، كتبت claude في طرفيتك، صحّحت bug صغيرًا. جيد. لكن عندما تشاهد فيديوهات demos Anthropic، ترى مطوّرين يُسلّمون feature كاملة في 30 دقيقة، يُطلقون audits على مستودع كامل، يُشغّلون agent ليليًا يُحضّر عمل الغد. وعندك، كل جلسة تبقى ثقيلة وتُدخل « approve » ثلاث مئة مرة في الساعة. يُملأ هذا الدرس هذه الفجوة.
الهدف هنا ليس التثبيت — موثّق في مكان آخر — بل هندسة تدفّقك. كيف تُعدّ الصلاحيات مرة واحدة لتتوقّف عن التصديق على عمليات تافهة. كيف تكتب ملف CLAUDE.md يربح ساعتين يوميًا. كيف تُسلسل sub-agents، تُعدّ hooks، تُوصِّل MCPs مفيدة. في النهاية، ستملك بيئة Claude Code جاهزة للإنتاج، وagent يتصرّف كزميل منضبط.
المتطلبات
- Claude Code مُثبَّت (
claude --versionيجب أن يردّ) - حساب Pro أو Max أو Team
- طرفية حديثة — Windows Terminal، iTerm2، أو Bash تحت WSL
- Git مُعَدّ، مستودع للعمل عليه
- المستوى: مطوّر متوسط
- الوقت المُقدَّر: 90 دقيقة قراءة-ممارسة
الخطوة 1 — التحقق من التثبيت والإصدار
قبل كل شيء، نتأكّد أن القاعدة منتظمة. كثير من السلوكيات الغريبة تأتي من تثبيت غير مُحدَّث. الأمر claude --version يعرض الإصدار المُثبَّت. الأمر claude doctor يُشخّص البيئة ويُبلِّغ عن المخاوف الكلاسيكية — auth منتهية، إصدار قديم، تبعية مفقودة.
claude --version
claude doctorالمخرج المتوقع: إصدار رقمي حديث، وتقرير أخضر من doctor. على Windows، إذا تعمل في Git Bash، تحقّق أن which claude يُشير على الـ binary المُثبَّت عالميًا.
الخطوة 2 — إنشاء ملف CLAUDE.md لمشروعك
ملف CLAUDE.md في جذر مستودع هو ما يقرأه Claude Code أولًا عند انطلاق كل جلسة. هذا مكافئ Custom Instructions لـ Projets في الدردشة — لكن هنا مُحفَّظ في Git، مُشارك مع الفريق، وهيكلي. بدون CLAUDE.md، Claude يكتشف مشروعك في كل جلسة؛ معه، يعرف من الثانية الأولى أي لغة، أي framework، أي اصطلاحات، أي أوامر يُطلق.
touch CLAUDE.md
$EDITOR CLAUDE.mdاملأ بالأقسام التالية. كيّف مع كدستك:
# Conventions de ce dépôt
## Stack
- Backend : Node.js 20, TypeScript, Express
- Base de données : PostgreSQL 16, accédée via Prisma
- Tests : Vitest pour l'unitaire, Playwright pour l'E2E
## Commandes principales
- \`npm run dev\` : démarre le serveur dev (port 3000)
- \`npm test\` : lance les tests Vitest
- \`npm run e2e\` : lance les tests Playwright
- \`npm run lint\` : ESLint + Prettier
## Conventions
- Toujours typer strictement (pas de \`any\`)
- Tests à côté du fichier, suffixe \`.test.ts\`
- Commits Conventional Commits (\`feat:\`, \`fix:\`, \`refactor:\`)
- Pas de console.log dans les commits
## Structure
- \`src/api/\` : routes Express
- \`src/domain/\` : logique métier pure
- \`src/infra/\` : accès DB, services externesبمجرد إنشاء هذا الملف، أطلق claude في المستودع واطلب « أعرض ملخصًا لما تعرفه عن هذا المشروع ». يجب أن ترى Claude يُعيد الكدسة، الأوامر والاصطلاحات. إذا نعم، الملف مقروء جيدًا وتكسب الآن دقيقتين شرح في كل جلسة مستقبلية.
الخطوة 3 — إعداد الصلاحيات مرة واحدة
الوضع الافتراضي لـ Claude Code يطلب تصديقًا لأقل عملية تلمس filesystem أو تُنفّذ shell. مفيد تربويًا في البداية، مرهق عمليًا بعد عشر جلسات. الحل: إعداد الصلاحيات في .claude/settings.json في جذر المستودع.
mkdir -p .claude
$EDITOR .claude/settings.json{
"permissions": {
"allow": [
"Bash(npm test:*)",
"Bash(npm run lint:*)",
"Bash(npm run typecheck:*)",
"Bash(git status)",
"Bash(git diff:*)",
"Bash(git log:*)",
"Read",
"Grep",
"Glob"
],
"deny": [
"Bash(rm -rf:*)",
"Bash(git push --force:*)",
"Bash(curl:*)",
"Bash(wget:*)"
]
}
}عند الإطلاق التالي، Claude لن ينتظر تصديقك لـ npm test أو git diff. في المقابل، سيستمر في الطلب للعمليات الخطرة، ويرفض منهجيًا الأوامر في deny. تكسب 30 دقيقة يوميًا، وتحتفظ بالأمان على ما يهم.
الخطوة 4 — أول تدفّق: تصحيح bug بـ /clear
claude
# في الجلسة :
> /clear
> Le test "calcul TVA panier" échoue depuis le commit 7a3f9. Trouve la cause et corrige sans casser les autres tests.الأمر /clear يُنظّف سياق الجلسة السابقة — reflex يُكتسب في بداية كل مهمة متمايزة. الـ prompt الدقيق يُعطي Claude نقطة انطلاق قابلة للتحقق: اختبار مسمّى، commit مشبوه، وقيد. Claude سيقرأ الاختبار، يُحدّد commit الخاطئ عبر git log، يُقارن النسختين، يقترح تصحيحًا، يُنفّذ npm test، ويُقدّم لك الـ diff.
المخرج المرجعي: patch مختصر، نتيجة الاختبارات، وملخّص التشخيص. لا تُصادق على تصحيح لا تفهمه — Claude يُخطئ، وأنت مسؤول عن الكود المُسجَّل.
الخطوة 5 — ثاني تدفّق: إضافة feature مع خطة
> Je veux ajouter une route POST /api/clients qui crée un client en base.
Plan d'abord — ne touche encore à aucun fichier. Liste les étapes,
les fichiers concernés, les tests à ajouter.Claude سيردّ بخطة مُرَقَّمة: إنشاء route في src/api/clients.ts، إضافة repository في src/infra/clientsRepo.ts، كتابة الاختبارات في src/api/clients.test.ts، إلخ. تقرأ هذه الخطة، تنتقدها، تُصحّح إذا أزعجك شيء. بمجرد التصديق، تُعطي الإذن: « OK، نفّذ ». Claude يكتب الملفات، يُطلق الاختبارات، يدور على الأخطاء.
هذا الانضباط « خطة-ثم-فعل » هو ما يفصل بين استخدام مبتدئ واستخدام إنتاجي. الخطة تُربحك وقتًا لاحقًا — تتجنّب refactors همجية — وتُحافظ عليك سيدًا للمعمار.
الخطوة 6 — ثالث تدفّق: refacto كبير مع sub-agents
للـ refactos المتقاطعة — إعادة تسمية مفهوم في كل الكود، ترحيل مكتبة — sub-agents هي الأداة. بدلًا من جلسة وحيدة تُحمّل كل شيء في الذاكرة، تُعلن agents مُتخصصين يُنسّقها Claude Code.
أنشئ ملف .claude/agents/refactor.md:
---
name: refactor
description: Spécialiste des refactos sûrs. Lit, propose un plan, applique par étapes, lance les tests entre chaque étape.
tools: Read, Edit, Bash, Grep
---
Tu es un agent dédié aux refactos. Procède toujours en trois temps :
1. Lecture exhaustive de l'aire impactée
2. Plan détaillé soumis pour validation
3. Application étape par étape avec tests entre chaque étape
Ne fais jamais de modification sans avoir lu le contexte complet.بمجرد وضع هذا sub-agent، تُستدعيه بـ « أطلق sub-agent refactor على وحدة clients ». الـ sub-agent يفتح سياقًا نظيفًا — لا يُلوّث جلستك الرئيسية — يُنفّذ ولاية ويُعيد تقريرًا. تحتفظ بالمحادثة الرئيسية طازجة لقيادة المجموعة.
الخطوة 7 — توصيل MCP مفيد: GitHub، Postgres، أو Linear
خوادم MCP توسّع ما يستطيع Claude Code فعله. توصيل MCP GitHub يُتيح لك طلب « اقرأ issue #142 واقترح fix »، دون نسخ-لصق.
claude mcp add githubاتبع authentication OAuth الذي يفتح في متصفّحك. بمجرد التصديق:
claude mcp listخادم GitHub يجب أن يظهر بحالة « connected ». أطلق ثم جلسة Claude واكتب « اذكر آخر 3 issues مفتوحة في المستودع الحالي ». إذا ردّ Claude بالـ issues الحقيقية، MCP يعمل.
الخطوة 8 — Hooks: أتمتة الاختبارات والـ lint
الـ Hooks سكربتات shell يُنفّذها Claude Code تلقائيًا في لحظات دقيقة من الدورة. حالة الاستخدام الأكثر مردودية: تمرير linter والاختبارات تلقائيًا بعد كل تعديل.
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit",
"hooks": [
{
"type": "command",
"command": "npm run lint -- --fix && npm run typecheck"
}
]
}
]
}
}مع هذا hook، بعد كل تعديل ملف، Claude Code يُطلق linter وtypecheck. إذا ظهر خطأ، يُرفع في المحادثة وClaude يُصحّحه غالبًا فورًا. تتجنّب السيناريو الكلاسيكي حيث الـ agent يُسجّل كودًا نظيفًا ظاهريًا لكن يكسر في CI.
الخطوة 9 — Routines: عمل ليلي
فتحت Anthropic الـ Routines: إعداد مهمة لتُنفَّذ حسب جدول، عبر استدعاء API، أو ردًّا على حدث. حالة الاستخدام التي تُغيّر الحياة: تشغيل agent ليلًا يجوب issues، يقترح خططًا، يُحضّر مسودّات PR. في الصباح، تصل ولديك عمل ممضوغ مسبقًا.
إنشاء routine من تطبيق سطح المكتب Claude Code. تُعطي اسمًا، prompt، جدول (مثلًا « كل يوم 6:00 GMT »)، ومستودع هدف. عند الإطلاق، Claude يُنفّذ المهمة باستقلالية، في instance مخصصة، وينشر نتيجته في Artifact أو commit على branche مخصصة.
نصيحة أولى: ابدأ بـ routine في القراءة فقط. « كل صباح، اسحب issues المفتوحة في هذا المستودع واقترح تصنيفًا بحسب الأولوية في تعليق. » بلا خطر وتُقيس الجودة قبل إعطاء صلاحيات كتابة. ثانية: راجع التنفيذات الأولى يدويًا.
الخطوة 10 — التحقق من المجموعة بدورة كاملة
cd ~/dev/votre-projet
claude
> /clear
> [tâche réelle de votre semaine]عند الإطلاق، Claude يجب أن يكون قد قرأ CLAUDE.md (دليل: يعرف كدستك دون سؤال). يجب أن يستطيع إطلاق npm test دون طلب إذن (دليل: settings مُعَدّة جيدًا). يجب أن يعرف إعادة صياغة المهمة كخطة قبل الكتابة (دليل: انضباط مُكتسب). بعد كل تعديل، hook lint يجب أن يُطلَق (دليل: مخرج hook مرئي). إذا ذكرت MCP — « افتح issue #X » — يجب أن يردّ بالبيانات الحقيقية.
أخطاء شائعة
| الخطأ | السبب | الحل |
|---|---|---|
| Claude ينسى السياق في كل جلسة | لا ملف CLAUDE.md |
أنشئ CLAUDE.md بالكدسة والأوامر |
| تصديق دائم لعمليات تافهة | صلاحيات افتراضية صارمة | إعداد .claude/settings.json بـ allowlist مستهدفة |
| الجلسات تنحرف وتفقد الجودة | لا /clear بين مهام غير مرتبطة |
reflex /clear في كل مهمة جديدة |
| Refactors تكسر اختبارات غير متوقعة | لا خطة مسبقة | اطلب خطة دائمًا، صادق، ثم نفّذ |
| كود نظيف ظاهريًا يكسر في CI | لا hook lint/typecheck بعد تعديل | إعداد hook PostToolUse Edit |
| تكلفة API تنفجر | جلسات Opus طويلة جدًا | Sonnet افتراضيًا، Opus فقط للمراحل المعقدة |
الأسئلة الشائعة
هل Claude Code يستطيع commit لي؟
نعم، إذا أذنت صراحة في الصلاحيات. الممارسة المُوصى بها تبقى مراجعة diff قبل commit. للروتينات الليلية، أعدّ Claude Code للدفع على branche مخصصة تدمجها يدويًا صباحًا.
هل أستخدم Claude Code على مشروع شركة خاص؟
نعم على كل الخطط المدفوعة. لمتطلبات الامتثال، انتقل إلى Team أو Enterprise وفعّل عدم الاحتفاظ للتدريب.
كيف أُشارك CLAUDE.md مع فريقي؟
يكفي تسجيله في Git. كل أعضاء الفريق الذين يستنسخون المستودع يستفيدون تلقائيًا من الإعداد.
ماذا أفعل عندما يُعدّل Claude Code ملفًا دون طلب؟
تحقّق من .claude/settings.json. على الأرجح لديك Edit في allow.
كم token تستهلك جلسة نموذجية؟
متغيّر. جلسة تصحيح بسيطة: 30-50 ألف token. Refacto كبير: 200-500 ألف token. روتين ليلي: ملايين محتملة. راقب الاستهلاك عبر claude usage.