يعمل Claude Code كإضافة أصلية لـ VS Code يتم تثبيتها مباشرة من السوق — لا حاجة لعلامة تبويب متصفح أو نسخ ولصق بين النوافذ. تضمّن الإضافة نفس محرك Claude Code الذي يُشغّل واجهة سطر الأوامر (CLI)، لذا فإن كل شيء بدءًا من أوامر الشرطة المائلة إلى تحرير الملفات إلى استدعاءات أدوات MCP يعمل بنفس الطريقة، ولكن داخل الشريط الجانبي لمحررك. كما تحصل PyCharm وبقية عائلة JetBrains على نفس المعاملة من خلال إضافة مخصصة لـ JetBrains. ولأن كلا السطحين يقرآن ANTHROPIC_BASE_URL من البيئة، فإن تحويل خلفية LLM إلى واجهة برمجة تطبيقات Novita AI — مع مجموعة نماذجها الأوسع — يتطلب تغيير متغير بيئة واحد فقط.
ما الذي تفعله إضافة VS Code بالضبط؟
إضافة Claude Code لـ VS Code ليست مجرد علامة تبويب دردشة ملحقة بمحررك. إنها تُظهر وكيل Claude Code الكامل داخل لوحة جانبية: نفس واجهة REPL، نفس مجموعة الأدوات، نفس استمرارية الجلسة. عندما تطلب منها إعادة هيكلة دالة أو كتابة اختبارات لملف مفتوح لديك، فإنها تقرأ وتحرر تلك الملفات مباشرة في مساحة العمل الخاصة بك — دون الحاجة إلى الحافظة.
أمور ملموسة تتعامل معها الإضافة:
- تعديلات متعددة الملفات مع فروقات مضمنة. يقترح Claude Code تغييرات ويعرض فرقًا يمكنك قبوله أو رفضه دون مغادرة المحرر.
- أوامر الشرطة المائلة. تعمل أوامر
/compactو/initو/memoryو/clearوباقي الأوامر بنفس طريقة CLI. - تثبيت السياق. تتيح لك البادئة
#إرفاق ملفات أو مجلدات أو رموز محددة كسياق لطلبك. - الوعي بـ CLAUDE.md. يتم تحميل تعليمات المشروع ومعايير البرمجة التي كتبتها في
CLAUDE.mdتلقائيًا عند بدء الجلسة. - استدعاءات أدوات MCP. أي خوادم MCP مسجلة في إعدادات Claude Code تكون متاحة داخل الإضافة.
ما لا تفعله: لا تضيف الإكمال التلقائي للذكاء الاصطناعي في مخزن المحرر. لهذا، توجد أدوات مثل Copilot أو Cline لدور مختلف. Claude Code في VS Code هو وكيل — تعطيه مهمة فينفذ خطوات متعددة، وليس مجرد إكمال سطري واحد.
تثبيت Claude Code في VS Code
افتح لوحة الإضافات في VS Code (Ctrl+Shift+X على ويندوز/لينكس، Cmd+Shift+X على macOS). ابحث عن Claude Code وابحث عن الإضافة المنشورة بواسطة Anthropic. انقر على تثبيت.
بدلاً من ذلك، قم بتشغيل هذا الأمر من الطرفية:
code --install-extension Anthropic.claude-code
بعد التثبيت، يظهر رمز Claude في شريط النشاط في VS Code على اليسار. انقر عليه لفتح لوحة Claude Code.
المصادقة عند التشغيل الأول. تطالبك الإضافة بتسجيل الدخول. لديك مساران:
- حساب Anthropic (اشتراك أو فاتورة وحدة التحكم): انقر من خلال تدفق OAuth في المتصفح.
- توجيه مفتاح API إلى Novita AI: تجاوز مصادقة Anthropic بالكامل. قم بتعيين
ANTHROPIC_BASE_URLوANTHROPIC_AUTH_TOKENفي بيئتك قبل تشغيل VS Code، وستستخدمها الإضافة بدلاً من ذلك. الإرشادات الكاملة في القسم التالي.
التحديثات التلقائية. يقوم VS Code بتحديث الإضافة في الخلفية عند إعادة تشغيل المحرر. لا تحتاج إلى إدارة الإصدارات يدويًا.
استخدام Claude Code في VS Code يوميًا
بمجرد فتح اللوحة، سير العمل واضح. اكتب طلبًا، يقرأ Claude Code مساحة عملك ويُرد بإجراءات مقترحة. قبل أن يحرر ملفًا، يعرض عليك فرقًا وينتظر الموافقة افتراضيًا.
بعض الأنماط التي تجعل الاستخدام اليومي فعالاً:
أشر إلى الملف الذي تنظر إليه. اكتب # متبوعًا باسم ملف لإرفاقه صراحةً كسياق. بالنسبة لملف مفتوح بالفعل في المحرر النشط، عادةً ما يلتقطه Claude Code تلقائيًا، لكن # مفيدة عندما تريد تثبيت ملف معين عبر مهمة متعددة الملفات.
قم بتشغيل /init مرة واحدة في مشروع جديد. يؤدي ذلك إلى إنشاء CLAUDE.md في جذر المستودع حيث يمكنك تخزين تعليمات خاصة بالمشروع — المكتبات المفضلة، ملاحظات البنية، اتفاقيات الاختبار. يقرأها Claude Code في كل بداية جلسة، لذا لا تكرر نفسك.
استخدم /compact عندما تطول الجلسة. مثل CLI، تقوم الإضافة بضغط تاريخ المحادثة عند الطلب لتحرير مساحة السياق للمهمة الحالية.
تحقق من قائمة الأدوات قيد التشغيل. في أسفل اللوحة، يعرض VS Code الأداة التي يستدعيها Claude Code حاليًا (قراءات الملفات، أوامر bash، عمليات البحث على الويب). هذا مفيد لفهم ما يحدث في المهام الآلية الطويلة.
التراجع (Undo) هو صديقك. جميع تعديلات الملفات تمر عبر نظام ملفات VS Code القياسي، لذا فإن Ctrl+Z يعيدها مثل أي تعديل يدوي. لا توجد مكدس تراجع منفصل لتغييرات Claude Code.
توجيه الإضافة إلى Novita AI
تقرأ إضافة VS Code ANTHROPIC_BASE_URL من البيئة عند بدء التشغيل — نفس المتغير الذي تستخدمه CLI. يؤدي تعيينه إلى نقطة نهاية Novita AI المتوافقة مع Anthropic إلى إعادة توجيه كل استدعاء API بعيدًا عن خوادم Anthropic. تحصل على الوصول إلى DeepSeek و Kimi K2 و Qwen و GLM ونماذج أخرى على بنية Novita AI، ويتم إصدار الفاتورة من خلال حساب Novita AI الخاص بك بمعدلات الرموز الخاصة بـ Novita.
الحصول على مفتاح API من Novita AI
اشترك في حساب Novita AI للحصول على أرصدة تجربة مجانية. انتقل إلى إدارة المفاتيح، وأنشئ مفتاحًا جديدًا، وانسخه. يحل هذا المفتاح محل مفتاح API الخاص بـ Anthropic عند التوجيه عبر Novita.
تعيين متغيرات البيئة قبل تشغيل VS Code
macOS و Linux — أضف هذه إلى ملف تعريف القشرة الخاص بك (.zshrc أو .bashrc أو ما يعادلها)، ثم أعد تحميله:
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"
source ~/.zshrc # أو ~/.bashrc
ويندوز (ثابت — يبقى بعد إعادة التشغيل) — استخدم PowerShell لتعيين متغيرات البيئة على مستوى المستخدم:
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.novita.ai/anthropic","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","<Your Novita API Key>","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL","deepseek/deepseek-v4-flash","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL","deepseek/deepseek-v4-flash","User")
أعد تشغيل VS Code بعد تعيين هذه المتغيرات حتى تقرأها الإضافة.
ويندوز (الجلسة فقط):
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
بعد تعيين هذه، قم بتشغيل VS Code من نفس القشرة. تلتقط الإضافة المتغيرات عند بدء التشغيل. لا تحتاج إلى تسجيل الدخول إلى Anthropic — تتعامل Novita مع المصادقة من خلال مفتاح API.
اختيار نموذج
يخبر ANTHROPIC_MODEL Claude Code بالنموذج الذي سيستخدمه للمهام الأساسية؛ يتحكم ANTHROPIC_SMALL_FAST_MODEL في العمليات الخلفية مثل ملخصات الملفات. يمكن تعيين أي نموذج متاح على API نماذج LLM من Novita AI هنا. النماذج المستخدمة بشكل متكرر مع Claude Code على Novita تشمل DeepSeek V4 Flash و Kimi K2 و GLM-4.6 — كل منها بأحجام نافذة سياق مختلفة وأسعار وخصائص أداء تعتمد على عبء عملك.
للرجوع إلى التوجيه الافتراضي لـ Anthropic، قم بإلغاء تعيين متغيرات البيئة:
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL ANTHROPIC_SMALL_FAST_MODEL
أو افتح VS Code من قشرة لم يتم تعيين هذه المتغيرات فيها مطلقًا.
تكامل PyCharm و JetBrains
يشحن Claude Code إضافة رسمية لمنصة JetBrains، والتي تغطي PyCharm و IntelliJ IDEA و WebStorm و GoLand و Rider وباقي عائلة JetBrains.
تثبيت الإضافة
افتح الإعدادات ← الإضافات في IDE الخاص بـ JetBrains، وانتقل إلى علامة التبويب السوق (Marketplace)، وابحث عن Claude Code. انقر على تثبيت، ثم أعد تشغيل IDE عند المطالبة.
بدلاً من ذلك، قم بتنزيل ملف الإضافة من موقع JetBrains Marketplace وقم بتثبيته عبر الإعدادات ← الإضافات ← تثبيت إضافة من القرص.
التشغيل الأول
بعد التثبيت، تظهر لوحة Claude Code في الشريط الجانبي لـ IDE أو منطقة نافذة الأداة حسب تخطيطك. يطالب التشغيل الأول بالمصادقة، مماثلًا لـ VS Code.
توجيه PyCharm إلى Novita AI
تقرأ إضافة JetBrains نفس متغيرات البيئة مثل إضافة VS Code و CLI. قم بتعيين ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN و ANTHROPIC_MODEL و ANTHROPIC_SMALL_FAST_MODEL في ملف تعريف القشرة الخاص بك قبل تشغيل IDE، وستوجه الإضافة عبر Novita.
إذا قمت بتشغيل PyCharm من مشغل سطح المكتب بدلاً من الطرفية (شائع على macOS و Linux)، فقد لا يرث IDE بيئة القشرة الخاصة بك. الإصلاح الموثوق هو ملف .env لكل مشروع أو تعيين المتغيرات في بيئة النظام بدلاً من ملف تعريف القشرة. على macOS تحديدًا، تكون المتغيرات المعينة عبر launchctl setenv مرئية لتطبيقات واجهة المستخدم الرسومية.
إضافة IDE مقابل CLI: متى تستخدم كلًا منهما
تشترك الإضافة و CLI في نفس المحرك. الفرق العملي هو السياق والتكامل.
| إضافة VS Code / JetBrains | CLI | |
|---|---|---|
| التنقل في الملفات | انقر للفتح، # للإشارة |
يقرأ من دليل العمل الحالي؛ حدد المسارات صراحة |
| مراجعة الفروق | مضمنة في المحرر | مخرجات الطرفية |
| مشاريع متعددة | لوحة واحدة لكل نافذة | جلسات منفصلة لكل دليل |
| CI/CD والأتمتة | غير مناسبة | علامة -p للتشغيلات الدفعية غير التفاعلية |
| التوجيه والبرمجة النصية | غير مدعومة | دعم كامل لأنابيب Unix |
| توجيه Novita AI | متغير بيئة ANTHROPIC_BASE_URL |
نفس الشيء |
الإضافة هي الخيار الأفضل عندما يكون سير عملك الأساسي هو تحرير الكود بشكل تفاعلي. CLI هو الخيار الصحيح عندما تقوم بأتمتة المهام، أو تشغيل Claude Code في البرامج النصية، أو التكامل مع CI، أو البناء على SDK Claude Code.
صندوق الحماية للوكيل من Novita AI
إذا انتقلت من التطوير التفاعلي إلى خطوط الأنابيب الآلية — تشغيل وكلاء Claude Code بدون رأس، أو إنشاء وكلاء متعددين ضد مستودعات مختلفة، أو بناء أدوات تقييم — يوفر صندوق حماية الوكيل من Novita AI بيئات تنفيذ معزولة لتشغيل الوكلاء برمجيًا. كل صندوق حماية هو آلة افتراضية مدعومة بـ Firecracker، لذا تعمل الوكلاء في عزلة دون التأثير على جهاز التطوير الخاص بك.
الأسئلة الشائعة
هل أحتاج إلى اشتراك مدفوع في Anthropic لاستخدام إضافة VS Code؟
لا — إذا قمت بتوجيه الإضافة إلى Novita AI عبر ANTHROPIC_BASE_URL، فإن كل الفوترة تتم من خلال حساب Novita AI الخاص بك. لا يلزم وجود حساب Anthropic ولا يتم إصدار فاتورة له.
كيف أقوم بتثبيت إضافة Claude Code لـ VS Code؟
افتح لوحة الإضافات في VS Code (Ctrl+Shift+X)، وابحث عن Claude Code (الناشر: Anthropic)، وانقر على تثبيت. أو قم بتشغيل code --install-extension Anthropic.claude-code من الطرفية.
هل تعمل إضافة Claude Code في Cursor؟
Cursor هو fork من VS Code ويدعم معظم إضافات VS Code. قد يتم تثبيت إضافة Claude Code، لكن Cursor يشحن بالفعل تكامل Claude المدمج الخاص به. تشغيل كليهما في وقت واحد يمكن أن ينتج اقتراحات مكررة وتدفقات مصادقة متعارضة. معظم المطورين يستخدمون واحدًا أو الآخر، وليس كليهما.
هل هناك إضافة متصفح لـ Claude؟
لا توجد إضافة متصفح رسمية من Anthropic. يعمل Claude Code كإضافة VS Code، وإضافة JetBrains، و CLI، وتطبيق سطح المكتب، ومن خلال واجهة الويب على claude.ai/code — ولكن ليس كإضافة متصفح تتصل بصفحات الويب العشوائية.
كيف أبدّل النماذج دون إعادة تشغيل VS Code؟
غيّر ANTHROPIC_MODEL في ملف تعريف القشرة الخاص بك، ثم أعد فتح VS Code من جلسة طرفية جديدة. داخل جلسة VS Code قيد التشغيل، لا يوجد مبدّل نماذج داخل اللوحة — يتم قراءة متغير البيئة عند بدء التشغيل.
هل يمكنني استخدام نماذج مختلفة لمشاريع مختلفة؟
نعم. قم بتعيين ANTHROPIC_MODEL في ملف .env على مستوى المشروع أو في تعليمات CLAUDE.md، أو استخدم direnv لنطاق متغيرات البيئة إلى أدلة محددة. يحترم Claude Code قيم البيئة على مستوى الجلسة، لذا فإن التوجيه لكل مشروع قابل للتحقيق باستخدام أدوات dotfile القياسية.
كيف يختلف دمج Claude مع VS Code عن استخدام Cline؟
Cline هي إضافة تحول VS Code إلى بيئة برمجة وكيلية باستخدام أي خلفية متوافقة مع OpenAI. Claude Code هو وكيل Anthropic الخاص، متاح كإضافة VS Code، مع مجموعة أدواته وحلقة التفكير الخاصة به. الفرق العملي الرئيسي: يمنحك Cline تحكمًا أكبر في الموفر والنموذج الذي يدير الحلقة، بينما Claude Code متكامل بإحكام مع عائلة نماذج Claude افتراضيًا — على الرغم من أن ANTHROPIC_BASE_URL يسمح لك بإعادة توجيهه إلى نقطة نهاية Novita AI المتوافقة.
مقالات مقترحة
