Claude Code هو وكيل برمجة سطر أوامر من Anthropic يقرأ قاعدة الأكواد الخاصة بك، ويحرر الملفات، وينفذ الأوامر، ويتصل بواجهات LLM API في الخلفية. يغطي هذا الدليل توثيق CLI الكامل: كيفية إعداده، وما هي العلامات وأوامر الشرطة المائلة المتاحة، وكيفية كتابة أوامر شرطة مائلة مخصصة، وكيفية توجيه استدعاءات API الخاصة به إلى Novita AI بدلاً من نقطة نهاية Anthropic الافتراضية.
ما هو Claude Code؟
Claude Code هو أداة برمجة وكيلية متاحة كـ CLI، وإضافة لـ VS Code، وإضافة لـ JetBrains، وتطبيق سطح مكتب، وواجهة متصفح. تشترك جميع الأسطح في نفس المحرك الأساسي: يتصل Claude Code بخلفية LLM API، ويقرأ مشروعك، وينفذ مهام متعددة الخطوات مثل كتابة الاختبارات، وإعادة الهيكلة عبر الملفات، وإنشاء طلبات السحب، وإدارة 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` في بداية كل جلسة، لذا فهو المكان المناسب لمعايير البرمجة، والمكتبات المفضلة، وملاحظات البنية، وقوائم المراجعة.
```text
/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 يطبع هل تقصد 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 بحثًا عن مشكلات أمنية وثغرات في تغطية الاختبار. استخدم عندما يطلب المستخدم مراجعة PR أو التحقق من جودة طلب السحب.
---
## التعليمات
راجع طلب السحب مع هذه الأولويات:
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="<مفتاح API الخاص بـ Novita>"
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=<مفتاح API الخاص بـ Novita>
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 "ابحث عن أي أنماط أخطاء" --output-format json
تدعم واجهة LLM API الخاصة بـ 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 من شاشتك. تقوم بتكوين الجلسة قبل بدايتها. يتم تشغيل أوامر الشرطة المائلة (مثل /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 دائمًا — معايير البرمجة، أوامر البناء، ملاحظات البنية. استخدم المهارات للإجراءات التي تشغلها عند الطلب — قوائم مراجعة PR، خطوات النشر، سير عمل إنشاء الاختبارات.
هل يعمل Claude Code في CI؟
نعم. استخدم claude -p "query" --output-format json للوضع غير التفاعلي مع الإخراج المنظم. أضف --max-budget-usd لتحديد الإنفاق و --max-turns لتحديد وقت التنفيذ. تتجاوز العلامة --bare الاكتشاف التلقائي للروابط والمهارات والإضافات لبدء تشغيل أسرع في السياقات النصية. يتكامل Claude Code أيضًا مع GitHub Actions و GitLab CI/CD من خلال قوالب سير العمل الرسمية.
Novita AI هي منصة سحابية للذكاء الاصطناعي توفر للمطورين طريقة سهلة لنشر نماذج الذكاء الاصطناعي باستخدام واجهة API البسيطة الخاصة بنا، مع توفير GPU سحابي ميسور وموثوق للبناء والتوسع.
