🔝 الدليل الرئيسي: Claude AI: الدليل الشامل 2026 · للـ workflows المتقدمة: Claude Code: تدفّقات يومية للمطوّر

Claude Code هو وكيل البرمجة الرسمي من Anthropic. يُثبَّت بأمر واحد، يعمل من الطرفية، يقرأ كودك، يُعدّل ملفاتك، يُنفّذ اختبارات، ويُصحّح أخطاءه. هذا الدرس يُغطّي التثبيت بعمق، الإعداد الأولي، وأول جلسة عملية — تكملةً لدرس workflows اليومية الذي يدخل في sub-agents، hooks، MCP وroutines.

المتطلبات

حساب Anthropic Pro، Max أو Team (Free لا يكفي)
OS: macOS 13+، Linux Ubuntu 22.04+، Fedora 39+، أو Windows 10/11 مع WSL 2
طرفية حديثة (iTerm2، Windows Terminal، أو bash/zsh قياسية)
Node.js 18+ مُثبَّت (لبعض MCPs المساعدة)
Git مُعَدّ مع اسم وbريد
الوقت المُقدَّر: 45 دقيقة

الخطوة 1 — تثبيت Native Installer

Anthropic تُقدّم Native Installer منذ نهاية 2025 الذي يُثبّت binary أصلي بدون Node.js عالمي — أسرع للبدء وأقل تعارضات. الأمر الموحّد:

# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

السكربت يُحمّل binary المُناسب لمعماريتك (arm64 أو x86_64)، يضعه في ~/.local/bin/claude (Linux/macOS) أو %LOCALAPPDATA%\claude\ (Windows)، ويُضيف PATH تلقائيًا.

أعد فتح الطرفية وتحقّق:

claude --version
claude doctor

claude --version يجب أن يعرض إصدارًا رقميًا حديثًا. claude doctor يُشخّص البيئة: مصادقة، إصدار، تبعيات. إذا كل شيء أخضر، أنت جاهز.

الخطوة 2 — أول مصادقة

claude login

الأمر يفتح متصفّحك على claude.ai، يطلب الاتصال بحسابك Anthropic، ويُعيد توجيهك بعد التصديق. token يُحفظ محليًا في ~/.claude/credentials.json (Linux/macOS) أو %USERPROFILE%\.claude\credentials.json (Windows).

للتحقق:

claude whoami

يجب أن يعرض بريدك Anthropic. إذا فشل، أعد claude login أو تحقّق من جدار الحماية.

الخطوة 3 — إعداد أولي للمشروع

اذهب إلى مستودعك:

cd ~/dev/mon-projet
claude

الأمر claude يُطلق جلسة تفاعلية في المجلد الحالي. في أول جلسة، اطلب:

> Donne-moi un aperçu de ce dépôt : langage, framework, commandes principales, structure des dossiers.

Claude يجوب المستودع، يقرأ package.json، README.md، الـ structure، ويردّ بملخص. هذا أول reflex مفيد عند الانضمام لمشروع جديد.

الخطوة 4 — إنشاء CLAUDE.md للذاكرة الدائمة

الملف CLAUDE.md في جذر مستودع هو ما يقرأه Claude Code أولًا عند انطلاق كل جلسة. مكافئ Custom Instructions لكن محفوظ في Git ومُشارَك مع الفريق.

touch CLAUDE.md

محتوى نموذجي:

# Conventions de ce dépôt

## Stack
- Backend : Node.js 20, TypeScript, Express
- Base de données : PostgreSQL 16, Prisma
- Tests : Vitest

