Claude Code هو وكيل برمجة سطر أوامر من Anthropic يقرأ قاعدة الكود الخاصة بك، ويحرر الملفات، وينفذ الأوامر، ويتصل بواجهات برمجة تطبيقات LLM في الخلفية. يغطي هذا الدليل الإعداد، والأعلام، وأوامر الشرطة المائلة، والأوامر المخصصة، وتوجيه استدعاءات API إلى Novita AI. لتوصيل قواعد البيانات، أو المتصفحات، أو مشغلات الكود، استخدم دليل تكوين Claude MCP المنفصل لإعداد CLI وJSON.
ما هو Claude Code؟
Claude Code هو أداة برمجة وكيلية متاحة كـ CLI، وإضافة لـ VS Code، وإضافة لـ JetBrains، وتطبيق سطح مكتب، وواجهة متصفح. تشترك جميع الأسطح في نفس المحرك الأساسي: يتصل Claude Code بواجهة LLM الخلفية، ويقرأ مشروعك، وينفذ مهام متعددة الخطوات مثل كتابة الاختبارات، وإعادة الهيكلة عبر الملفات، وإنشاء طلبات السحب، وإدارة git.
CLI هو السطح الأكثر مرونة. يتبع اتفاقيات Unix — يمكنك توجيه السجلات إليه، وتشغيله في CI باستخدام العلم -p، أو ربطه بأدوات أخرى. يقع التكوين في ملفات (CLAUDE.md، .claude/settings.json، متغيرات البيئة)، لذا يتصرف بشكل متوقع في السياقات الآلية.
تحت الغطاء، يرسل Claude Code كل طلب إلى نقطة نهاية API متوافقة مع Anthropic. افتراضيًا، تلك النقطة هي api.anthropic.com، لكن يمكنك إعادة توجيهها إلى أي مزود متوافق مع Anthropic — بما في ذلك Novita AI — باستخدام متغير بيئة واحد.
إعداد Claude Code
التثبيت
الطريقة الموصى بها على macOS و Linux و WSL هي المثبت الأصلي:
curl -fsSL https://claude.ai/install.sh | bash
على Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
تحديثات المثبتات الأصلية تتم تلقائيًا في الخلفية.
إذا كنت تفضل npm، فإن Node.js 18 أو أعلى مطلوب:
node --version # يجب أن يكون 18 أو أعلى
npm install -g @anthropic-ai/claude-code
Homebrew (macOS) يتتبع قناة الإصدار المستقر:
brew install --cask claude-code
Homebrew لا يقوم بالتحديث التلقائي. قم بتشغيل brew upgrade claude-code عندما تريد أحدث إصدار.
التشغيل الأول
انتقل إلى دليل المشروع وابدأ الجلسة التفاعلية:
cd your-project
claude
في الاستخدام الأول، يطلب منك Claude Code تسجيل الدخول. بعد المصادقة، يقرأ مشروعك وينتظر التعليمات.
إعداد المشروع
قم بتشغيل /init في أي مستودع جديد لإنشاء ملف CLAUDE.md ابتدائي. يقرأ Claude Code ملف CLAUDE.md في بداية كل جلسة، لذا فهو المكان المناسب لمعايير البرمجة، والمكتبات المفضلة، وملاحظات البنية، وقوائم المراجعة.
/init
بعد /init، استخدم /memory لتحرير الملف أو تفعيل الذاكرة التلقائية، التي تحفظ الملاحظات التي يسجلها Claude Code حول مشروعك عبر الجلسات.
مرجع أوامر CLI
أوامر shell ذات المستوى الأعلى في Claude Code تبدأ الجلسات، وتدير المصادقة، وتتعامل مع العمل الخلفي. قائمة جزئية بأكثرها فائدة:
| الأمر | الوصف |
|---|---|
claude |
بدء جلسة تفاعلية في الدليل الحالي |
claude "query" |
بدء جلسة مع مطالبة أولية |
claude -p "query" |
تشغيل استعلام والخروج (وضع غير تفاعلي / وضع SDK) |
cat file | claude -p "query" |
توجيه المحتوى إلى استعلام |
claude -c |
متابعة أحدث جلسة في الدليل الحالي |
claude -r "name" "query" |
استئناف جلسة بالاسم أو المعرف |
claude update |
التحديث إلى أحدث إصدار |
claude install stable |
تثبيت أو إعادة تثبيت إصدار معين |
claude auth login |
تسجيل الدخول إلى حساب Anthropic الخاص بك |
claude auth login --console |
تسجيل الدخول باستخدام فوترة مفتاح API بدلاً من الاشتراك |
claude auth status |
عرض حالة المصادقة |
claude agents --json |
فتح عرض الوكيل، طباعة الجلسات النشطة بصيغة JSON |
claude mcp |
تكوين خوادم MCP |
claude daemon status |
التحقق من حالة المشرف على الجلسات الخلفية |
إذا أخطأت في كتابة أمر فرعي، يقترح Claude Code أقرب تطابق: claude udpate يطبع Did you mean claude update?.
مرجع أعلام CLI
تعدل الأعلام كيفية تصرف Claude Code في جلسة. مررها بعد claude في أي استدعاء. مجموعة من أكثر الأعلام شيوعًا:
| العلم | ما يفعله |
|---|---|
-p, --print |
وضع غير تفاعلي؛ طباعة الرد والخروج |
-c, --continue |
تحميل أحدث محادثة |
-r, --resume |
استئناف جلسة بالمعرف أو الاسم |
--model |
تعيين النموذج لهذه الجلسة (sonnet، opus، haiku، أو معرف نموذج كامل) |
--permission-mode |
البدء في وضع إذن: default، plan، auto، acceptEdits، bypassPermissions |
--add-dir |
منح وصول الملفات إلى دليل إضافي |
--system-prompt |
استبدال المطالبة النظامية بالكامل |
--append-system-prompt |
إلحاق بالمطالبة النظامية الافتراضية |
--max-turns |
تحديد عدد الأدوار الوكيلية في وضع -p |
--max-budget-usd |
تحديد الحد الأقصى لإنفاق API في وضع -p |
--output-format |
تنسيق الإخراج لوضع -p: text، json، stream-json |
--bg |
البدء كوكيل خلفي، والعودة فورًا |
--worktree, -w |
البدء في شجرة عمل git معزولة |
--bare |
تخطي الاكتشاف التلقائي للخطافات والمهارات والإضافات و MCP لاستدعاءات نصية أسرع |
--verbose |
عرض الإخراج الكامل لكل دورة |
--mcp-config |
تحميل خوادم MCP من ملف JSON |
--effort |
تعيين جهد التفكير: low، medium، high، xhigh، max |
التوليف --print + --output-format json هو النمط القياسي للبرمجة النصية. لخطوط أنابيب CI ذات قيود الميزانية، ادمجه مع --max-budget-usd و --max-turns.
توثيق أوامر الشرطة المائلة
أوامر الشرطة المائلة تعمل داخل جلسة نشطة. اكتب / لرؤية كل ما هو متاح، أو / متبوعة بأحرف للتصفية. الأوامر تعمل فقط في بداية الرسالة.
إدارة الجلسة والسياق
| الأمر | الغرض |
|---|---|
/clear |
بدء محادثة جديدة؛ تبقى الجلسة السابقة في /resume |
/compact |
تلخيص المحادثة لتحرير مساحة نافذة السياق |
/context |
تصور استخدام السياق ورؤية اقتراحات التحسين |
/resume |
إعادة فتح جلسة سابقة باسمها أو من منتقي |
/branch |
تفرع المحادثة لتجربة اتجاه مختلف |
/rewind |
التراجع بالكود والمحادثة إلى نقطة تفتيش |
إعداد المشروع
| الأمر | الغرض |
|---|---|
/init |
إنشاء ملف CLAUDE.md ابتدائي للمشروع |
/memory |
تحرير ملفات CLAUDE.md وإدارة الذاكرة التلقائية |
/mcp |
إدارة اتصالات خادم MCP بشكل تفاعلي |
/agents |
تكوين إعدادات الوكيل الفرعي |
/permissions |
تعيين قواعد السماح والطلب والرفع للأدوات |
/hooks |
عرض تكوينات الخطافات |
سير العمل التطويري
| الأمر | الغرض |
|---|---|
/plan |
الدخول إلى وضع التخطيط قبل تغيير كبير |
/model |
تبديل النموذج النشط |
/effort |
ضبط مستوى جهد التفكير |
/diff |
فتح عارض الفروق التفاعلي |
/code-review [--fix] |
مراجعة الفرق الحالي؛ --fix يطبق النتائج |
/security-review |
فحص أمني عميق للتغييرات المعلقة |
/batch <instruction> |
تحليل تغيير كبير وتشغيله بالتوازي في أشجار العمل |
/background |
فصل الجلسة لتشغيلها كعامل خلفي |
الأدوات المساعدة
| الأمر | الغرض |
|---|---|
/help |
عرض الأوامر المتاحة |
/doctor |
تشخيص مشكلات التثبيت والإعدادات |
/usage |
عرض تكلفة الجلسة واستخدام الخطة |
/export |
تصدير المحادثة كنص عادي |
/config |
فتح الإعدادات أو تعيين قيمة مباشرة: /config thinking=false |
/skills |
سرد المهارات المتاحة |
أوامر الشرطة المائلة المخصصة
أوامر الشرطة المائلة المخصصة — التي تسمى الآن مهارات — تتيح لك حزم إجراءات قابلة للتكرار يمكن لفريقك مشاركتها.
كيفية إنشاء أمر مخصص
أنشئ دليلاً تحت .claude/skills/ (على مستوى المشروع) أو ~/.claude/skills/ (شخصي، متاح عبر جميع المشاريع):
mkdir -p .claude/skills/review-pr
أنشئ ملف SKILL.md داخل ذلك الدليل:
---
description: مراجعة طلب سحب مفتوح على GitHub بحثًا عن مشكلات أمنية وثغرات في تغطية الاختبار. استخدم عندما يطلب المستخدم مراجعة طلب سحب أو التحقق من جودة طلب السحب.
---
## التعليمات
راجع طلب السحب مع هذه الأولويات:
1. تحديد أي ثغرات أمنية: مخاطر الحقن، فجوات المصادقة، كشف البيانات.
2. التحقق من تغطية الاختبار لمسارات الكود الجديدة.
3. الإبلاغ عن أي معالجة مفقودة للأخطاء عند حدود النظام.
لخص النتائج في ثلاثة أقسام: الأمان، التغطية، أخرى. استخدم ✓ للفحوصات الناجحة و⚠ للمشكلات.
هذا ينشئ أمر /review-pr يمكنك استدعاؤه مباشرة:
/review-pr
يقوم Claude أيضًا بتحميل المهارة تلقائيًا عندما تطلب شيئًا يطابق الوصف.
مواقع المهارات والأولوية
تتبع المهارات ترتيب أولوية: المؤسسة تتجاوز الشخصي، الشخصي يتجاوز المشروع. مهارات المشروع في .claude/skills/. المهارات الشخصية (المتاحة في جميع مشاريعك) توضع في ~/.claude/skills/.
~/.claude/skills/ → شخصي، جميع المشاريع
.claude/skills/ → هذا المشروع فقط
الأوامر المخصصة في .claude/commands/ لا تزال تعمل. ملف في .claude/commands/deploy.md ومهارة في .claude/skills/deploy/SKILL.md كلاهما ينشئ /deploy ويتصرفان بنفس الطريقة.
حقن السياق الديناميكي
يمكن للمهارات حقن بيانات حية قبل أن يرى Claude المطالبة. البادئة ! تشغل أمر shell وتضمّن مخرجاته:
---
description: تلخيص التغييرات غير الملتزمة وتحديد المخاطر.
---
## الفرق الحالي
!`git diff HEAD`
## التعليمات
لخص التغييرات في نقاط. حدد أي مخاطر: معالجة مفقودة للأخطاء، قيم ثابتة، مسارات غير مختبرة.
عند تشغيل هذه المهارة، ينفذ Claude Code git diff HEAD ويستبدل ذلك السطر بمخرجات الفرق الفعلية. يرى Claude حالة شجرة العمل الحقيقية بدلاً من الاضطرار إلى طلبها عبر استدعاءات الأداة.
استخدام Novita AI كخلفية LLM
يقوم Claude Code بتوجيه جميع حركة مرور API عبر متغير البيئة ANTHROPIC_BASE_URL. تعيينه إلى نقطة نهاية Novita AI المتوافقة مع Anthropic يمنحك الوصول إلى مجموعة واسعة من النماذج — بما في ذلك DeepSeek و Kimi و Qwen و GLM — بتكلفة أقل بكثير لكل رمز مقارنة بنقطة نهاية Anthropic الافتراضية.
احصل على مفتاح API الخاص بـ Novita AI
قم بالتسجيل للحصول على حساب Novita AI لاستلام أرصدة تجربة مجانية. انتقل إلى صفحة إدارة المفاتيح، وانقر على إنشاء مفتاح جديد، وانسخ المفتاح فورًا.
تعيين متغيرات البيئة
على Mac و Linux:
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Your Novita API Key>"
export ANTHROPIC_MODEL="deepseek/deepseek-v4-flash"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek/deepseek-v4-flash"
على Windows (موجه الأوامر):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Your Novita API Key>
set ANTHROPIC_MODEL=deepseek/deepseek-v4-flash
set ANTHROPIC_SMALL_FAST_MODEL=deepseek/deepseek-v4-flash
لجعلها دائمة على Mac/Linux، أضف أسطر export إلى ~/.bashrc أو ~/.zshrc.
ANTHROPIC_SMALL_FAST_MODEL يتحكم في النموذج خفيف الوزن الذي يستخدمه Claude Code للمهام الداخلية السريعة مثل عمليات البحث عن الملفات والملخصات السريعة. تعيينها إلى نفس معرف النموذج يحافظ على جميع حركة المرور على حساب فوترة واحد.
ابدأ Claude Code
مع وجود متغيرات البيئة، قم بتشغيل Claude Code بشكل طبيعي:
cd your-project
claude
يتصل Claude Code بنقطة نهاية Novita AI مع النموذج الذي حددته. تعمل الجلسة التفاعلية بشكل مماثل — جميع أعلام CLI، وأوامر الشرطة المائلة، والمهارات المخصصة تتصرف بنفس الطريقة بغض النظر عن الخلفية المستخدمة.
للبرمجة النصية و CI، ينطبق نفس النهج:
cat logs.txt | claude -p "find any error patterns" --output-format json
واجهة برمجة تطبيقات LLM من Novita AI تدعم تنسيق رسائل Anthropic الكامل، بما في ذلك استخدام الأدوات، والمخرجات المنظمة، والبث، لذا فإن كل ميزات Claude Code تعمل دون تعديل.
Agent Sandbox للتنفيذ المعزول
إذا كنت تبني خطوط أنابيب آلية فوق Claude Code، فإن Agent Sandbox من Novita AI يوفر بيئات تنفيذ معزولة مدعومة بـ firecracker لتشغيل الوكلاء برمجيًا. هذا مناسب لسير عمل CI، والعملاء الخلفيين، وأي إعداد متعدد الوكلاء حيث تحتاج إلى عزل التنفيذ بدلاً من التشغيل مباشرة على جهاز التطوير الخاص بك.
Claude Code كأداة IDE
يتكامل Claude Code مع المحررات مباشرة، وهذا ما يعنيه الناس عندما يقولون “claude code هو ide” — إنه ليس IDE قائم بذاته بل وكيل برمجة يدمج في بيئتك الحالية.
VS Code و Cursor
قم بتثبيت إضافة Claude Code من سوق VS Code (ابحث عن “Claude Code”) أو من سوق Cursor. بعد التثبيت، افتح لوحة الأوامر (Cmd+Shift+P / Ctrl+Shift+P)، اكتب “Claude Code”، واختر فتح في علامة تبويب جديدة.
تكامل VS Code يضيف مراجعة الفروق المضمنة، وإشارات @-ملف، ومراجعة الخطة قبل التعديلات، وسجل المحادثة مباشرة في لوحة المحرر. يمكنك أيضًا استخدام Claude Code في الطرفية المدمجة جنبًا إلى جنب مع الإضافة.
JetBrains
قم بتثبيت إضافة Claude Code من سوق JetBrains وأعد تشغيل IDE الخاص بك. تتطلب الإضافة تثبيت CLI بشكل منفصل. توفر عرض الفروق التفاعلي ومشاركة سياق التحديد في IntelliJ IDEA و PyCharm و WebStorm و IDEs JetBrains الأخرى.
تطبيق سطح المكتب والويب
تطبيق سطح المكتب Claude Code (macOS و Windows) يتيح لك مراجعة الفروق بصريًا، وتشغيل جلسات متعددة جنبًا إلى جنب، وجدولة المهام المتكررة. الواجهة الويب على claude.ai/code تشغل الجلسات في المتصفح دون إعداد محلي، مفيد للمستودعات التي لا تملكها محليًا أو لبدء مهام طويلة يمكنك مراقبتها عن بعد.
الأسئلة الشائعة
ما هو ANTHROPIC_BASE_URL ولماذا هو مهم؟
ANTHROPIC_BASE_URL يخبر Claude Code بنقطة نهاية API التي يجب إرسال الطلبات إليها. الافتراضي هو api.anthropic.com. تعيينه إلى https://api.novita.ai/anthropic يوجه جميع حركة المرور إلى نقطة نهاية Novita AI المتوافقة مع Anthropic، حيث يمكنك استخدام نماذج بديلة بأسعار مختلفة. لا حاجة لتغييرات في الكود أو إضافات — فقط متغير البيئة.
ما الفرق بين أعلام CLI وأوامر الشرطة المائلة؟
أعلام CLI (مثل --model، --permission-mode، --max-turns) تُعيّن عند تشغيل ثنائي claude من shell الخاص بك. تقوم بتكوين الجلسة قبل أن تبدأ. أوامر الشرطة المائلة (مثل /model، /plan، /compact) تعمل داخل جلسة نشطة وتغير السلوك في منتصف المحادثة.
هل يمكنني استخدام Claude Code بدون اشتراك Claude؟
نعم. claude auth login --console يسجل دخولك باستخدام فوترة مفتاح API لوحدة تحكم Anthropic، والتي تستخدم تسعير الدفع لكل رمز بدلاً من الاشتراك. إذا قمت بالتوجيه إلى Novita AI عبر ANTHROPIC_BASE_URL، فأنت تحتاج فقط إلى حساب Novita AI — لا يتم فوترة حساب Anthropic الخاص بك.
كيف تختلف أوامر الشرطة المائلة المخصصة عن CLAUDE.md؟
محتوى CLAUDE.md يُحمّل في بداية كل جلسة ويبقى في السياق طوال الوقت. المهارات (الأوامر المخصصة) تُحمّل فقط عند استدعائها، لذا فإن المواد المرجعية الطويلة لا تضيف تكلفة رمز حتى تحتاجها فعليًا. استخدم CLAUDE.md للحقائق المتعلقة بالمشروع التي يجب أن يعرفها Claude دائمًا — معايير البرمجة، أوامر البناء، ملاحظات البنية. استخدم المهارات للإجراءات التي تشغلها عند الطلب — قوائم مراجعة طلبات السحب، خطوات النشر، سير عمل توليد الاختبارات.
هل يعمل Claude Code في CI؟
نعم. استخدم claude -p "query" --output-format json للوضع غير التفاعلي مع إخراج منظم. أضف --max-budget-usd لتحديد الإنفاق و --max-turns لتحديد وقت التنفيذ. العلم --bare يتخطى الاكتشاف التلقائي للخطافات والمهارات والإضافات لبدء تشغيل أسرع في السياقات النصية. يتكامل Claude Code أيضًا مع GitHub Actions و GitLab CI/CD من خلال قوالب سير العمل الرسمية.
Novita AI هي منصة سحابية للذكاء الاصطناعي تقدم للمطورين طريقة سهلة لنشر نماذج الذكاء الاصطناعي باستخدام واجهة برمجة تطبيقات بسيطة، مع توفير GPU سحابي ميسور التكلفة وموثوق للبناء والتوسع.
