النقاط الرئيسية
- طريقتان للتثبيت: استخدم المثبت الأصلي (
curl -fsSL https://claude.ai/install.sh | bash) للإعداد بدون تبعيات (zero-dependency)، أو npm (npm install -g @anthropic-ai/claude-code) إذا كنت بحاجة إلى تحديد إصدار معين (version pinning). - متطلبات النظام بسيطة: macOS 13+، Linux (Ubuntu 20.04+/Debian 10+)، أو Windows 10+ مع WSL. 4GB RAM على الأقل. لا حاجة لـ GPU.
- مطلوب حساب: تحتاج إلى حساب Claude Pro، Max، Teams، Enterprise، أو Console (API). خطة Claude.ai المجانية لا تشمل الوصول إلى Claude Code.
- الإعداد يستغرق أقل من خمس دقائق: قم بالتثبيت، والمصادقة في متصفحك، وابدأ في استخدام Claude Code في أي دليل مشروع على الفور.
كيفية تثبيت Claude Code: دليل الإعداد الكامل (2026)
Claude Code هو مساعد البرمجة بالذكاء الاصطناعي من Anthropic الذي يعمل مباشرة في terminal الخاصة بك. يقوم بقراءة codebase الخاصة بك، وكتابة الكود، وتشغيل الأوامر، والتعامل مع التعديلات المعقدة لملفات متعددة -- كل ذلك من واجهة command-line واحدة.
على عكس أدوات دردشة الذكاء الاصطناعي المستندة إلى المتصفح، يعمل Claude Code داخل بيئة التطوير الفعلية الخاصة بك. فهو يرى هيكل الملفات، ويفهم سياق المشروع، ويجري تغييرات على الملفات الحقيقية على جهازك.
يأخذك هذا الدليل عبر كل خطوة من خطوات تثبيت Claude Code في 2026، بدءاً من التحقق من المتطلبات الأساسية وصولاً إلى تشغيل أول جلسة برمجة مدعومة بالذكاء الاصطناعي. سواء كنت تستخدم macOS، Linux، أو Windows، سيكون لديك Claude Code قيد التشغيل في أقل من خمس دقائق.
ما تحتاجه (قائمة المتطلبات الأساسية)
قبل تثبيت Claude Code، تأكد من توفر ما يلي:
- نظام التشغيل: macOS 13.0 (Ventura) أو أحدث، Ubuntu 20.04+ أو Debian 10+، أو Windows 10 (إصدار 1809+) مع WSL
- RAM: 4GB على الأقل (يُنصح بـ 8GB للمشاريع الكبيرة)
- اتصال بالإنترنت: يتصل Claude Code بـ API السحابي الخاص بـ Anthropic، لذا يلزم وجود اتصال نشط
- حساب Anthropic: حساب Claude Pro (20$/شهرياً)، Claude Max (100-200$/شهرياً)، Teams، Enterprise، أو Console (API)
- Terminal: Bash، Zsh، أو PowerShell
- Node.js 18+ (مطلوب فقط لطريقة التثبيت عبر npm)
لا تحتاج إلى GPU. تتم جميع عمليات معالجة الذكاء الاصطناعي على خوادم Anthropic. يحتاج جهازك فقط إلى تشغيل CLI client وإرسال الطلبات عبر الشبكة.
الخطوة 1: تثبيت Node.js (إذا لم يكن لديك)
إذا كنت تخطط لاستخدام طريقة التثبيت عبر npm، فأنت بحاجة إلى Node.js 18 أو أعلى. إذا كان لديك Node.js مثبتاً بالفعل، فتحقق من الإصدار:
node --version
إذا أظهرت المخرجات v18.0.0 أو أعلى، فانتقل إلى الخطوة 2. إذا لم يكن الأمر كذلك، فقم بتثبيت أو تحديث Node.js باستخدام nvm (Node Version Manager)، وهو النهج الموصى به لأنه يتجنب مشكلات الأذونات ويسمح لك بالتبديل بين إصدارات Node بسهولة.
تثبيت nvm على macOS أو Linux:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
أغلق الـ terminal وأعد فتحه، ثم قم بتثبيت Node.js:
nvm install 22
nvm use 22
node --version
يجب أن ترى رقم إصدار يبدأ بـ v22. إن Node.js 22 هو إصدار LTS الحالي ويعمل بشكل مثالي مع Claude Code.
تثبيت Node.js على Windows (داخل WSL):
أولاً، تأكد من تثبيت WSL (راجع قسم Windows أدناه). ثم افتح terminal الخاص بـ WSL وقم بتشغيل نفس أوامر nvm المذكورة أعلاه.
الخطوة 2: تثبيت Claude Code
لديك خياران لتثبيت Claude Code. المثبت الأصلي (native installer) هو الآن الطريقة الموصى بها، لكن npm لا يزال مدعوماً بالكامل.
الخيار (أ): المثبت الأصلي (موصى به)
لا يتطلب المثبت الأصلي أي تبعيات -- لا Node.js، ولا npm. يتم تحديثه تلقائياً في الخلفية وهو الطريقة الأساسية التي تختبرها وتدعمها Anthropic.
macOS و Linux:
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell، بصلاحية مسؤول):
irm https://claude.ai/install.ps1 | iex
يقوم المثبت بتنزيل binary الخاص بـ Claude Code، ووضعه في PATH الخاص بك، وتكوين التحديثات التلقائية. تستغرق العملية بأكملها أقل من دقيقة.
الخيار (ب): تثبيت npm
إذا كنت تفضل npm -- على سبيل المثال، لتحديد إصدار معين أو لأن npm قياسي في سير عملك -- فقم بتشغيل:
npm install -g @anthropic-ai/claude-code
هام: لا تستخدم sudo مع تثبيت npm. إذا واجهت أخطاء في الأذونات، فإن الحل الصحيح هو استخدام nvm (الذي يثبت Node.js في دليل المستخدم الخاص بك) بدلاً من تشغيل npm كمسؤول (root).
تحقق من التثبيت
بغض النظر عن الطريقة التي اخترتها، تحقق من تثبيت Claude Code:
claude --version
يجب أن ترى رقم الإصدار. يمكنك أيضاً تشغيل أداة التشخيص المدمجة:
claude doctor
يتحقق هذا الأمر من بيئتك ويبلغ عن أي مشكلات في التكوين.
الخطوة 3: المصادقة
يتطلب Claude Code المصادقة قبل أن تتمكن من استخدامه. قم بتشغيل:
claude
في المرة الأولى التي تقوم فيها بتشغيل هذا الأمر، سيفتح Claude Code متصفح الويب الافتراضي الخاص بك ويطلب منك تسجيل الدخول إلى حساب Anthropic الخاص بك. اتبع المطالبات لتفويض CLI.
خيارات المصادقة
تسجيل الدخول المستند إلى المتصفح (افتراضي): الأفضل للأجهزة الشخصية. يفتح Claude Code نافذة متصفح، وتقوم بتسجيل الدخول، ويتلقى CLI رمز المصادقة (authentication token) تلقائياً. يعمل هذا مع حسابات Claude Pro، Max، Teams، و Enterprise.
مفتاح API (لـ CI/CD والأتمتة): إذا كنت تقوم بتشغيل Claude Code في بيئة headless أو pipeline الخاص بـ CI/CD، فقم بتعيين مفتاح API الخاص بك كمتغير بيئة (environment variable):
export ANTHROPIC_API_KEY=sk-ant-your-key-here
يمكنك إنشاء مفتاح API من Anthropic Console. تتم محاسبة استخدام API لكل token وفقاً لأسعار Anthropic المعلنة.
الاشتراك مقابل محاسبة API: مع اشتراك Pro أو Max، يتم تضمين استخدامك لـ Claude Code في خطتك الشهرية (يخضع لحدود الاستخدام). مع مفتاح API من Console، فإنك تدفع مقابل كل token. اختر بناءً على حجم استخدامك -- الاشتراكات أبسط للاستخدام المنتظم، بينما تمنحك محاسبة API تحكماً أكبر لأعباء العمل المتغيرة أو المؤتمتة.
الخطوة 4: مشروعك الأول
الآن بعد أن تم تثبيت Claude Code والمصادقة عليه، جربه على مشروع حقيقي.
انتقل إلى أي دليل مشروع:
cd ~/my-project
ابدأ Claude Code:
claude
أنت الآن في جلسة تفاعلية. لقد قرأ Claude Code هيكل مشروعك وأصبح جاهزاً للمساعدة. حاول إعطاءه مهمة:
> Explain the architecture of this project
سيقوم Claude Code بمسح ملفاتك، وتحديد tech stack، وإعطائك ملخصاً لكيفية تنظيم المشروع.
جرب شيئاً أكثر عملية:
> Add input validation to the user registration form
سيحدد Claude Code الملفات ذات الصلة، ويقترح التغييرات، ويطلب تأكيدك قبل تعديل أي شيء. يمكنك مراجعة كل تغيير في diff view وقبوله أو رفضه.
لمهمة واحدة دون الدخول في الوضع التفاعلي، استخدم علامة -p:
claude -p "Write unit tests for the auth module"
يؤدي هذا إلى تشغيل المهمة، وإخراج النتيجة، والخروج -- وهو أمر مفيد للبرمجة النصية والأسئلة السريعة.
الخطوة 5: التكوين الأساسي
يعمل Claude Code بشكل مباشر مع إعدادات افتراضية معقولة، ولكن يمكنك تخصيص سلوكه ليناسب سير عملك.
اختيار النموذج
يستخدم Claude Code أحدث نموذج Claude افتراضياً. لتحديد نموذج مختلف:
claude config set model claude-opus-4-6
أو لجلسة واحدة:
claude --model claude-sonnet-4-20250514
الأذونات
يطلب Claude Code التأكيد قبل تنفيذ إجراءات قد تكون مدمرة مثل كتابة الملفات أو تشغيل أوامر shell. يمكنك تكوين هذا السلوك:
claude config set permissions.auto-accept-edits true
إعدادات على مستوى المشروع
قم بإنشاء ملف .claude/settings.json في جذر مشروعك لتحديد التكوين المشترك للفريق:
{
"permissions": {
"allow": ["read", "write", "shell"],
"deny": ["shell:rm -rf *"]
},
"model": "claude-sonnet-4-20250514",
"environment": {
"NODE_ENV": "development"
}
}
يجب الالتزام بهذا الملف في نظام التحكم في الإصدار (version control) بحيث يتشارك فريقك بالكامل في نفس سلوك Claude Code.
بالنسبة للتجاوزات الشخصية التي لا ينبغي الالتزام بها، استخدم .claude/settings.local.json بدلاً من ذلك.
تكوين خادم MCP
يدعم Claude Code خوادم Model Context Protocol (MCP) لتوسيع قدراته. قم بتكوينها في ملف .mcp.json في جذر مشروعك:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}
التثبيت في بيئات مختلفة
macOS
المثبت الأصلي هو أبسط طريق على macOS. يتم دعم كل من أجهزة Apple Silicon (M1/M2/M3/M4) وأجهزة Intel:
curl -fsSL https://claude.ai/install.sh | bash
بدلاً من ذلك، يتوفر Claude Code عبر Homebrew:
brew install --cask claude-code
Linux
يعمل على Ubuntu 20.04+، Debian 10+، ومعظم التوزيعات الحديثة:
curl -fsSL https://claude.ai/install.sh | bash
إذا كنت تستخدم توزيعة قديمة، فاستخدم طريقة npm مع nvm لتجنب مشكلات التبعيات على مستوى النظام.
Windows (WSL)
يتطلب Claude Code على Windows إما WSL أو Git for Windows. إن WSL هو النهج الموصى به:
- افتح PowerShell كمسؤول وقم بتثبيت WSL:
wsl --install
-
أعد تشغيل الكمبيوتر عندما يُطلب منك ذلك.
-
افتح terminal الخاص بـ WSL (Ubuntu افتراضياً) وقم بتثبيت Claude Code:
curl -fsSL https://claude.ai/install.sh | bash
بدلاً من ذلك، يمكنك استخدام مثبت Windows الأصلي مباشرة في PowerShell:
irm https://claude.ai/install.ps1 | iex
Docker
بالنسبة لبيئات الحاويات (containerized)، أضف Claude Code إلى Dockerfile الخاص بك:
FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code
ENV ANTHROPIC_API_KEY=your-key-here
بالنسبة لـ pipelines الخاصة بـ CI/CD، قم بتمرير مفتاح API في وقت التشغيل بدلاً من دمجه في الصورة:
docker run -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY my-claude-image claude -p "Run the test suite and fix any failures"
Pipelines الخاصة بـ CI/CD
تم تصميم وضع headless الخاص بـ Claude Code (علامة -p) للأتمتة. إليك مثال على GitHub Actions:
- name: AI Code Review
run: |
npx @anthropic-ai/claude-code -p "Review the changes in this PR and suggest improvements" --output-format json
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
تعيد علامة --output-format json مخرجات منظمة يمكن للخطوات اللاحقة تحليلها.
تحديث Claude Code
المثبت الأصلي
إذا قمت بتثبيت Claude Code باستخدام المثبت الأصلي، فستحدث التحديثات تلقائياً في الخلفية. لا يلزم اتخاذ أي إجراء. يمكنك تكوين قناة التحديث:
claude config set update-channel stable
للتحقق من إصدارك الحالي:
claude --version
npm
إذا قمت بالتثبيت عبر npm، فقم بالتحديث يدوياً:
npm update -g @anthropic-ai/claude-code
أو قم بتثبيت إصدار معين:
npm install -g @anthropic-ai/claude-code@latest
التكامل مع IDE
بينما يعد Claude Code أداة تعتمد على terminal في المقام الأول، إلا أنه يتكامل مباشرة مع IDEs الشهيرة لتوفير تجربة بصرية أكثر.
إضافة VS Code
توفر إضافة VS Code واجهة رسومية أصلية لـ Claude Code داخل المحرر الخاص بك. تتضمن لوحة دردشة، تراجعاً مستنداً إلى نقاط التحقق (checkpoint-based undo)، مراجع للملفات مع إشارات @ (mentions)، والقدرة على تشغيل محادثات متعددة في علامات تبويب متوازية.
للتثبيت، افتح VS Code وابحث عن "Claude Code" في لوحة Extensions، أو قم بتشغيل:
code --install-extension anthropic.claude-code
بمجرد التثبيت، يمكنك فتح لوحة Claude Code من الشريط الجانبي والتفاعل معها تماماً مثل إصدار terminal، ولكن مع ميزة إضافية تتمثل في رؤية ملفات diff المعروضة في عارض diff الأصلي لـ VS Code.
إضافات JetBrains
بالنسبة لـ IntelliJ IDEA، PyCharm، WebStorm، GoLand، وغيرها من JetBrains IDEs، قم بتثبيت إضافة Claude Code من JetBrains Marketplace:
- افتح JetBrains IDE الخاص بك
- انتقل إلى Settings ثم Plugins ثم Marketplace
- ابحث عن "Claude Code"
- انقر فوق Install وأعد تشغيل IDE
تقوم إضافة JetBrains بتشغيل Claude Code CLI داخل terminal المدمج في IDE الخاص بك وتفتح التغييرات المقترحة في عارض diff الخاص بـ IDE. هي حالياً في المرحلة التجريبية (beta) ولكنها تعمل بكامل طاقتها للاستخدام اليومي.
استكشاف الأخطاء وإصلاحها
"command not found: claude"
إن binary الخاص بـ Claude Code ليس في PATH الخاص بك. إذا استخدمت المثبت الأصلي، فحاول فتح نافذة terminal جديدة. إذا لم ينجح ذلك، فقم بتشغيل نص التثبيت مرة أخرى. بالنسبة لتثبيتات npm، تأكد من وجود دليل npm bin العالمي في PATH الخاص بك:
npm config get prefix
أضف الدليل الفرعي bin لهذا المسار إلى متغير PATH في shell الخاص بك.
"إصدار Node.js قديم جداً"
يتطلب Claude Code إصدار Node.js 18+. تحقق من إصدارك باستخدام node --version. إذا كان أقل من 18، فقم بتثبيت إصدار أحدث باستخدام nvm:
nvm install 22
nvm use 22
أخطاء أذونات npm (EACCES)
لا تستخدم أبداً sudo npm install -g. بدلاً من ذلك، قم بإصلاح دليل npm الافتراضي أو استخدم nvm، الذي يثبت كل شيء في دليل المستخدم الخاص بك ويتجنب تعارض الأذونات تماماً:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
npm install -g @anthropic-ai/claude-code
فشل المصادقة أو المتصفح لا يفتح
إذا لم ينجح تسجيل الدخول المستند إلى المتصفح (شائع في الخوادم البعيدة أو WSL)، يمكنك المصادقة باستخدام مفتاح API بدلاً من ذلك:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude
قم بإنشاء مفتاح API الخاص بك من console.anthropic.com.
"Network Error" أو مهلة أثناء التثبيت
قد تمنع شبكتك أو جدار الحماية npm أو المثبت الأصلي. جرب:
npm config set registry https://registry.npmjs.org/
إذا كنت خلف بروكسي خاص بشركة، فقم بتكوين npm لاستخدامه:
npm config set proxy http://your-proxy:8080
npm config set https-proxy http://your-proxy:8080
Claude Code يعمل ببطء
إن Claude Code نفسه خفيف الوزن -- عادةً ما يعني البطء زمن انتقال الشبكة (latency) إلى API الخاص بـ Anthropic. تحقق من اتصالك بالإنترنت. إذا كنت تستخدم VPN، فحاول فصله. يمكنك أيضاً التحقق من حالة API على status.anthropic.com.
الخطوات التالية
لقد قمت بتثبيت Claude Code والمصادقة عليه وتشغيله. إليك وجهتك التالية من هنا:
- تعلم سير العمل: اقرأ Claude Code tutorial للحصول على تعمق في استراتيجيات كتابة المطالبات (prompting)، وتحرير ملفات متعددة، وتحقيق أقصى استفادة من التطوير المدعوم بالذكاء الاصطناعي.
- قارن خياراتك: تعرف على كيفية مقارنة Claude Code في مقارنة Claude Code vs Cursor إذا كنت تختار بين أدوات البرمجة بالذكاء الاصطناعي.
- استكشف الميزات المتقدمة: يدعم Claude Code خوادم MCP، والخطافات المخصصة (custom hooks)، وأتمتة headless، وتكوينات النماذج المتعددة. تغطي الوثائق الرسمية هذه الميزات بالتفصيل.
يعد Claude Code أسرع طريقة لإدخال الذكاء الاصطناعي في سير عمل التطوير الحالي لديك دون تغيير أدواتك أو مغادرة terminal الخاصة بك. الآن بعد تثبيته، ابدأ بمهمة صغيرة في مشروع حقيقي -- سترى الفرق على الفور.
