البداية

إيه هو Claude Code؟

Claude Code هو مساعد ذكاء اصطناعي للبرمجة بيشتغل في الترمينال بتاعك — النافذة النصية اللي المطورين بيكتبوا فيها الأوامر. بدل ما تدوس على أزرار في تطبيق، بتكتب اللي عايزه بالعربي أو الإنجليزي، وClaude بيقرأ الكود بتاعك، بيقترح إصلاحات، بيكتب features جديدة، بيشغّل tests، وحتى بيدير الملفات — كل ده عن طريق فهم المشروع بتاعك مباشرة على جهازك.

قبل ما تقدر تستخدم أي slash command أو تبني workflow، لازم Claude Code يكون شغّال على جهازك. الموديول ده هياخدك خطوة بخطوة في التثبيت، المصادقة، اختيار الترمينال والـ IDE المناسب، وتشغيل أول جلسة ليك.

المتطلبات الأساسية

Claude Code بيشتغل على macOS 13+، Ubuntu 20.04+ (وتوزيعات Linux الحديثة التانية)، وWindows 10 1809+ (نيتيف أو WSL). محتاج على الأقل 4 جيجا رام — 8 جيجا أفضل عشان تشتغل براحة. لازم يكون عندك اتصال إنترنت نشط طول الوقت.

كمان محتاج اشتراك مدفوع من Anthropic. الـ Claude Code متاح على خطط Pro، Max، Team، وEnterprise. الخطة المجانية في Claude.ai مش بتتضمن Claude Code. بدلًا من كده، تقدر تستخدم API key من Anthropic Console أو تتصل عبر Amazon Bedrock أو Google Vertex AI أو Microsoft Foundry.

على Windows، لازم تثبّت Git for Windows بشكل منفصل قبل ما Claude Code يشتغل.

تثبيت الـ CLI

الطريقة الموصى بيها لتثبيت Claude Code هي الـ native installer. بيعمل تحديث تلقائي في الخلفية فدايمًا عندك آخر إصدار.

على macOS أو Linux (بما فيهم WSL):

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

على Windows عن طريق PowerShell:

irm https://claude.ai/install.ps1 | iex

على Windows عن طريق CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

فيه طرق تثبيت بديلة، بس بتحتاج تحديث يدوي. Homebrew: brew install --cask claude-code. WinGet: winget install Anthropic.ClaudeCode. طريقة npm (npm install -g @anthropic-ai/claude-code) لسه شغّالة بس deprecated — هتتوقف عن استقبال التحديثات في النهاية.

بعد التثبيت، اتأكد إنه اشتغل:

claude --version

تقدر تتحكم في قناة التحديثات عن طريق /config — اختار بين latest (أحدث المزايا) وstable (إصدارات مُختبرة).

المصادقة

لما بتشغّل claude لأول مرة، بيفتح المتصفح تلقائيًا للـ OAuth authentication. سجّل دخولك بحساب Anthropic بتاعك وخلاص كده.

لو بتستخدم API key بدلًا من كده، عيّن الـ environment variable قبل ما تشغّل:

export ANTHROPIC_API_KEY=sk-ant-...
claude

للإعدادات الخاصة بالشركات أو cloud providers، استخدم الـ environment variables المناسبة:

• Amazon Bedrock: CLAUDE_CODE_USE_BEDROCK=1
• Google Vertex AI: CLAUDE_CODE_USE_VERTEX=1
• Microsoft Foundry: CLAUDE_CODE_USE_FOUNDRY=1

بيانات الاعتماد بتاعتك بتتخزن بشكل آمن — في macOS Keychain على Mac، أو في ~/.claude/.credentials.json (mode 0600) على Linux وWindows.

عشان تبدّل حسابات أو تعيد المصادقة في أي وقت، استخدم /logout.

الترمينال بتاعك: Warp موصى بيه

Claude Code بيشتغل في أي ترمينال — Terminal.app، iTerm2، Windows Terminal، Alacritty، Kitty، Ghostty، وغيرهم. بس لأفضل تجربة، بننصح بـ Warp.

Warp عنده plugin رسمي لـ Claude Code بيوفّر إشعارات نيتيف لسطح المكتب لما Claude يخلّص مهمة، يحتاج input منك، أو يطلب صلاحيات. ده مفيد جدًا للعمليات الطويلة لما بتنقل لنافذة تانية.

عشان تثبّت الـ Warp plugin، شغّل الأوامر دي جوه Claude Code بعد التثبيت:

/plugin marketplace add warpdotdev/claude-code-warp
/plugin install warp@claude-code-warp

أعد تشغيل Claude Code بعد التثبيت عشان يتفعّل الـ plugin. هتاخد إشعارات نيتيف من نظام التشغيل لما المهام تخلص، لما Claude مستني، ولما يحتاج صلاحيات — مش هتحتاج ترجع تتشيك يدوي تاني.

لو بتفضّل ترمينال تاني، Claude Code كمان عنده أمر /terminal-setup مدمج بيعمل إعداد تلقائي لدعم الإشعارات لترمينالات زي Kitty وGhostty وAlacritty.

إضافات الـ IDE

Claude Code بدأ كأداة CLI، بس دلوقتي عنده إضافات رسمية للمحررات الرئيسية. تقدر تستخدم الاتنين — الـ CLI للشغل الثقيل في الترمينال والإضافة للراحة جوه المحرر.

VS Code هي الإضافة الأنضج. ثبّتها من VS Code Marketplace أو شغّل code --install-extension Anthropic.claude-code. بتوفّر واجهة رسومية نيتيف، مراجعة diff بصرية، مراجع للملفات، تاريخ المحادثات، والقدرة على تشغيل محادثات متعددة في tabs.

JetBrains عنده plugin رسمي في مرحلة beta، متاح في JetBrains Marketplace لـ IntelliJ IDEA وWebStorm وPyCharm وباقي IDEs بتاعة JetBrains. بينسّق الـ CLI مع diff viewer بتاع الـ IDE لتجربة سلسة.

كل من Cursor وWindsurf (فروع من VS Code) كمان بيدعموا إضافات Claude Code.

بعيدًا عن إضافات الـ IDE، فيه كمان Desktop App لـ macOS وWindows بيوفّر diffs بصرية، معاينة حية للتطبيق، وagents مستقلة في الخلفية — من غير ترمينال. وكمان Claude Code على الويب (claude.ai/code) هو research preview بيشتغل على cloud VMs، فتقدر تشتغل من أي متصفح من غير أي إعداد محلي.

أول جلسة ليك

روح لأي مجلد مشروع وشغّل Claude Code:

cd my-project
claude

هتشوف رسالة ترحيب وprompt. اكتب اللي عايزه Claude يعمله بكلام عادي:

What files are in this project and what does it do?

Claude هيقرأ ملفاتك، يحلل البنية، ويديك ملخص. من هنا، تقدر تطلب منه يعمل تغييرات، يصلّح bugs، يشغّل tests، أو يشرح كود. لما Claude يحتاج يعمل إجراءات زي تعديل ملفات أو تشغيل أوامر، هيطلب إذنك الأول.

كده خلاص — أنت جاهز. روح للموديول اللي بعده عشان تتعلم الـ slash commands اللي بتخلّي Claude Code قوي فعلًا.