Claude Code هو وكيل برمجة يعمل في الطرفية (terminal-first) من Anthropic. يقرأ قاعدة الكود الخاصة بك، ويحرر الملفات، وينفذ الأوامر، ويمكنه الاتصال بالخوادم الخلفية المتوافقة مع Anthropic بدلاً من استخدام API الافتراضي لـ Anthropic فقط. يغطي هذا الدليل إعداد Claude Code CLI، وأوامر الشرطة المائلة، والمهارات المخصصة، وكيفية توجيه الطلبات عبر Novita AI.
إذا كنت بحاجة إلى قواعد بيانات أو متصفحات أو أدوات خارجية أخرى، فاستخدم هذا الدليل مع دليل تكوين MCP Claude.
النقاط الرئيسية
- Claude Code هو وكيل سطر أوامر، وليس مجرد صندوق إدخال نصوص.
/compactو/resumeو/permissionsو/modelهي أوامر جلسة، بينما-pو--resumeهي أعلام CLI.- أوامر الشرطة المائلة المخصصة أصبحت الآن كمهارات، لذا فكل من
.claude/skills/و.claude/commands/مهمة. - يمكن لـ Novita AI أن تعمل كخادم خلفي متوافق مع Anthropic من خلال
ANTHROPIC_BASE_URL. - Claude Code مناسب لكل من سير العمل الشبيه بـ IDE وعمليات الوكيل الآلية.
ما هو Claude Code؟
Claude Code هو أداة البرمجة الوكيلة من Anthropic. يعمل CLI في الطرفية الخاصة بك، لكن نفس الوكيل يظهر أيضًا في تطبيق سطح المكتب، وواجهة المتصفح، وتكاملات المحرر.
CLI هو السطح الأكثر مرونة. يتبع اصطلاحات Unix، لذا يمكنك توجيه الملفات إليه، وتشغيله بشكل غير تفاعلي باستخدام -p، وربطه بالبرامج النصية أو CI. التكوين موجود في CLAUDE.md، و .claude/settings.json، ومتغيرات البيئة، مما يجعله مناسبًا قويًا لسير عمل البرمجة القابلة للتكرار.
في الخلفية، يرسل Claude Code طلبات إلى نقطة نهاية API متوافقة مع Anthropic. افتراضيًا، هذه النقطة هي خدمة Anthropic الخاصة، لكن يمكنك إعادة توجيهها إلى LLM API الخاص بـ Novita AI بمتغير بيئة واحد.
إعداد Claude Code
التثبيت
قم بتثبيت CLI باستخدام Node.js 18 أو أحدث:
npm install -g @anthropic-ai/claude-code
التشغيل الأول
قم بتشغيل Claude Code في دليل مشروع:
cd your-project
claude
في الاستخدام الأول، يطالبك Claude Code بتسجيل الدخول. بعد المصادقة، يقرأ مشروعك وينتظر التعليمات.
إعداد المشروع
قم بتشغيل /init في أي مستودع جديد لإنشاء ملف CLAUDE.md مبدئي. يقرأ Claude Code ملف CLAUDE.md في بداية كل جلسة، لذا فهو المكان المناسب لمعايير البرمجة، والمكتبات المفضلة، وملاحظات البنية، وقوائم المراجعة.
/init
بعد /init، استخدم /memory لتحرير الملف أو تفعيل الذاكرة التلقائية، التي تحفظ الملاحظات التي يسجلها Claude حول مشروعك عبر الجلسات.
مرجع أوامر CLI
| الأمر | الوصف |
|---|---|
claude |
بدء جلسة تفاعلية في الدليل الحالي |
claude "استعلام" |
بدء جلسة مع أمر أولي |
claude -p "استعلام" |
تشغيل استعلام والخروج |
cat file | claude -p "استعلام" |
توجيه محتوى إلى استعلام |
claude -c |
متابعة أحدث جلسة في الدليل الحالي |
claude -r "اسم" "استعلام" |
استئناف جلسة بالاسم أو المعرف |
claude update |
التحديث إلى أحدث إصدار |
claude install stable |
تثبيت أو إعادة تثبيت الإصدار المستقر |
claude auth login |
تسجيل الدخول إلى حساب Anthropic الخاص بك |
claude auth login --console |
تسجيل الدخول باستخدام فواتير مفتاح API بدلاً من الاشتراك |
claude auth status |
عرض حالة المصادقة |
claude mcp |
تكوين خوادم MCP |
claude doctor |
عرض تشخيصات التثبيت والإعدادات |
مرجع أعلام CLI
| العلم | الوظيفة |
|---|---|
-p، --print |
وضع غير تفاعلي؛ طباعة الرد والخروج |
-c، --continue |
تحميل أحدث محادثة |
-r، --resume |
استئناف جلسة بالمعرف أو الاسم |
--model |
تعيين النموذج لهذه الجلسة |
--permission-mode |
البدء في وضع الإذن |
--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 |
تعيين جهد الاستدلال |
التركيبة --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 <تعليمة> |
تفكيك تغيير كبير وتشغيله في أشجار عمل متوازية |
/background |
فصل الجلسة لتشغيلها كوكيل في الخلفية |
الأدوات المساعدة
| الأمر | الغرض |
|---|---|
/help |
عرض الأوامر المتاحة |
/doctor |
تشخيص مشكلات التثبيت والإعدادات |
/usage |
عرض تكلفة الجلسة واستخدام الخطة |
/export |
تصدير المحادثة كنص عادي |
/config |
فتح الإعدادات أو تعيين قيمة مباشرة |
/skills |
عرض المهارات المتاحة |
أوامر الشرطة المائلة المخصصة
أوامر الشرطة المائلة المخصصة أصبحت الآن كمهارات. ملفات .claude/commands/ الحالية لا تزال تعمل، لكن .claude/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/commands/ لا تزال تعمل. ملف في .claude/commands/deploy.md ومهارة في .claude/skills/deploy/SKILL.md كلاهما ينشئ /deploy.
استخدام Novita AI كخادم LLM خلفي
يقوم Claude Code بتوجيه حركة مرور API عبر ANTHROPIC_BASE_URL. تعيينها إلى نقطة نهاية Novita AI المتوافقة مع Anthropic يمنحك الوصول إلى نماذج Novita دون تغيير سير عمل Claude Code.
الحصول على مفتاح 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="moonshotai/kimi-k2-instruct"
export ANTHROPIC_SMALL_FAST_MODEL="moonshotai/kimi-k2-instruct"
على Windows (موجه الأوامر):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<مفتاح API الخاص بـ Novita>
set ANTHROPIC_MODEL=moonshotai/kimi-k2-instruct
set ANTHROPIC_SMALL_FAST_MODEL=moonshotai/kimi-k2-instruct
ANTHROPIC_SMALL_FAST_MODEL يتحكم في النموذج خفيف الوزن الذي يستخدمه Claude Code للمهام الداخلية السريعة مثل البحث عن الملفات والتلخيصات السريعة.
تشغيل Claude Code
cd your-project
claude
للبرمجة النصية و CI، ينطبق نفس النهج:
cat logs.txt | claude -p "ابحث عن أي أنماط أخطاء" --output-format json
يدعم LLM API الخاص بـ Novita AI تنسيق رسائل Anthropic، بما في ذلك استخدام الأدوات والمخرجات المنظمة والبث، لذا يعمل Claude Code دون تعديل.
Agent Sandbox للتنفيذ المعزول
إذا كنت تبني خطوط أنابيب آلية فوق Claude Code، فإن Agent Sandbox من Novita AI يوفر لك تنفيذًا معزولًا لتشغيل الوكيل، وهو مفيد لسير عمل CI ومهام البرمجة متعددة الخطوات.
Claude Code كأداة IDE
غالبًا ما يُوصف Claude Code بأنه “IDE” لأنه يجلس داخل سير العمل الحالي الخاص بك بدلاً من استبداله. بشكل أكثر دقة، هو طبقة وكيل تعمل مع طرفيتك ومحررك وسياق مشروعك.
VS Code و Cursor
قم بتثبيت إضافة Claude Code من سوق VS Code أو من سوق Cursor. بعد التثبيت، افتح لوحة الأوامر، واكتب “Claude Code”، واختر فتح في علامة تبويب جديدة.
يضيف تكامل VS Code مراجعة الفروق المضمنة، وإشارات الملفات، ومراجعة الخطة قبل التعديلات، وسجل المحادثة مباشرة في لوحة المحرر. يمكنك أيضًا استخدام Claude Code في الطرفية المدمجة إلى جانب الإضافة.
JetBrains
قم بتثبيت إضافة Claude Code من سوق JetBrains وأعد تشغيل IDE الخاص بك. توفر عرض الفروق التفاعلي ومشاركة سياق التحديد في IntelliJ IDEA و PyCharm و WebStorm و IDEs JetBrains الأخرى.
تطبيق سطح المكتب والويب
يتيح لك تطبيق سطح المكتب Claude Code مراجعة الفروق بصريًا وتشغيل جلسات متعددة جنبًا إلى جنب. الواجهة web على claude.ai/code تشغل الجلسات في المتصفح دون أي إعداد محلي.
الأسئلة الشائعة
ما هو ANTHROPIC_BASE_URL ولماذا هو مهم؟
يخبر ANTHROPIC_BASE_URL Claude Code بنقطة نهاية API التي يجب إرسال الطلبات إليها. الافتراضي هو API الخاص بـ Anthropic. تعيينها إلى https://api.novita.ai/anthropic يوجه حركة المرور إلى نقطة نهاية Novita AI المتوافقة مع Anthropic.
ما الفرق بين أعلام CLI وأوامر الشرطة المائلة؟
يتم تعيين أعلام CLI عند تشغيل claude من شاشتك الطرفية. أوامر الشرطة المائلة تعمل داخل جلسة نشطة وتغير السلوك في منتصف المحادثة.
هل يمكنني استخدام Claude Code بدون اشتراك Claude؟
نعم. claude auth login --console يسجل دخولك باستخدام فواتير مفتاح API لوحدة تحكم Anthropic. إذا قمت بالتوجيه إلى Novita AI عبر ANTHROPIC_BASE_URL، فأنت تحتاج فقط إلى حساب Novita AI.
كيف تختلف أوامر الشرطة المائلة المخصصة عن CLAUDE.md؟
يتم تحميل CLAUDE.md في بداية كل جلسة ويبقى في السياق. يتم تحميل المهارات فقط عند استدعائها، لذا استخدم CLAUDE.md لحقائق المشروع الدائمة ومهارات الإجراءات القابلة للتكرار.
هل يعمل Claude Code في بيئة CI؟
نعم. استخدم claude -p "استعلام" --output-format json للوضع غير التفاعلي. أضف --max-budget-usd لتحديد الإنفاق و --max-turns لتحديد وقت التنفيذ.
Novita AI هي منصة سحابية للذكاء الاصطناعي تقدم للمطورين طريقة سهلة لنشر نماذج AI باستخدام API البسيط الخاص بنا، مع توفير حوسبة GPU موثوقة وبأسعار معقولة للبناء والتوسع.
