تأتي Claude Code في VS Code كعامل برمجة كامل في الشريط الجانبي — ليست أداة إكمال، بل محلل مشكلات متعدد الخطوات يقرأ مشروعك، ويحرر الملفات، وينفذ الأوامر. يشارك امتداد VS Code محركه مع CLI، لذا فإن أوامر الشرطة المائلة، والوعي بـ CLAUDE.md، واستدعاءات أدوات MCP تعمل جميعها بنفس الطريقة التي تستخدمها بها في الطرفية. ما يجعل الإعداد جديرًا بالفهم هو طبقة الواجهة الخلفية: كل استدعاء استدلال يمر عبر نقطة نهاية تتحكم فيها، وتوجيه نقطة النهاية تلك إلى Novita AI يفتح الوصول إلى نماذج Claude بالإضافة إلى كتالوج أوسع من بدائل البرمجة مفتوحة المصدر — بأسعار تجعل مهام العامل عالية الحجم عملية.
ما الذي تفعله Claude Code في VS Code
امتداد Claude Code في VS Code هو لوحة جانبية، وليس محرك إكمال تلقائي مضمن. افتحه، وصف مهمة، ويقوم Claude Code بتنفيذ عمل متعدد الخطوات: قراءة الملفات، كتابة التغييرات، تشغيل أوامر الصدفة (shell commands)، وانتظار موافقتك على الفروقات (diffs) قبل تطبيقها. هذا التمييز مهم لأن المطورين غالبًا ما يبحثون عن “claude code vs code” متوقعين تجربة مشابهة لـ Copilot — اقتراحات سطر واحد تكمل أثناء الكتابة. هذا ليس ما يقدمه Claude Code. بالنسبة للإكمالات، هناك أدوات أخرى تملأ هذا الدور. Claude Code في VS Code للمهام: كتابة اختبارات لهذه الوحدة، إعادة هيكلة معالج المصادقة، شرح سبب بطء هذا الاستعلام، إنشاء طلب سحب بالتغييرات اليوم.
إمكانيات ملموسة داخل الامتداد:
- تعديلات متعددة الملفات مع فروقات مضمنة. يقترح Claude Code تغييرات عبر ملفات متعددة ويعرض فروقات يمكنك قبولها أو رفضها دون مغادرة المحرر.
- أوامر الشرطة المائلة. تعمل
/compactو/clearو/initو/memoryوأوامر الشرطة المائلة المخصصة التي عرّفتها بنفس الطريقة تمامًا كما في CLI. - تثبيت السياق. البادئة
#تُرفق ملفات أو رموزًا أو مجلدات محددة بالطلب. كتابة#src/auth/handler.ts fix the race conditionتعطي Claude Code السياق الصحيح فورًا. - الوعي بـ CLAUDE.md. معايير الترميز للمشروع، ملاحظات البنية، المكتبات المفضلة — أي شيء في
CLAUDE.mdيُحمّل عند بدء الجلسة. تكتبه مرة واحدة؛ يحترمه العامل في كل جلسة. - استدعاءات أدوات MCP. خوادم MCP المسجلة في إعدادات Claude Code متاحة داخل لوحة الامتداد.
ما لا يفعله الامتداد: استبدال اختصارات المحرر الحالية، تعديل تلوين الصيغة، أو إضافة إكمالات لكل ضغطة مفتاح. إنها واجهة عامل موضوعة فوق سير عملك العادي في VS Code.
كيفية إضافة Claude Code إلى VS Code
افتح لوحة الامتدادات (Ctrl+Shift+X في Windows/Linux، Cmd+Shift+X في macOS). ابحث عن Claude Code وابحث عن الناشر Anthropic. انقر على تثبيت.
إذا كنت تفضل سطر الأوامر:
code --install-extension Anthropic.claude-code
بعد التثبيت، يظهر أيقونة Claude في شريط النشاط على الجانب الأيسر من VS Code. انقر عليها لفتح لوحة العامل.
المصادقة عند التشغيل الأول. يطلب منك الامتداد تسجيل الدخول عند الفتح الأول. مساران:
- حساب Anthropic: عملية OAuth عبر المتصفح — تعمل إذا كان لديك مفتاح API من Anthropic Console أو اشتراك Claude نشط.
- مفتاح API من Novita AI: عيّن
ANTHROPIC_BASE_URLوANTHROPIC_AUTH_TOKENفي بيئة الصدفة (shell) الخاصة بك قبل تشغيل VS Code من تلك الطرفية. يقرأ الامتداد هذه الإعدادات عند بدء التشغيل ويتجاوز تسجيل الدخول إلى Anthropic بالكامل. التفاصيل في القسم التالي.
يقوم VS Code بتحديث الامتداد تلقائيًا في الخلفية. لا تحتاج إلى تتبع الإصدارات يدويًا.
كيف تعمل واجهة LLM الخلفية للواجهة البرمجية
فهم البنية ثلاثية الطبقات يوضح كل قرار تكوين:
- طبقة واجهة المستخدم: امتداد VS Code (أو CLI، أو تطبيق سطح المكتب — أسطح قابلة للتبادل).
- طبقة منطق العامل: محرك Claude Code — تعريفات الأدوات، إدارة الجلسات، قراءة الملفات، تنفيذ الأوامر.
- طبقة واجهة API LLM: نقطة نهاية الاستدلال التي تعالج كل استدعاء لنموذج اللغة.
افتراضيًا، تشير طبقة واجهة API LLM إلى api.anthropic.com. يرسل Claude Code الطلبات باستخدام تنسيق Anthropic Messages API. التفصيل الحاسم: ANTHROPIC_BASE_URL يعيد توجيه جميع تلك الطلبات إلى أي نقطة نهاية متوافقة مع Anthropic. يوفر Novita AI نفس تنسيق Messages API على https://api.novita.ai/anthropic، لذا فإن التبديل يكون شفافًا لطبقة منطق العامل — لا يعلم Claude Code ولا يهتم ما إذا كانت الاستجابة جاءت من خوادم Anthropic أم Novita.
ثلاث متغيرات بيئية إضافية تكمل التكوين:
ANTHROPIC_AUTH_TOKEN— مفتاح API الخاص بك للمزود المختار.ANTHROPIC_MODEL— معرف النموذج لاستخدامه في المهام الرئيسية.ANTHROPIC_SMALL_FAST_MODEL— معرف النموذج للمهام الخلفية السريعة مثل التلخيص وضغط السياق.
عيّن هذه المتغيرات قبل تشغيل VS Code، وسيرثها الامتداد من بيئة الصدفة.
ربط Claude Code بـ Novita AI
الخطوة 1: الحصول على مفتاح API من Novita AI
سجّل في novita.ai وانتقل إلى صفحة إدارة المفاتيح. أنشئ مفتاحًا جديدًا وانسخه فورًا — لن يظهر مرة أخرى.
الخطوة 2: تعيين متغيرات البيئة
في macOS أو Linux، قم بتصدير المتغيرات في الطرفية قبل تشغيل VS Code:
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<your-novita-api-key>"
export ANTHROPIC_MODEL="zai-org/glm-4.6"
export ANTHROPIC_SMALL_FAST_MODEL="zai-org/glm-4.6"
في Windows (موجه الأوامر):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<your-novita-api-key>
set ANTHROPIC_MODEL=zai-org/glm-4.6
set ANTHROPIC_SMALL_FAST_MODEL=zai-org/glm-4.6
ثم قم بتشغيل VS Code من نفس جلسة الطرفية:
code .
الخطوة 3: التحقق من الاتصال
افتح لوحة Claude Code وأرسل رسالة اختبار قصيرة. إذا أعاد الامتداد ردًا، فإن التوجيه يعمل. أنت الآن تُفوتر من خلال Novita AI — لن يتم تحصيل رسوم من حساب Anthropic الخاص بك.
لجعل التكوين دائمًا، أضف تصدير المتغيرات إلى ملف تعريف الصدفة الخاص بك (~/.zshrc، ~/.bashrc، أو ما يعادلها) أو استخدم ملف .env على مستوى المشروع يُدار بواسطة direnv لتبديل النموذج حسب المشروع.
نماذج مفتوحة المصدر تضاهي أداء البرمجة للنماذج مغلقة المصدر
بمجرد أن توجّه حركة المرور عبر Novita AI، فأنت لست مقيدًا بنماذج Claude. يشمل كتالوج LLM من Novita نماذج برمجة مفتوحة المصدر تنافس مباشرة البدائل مغلقة المصدر على المعايير المهمة لمهام البرمجة العاملة.
GLM-4.6 من Zhiyu AI هو مثال عملي. يحمل نافذة سياق بطول 200 ألف رمز (200K token) ويحقق معدل فوز بنسبة 48.6% ضد Claude Sonnet 4 في تقييمات البرمجة الواقعية. لسير العمل العاملة حيث يكون السياق الطويل مهمًا (تصحيح الأخطاء عبر قواعد أكواد كبيرة، قراءة مجموعات اختبار كاملة)، فإن نافذة السياق تلك تمثل ميزة عملية، وليست مجرد رقم في ورقة المواصفات. معرف النموذج في Novita هو zai-org/glm-4.6.
النماذج الأخرى على منصة Novita التي تستحق التقييم لأعباء عمل البرمجة تشمل DeepSeek R1 و Qwen 3 Coder، وكلاهما أظهر أداءً تنافسيًا في معايير توليد الكود واتباع التعليمات. نفس متغير البيئة ANTHROPIC_MODEL يبدل بينها — لا حاجة لإعادة التثبيت أو تكامل جديد.
الحجة التكلفوية للنماذج مفتوحة المصدر: الفرق التي تشغل Claude Code على نطاق واسع — أعداد كبيرة من تشغيلات العامل في خطوط CI، إعدادات متعددة المطورين بمفاتيح Novita API مشتركة، أو جلسات عاملة طويلة تستهلك عددًا كبيرًا من الرموز — تجد أن النماذج مفتوحة المصدر بأسعار Novita تخلق مساحة ذات معنى في ميزانية البنية التحتية. نموذج يؤدي بنسبة 90% من مستوى Claude Sonnet 4 بتكلفة 40% يغير اقتصاديات تشغيل العاملين باستمرار.
Novita Agent Sandbox كبيئة تنفيذ
يمكن لـ Claude Code في VS Code تشغيل أوامر الصدفة محليًا — سيبني مشروعك، ويشغل الاختبارات، ويثبت الحزم، وينشئ ملفات على جهازك. بالنسبة لمعظم المهام اليومية، هذا مقبول. لكن بعض المهام العاملة تُعالج بشكل أفضل في بيئة حاسوبية معزولة: مجموعات اختبار ثقيلة توقف جهازك، خطوات بناء تثبت حزم نظام، أوامر تعدل تكوين النظام، أو تشغيلات عامل متوازية حيث تحتاج إلى قابلية التكرار.
Novita Agent Sandbox يوفر بيئات تنفيذ سحابية مصممة خصيصًا لحالة الاستخدام هذه. وضع الحماية (sandbox) هو جهاز افتراضي صغير (microVM) يبدأ في أجزاء من الثانية، ويشغل الكود في عزلة عن نظام المضيف، وينتهي بشكل نظيف عند انتهاء المهمة. لا توجد حالة متبقية، ولا تأثير على بيئتك المحلية، ولا انتظار لاستعادة وحدة المعالجة المركزية لجهازك.
بالنسبة لمستخدمي Claude Code، فإن سير العمل العملي هو: توجيه الاستدلال إلى نقطة نهاية LLM من Novita AI لاستدعاءات نموذج اللغة، وبالنسبة لمهام التنفيذ الثقيلة — البناء، تشغيل الاختبارات، تقييم الكود — تشغيل مثيل Agent Sandbox عبر Novita Agent Sandbox API. تشترك الخدمتان في المصادقة (نفس مفتاح API من Novita)، لذا لا توجد إدارة منفصلة للبيانات الاعتمادية.
الفرق التي تبني خطوط مراجعة أكواد آلية أو عوامل Claude Code مدمجة مع CI تجد هذه المجموعة مفيدة بشكل خاص: تظل تكلفة LLM قابلة للتنبؤ بأسعار Novita لكل رمز، وتظل تكلفة الحوسبة قابلة للتنبؤ بفوترة Agent Sandbox لكل ثانية.
نصائح لسير العمل اليومي في VS Code
بعض الأنماط التي تجعل الامتداد عمليًا وليس مجرد فضول:
- ابدأ مشاريع جديدة باستخدام
/init. تشغيل/initفي مستودع جديد يُنشئ ملف بدءCLAUDE.md. إنها الطريقة الأكثر كفاءة لإخبار Claude Code باتفاقيات مشروعك قبل أن يبدأ التحرير. - ثبّت السياق باستخدام
#. بدلاً من وصف الملف الذي يجب النظر إليه، اكتب#filenameلإرفاقه مباشرة. لعمل إعادة الهيكلة،#src/components/Button.tsx update the onClick handler to use the new event typeأسرع من “انظر إلى مكون Button و…” - استخدم
/compactبشكل استباقي. في جلسة طويلة، يتراكم السياق لدى Claude Code./compactيلخص المحادثة ويقلل من حمل الرموز. قم بتشغيله بعد الانتهاء من مهمة رئيسية، قبل البدء في المهمة التالية. - اقبل أو ارفض الفروقات (diffs) داخل اللوحة. قبل أن يحرر Claude Code ملفًا، يعرض الفرق في اللوحة. ليس عليك قبول كل تغيير — ارفض الفروقات الجزئية واطلب نهجًا منقحًا. معاملة كل رد كنقطة بداية وليس إجابة نهائية تنتج نتائج أفضل.
- افصل تعليمات المشروع عن تعليمات الجلسة.
CLAUDE.mdمخصص لسياق المشروع المستقر (أوامر البناء، البنية، أسلوب الكود). التعليمات المؤقتة للمهمة الحالية تنتمي إلى موجه الجلسة. لا تزدحمCLAUDE.mdبتوجيهات مهمة واحدة.
الأسئلة الشائعة
أين وثائق امتداد Claude Code في VS Code؟
الوثائق الرسمية للامتداد تُصان بواسطة Anthropic على claude.ai/code. ملاحظات الإصدار وسجل التغييرات مرئية في لوحة امتدادات VS Code تحت قائمة Claude Code.
هل امتداد Claude Code في VS Code مجاني؟
الامتداد نفسه مجاني للتثبيت. تكاليف الاستخدام تعتمد على تكوين الواجهة الخلفية لديك. مع حساب Anthropic، تدفع لكل رمز أو تستخدم أرصدة اشتراك. مع توجيه Novita AI، تدفع سعر Novita لكل رمز ولا تُطبق رسوم Anthropic. الحسابات الجديدة في Novita تتلقى أرصدة تجربة مجانية عند التسجيل.
هل يمكنني استخدام امتداد VS Code وCLI Claude Code في نفس الوقت؟
نعم، لكنهما يعملان كجلستين منفصلتين. امتداد VS Code لا يشارك جلسة حية مع مثيل CLI مفتوح. إذا كنت بحاجة إلى استمرارية الجلسة بينهما، استخدم claude -c في CLI لاستئناف أحدث جلسة من ذلك الدليل.
ما الفرق بين Claude Code و Cline في VS Code؟
Cline هو امتداد VS Code يوجّه عمل العامل عبر أي واجهة خلفية متوافقة مع OpenAI — يمنحك أقصى مرونة في المزود ولكنه يتطلب تكوينًا أكثر. Claude Code هو العامل الخاص بـ Anthropic مع مجموعة أدوات مدمجة بإحكام. إعادة توجيه ANTHROPIC_BASE_URL تعطي Claude Code مرونة خلفية مماثلة عمليًا. إذا كان لديك بالفعل Novita AI معدّة لـ Claude Code، فلن تحتاج إلى تثبيت Cline منفصل للوصول إلى كتالوج نماذج Novita.
هل يمكنني استخدام نماذج مختلفة لمشاريع مختلفة؟
نعم. استخدم direnv مع ملفات .env على مستوى المشروع لتحديد نطاق ANTHROPIC_MODEL لدليل محدد. عندما تفتح ذلك المشروع في VS Code من طرفية مع تفعيل direnv، يرث الامتداد إعداد النموذج الخاص بالمشروع.
Novita AI هي منصة سحابية للذكاء الاصطناعي تقدم للمطورين طريقة سهلة لنشر نماذج الذكاء الاصطناعي باستخدام واجهة برمجة التطبيقات البسيطة لدينا، مع توفير سحابة GPU ميسورة التكلفة وموثوقة للبناء والتوسع.