## Commandes principales
- \`npm run dev\` : serveur de développement
- \`npm test\` : tests
- \`npm run lint\` : linter

## Conventions
- TypeScript strict (pas de \`any\`)
- Conventional Commits
- Tests à côté du fichier, suffixe \`.test.ts\`

التفاصيل في درس workflows اليومية.

الخطوة 5 — أول مهمة عملية

الـ workflow الأساسي للتصحيح:

claude
> /clear
> Le test "calcul TVA" échoue. Trouve la cause et corrige sans casser les autres tests.

الأمر /clear يُنظّف سياق الجلسة السابقة — reflex مهم. Claude يقرأ الاختبار، يُحدّد cause الخطأ، يقترح تصحيحًا، يُنفّذ npm test، ويُقدّم لك diff. تُصادق أو تطلب تعديلًا.

الخطوة 6 — sub-agents والإعدادات المتقدمة

للمشاريع الكبيرة، Claude Code يدعم sub-agents — agents مُتخصصين تُعلنهم في .claude/agents/. مثال sub-agent للـ refactos:

---
name: refactor
description: Spécialiste des refactos sûrs. Lit, propose un plan, applique par étapes.
tools: Read, Edit, Bash, Grep
---

Tu es dédié aux refactos. Procède en trois temps : lecture, plan validé, application.

استدعِ بـ « أطلق sub-agent refactor على وحدة clients ». التفاصيل في درس workflows.

الخطوة 7 — تكامل IDE

Claude Code يتكامل مع عدة IDEs:

VS Code: إضافة « Claude Code » من Marketplace
Cursor وWindsurf: نفس الإضافة (مبنيّة على VS Code)
JetBrains (IntelliJ، WebStorm، PyCharm): plugin مخصص
Slack: integration رسمية لإطلاق Claude Code من قناة

الإضافة تضع زرّ Claude في الـ sidebar وتُتيح المحادثة دون مغادرة IDE.

الخطوة 8 — التحديث والصيانة

claude update      # mise à jour vers dernière version stable
claude doctor      # diagnostic complet
claude logout      # déconnexion (utile sur poste partagé)

الـ updates يجب اختبارها بسرعة بعد التثبيت — أحيانًا، إصدار جديد يُغيّر سلوكًا. claude doctor بعد كل تحديث reflex جيد.

أخطاء شائعة عند التثبيت

الخطأ	السبب	الحل
`command not found: claude`	PATH غير مُحمَّل	أعد فتح الطرفية أو `source ~/.bashrc`
`claude login` يفشل في الفتح	متصفّح افتراضي خاطئ	اضبط متصفّح افتراضي أو افتح URL يدويًا
`Authentication failed`	token منتهي	`claude logout` ثم `claude login`
على Windows: PowerShell يحجب السكربت	execution policy مقيّدة	`Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`
على WSL: claude لا يجد ملفات	مسارات WSL مختلفة عن Windows	اعمل في `/home/user/projets` داخل WSL، لا `/mnt/c/`

تكييف للسياق العربي

للمطوّرين في الرياض، دبي، الدار البيضاء أو القاهرة، Claude Code يعمل بشكل ممتاز. الـ latency من المنطقة 100-300 ms — غير محسوسة في الدردشة. للجلسات agentique الطويلة، اتصال fibre مستقر يُفضَّل على 4G لتجنّب انقطاعات منتصف-جلسة.

للحساب: Pro بـ 20 USD/شهر يكفي لاستخدام يومي معتدل (3-4 ساعات). للاستخدام المكثّف، Max 5x بـ 100 USD/شهر هو الخطوة التالية. الدفع ببطاقة Visa دولية أو Mada قابلة للدفع الدولي.

الأسئلة الشائعة

هل Claude Code يحلّ محل IDE؟
لا، يُكمّلها. تستمر في فتح VS Code أو vim لكتابة الكود اليدوية، Claude Code يُساعد عبر CLI أو إضافة IDE.

هل أستخدمه offline؟
لا. الاستدلال يحدث على خوادم Anthropic. يحتاج اتصال إنترنت دائم.

هل أُحدّد ميزانية شهرية؟
على API نعم (في console Anthropic). على Pro/Max، الحد هو حصة الخطة، لا تنفجر فاتورة.

هل يعمل على Apple Silicon؟
نعم، binary أصلي ARM64 للأداء الأمثل.

أين أتعلّم أكثر؟
workflows اليومية للممارسة العميقة، MCP مع Claude لتوسيع الأدوات، وdocs.claude.com للمرجع الرسمي.

Claude Code درس عملي: التثبيت، workflows، sub-agents