واجهة سطر الأوامر Claude Code: المرجع التقني الشامل
آخر تحديث: 12 ديسمبر 2025
تحديث ديسمبر 2025: أصبح Claude Code الآن يدير سير عمل الهندسة المؤسسية من خلال التحرير الوكيلي متعدد الملفات، وتكامل بروتوكول MCP مع أكثر من 300 خدمة خارجية، والوكلاء الفرعيون المتخصصون للمهام المعقدة، ونظام الخطافات لأتمتة CI/CD. يتيح نظام الأذونات ضوابط أمنية دقيقة. التبديل بين النماذج Haiku (سريع/اقتصادي) و Opus (قوي) يحسّن المفاضلة بين التكلفة والأداء.
أمضيت أشهراً في اختبار Claude Code إلى أقصى حدوده عبر قواعد الشفرة الإنتاجية، وخطوط أنابيب CI/CD، والنشر المؤسسي. يُكثّف هذا الدليل تلك التجربة في المرجع الشامل الذي كنت أتمنى وجوده عندما بدأت. يغطي كل شيء من التثبيت الأولي إلى الأنماط المتقدمة التي لا يكتشفها معظم المستخدمين.
Claude Code ليس واجهة محادثة تصادف أنها تعرف البرمجة. إنه نظام وكيلي يقرأ قاعدة الشفرة الخاصة بك، وينفذ الأوامر، ويعدّل الملفات، ويدير سير عمل git، ويتصل بالخدمات الخارجية، ويفوّض المهام المعقدة إلى وكلاء فرعيين متخصصين—كل ذلك من خلال واجهة سطر الأوامر التي تتكامل مع طريقة عمل المطورين الفعلية.
الفرق بين استخدام Claude Code بشكل عرضي واستخدامه بفعالية يكمن في فهم بنيته: التسلسل الهرمي للتكوين الذي يتحكم في السلوك، ونظام الأذونات الذي يضبط العمليات، ونظام الخطافات الذي يمكّن الأتمتة الحتمية، وبروتوكول MCP الذي يوسّع القدرات، ونظام الوكلاء الفرعيين الذي يتعامل مع المهام المعقدة متعددة الخطوات. أتقن هذه الأنظمة وسيصبح Claude Code مضاعفاً للقوة. أهملها وستفقد معظم القيمة.
يفترض هذا الدليل أنك مرتاح مع أدوات سطر الأوامر وتريد الصورة الكاملة. كل ميزة موثقة بالصياغة الفعلية، وأمثلة تكوين حقيقية، والحالات الحدية التي تُعثّر المستخدمين ذوي الخبرة. سواء كنت تُعدّ مشروعك الأول أو تنشر عبر منظمة هندسية مؤسسية، المعلومات موجودة هنا.
كيف يعمل Claude Code: النموذج الذهني
قبل الغوص في الميزات، افهم كيف تشكّل بنية Claude Code كل ما تفعله به. يعمل النظام في ثلاث طبقات:
┌─────────────────────────────────────────────────────────┐
│ طبقات CLAUDE CODE │
├─────────────────────────────────────────────────────────┤
│ طبقة التوسعة │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ MCP │ │الخطافات │ │المهارات │ │الإضافات │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ أدوات خارجية، أتمتة حتمية، خبرة المجال │
│ إضافات مُجمّعة │
├─────────────────────────────────────────────────────────┤
│ طبقة التفويض │
│ ┌─────────────────────────────────────────────────┐ │
│ │ الوكلاء الفرعيون (حتى 10 متوازيين) │ │
│ │ Explore | Plan | General-purpose | Custom │ │
│ └─────────────────────────────────────────────────┘ │
│ سياقات معزولة للعمل المركّز، تعيد ملخصات │
├─────────────────────────────────────────────────────────┤
│ الطبقة الأساسية │
│ ┌─────────────────────────────────────────────────┐ │
│ │ سياق المحادثة الرئيسي │ │
│ │ الأدوات: Read, Edit, Bash, Glob, Grep, etc. │ │
│ └─────────────────────────────────────────────────┘ │
│ تفاعلك الأساسي؛ سياق محدود؛ يكلف مالاً │
└─────────────────────────────────────────────────────────┘
الطبقة الأساسية: محادثتك الرئيسية. كل رسالة، وقراءة ملف، ومخرج أداة تستهلك سياقاً من نافذة مشتركة بحجم 200 ألف رمز (مليون مع Premium). عندما يمتلئ السياق، يفقد Claude تتبع القرارات السابقة وتتدهور الجودة. هذه الطبقة تكلف مالاً لكل رمز.
طبقة التفويض: الوكلاء الفرعيون يُنشأون بسياقات نظيفة، يقومون بعمل مركّز، ويعيدون ملخصات. نتائج الاستكشاف لا تضخّم محادثتك الرئيسية—فقط الاستنتاجات تعود. استخدم وكلاء Haiku الفرعيين للاستكشاف (رخيص، سريع) و Sonnet للتنفيذ.
طبقة التوسعة: MCP يربط الخدمات الخارجية (قواعد البيانات، GitHub، Sentry). الخطافات تضمن تنفيذ أوامر shell بغض النظر عن سلوك النموذج. المهارات تُشفّر خبرة المجال التي يطبقها Claude تلقائياً. الإضافات تُجمّع كل هذا للتوزيع.
الفكرة الأساسية: معظم المستخدمين يعملون بالكامل في الطبقة الأساسية، يراقبون تضخم السياق وارتفاع التكاليف. المستخدمون المحترفون يدفعون الاستكشاف والعمل المتخصص إلى طبقة التفويض، يحافظون على تكوين طبقة التوسعة لسير عملهم، ويستخدمون الطبقة الأساسية فقط للتنسيق والقرارات النهائية.
جدول المحتويات
- التثبيت والمصادقة
- أوضاع التفاعل الأساسية
- نظام التكوين بالتفصيل
- اختيار النموذج والتبديل
- نظام الأذونات والأمان
- نظام الخطافات
- MCP (بروتوكول سياق النموذج)
- الوكلاء الفرعيون وتفويض المهام
- وضع التفكير الموسّع
- أنماط المخرجات
- أوامر الشرطة المائلة
- المهارات
- نظام الإضافات
- الذاكرة وإدارة السياق
- الصور والمدخلات متعددة الوسائط
- تكامل Git وسير العمل
- تكامل بيئة التطوير
- أنماط الاستخدام المتقدمة
- Claude Code عن بُعد
- الوكلاء في الخلفية
- إدارة التكاليف والفوترة
- تحسين الأداء
- استكشاف الأخطاء وإصلاحها والتصحيح
- النشر المؤسسي
- مرجع اختصارات لوحة المفاتيح
- أفضل الممارسات
التثبيت والمصادقة
متطلبات النظام
يعمل Claude Code على macOS 10.15+، و Ubuntu 20.04+/Debian 10+، و Windows 10+ من خلال WSL أو Git Bash. يتطلب النظام 4 جيجابايت ذاكرة عشوائية كحد أدنى واتصال إنترنت نشط. توافق Shell يعمل بشكل أفضل مع Bash أو Zsh أو Fish.
لنظام Windows، كلا من WSL 1 و WSL 2 يعملان. Git Bash يعمل أيضاً إذا كنت تفضل Windows الأصلي. Alpine Linux والأنظمة الأخرى القائمة على musl تتطلب حزماً إضافية:
apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0
طرق التثبيت
التثبيت الأصلي (موصى به)
الملف الثنائي الأصلي يوفر أنظف تجربة بدون اعتماد على Node.js:
# macOS و Linux
curl -fsSL https://claude.ai/install.sh | bash
# بديل Homebrew
brew install --cask claude-code
# 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
لتثبيت إصدار محدد:
# تثبيت إصدار محدد
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
# تثبيت الأحدث صراحةً
curl -fsSL https://claude.ai/install.sh | bash -s latest
# Windows PowerShell - إصدار محدد
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58
تثبيت NPM
للبيئات التي يُفضّل فيها npm:
npm install -g @anthropic-ai/claude-code
لا تستخدم أبداً sudo مع تثبيت npm—إنه يخلق مشاكل أذونات تُعقّد كل شيء لاحقاً.
الترحيل من تثبيت موجود
إذا كان لديك تثبيت قائم على npm أقدم، رحّل إلى الملف الثنائي الأصلي:
claude install
خيارات المصادقة
يدعم Claude Code ثلاثة مسارات للمصادقة، كل منها بمفاضلات مختلفة:
Claude Console (فوترة API)
اتصل بـ API الخاص بـ Anthropic مباشرة من خلال console.anthropic.com. أنشئ حساباً، وأعدّ الفوترة، وصادق من خلال CLI. هذا يوفر فوترة قائمة على الاستخدام مع وصول كامل لـ API. يتم إنشاء مساحة عمل "Claude Code" مخصصة تلقائياً—لا يمكنك إنشاء مفاتيح API لهذه المساحة، لكن يمكنك مراقبة الاستخدام.
اشتراك Claude Pro أو Max
استخدم بيانات اعتماد حسابك على claude.ai. يغطي الاشتراك كلاً من واجهة الويب واستخدام CLI تحت خطة شهرية واحدة. هذا يبسّط الفوترة للمستخدمين الأفراد الذين يريدون تكاليف متوقعة.
المنصات المؤسسية
AWS Bedrock و Google Vertex AI و Microsoft Foundry كل منها يوفر وصولاً بمستوى مؤسسي مع علاقات فوترة سحابية موجودة:
# AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_PROFILE=your-profile
# Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project
# Microsoft Foundry
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource-name
# اختياري: مصادقة مفتاح API (وإلا يستخدم Entra ID)
export ANTHROPIC_FOUNDRY_API_KEY=your-key
للنشر المؤسسي خلف بروكسي أو من خلال بوابات LLM:
# بروكسي مؤسسي
export HTTPS_PROXY='https://proxy.example.com:8080'
# بوابة LLM (تخطي المصادقة الأصلية)
export CLAUDE_CODE_USE_BEDROCK=1
export ANTHROPIC_BEDROCK_BASE_URL='https://your-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1
التحقق
claude doctor
هذا يُبلّغ عن نوع التثبيت، والإصدار، وتكوين النظام، وأي مشاكل مكتشفة.
التحديثات
Claude Code يُحدّث تلقائياً بشكل افتراضي، يتحقق عند بدء التشغيل ودورياً أثناء الجلسات. التحديثات تُنزّل في الخلفية وتُطبّق عند الإطلاق التالي.
تعطيل التحديث التلقائي:
export DISABLE_AUTOUPDATER=1
أو في settings.json:
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
تحديث يدوي:
claude update
إلغاء التثبيت
التثبيت الأصلي (macOS/Linux/WSL):
rm -f ~/.local/bin/claude
rm -rf ~/.claude-code
التثبيت الأصلي (Windows PowerShell):
Remove-Item -Path "$env:LOCALAPPDATA\Programs\claude-code" -Recurse -Force
Remove-Item -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps\claude.exe" -Force
تنظيف التكوين (يزيل جميع الإعدادات):
rm -rf ~/.claude
rm ~/.claude.json
rm -rf .claude
rm -f .mcp.json
أوضاع التفاعل الأساسية
REPL التفاعلي
شغّل Claude Code بدون وسائط للدخول في حلقة القراءة-التقييم-الطباعة التفاعلية:
cd your-project
claude
REPL يحافظ على سياق المحادثة عبر الدورات. اكتب الاستفسارات مباشرة، واستقبل الردود، واستمر حتى تخرج بـ /exit أو Ctrl+D.
ابدأ بموجه أولي لتركيز الجلسة:
claude "explain the authentication flow in this project"
نصيحة خبير: REPL يحتفظ بالحالة عبر أحداث الضغط. عندما يكبر السياق كثيراً، يلخّص Claude تلقائياً المحادثة الأقدم مع الحفاظ على القرارات الرئيسية ومقتطفات الكود. يمكنك تشغيل هذا يدوياً بـ /compact أو إضافة تعليمات مخصصة لما يجب الحفاظ عليه.
الوضع غير التفاعلي
وضع الطباعة (-p) ينفذ استفساراً واحداً ويخرج:
# استفسار مباشر
claude -p "list all TODO comments in this project"
# معالجة مدخلات مُمرّرة
cat error.log | claude -p "identify the root cause of these failures"
# التسلسل مع أدوات أخرى
claude -p "generate a README" > README.md
لمخرجات منظمة مناسبة للتحليل في السكربتات:
claude -p "count lines by file type" --output-format json
مخرجات JSON تتضمن كل ما تحتاجه للأتمتة:
{
"type": "result",
"subtype": "success",
"total_cost_usd": 0.0034,
"is_error": false,
"duration_ms": 2847,
"duration_api_ms": 1923,
"num_turns": 4,
"result": "نص الرد هنا...",
"session_id": "abc-123-d
[تم اقتطاع المحتوى للترجمة]
